Pular para o conteúdo principal

Atualização do Signer em Windows Server

Esta página mostra como atualizar uma instância on-premises do Signer instalada no IIS conforme o setup em Windows Server.

Antes de atualizar​

  1. Verifique a versão instalada. Abra https://<seu-dominio>/api/system/info no navegador. O campo productVersion 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 Hosting Bundle do .NET 10.0. Instale-o antes de trocar os binários.
  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 no appsettings.iis.json.

Backup​

  1. Pare o site no Gerenciador do IIS.
  2. Faça backup do banco de dados no SQL Server.
  3. Faça uma cópia da pasta do site (por exemplo, C:\inetpub\Signer). A cópia inclui o appsettings.iis.json.

Atualização​

  1. Baixe o pacote da versão nova: https://cdn.lacunasoftware.com/signer/signer-<versão>.zip. Os links de cada versão estão no changelog.
  2. Extraia o pacote para a pasta do site e sobrescreva todos os arquivos.
  3. Faça no appsettings.iis.json as alterações que o changelog pedir.
  4. Inicie o site no Gerenciador do IIS.
observação

O pacote não tem um arquivo appsettings.iis.json, por isso a sua configuração não muda. O pacote tem um web.config. Se você alterou o web.config (por exemplo, o limite de upload do IIS), refaça a alteração depois de extrair o pacote. Veja Limite de upload.

Verifique a atualização​

  1. Abra https://<seu-dominio>/api/system/info e verifique se productVersion mostra a versão nova.
  2. Abra o arquivo de log (configurado em Serilog, por exemplo C:\Logs\Signer.log) e procure erros da inicialização. A atualização do banco pode levar alguns minutos.

Se o site 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 o IIS mostrar o erro 500.31 logo depois de uma atualização para a 3.x, verifique se o Hosting Bundle do .NET 10.0 está instalado.

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, pare o site e restaure a cópia da pasta do site.

Veja também​

Ver em Markdown