GE - Como Fazer - Atualização CIGAM

De CIGAM WIKI
Revisão de 12h10min de 4 de abril de 2025 por Leonardo.negrini (discussão | contribs) (Quais alterações efetuar no Magic.ini?)

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 tem por função auxiliar na sincronização de informações, criação de objetos de banco de dados e na execução de rotinas necessárias para atualização de uma versão no ERP CIGAM. Para isto, antes de executar o assistente, o usuário deve se certificar que o ambiente está atualizado com todos os componentes que compõem o ERP CIGAM, como arquivos ‘.ecf’, pastas, dll’s e demais objetos necessários para o perfeito funcionamento do ERP.

Voltar ao início


Como executar o Assistente de Atualização?

1. Iniciando o Assistente de Atualização:
  • Ao abrir o CGAtualização, caso existam arquivos para uma nova versão no ambiente, será exibida a mensagem:
"Foi identificada uma versão mais nova para atualização. Deseja atualizar agora?"
  • Clique em "Sim" para iniciar o Assistente de Atualização, que apresentará 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

[Versão 241007.d 1]Observação: Se o valor das configurações 'GE - AM - 569 - Release atual' e 'GE - AM - 1428 - Patch atual' indicarem que o ambiente está com uma versão menor que a correspondente ao pacote de versão encontrado na pasta de instalação, deve acessar o Assistente de Atualização normalmente.

Se o valor das configurações 'GE - AM - 569 - Release atual' e 'GE - AM - 1428 - Patch atual' indicarem que o ambiente está com uma versão igual ou maior que a correspondente ao pacote de versão encontrado na pasta de instalação, será exibido a seguinte mensagem: "O ambiente está atualizado com a versão disponível na pasta de instalação. Para utilizar o Assistente de Atualização, é necessário baixar uma versão mais recente".

2. Seguindo o Processo de Atualização:
  • Marque a opção "Verifiquei os itens acima e desejo prosseguir com a instalação" para começar a atualização.
  • Caso o processo seja interrompido ou falhe, é possível: (Funcionalidade disponível a partir da versão CIGAM 211013RC)
    • Retomar a etapa anterior.
    • Recomeçar o processo, dependendo da necessidade.
3. Finalizando a Atualização:
  • Após a conclusão, será exibido o status de cada etapa, indicando sucesso ou falhas.
  • Em caso de divergências:
    • Utilize os botões "Checklist" e "Manutenção scripts" para executar novamente as ações necessárias, sem sair do Assistente.
  • Clique em "Avançar" para acessar a tela de finalização.
4. Finalização:
  • Após a conclusão do processo de atualização, o sistema executará automaticamente as seguintes ações:
    • Restaurará o valor StartApplication = %CIGAM_INSTAL%CGAplicacao.ecf no arquivo Magic.ini.
    • Desmarcará as opções NoCheckExist e NoCheckDefinition.
  • Ação manual necessária: Configure o arquivo Magic.ini como "Somente leitura".
5. Auditor de Ambiente:
  • A partir da [Versão 240506 1], ao selecionar "Sair" no Assistente de Atualização:
    • O Assistente será encerrado automaticamente.
    • O Auditor de Ambiente será aberto imediatamente, permitindo uma revisão do ambiente atualizado.
6. Primeiro Acesso ao CIGAM Após Atualização:
  • Ao abrir o CIGAM, o componente CIGAMK será sincronizado automaticamente. Clique em "OK" para concluir.


ATENÇÃO!

Quando há atualização de dados no ambiente de teste (database de teste) e no ambiente de homologação (database de homologação) obrigatoriamente deve ser alteradas as configurações que seguem para Homologação:

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