isoCRM - Instalação de pacote (novo padrã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:

C:/inetpub/wwwisocrm/isocrm

*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:

Acesse a pasta isoCRM_Config
Procure pela aplicação isoConfigDB.exe e execute.

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:

Pool principal = isocrm;
Pool das APIs (para configurar, seguir este documento) = isocrmapi;
O nome dessas Pools são padrões, só deve ser mudado em caso de solicitação customizada do cliente ou se houver mais de um cliente no servidor.

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:

isocrm -> utilizará a pool principal no diretório ..\app\web;
isocrmapi-> utilizará a pool APIs no diretório ..\app\isoCRM_api;
isocrmbi -> utilizará a pool principal no diretório ..\app\isoCRM_BI;
isocrmbot -> utilizará a pool das principal no diretório ..\app\isoCRM_isoBot;
isocrmmodern -> utilizará a pool principal no diretório ..\app\isoCRM_modern;
isocrmnucleo -> utilizará a pool principal no diretório ..\app\isoCRM_Nucleo\web;
isocrmws -> utilizará a pool principal no diretório ..\app\isoCRM_WS.
isocrmintegraws-> utilizará a pool principal no diretório ..\app\isoCRM_IntegraWS. (A partir da versão 17.0.0 R45 B2)
isocrmisoapi -> utilizará a pool principal no diretório ..\app\isoCRM_isoAPI. (A partir da versão 17.0.0 R45 B2)
isocrmclassic -> utilizará a pool principal no diretório..\app\isoCRM_classic. (A partir da versão 17.0.0 R45 b1)
isocrmreact -> utilizará a pool principal no diretório ..\app\isoCRM_react. (A partir da versão 17.0.0 R48 B1)

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:

<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.

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

<BaseURL>/isocrmintegraws/</BaseURL>

Report abuse