isoCRM - Atualização de pacote

Através deste documento, será possível fazer a atualização do sistema através do novo pacote. É de extrema importância que seja feito um backup do sistema antes de continuar com o processo.

Procedimento:

1 - Desligando a aplicação

Antes de começar o processo de atualização de pacote, é necessário desligar a aplicação. Para isso, acesse primeiramente o programa Task Scheduler.

Caso haja motores ligados, desligar os mesmos antes de continuar.

Após parar os motores, é preciso parar a Application Pool da aplicação que será atualizada. Para isso, será utilizado o programa Internet Information Services (IIS) Manager.

Ao selecionar a aplicação e desligá-la clicando no botão "Stop", não será possível acessar o domínio e o processo de atualização pode ser começado.

2 - Extraindo o novo pacote de versão

Para encontrar o diretório da aplicação, acesse:

C:/inetpub/wwwroot/isoEnterprise

Coloque o arquivo do pacote dentro deste diretório.

Obs: o nome usado acima é apenas um exemplo, não sendo uma regra, o importante é poder identificar a versão nova a versão antiga.

Coloque o nome da aplicação no pacote recém extraído e identifique a versão antiga que será substituída.

3.x - Fazendo o apontamento do banco de dados - isoConfigDB.exe

Entrando no diretório do pacote recém extraído será feito o apontamento do banco de dados:

Acesse a pasta isoCRM_Config
Procure pelo programa "isoConfigDB.exe" e execute.

A seguinte tela será exibida, 1 vez. Este fara a atualização de todos os web.config e cliente.exe.config do pacote.

Obs: No primeiro campo, sempre manter a opção "Default".

Preencha com as informações sobre o banco para fazer o apontamento:

Server/DS: Servidor do banco da dados(utilizar "localhost" caso o banco esteja no mesmo servidor).
Database: Banco de dados do cliente(mesmo nome do banco que será feito as reorganizações.
Name: Usuário do banco de dados utilizado pelo cliente.
Password: Senha do usuário de banco de dados utilizado pelo cliente.

Ao clicar no botão "Save and Test Connection" o aviso "Test Connection Succeeded" será exibido caso as informações estejam corretas, confirmando o apontamento.

3 - Fazendo o apontamento do banco de dados - New

Caso voce tenha utilizado o processo acima, não será necessário executar o item 3.

Entrando no diretório do pacote recém extraído será feito o apontamento do banco de dados:

Acesse a pasta isoCRM_Config
Procure pelo executável "GxConfig.exe" e execute.

A seguinte tela será exibida, varias vezes. Este fara a copia e atualização de todos os web.config e cliente.exe.config do pacote.

Obs: No primeiro campo, sempre manter a opção "Default".

Preencha com as informações sobre o banco para fazer o apontamento:

Server/DS: Servidor do banco da dados(utilizar "localhost" caso o banco esteja no mesmo servidor).
Database: Banco de dados do cliente(mesmo nome do banco que será feito as reorganizações.
Name: Usuário do banco de dados utilizado pelo cliente.
Password: Senha do usuário de banco de dados utilizado pelo cliente.

Ao clicar no botão "Save and Test Connection" o aviso "Test Connection Succeeded" será exibido caso as informações estejam corretas, confirmando o apontamento.

O próximo passo é entrar na pasta "bin" dentro da pasta "web" e localizar o arquivo "client.exe.config" e renomeá-lo para "web.config".

Obs: No primeiro campo, sempre manter a opção "Default".

Repita o processo de apontamento através do "GxConfig.exe" e teste a conexão para confirmar o processo.

Após feito o apontamento, renomear novamente o arquivo "web.config" para "client.exe.config".

5 - Apontamento da pasta Motor

Será feito o apontamento do banco dentro da pasta motor assim como foi feito anteriormente na pasta web. Para isso, acesse a pasta motor na VERSÃO ATUALIZADA.

Acessando a pasta bin, localize o arquivo "client.exe.config", o renomeie para "web.config" e execute o "GxConfig.exe".

Após configurar os dados do banco de dados e confirmar a conexão, renomeie novamente o arquivo "web.config" para "client.exe.config".

6 - Arquivo location.xml

CASO dentro da pasta "bin" do diretório Motor contenha o arquivo location.xml, deverá ser feito alterações dentro dele.

Para isso abra o arquivo para edição e localize a seguinte tag:

<BaseURL>/isocrmhomol/</BaseURL>

Altere o conteúdo central da tag para, por exemplo:

<BaseURL>/ExemploCliente/</BaseURL>

O nome inserido deve ser o nome do diretório virtual da aplicação de PRODUÇÃO do cliente em questão.

7 - Ligando novamente a aplicação

Após seguir os passos demonstrados, já é possível ligar novamente a aplicação e checar se está funcionando normalmente.

Para isso deve-se abrir o "IIS" novamente, encontrar o Pool da aplicação e clicar no botão "Start":

Após ligar a aplicação, deve-se abrir o "Task Scheduler" para iniciar os motores existentes:

Também é possível verificar se os motores estão funcionando normalmente através do sistema.

Para isso, acesse no menu lateral:

Supervisor
- Segurança
  - Acessos
    - Finaliza sessão

A tela com a lista de usuários logados no sistema sera exibida, incluindo os usuários motores, sendo assim, pode-se saber quais motores estão ativos.

8 - Conferindo versão do banco de dados

Além de atualizar o pacote da aplicação, deve-se fazer a atualização no banco de dados através dos scripts de reorganização.

*O procedimento a seguir deve ser feito com a aplicação desligada. Para desligar a aplicação, siga o procedimento no começo do documento.

O primeiro passo é saber qual a versão atual do sistema no banco de dados, para descobrir, acesse o banco(neste exemplo utilizaremos o SQL) através do programa Microsoft SQL Server Management Studio.

Expanda a opção com o nome do banco (ex: isocrmhomol);
Expanda a pasta Databases;
Clique com o botão direito em cima do Banco de dados com o nome em que foi apontado anteriormente(ex: isoCRM) e selecione a opção New Query para começar uma nova consulta.

Ao abrir a nova consulta, é possível verificar a versão atual através do comando "select * from isoversao"(Para executar um comando, selecione-o e aperte F5.

No exemplo acima é possível verificar que a versão atual do banco é a V231.

9 - Criando backup do banco de dados

É de extrema importância criar um backup do banco de dados atual, pois caso algo de errado aconteça no processo de atualização, é possível reverter tais alterações para o momento anterior ao procedimento de reorganização.

Clique com o botão direito em cima do banco de dados que deseja fazer o backup:

Acesse a aba "Tasks";
Clique na opção "Back Up..." para abrir a interface de criação de backup.

Através desta interface é possível escolher onde será salvo o backup criado, podendo adicionar caminhos através do botão "Add...".

Após escolhido o diretório de destino, clicar no botão "OK" e aguardar a criação do backup.

10 - Atualizando o banco através das reorganizações

Após verificado a versão atual e criado o backup do banco de dados, deve-se baixar TODAS as próximas versões até a última lançada. Por exemplo, se a versão está na 225, será preciso baixar a 226, 227, 228, etc.

Supondo que a versão atual seja a 225, primeiramente faça o download da reorganização 226, abra o script do arquivo .sql e copie todo o conteúdo dentro dele.

Retorne à consulta criada previamente e cole todo o conteúdo do script da reorganização.

Execute todos os comandos dentro do script separadamente, os comandos são separados pelos pontilhados. Executar desta maneira facilita a detecção de possíveis erros.

Após terminar de rodar todo o script, deverá ser feito o mesmo processo com as próximas reorganizações até chegar na última versão.

Report abuse