isoCRM - Atualização de pacote
Como fazer a atualização de pacote
Para criar uma aplicação do 0, seguir o seguinte documento.
A quem se destina
Destina-se ao setor de TI da empresa ou responsável por atualizar o sistema.
Objetivo
Este documento tem o objetivo de mostrar o procedimento passo-a-passo de como atualizar a versão do sistema.
Introdução
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.