isoCRM - Instalação de pacote (novo padrão)

Como fazer a atualização de pacote

A quem se destina

Destina-se ao setor de TI da empresa ou responsável por instalar o sistema.

Objetivo

Este documento tem o objetivo de mostrar o procedimento passo-a-passo de como estruturar e instalar um pacote do sistema.

Introdução

Com este documento, será possível fazer a instalação do sistema através de um novo pacote, seguindo a nova estrutura e padronização de diretórios, procurando deixar a instalação mais prática independente de onde for instalado. É de extrema importância que seja feito um backup do sistema antes de continuar com o processo.


O nome do diretório da aplicação deverá ser "app".

Os motores ficam com o prefixo dos nomes das aplicações no IIS para mais fácil identificação.

Procedimento:

1 - Extraindo o novo pacote de versão

O primeiro passo é definir o diretório onde ficará o(s) pacote(s). Por padrão, o caminho para colocar e extrair o pacote é o seguinte:

*Caso o diretório não exista, criar.

**Caso o cliente tenha definido um nome, utilizar o nome definido.

***Caso exista mais de uma aplicação no servidor(Ex: produção e homologação), identificar no diretório.

****O diretório onde estarão as aplicações não pode estar sendo monitorado pelo antivírus.

Como exemplo, no diretório mostrado acima, está a aplicação de homologação. Como ela está no mesmo servidor de outras aplicações, foi necessário identifica-la, por isso o nome do diretório "isocrmhomol".


O nome do diretório da aplicação deverá ser "app".

2 - Fazendo o apontamento do banco de dados

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

A seguinte tela será exibida. Este fará a cópia e atualização de todos os web.config e cliente.exe.config do pacote.

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

Caso seja necessário instalar a aplicação de integração, isoCRM_Integracao (via tabelas), em base diferente do padrão. É necessário efetuar a configuração manualmente do client.exe.config, utilizando o GxConfig.exe do diretório isoCRM_Config.

3 - Criando pools e websites no IIS

Após configuração e apontamento do pacote para o banco de dados, será necessário criar os componentes dentro do IIS e apontá-los para o pacote.

Será necessário criar as seguintes pools:

Após criar as pools, será necessário criar o website da aplicação, onde serão criados e apontados as "amarrações"  das pastas correspondentes do pacote extraído anteriormente.

A configuração do "Binding" pode ser feito depois, caso não consiga ser configurado nesse primeiro momento.

Após a criação do website, será necessário criar as aplicações que vincularão com as pastas do pacote. Ao criar uma aplicação, é necessário informar o nome da aplicação, a pool que ele utilizará e o diretório no pacote(irá mudar conforme a aplicação). 

As aplicações a serem criadas são as seguintes:

Conforme o exemplo ao lado, serão criados os seguintes 10 websites:

O objetivo dessas nomeações é ter o máximo de configurações padronizadas, evitando erros de apontamento e facilitando o processo de instalação e/ou atualização dos pacotes.

4 - Instalando o URL Rewrite

O URL Rewrite é um componente do IIS que deve ser instalado como parte da configuração.

Para fazer a instalação deste componente, é necessário ter o Web Plataform do IIS instalado. Para isso, basta acessar no menu lateral direito a seguinte opção conforme a imagem:

Na tela do Web Plataform, buscar "URL rewrite" no campo de pesquisa de componentes no canto superior direito.

Após encontrá-lo, basta selecioná-lo e clicar em "Install" no canto inferior direito para concluir a instalação.

5 - Configurar motores da aplicação

Após configurar a aplicação, será necessário criar os agendamentos dos motores da aplicação. Para isso, abra o Task Scheduler.

Clicando em Nova Tarefa, será aberta a tela de configuração da mesma:

Na aba General é configurado o nome do agendamento e sua prioridade.

Na aba Triggers é criado o gatilho de agendamento automático, fazendo com que seja disparado automáticamente.

Por padrão é criado o agendamento diário para ser ligado às 08:00h da manhã, podendo variar conforme necessidade.

*alguns motores não possuem o agendamento, pois são ligados apenas em situações específicas.

Na aba Actions será definido o arquivo a ser rodado no agendamento.

Será selecionado o arquivo do motor no diretório da aplicação no campo "Program/script".

No campo "Start in" deve se colocar o caminho até o "..\motor" para que o arquivo do motor funcione no agendamento.

Esse é um exemplo de motor, devido a padronização, esse mesmo motor funcionaria em qualquer aplicação sem precisar mexer no direcionamento manual do mesmo, facilitando ainda mais o processo.

6 - Configurações adicionais

Na configuração dos bindings, quando for necessário adicionar um DNS, o prefixo desse DNS tambem deverá ter o nome da aplicação, conforme o print abaixo:

Para geração do certificado para um binding especifico, seguir este documento.

6.1 - Liberação de acesso

Outra configuração que pode ser necessária durante a instalação, é a liberação de total acesso (via propriedades) para dois usuários do servidor do diretório wwwisocrm: IUSR e IIS_IUSRS.

6.2 - Redirecionamento HTTP

É possível configurar um redirecionamento, para que não seja necessário inserir o url inteiro para que seja redirecionado para a tela inicial do isoCRM. Para isso, no IIS, clique no site que deseja adicionar o redirecionamento e clique em "Redirecionamento HTTP" conforme a imagem a seguir:

Na tela que abrir, será necessário marcar a opção de redirecionamento e adicionar exatamente esse caminho(que deve ser padrão para todas as aplicações isoCRM): "/isocrmmodern/#principal"

6.3 - Liberação do antivírus

O objetivo dessa configuração é aliviar o processamento do antivirus e impedir que ele barre algum arquivo erroneamente nos diretórios do isoCRM. Para isso, no "Iniciar", digitar "virus" e clicar na primeira opção "Proteção contra virús e ameaças".

Após acessar as seguintes opções, adicionar todos os diretórios de aplicação ou banco de dados do isoCRM, como por exemplo:

6.4 - Agendamento da varredura do antivírus

Essa configuração é para ajustar a prioridade e o horário da varredura automática do windows defender, alterando ela pra um momento onde caso exista um atraso, não há a possibilidade de ser feita durante uso do ambiente, evitando lentidões.

Para isso acesse o Agendador de tarefas e vá nos diretórios laterais: Task Scheduler Library -> Microsoft -> Windows -> Windows Defender(clique nessa opção).

Ao abrir os agendamentos do Windows Defender, clique na opção Windows Defender Scheduled Scan, conforme o print e vá em propriedades.

Na aba General, desmarcar a opção para rodar com privilégios altos.

Na aba Trigger, mudar o horário de execução para 22h(10PM).

Na aba Conditions, desmarcar as opções de começar a tarefa quando o computador estiver ocioso, e a opção de começar apenas começar a tarefa quando o computador estiver energizado.

7 - Arquivo location.xml

CASO dentro da pasta "bin" do diretório Motor ou isoCRM_Integracao 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:

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

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

Caso utilize os motores de integração, apontar para a aplicação isocrmintegraws conforme exemplo: