CONTEÚDO

Configurações

1. AppServer
2. Java
3. Tomcat
4. TOTVS CORS Valve
5. BIRT
6. Propriedades

Configurações

Abaixo temos várias configurações que devem ser feitas no ambiente do Datasul que foi recém instalado.

01. AppServer

Definição de um usuário de rede para o AdminService

Após instalar o AppServer, será necessário configurar o AdminService for OpenEdge, adicionando uma conta de login, conforme os passos abaixo:

Execute o Serviços do Windows, através do Executar (WIN + R) e executar o programa services.msc, conforme a imagem a seguir:

Localize o AdminService for OpenEdge e entre nas Propriedades desse serviço, clicando com o botão direito do mouse.

Acesse a aba Logon e informe uma conta de acesso à rede no logon, pois isso permitirá que o AppServer acesse programas que estejam em outros servidores em sua rede, depois volte para a aba Geral e clique em Iniciar o serviço.

Após essa configuração do AppServer, acesse o OpenEdge Explorer através do link de acesso http://localhost:9090/login.jsp para ter acesso e poder ajustar o seu Appserver

Informações adicionais para a configuração do Appserver Progress para o Datasul for THF:

Framework - Linha Datasul - TEC - Configuração do Appserver Progress para o Datasul for THF

02. JAVA

Será necessário criar duas variáveis de ambiente para o Java, para fazer isso acesse as Configurações do Windows, através do botão direito sobre o botão Iniciar, clicar na opção Sistema

Na tela que irá aparecer, clique na opção Informações do Sistema

Será apresentado a tela abaixo onde você terá que clicar em Configurações avançadas do sistema

Dentro da tela de Propriedades do Sistema, clique em Variáveis de Ambiente

Adicionar as seguintes variáveis de ambiente no servidor:

Adicionar as seguintes variáveis de ambiente na máquina client:  ????????????????????????????????????????????????????????

03. Tomcat

Como melhorar a performance da carga do Tomcat utilizado pelo Datasul for THF?

1. Navegue até o diretório onde está instalado o Tomcat;
2. Faça um backup do arquivo conf\catalina.properties, depois edite o arquivo e altere-o conforme procedimento a seguir:

De:

tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\

Para:

tomcat.util.scan.StandardJarScanFilter.jarsToSkip=*.jar\

3. Ainda no arquivo conf\catalina.properties realize a seguinte alteração:

De:

tomcat.util.scan.StandardJarScanFilter.jarsToScan=\

Para:

tomcat.util.scan.StandardJarScanFilter.jarsToScan=spring-webmvc*.jar,totvs-login-java*.jar,jstl*.jar\

4. Faça um backup do arquivo conf\server.xml. Edite o arquivo e localize a tag Host, localizada ao final do arquivo. Nesta tag, inclua a propriedade startStopThreads="3", conforme exemplo abaixo:

<Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true" startStopThreads="3">

Este parâmetro define a quantidade de Threads que serão utilizadas no processo de carga do Tomcat. Defina-o de acordo com a quantidade de processadores disponíveis em seu servidor. Quanto maior a quantidade de Threads, mais rápido deve ser o startup da instância.

5. Certifique-se de que as alterações foram salvas e reinicie o Tomcat.

Definindo o AppServer para a sua instância do Tomcat?

Para definir qual o AppServer que o Tomcat irá utilizar, voce terá que realizar os seguintes passos:

1. Através do Explorador de Arquivos, acesse o diretório onde encontra-se instalado o Tomcat;
2. Edite o arquivo conf\context.xml, realizando um backup deste arquivo antes de efetuar as alterações sugeridas;
3. Neste arquivo localize a tag Context e insira ou edite a tag de acordo com o exemplo abaixo:

<Environment name="totvs.appserver" type="java.lang.String" value="AppServer://JV-CAT-TST01:5162/Datasul_12_1_33"/>

Onde temos no exemplo:

JV-CAT-TST01 - Nome do servidor onde está o broker Appserver;
5162 - Porta do NameServer utilizado pelo broker Appserver;
Datasul_12_1_33 - Nome do broker Appserver criado para esta instância do Tomcat.

Abaixo um exemplo do conteúdo do conteúdo completo deste arquivo:

<?xml version="1.0" encoding="UTF-8" ?>
<Context crossContext="true">
   <WatchedResource>WEB-INF/web.xml</WatchedResource>
   <WatchedResource>WEB-INF/tomcat-web.xml</WatchedResource>
   <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>
   <Environment name="totvs.appserver" type="java.lang.String" value="AppServer://JV-CAT-TST01:5162/Datasul_12_1_33"/>
</Context>

4. Salve as alterações no arquivo e reinicie o Tomcat para que a configuração seja lida novamente por esta instância.

Como definir propriedades fixas para uma instância do Tomcat ?

Você pode especificar propriedades diferentes para cada uma das instâncias do Tomcat que você possuir, para que isso possa acontecer, em cada instância você terá que alterar o arquivo conf\context.xml especificando as propriedades desejadas.

Utilizaremos como exemplo uma holding que possui três servidores de licenças e vamos apontar para três instâncias do Tomcat, conforme abaixo:

1. Através do Explorador de Arquivos, acesse o diretório onde encontra-se instalado a instância 1 do Tomcat e edite o arquivo conf\context.xml
2. Neste arquivo localize a tag Context e insira ou edite a tag de acordo com o exemplo abaixo:

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_EMP_1" type="java.lang.String" />

<Environment name="totvs.license.server" value="LSServer1" type="java.lang.String" />
<Environment name="totvs.license.port" value="5555" type="java.lang.String" />

3. Edite agora o arquivo conf\context.xml da instância 2 do Tomcat;
4. Neste arquivo localize a tag Context e insira ou edite a tag de acordo com o exemplo abaixo:

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_EMP_2" type="java.lang.String" />

<Environment name="totvs.license.server" value="LSServer2" type="java.lang.String" />
<Environment name="totvs.license.port" value="5555" type="java.lang.String" />

5. Edite o arquivo conf\context.xml da instância 3 do Tomcat;
6. Neste arquivo localize a tag Context e insira ou edite a tag de acordo com o exemplo abaixo:

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_EMP_3" type="java.lang.String" />

<Environment name="totvs.license.server" value="LSServer3" type="java.lang.String" />
<Environment name="totvs.license.port" value="5555" type="java.lang.String" />

No exemplo acima, configuramos três instâncias do Tomcat, onde cada uma está apontando para um AppServer e Servidor de Licenças diferentes.

04. TOTVS CORS Valve

Quando o produto não permitir realizar requisições para servidores diferentes, e esses bloqueios ocorram por causa de erros de CORS, será necessário seguir os seguintes passos para solucionar o problema:

• Acessar o diretório do Tomcat, dentro da pasta conf e editar o arquivo server.xml (caminho completo tomcat\conf\server.xml):
• Adicionar as linhas abaixo como elemento filho da tag <Host ...>:

<Valve className="com.totvs.valve.TotvsCorsValve"
            allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion,x-totvs-appcode"
            contextsToValidate="/totvs-login,/totvs-rest,/dts,/api,/webexecbo"
            allowOrigin="*"
            allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
            allowCredential="true" />

• Adicionar o arquivo totvs-valve-1.0.jar no diretório "lib", relacionada à instância do Apache Tomcat.

05. BIRT

06. Propriedades

Uma vez que os bancos de dados, AppServer e Tomcat  foram carregados, você conseguirá realizar o seu primeiro acesso ao produto utilizando o usuário super com a senha super, onde a senha deverá ser alterada mais adiante.

Acessando o produto, você conseguirá configurar o produto através das Propriedades do Produto, conforme abaixo:

https://tdn.totvs.com/pages/viewpage.action?pageId=519208539
Requisitos: https://tdn.totvs.com/pages/viewpageattachments.action?pageId=519208539&preview=/519208539/519705220/Piloto%20D4THF.pdf
Instalação: https://www.youtube.com/watch?v=kOZB0XnDyTw
Update JBOSS para THF: https://www.youtube.com/watch?v=IK1tFY-TZpM
Valve: https://tdn.totvs.com/display/LDT/TOTVS+CORS+Valve
BIRT: https://tdn.totvs.com/pages/viewpage.action?pageId=507017154