GE - Como Fazer - Atualização CIGAM

De CIGAM WIKI

Voltar

Como Fazer > Utilidades/Diversos > Atualização CIGAM

A partir da manutenção de um Plano regular de Atualização do ERP CIGAM, considerando as boas práticas indicadas pela equipe da CIGAM, é possível manter uma ótima experiência de uso da solução, garantindo uma maior e melhor integridade das informações, produtividade nas operações, além de ter ao dispor o que há de melhor e mais novo no sistema.

Além disto, o atendimento do suporte CIGAM é mais ágil e efetivo, uma vez que a equipe de Suporte opera com a versão atualizada, facilita e agiliza a disponibilização de alterações legais e correções do sistema, evitando retrabalhos e custos para os atendimentos e/ou para a entrega de alguma solução já disponível. O processo requer uma sequência para a execução das rotinas de atualização e, como forma de simplificar e dar maior integridade para a operação, existe o Assistente de Atualização que conduz o usuário para a correta realização da atualização do ERP CIGAM.

Preparar a estrutura do CIGAM11 para atualização

Primeiramente, precisamos preparar a estrutura do CIGAM11 para receber atualização da nova release, conforme descrito na sequência.

Quais arquivos e extensões deve ser efetuado o backup?

Antes de qualquer alteração ou execução dos processos que envolvem a atualização, é a realização do Backup, especialmente quando a atualização envolve um dos ambientes oficiais do cliente, como Ambiente de Produção, Ambiente de Contingência ou integrações específicas, como as CUSTOMIZAÇÕES.

Logo, devem ser efetuado backup dos arquivos e extensões que seguem:

  • Arquivos: Apoio, ECF, XPA, Magic.ini, Cab, Graficos, CDK, Imagens, Cigam, PAF, Config, Script, Modelos
  • Extensões: .d, .s, .u, .i, .dll, .zip, .ecf , .exe, .ocx, .rar, *.tlb

A pasta Modelos deve ser feito backup para garantir que nenhum arquivo seja perdido após a atualização, pois é muito modificado relatórios ‘padrões’ são modificados e suas alterações perdidas.

Como padrão, são realizadas as cópias de todos os arquivos relacionados na pasta “COPIAS” e dentro desta pasta, é recomendado o uso da nomenclatura “BKP_ATL_DATAATUAL”.

Voltar ao início

Onde efetuar o download da release?

Os arquivos para atualização da release podem ser encontrados no disco virtual ou FTP da CIGAM.

Por padrão, os arquivos são salvos sempre na mesma pasta \\Servidor\CIGAM\CIGAM11\Atualiza11\VERSÃO.zip

Quais arquivos substituir para atualização?

Antes de substituir os arquivos baixados anteriormente é necessário apagar da estrutura do CIGAM11 as dlls e a pasta SCRIPT, para evitar que seja compilado algum script antigo para a nova versão e deixar integro o carregamento garantido que não haverá CABs desnecessários e dlls antigas na estrutura.

Após, descompactar a release que deseja atualizar sobre a estrutura do CIGAM11, confirmando a opção para sobrescrever todas as pasta e arquivos.

Voltar ao início

Preparação do Ambiente

Com a estrutura do CIGAM11 preparada para atualização, devemos iniciar a preparação do ambiente para a atualização ocorrer corretamente.

Quais alterações efetuar no Magic.ini?

Nesse passo, precisamos manter o maior cuidado possível, pois estamos alterando o coração do ERP CIGAM, o arquivo Magic.ini.

No Magic.ini iremos primeiramente desproteger a opção de “Somente Leitura”, encontrando-o na pasta CIGAM11 e clicando com botão direito, PROPRIEDADES, no Magic. Logo após, desmarcando o atributo.

Magic_Somente_Leitura.png


Finalizando esse processo, vamos editar o Magic.ini e deixar pronto para atualização.

  • Localizar (CTRL+F) o “CIGAM_SQL” e retirar na variável NoCheckExist as letras “NO” deixando apenas CheckExist. Efetuar o mesmo procedimento na variável NoCheckDefinition, ou seja, retirar as letras “NO” deixando apenas CheckDefinition.

Com isso, estamos habilitando o “verificar existência” e "verificar definição" e assim preparando o início da atualização.

CIGAM_SQL.png


Sugerimos que seja criado um Atalho com “Adendo”, com os parâmetros “CheckDefinition” e “CheckExist” marcados e o StartApplication = %CIGAM_INSTAL%CGAtualizacao.ecf facilitando o acesso do ambiente de atualização, verificar 'GE - Como Fazer - Adendo'.

Além disso também sugerimos para ser adicionado nas seções do MAGIC_DATABASES o parâmetro SQL_NO_INMEMORYTABLES = Y para clientes que utilizam o SQL Server 2019 com o Magic XPA 4.91. Conforme mencionado na WIKI 'Instalação CIGAM 11'.

Voltar ao início

Como abrir o CGAtualização?

O CGAtualização pode ser aberto conforme segue:

Exemplo: E:\CIGAM11\XPA\MgxpaRuntime.exe /INI=E:\Cigam11\Magic\Magic.ini //@E:\CIGAM11\Magic\AdendoAtualizacao.ini.

  • Através de utilidades localizado na barra de topo do CIGAM, em aplicações é possível acessar o programa Abrir aplicações possibilitando a abertura do Atualiza Cigam;

  • Acessar diretamente a aplicação através do ícone de acesso ao sistema, basta incluir a chamada do ecf, /StartApplication=%CIGAM_INSTAL%CGAtualizacao.ecf, no ícone de acesso conforme exemplo:

E:\CIGAM11\XPA\MgxpaRuntime.exe /INI=E:\Cigam11\Magic\Magic.ini /StartApplication=%CIGAM_INSTAL%CGAtualizacao.ecf

Voltar ao início

O que é o Assistente de Atualização?

O Assistente de Atualização é uma ferramenta que auxilia na sincronização de informações, na criação de objetos no banco de dados e na execução das rotinas necessárias para a atualização do ERP CIGAM para uma nova versão.

Antes de executar o Assistente, é fundamental que o usuário verifique se o ambiente está devidamente atualizado, incluindo todos os componentes do ERP CIGAM, como arquivos ‘.ecf’, pastas, DLLs e demais objetos essenciais para o correto funcionamento do sistema.

Como executar o Assistente de Atualização?

1️⃣ Iniciando o Assistente

  • Ao abrir o CGAtualização, se houver uma versão mais nova disponível, será exibida a mensagem:
"Foi identificada uma versão mais nova para atualização. Deseja atualizar agora?"
  • Clique em Sim para iniciar o Assistente, que mostrará orientações iniciais sobre o processo, conforme imagem.
Observação: Caso o assistente não inicie automaticamente, clique com o botão direito na aplicação e selecione:
"Autoconversão > Assistente de Atualização".
Assistente
Importante:
  • Se o ambiente estiver com uma versão menor que a do pacote de instalação, o assistente abrirá normalmente.
  • Caso contrário, aparecerá a mensagem de ambiente atualizado [Versão 241007.d 1].

2️⃣ Seguindo o processo de atualização

  • Marque a opção:
"Verifiquei os itens acima e desejo prosseguir com a instalação"
  • A partir da versão 211013RC, se o processo for interrompido, é possível:
✅ Retomar a etapa anterior
✅ Recomeçar o processo

3️⃣ Finalizando a atualização

  • Ao concluir, o assistente exibirá o status de cada etapa (sucesso ou falhas).
  • Em caso de divergências:
  • Utilize os botões Checklist e Manutenção scripts para refazer ações necessárias.
  • Clique em Avançar para prosseguir com a finalização.

4️⃣ Finalização automática

Após o processo, o sistema executará:
  • Restauração do parâmetro StartApplication = %CIGAM_INSTAL%CGAplicacao.ecf no Magic.ini.
  • Desmarcação das opções NoCheckExist e NoCheckDefinition.
✅ Ação manual necessária: Definir o arquivo Magic.ini como Somente leitura.

5️⃣ Auditor de Ambiente

A partir da [Versão 240506 1], ao selecionar Sair no Assistente:
  • O Assistente será encerrado.
  • O Auditor de Ambiente será aberto automaticamente para revisão do ambiente atualizado.

6️⃣ Primeiro acesso ao CIGAM após a atualização

Ao abrir o CIGAM:
  • O componente CIGAMK será sincronizado automaticamente.
  • Clique em OK para concluir.

⚠️ ATENÇÃO!

Quando forem realizadas atualizações nos ambientes de teste ou homologação (database), é obrigatório ajustar as configurações dos ambientes, conforme segue:

Voltar ao início

Versão

Versão 240506

  1. ↑ Liberado a partir da OS 373456/647.

Versão 241007.d

  1. ↑ Liberado a partir da OS 373456/828.

Voltar ao início

Disponível em "https://www.cigam.com.br/wiki/index.php?title=GE_-_Como_Fazer_-_Atualização_CIGAM&oldid=146165"