Pular para o conteúdo principal

Atualização do Signer em Linux

Esta página mostra como atualizar uma instância on premises do Signer instalada em Linux conforme a instalação em Ubuntu Server.

info

Essas instruções assumem que você está autenticado como root. Se você não estiver, execute sudo su - antes de continuar.

Antes de atualizar​

  1. Verifique a versão instalada:

    curl http://localhost:5001/api/system/info

    O campo productVersion da resposta mostra a versão.

  2. Leia o changelog de todas as versões entre a sua e a nova. Procure as versões marcadas com alteração no modelo do banco de dados.

  3. Se você vai sair da versão 2.x para a 3.x, siga também Atualizando para 3.x. A versão 3.0.0 exige o ASP.NET Core Runtime 10.0.

  4. Atualize primeiro o ambiente de homologação. Teste o envio e a assinatura de documentos antes de atualizar a produção.

  5. Escolha um horário de pouco uso. Na primeira inicialização, a aplicação atualiza o banco de dados quando a versão nova tem alterações no modelo.

aviso

Se você tem mais de um servidor, só um deles deve atualizar o banco de dados. Pare os outros servidores, atualize um servidor e espere ele iniciar. Depois, atualize os outros. Outra opção: em todos os servidores menos um, defina General:AutoUpdateDatabase e General:ProcessBackgroundJobs como false.

Backup​

  1. Faça backup do banco de dados no SQL Server.

  2. Faça uma cópia da pasta dos binários e da pasta de configuração:

    tar czf /root/signer-backup-$(date +%Y%m%d).tar.gz /usr/share/lacuna-signer /etc/lacuna-signer

Atualização​

  1. Defina a versão nova. Veja a versão mais recente no changelog:

    VERSION=3.0.0

  2. Baixe o pacote, pare o serviço, troque os binários e inicie o serviço:

    curl -O https://cdn.lacunasoftware.com/signer/signer-$VERSION.tar.gz
    systemctl stop lacuna-signer
    rm -fR /usr/share/lacuna-signer/*
    tar xzf signer-$VERSION.tar.gz -C /usr/share/lacuna-signer
    chmod -R a=,u+rwX,go+rX /usr/share/lacuna-signer
    systemctl start lacuna-signer

A configuração fica em /etc/lacuna-signer e não muda com a atualização.

Verifique a atualização​

  1. Verifique se o serviço está ativo:

    systemctl status lacuna-signer

  2. Verifique se productVersion mostra a versão nova:

    curl http://localhost:5001/api/system/info

  3. Acompanhe o log durante a primeira inicialização. A atualização do banco pode levar alguns minutos:

    journalctl -u lacuna-signer -f

Se o serviço não iniciar e o log mostrar PKI SDK License was not loaded successfully, a aplicação não carregou a licença do PKI SDK (licença ausente, inválida ou vencida). Peça uma licença atualizada à Lacuna e informe-a em PkiSuite:SdkLicense.

Se algo der errado​

Se a versão nova tiver um problema, fale primeiro com o suporte da Lacuna. Se for preciso voltar à versão anterior, siga o rollback de versão. Para voltar só os binários, extraia a pasta /usr/share/lacuna-signer do backup.

Veja também​

Ver em Markdown