Manual de atualização

Este manual descreve como atualizar uma instalação existente do Business Intelligence (BI) para uma versão nova. Ele se destina à equipe de infraestrutura (TI).

Para a primeira instalação, consulte o Manual de instalação.

Como identificar a versão

A versão instalada aparece no rodapé de todas as telas do BI, inclusive na tela de login — por exemplo, Versão: 2026.10.7.1. A versão segue o formato Ano.Mês.Dia.Build.

Cada pacote novo é entregue como BI-<versão>.zip, com a mesma estrutura do pacote de instalação (INSTALAR.bat, api/, frontend/, api-demo/).

O que é mantido e o que é substituído

Atenção: qualquer arquivo alterado manualmente dentro de C:\BI\api, C:\BI\frontend ou C:\BI\api-demo (por exemplo, o web.config) é sobrescrito pela versão nova. A única exceção é o appsettings.Production.json.

1. Antes de atualizar

1. Avise os usuários: o BI fica indisponível por alguns minutos durante a atualização.
2. Faça cópia de segurança de:
   • C:\BI\api\appsettings.Production.json;
   • a pasta C:\BI\dados;
   • a pasta C:\BI inteira (para voltar à versão anterior, se necessário);
   • o schema do BI no Oracle (com o DBA) — recomendado, porque a atualização pode alterar a estrutura do banco e essa alteração não é desfeita automaticamente.
3. Copie o pacote novo (BI-<versão>.zip) para o servidor e extraia o zip inteiro em uma pasta nova (não extraia por cima de C:\BI).

2. Atualizar (recomendado: com o instalador)

1. Na pasta do pacote novo, dê dois cliques em INSTALAR.bat (ele pede permissão de administrador).
2. O instalador reconhece que o BI já está instalado e:
   • não pergunta de novo os dados do Oracle nem do administrador — mostra "Configuracao existente mantida";
   • para os sites do BI no IIS;
   • substitui os programas pelos da versão nova;
   • liga os sites novamente e confere IIS, firewall e APIs de demonstração.
3. Aguarde a etapa 8/8 – Testando. Na primeira inicialização da versão nova, a API pode levar 1 a 2 minutos para responder, se precisar atualizar a estrutura do banco.
4. Ao final deve aparecer "BI INSTALADO COM SUCESSO".

Se o BI tiver sido instalado em outra pasta (opção -InstallDir), rode o instalador com a mesma opção, pelo PowerShell como administrador: .\Instalar-BI.ps1 -InstallDir D:\BI.

3. Depois de atualizar

1. Abra o BI no navegador e confira a versão no rodapé.
2. Peça aos usuários que recarreguem a página com Ctrl+F5, para o navegador não usar a versão antiga guardada.
3. Abra um painel e confira se os dados aparecem.
4. Em caso de aviso amarelo ou erro no instalador, guarde o log C:\ProgramData\BI-instalacao-<data>.log e envie para a equipe do BI.

4. Atualizar só as APIs de demonstração

Quando a atualização envolver apenas as APIs de demonstração, a equipe do BI envia o pacote pequeno BI-demo-<versão>.zip:

1. Extraia o zip no servidor da API do BI.
2. Dê dois cliques em INSTALAR-DEMO.bat.
3. Ao final deve aparecer "APIS DE DEMONSTRACAO PRONTAS".

Esse pacote não mexe na tela, na API do BI, no IIS nem no banco.

5. Atualização manual (sem o instalador)

Use apenas se não for possível executar o INSTALAR.bat.

1. Faça as cópias de segurança do item 1.
2. No Gerenciador do IIS, pare os pools de aplicativos BI-API e BI-Web.
3. Substitua o conteúdo de C:\BI\api pelo da pasta api/ do pacote novo, preservando o appsettings.Production.json.
4. Substitua o conteúdo de C:\BI\frontend pelo da pasta frontend/ do pacote novo.
5. Inicie os pools BI-API e BI-Web.
6. Faça as conferências do item 3.

6. Voltar à versão anterior

Se a versão nova apresentar problema:

1. Pare os pools BI-API e BI-Web no IIS.
2. Restaure a cópia da pasta C:\BI feita antes da atualização.
3. Se a versão nova tiver alterado a estrutura do banco, peça ao DBA para restaurar o backup do schema do BI — a versão anterior pode não funcionar com a estrutura nova.
4. Inicie os pools e confira a versão no rodapé.
5. Informe a equipe do BI, enviando o log da instalação.

Histórico de versões