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
Item
Na atualização
Painéis, fontes de dados, usuários, links compartilhados, auditoria
Mantidos — ficam no banco Oracle.
Configuração (
C:\BI\api\appsettings.Production.json): Oracle, chave de segurança, endereços
Mantida.
Chaves de criptografia (
C:\BI\dados\chaves)
Mantidas.
Sites do IIS, firewall, tarefas agendadas
Mantidos (e conferidos).
Programas (
C:\BI\api, 
C:\BI\frontend, 
C:\BI\api-demo)
Substituídos pela versão nova.
Estrutura do banco
Atualizada automaticamente pela API na primeira inicialização, quando a versão nova exigir.
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
Avise os usuários: o BI fica indisponível por alguns minutos durante a atualização.
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.
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)
Na pasta do pacote novo, dê dois cliques em 
INSTALAR.bat (ele pede permissão de administrador).
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.
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.
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
Abra o BI no navegador e confira a versão no rodapé.
Peça aos usuários que recarreguem a página com Ctrl+F5, para o navegador não usar a versão antiga guardada.
Abra um painel e confira se os dados aparecem.
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:
Extraia o zip no servidor da API do BI.
Dê dois cliques em 
INSTALAR-DEMO.bat.
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.
Faça as cópias de segurança do item 1.
No Gerenciador do IIS, pare os pools de aplicativos BI-API e BI-Web.
Substitua o conteúdo de 
C:\BI\api pelo da pasta 
api/ do pacote novo, preservando o 
appsettings.Production.json.
Substitua o conteúdo de 
C:\BI\frontend pelo da pasta 
frontend/ do pacote novo.
Inicie os pools BI-API e BI-Web.
Faça as conferências do item 3.
6. Voltar à versão anterior
Se a versão nova apresentar problema:
Pare os pools BI-API e BI-Web no IIS.
Restaure a cópia da pasta 
C:\BI feita antes da atualização.
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.
Inicie os pools e confira a versão no rodapé.
Informe a equipe do BI, enviando o log da instalação.
Histórico de versões
Versão
Principais mudanças
2026.10.7.1
Nova interface (visual renovado, tema claro/escuro); filtro por clique nos gráficos mais fluido; instalador automático (
INSTALAR.bat); APIs de demonstração incluídas, com nomes próprios (
api.saneamento.cebi, 
api.os.cebi); a API aceita vários endereços da tela (
Frontend:BaseUrl separado por vírgula).
2026.6.12.1
Primeira versão entregue para publicação no servidor.