Kbase 88903: Implantar Datasul for THF
| Autor |
Fabio Dalfovo - GCAD BART |
| Acesso |
Público |
| Publicação |
10/18/2018 |
|
A rotina de Instalação do Datasul for THF faz: o download de arquivos para implantação(inclusive instalação do TOMCAT na versão 9 de 64 Bits, essa versão requer JRE 8 ou superior de 64bits - https://tomcat.apache.org/whichversion.html), descompactação de arquivos e atualização de dados no banco EMSFND. IMPORTANTE: em caso de execução incorreta sobre um determinado banco EMSFND, ex.: o banco informado era de produção, porém os parâmetros de instância são de ambiente de testes, somente é necessário executar a tarefa com as novas parametrizações, sem necessidade de voltar backup do banco.
País: Selecionar o país que será utilizado para importação do menu.
Conexão EMSFND: Contém os parâmetros de conexão ao banco emsfnd. Esses parâmetros de conexão são informados no cadastro de ambientes na página de Banco Acesso 4GL. Se o banco de dados é PROGRESS e possui segurança aplicada, então selecione a opção Bancos Seguros e informe o usuário e senha do banco(essa informação não é transmitida para a TOTVS e nem registrada em logs).
Instância Atual: É a instância do JBOSS que será convertida para TOMCAT. O console busca essa informação do cadastro de ambientes na página Instâncias. IMPORTANTE: o console somente lê as informações dessa instância não modifica parâmetros ou descompacta arquivos nesse diretório.
Dir extração binários(.r): Diretório onde são extraídos os arquivos .r necessários para o Datasul for THF. Caso seja necessário modificar esse diretório, acesse o cadastro de ambientes na página Propath.
TOMCAT
Instalação local: O servidor de aplicação TOMCAT será executado no mesmo servidor/estação onde está sendo executado o console.
Instalar em outro servidor: Se o TOMCAT não for instalado no servidor onde está sendo executado o console, então informe no Diretório de instalação, o caminho onde será realizada a descompactação e no campo Diretório do servidor que foi compartilhado para a instalação(na visão do servidor), o caminho de instalação para acessar esse diretório, como se estivesse no servidor. Exemplo: o compartilhamento \\Servidor\Totvs\ServidorAplicacao, se acessado diretamente no servidor seria no servidor C:\Totvs\ServidorAplicacao. IMPORTANTE: Essa informação Diretório do servidor que foi compartilhado para a instalação(na visão do servidor), é necessária para construção do script de criação de serviço(.bat) que é gerado no Diretório de instalação, esse script pode ser editado a qualquer momento.
O Tomcat baixado pelo console funcionará em Windows ou Linux. Porém, quando direcionado para o servidor Linux, deverá ser executado scripts .sh para registro dos serviços.
Diretório de instalação: Onde serão descompactados os arquivos referentes a instalação do TOMCAT e criação de demais arquivos(script de criação de serviço(.bat), arquivos .pf, arquivos de alias, arquivo .properties).
Porta da aplicação: Porta pelo qual a aplicação irá responder. Se a instância atual do JBOSS está na porta 8080 então instale o TOMCAT na mesma porta e assim sucessivamente para as demais instâncias.
Nome do serviço: Nome do serviço do Windows. É possível registrar o serviço já na execução da tarefa, entretanto é necessário executar o console como Administrador. IMPORTANTE: se não for registrado o serviço nesse momento, o console deixa os scripts para criação do serviço no Diretório de instalação.
Alterar portas: Caso seja necessário modificar alguma porta para instalação. IMPORTANTE: se for utilizar portas padrões de instalação ou as portas ali demonstradas não estejam em uso por outra aplicação, não é necessário modificar esses parâmetros.
AppServer Progress
Customizar AppServer: A tarefa de implantação do Datasul for THF faz uma verificação nos bancos de dados cadastrados no produto Datasul, e sugere o nome do AppServer para cada empresa cadastrada no ambiente(com base no que está informado programa de Parâmetros do Foundation). Clicando na opção Customizar AppServer é possível modificar o nome dos brokers. Esses mesmos nomes de brokers são utilizados para criação de arquivos .pf e alias por empresa e também integrados ao arquivo %DLC%/properties/ubroker.properties, que é utilizado para configuração de AppServer. Nessa tela também é possível indicar qual é o broker Appserver do Foundation, cujo endereço de conexão será configurado no arquivo context.xml do Tomcat.
IMPORTANTE: não informar nomes de brokers com espaços ou caracteres especiais.
ATENÇÃO: Caso possua mais de uma empresa em um mesmo conjunto de bancos, você pode apontar essas empresas para o mesmo broker Appserver por essa tela.
Arquivo config.xml: selecionar o arquivo config.xml da instância atual do JBOSS que está sendo convertida. A localização padrão é ....\ERP\scripts-XXXX\config.xml. IMPORTANTE: O console somente lê informações desse arquivo, não faz modificações.
RemoteServerPort: Essa é a porta usada na abertura do Datasul Interactive. Caso você mantenha o ambiente antigo com Jboss, recomenda-se mudar essa porta para não ocorrer conflito ao abrir o DI no ambiente com Datasul for THF ativo. O valor apresentado em tela é a configuração atual do config.xml e ele pode ser alterado para um novo valor.
Utiliza EAI2
Configuração EAI2: Se na instalação atual do JBOSS é utilizada alguma funcionalidade de EAI2, então selecione esse arquivo de configuração. A localização padrão é ...\ServidorAplicação\jboss-4.2.3.GA\server\instance-XXXX\conf\datasul\eai2-config.properties. IMPORTANTE: Se não constar esse arquivo na pasta, pode ser desconsiderado esse campo.
*** Importante*** Desabilite o monitoramento do Audit Trail para o banco do Foundation - EMSFND antes de iniciar o procedimento de instalação do Datasul for THF.
Detalhes sobre o procedimento na documentação: https://centraldeatendimento.totvs.com/hc/pt-br/articles/360050387194-DS-THF-Audit-Trail-no-processo-de-instala%C3%A7%C3%A3o-do-Datasul-for-THF?source=search
**Após a execução da Instalação do Datasul for THF, fique atento as Considerações Finais.
Confira os procedimentos de implantação do Datasul do THF nesse endereço:
https://centraldeatendimento.totvs.com/hc/pt-br/articles/360033925054-DS-THF-Instala%C3%A7%C3%A3o-do-Datasul-for-THF