CONTEÚDO

Configurações

AppServer
Java
Tomcat
TOTVS CORS Valve
BIRT
Primeiro Acesso
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:

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_11-1-26.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_9-7-5.png

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.

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_9-10-53.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_10-36-9.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_10-57-22.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_10-58-33.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_15-5-0.png

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

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-11_15-6-12.png

Adicionar as seguintes variáveis de ambiente no servidor:

Variável	Conteúdo de exemplo
JAVA_HOME	c:\Program Files\Java\jdk-11.0.2
CLASSPATH	;%JAVA_HOME%\bin;%JAVA_HOME%\lib;%JAVA_HOME%\jre\lib

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

Variável	Conteúdo de exemplo
JAVA_HOME	c:\dlc117\jre
CLASSPATH	;%JAVA_HOME%\bin;%JAVA_HOME%\lib

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" />

Caso seja necessário restringir o acesso de acordo com o servidor de origem, o mesmo deve ser informado no atributo allowOrigin no formato "<protocolo>://<servidor>:<porta>".

Ex: allowOrigin="http://localhost:8080"

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

IMPORTANTE!

A tag "Valve" deve estar configurada como o último elemento da tag "Host". Caso exista algum "Header" da request diferente dos informados anteriormente (allowHeaders), estes devem ser incluídos nessa tag.

05. BIRT

Nas propriedades de Relatórios, você deverá especificar o diretório onde está o engine do BIRT e também o diretório aonde ficam armazenados os templates de relatório, conforme o exemplo abaixo:

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-17_14-13-58.png

06. Primeiro Acesso

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 esta senha deverá ser alterada mais adiante.

07. Propriedades

Algumas funcionalidades do sistema possuem a característica de permitirem ter vários comportamentos ou formas de execução, conforme a necessidade de uso. Para sinalizar quais serão os comportamentos e quais serão as formas de execução existem as Propriedades do Sistema. Existem várias propriedades no sistema que podem ser configuradas, e todas estão agrupadas em um único programa, o de Propriedades do Sistema (pesquisando pelo menu: propriedades), que pode ser acessado pela barra de ferramentas do menu, Configurações -> Propriedades do Sistema. O programa de Propriedades do Sistema está dividido por grupos de afinidades, dividindo as propriedades por assuntos.

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

1. Faça o login no produto:

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-17_9-51-0.png

2. Uma vez logado, clique no ícone Configurações:

Linha Datasul > 2. Como configurar o ambiente Datasul ? > image2021-11-17_9-53-34.png

3. Será apresentado a janela abaixo onde você acessará Propriedades Do Sistema:

4. Dentro das Propriedades do Sistema, temos os seguintes propriedades que podem ser acessadas:

Propriedades Acesso

São propriedades que definem como será o acesso ao produto.

Login automático
Fluig Identity
LDAP

Propriedades Atalhos de Execução

São propriedades que definem os atalhos de execução (Datasul Interactive - DI).

Propriedades E-mail

São propriedades que definem o servidor de e-mail que será utilizado.

Autenticação
Remetente Padrão
Envio de Email. É o local que podemos testar se as configurações fornecidas estão adequadas para o envio de e-mail.

Propriedades EAI

São propriedades que definem a integração utilizando o EAI.

Inicialização
Leitura da fila do EAI
Notificações do EAI

Propriedades Fluig

São propriedades que definem a integração com o Fluig ECM.

Configuração
Usuário Integrador

Propriedades Gerais

São propriedades que definem as configurações gerais do produto.

API Manager
Central de Documentos
Impressão
Mapas
RFI
Web Service
Snowden
Configuração Servidor
Datasul Interactive

Propriedades Integrações TOTVS

São propriedades para configuração e gerenciamento das Integrações Totvs.

Totvs Rac,
Totvs Apps,
Totvs Reports
Carol

Propriedades Jornalização

São propriedades para configuração dos parâmetros de Jornalização (Journaling) para controle de integração de dados do produto Datsul com o serviço Totvs Apps.

Propriedades JWT

São propriedades para configuração e gerenciamento do JWT.

Propriedades Licença

São propriedades que definem como será o consumo de licença.

Tipo de ambiente
Conexão
Aplicar arquivo emergencial

Propriedades Menu

São propriedades que definem os comportamentos do menu do produto.

Propriedades Relatórios

São propriedades que definem informações dos relatórios - BIRT.

Gerais
Serviços

Propriedades RPW

São propriedades que definem o comportamento do RPW.

Propriedades Segurança

São propriedades que definem a parte de segurança de acesso ao produto e de sessão.

Recuperação de senha
Segurança avançada
Senha expirada
Segurança de sessão
Controle de Sessões
Timeout

As propriedades que forem especificadas nas telas de Propriedades Do Sistema e que são gravadas em banco de dados são sobrescritas pelas propriedades que forem informadas no arquivo conf\context.xml.

As propriedades no arquivo context.xml possuem prioridade sobre as propridades cadastradas em banco.

5. A tela de propriedades possui um filtro que permite acessar mais facilmente as propriedades desejadas, conforme o exemplo abaixo:

Agrupador de Propriedades

Temos um conceito de agrupador de propriedades, onde podemos utilizar o mesmo banco de dados para várias instâncias do Tomcat ou ambientes de teste, homologação e desenvolvimento. Esse agrupador por padrão vem com o valor default e para cada instância diferente poderemos especificar um agrupador por instância.

Abaixo temos algumas características em utilizar um agrupador de propriedades:

Ganho de escalabilidade, onde podemos tem mais de um Tomcat trabalhando ao mesmo tempo apontando para os mesmos bancos;
Podemos ter propriedades especificas para cada Tomcat
Quando não for especificado uma propriedade especifica, será assumido o valor da propriedade default

Abaixo temos um exemplo de utilização de agrupadores e propriedades especificas para varias instancias do tomcat que estão rodando:

Em um balanceamento de carga com o Apache, podemos ter vários Tomcats com portas diferentes apontando para os mesmos bancos de dados.
Nas Propriedades Gerais, existem algumas propriedades onde você especifica o endereco IP (Web) interno e externo, se possuírmos várias instâncias do Tomcat, teremos que especificar em cada instância o respectivo agrupador e o endereco IP (Web) interno e externo
Veja como ficou isso nas configuracoes dentro do arquivo conf\context.xml, conforme abaixo:
- Abaixo temos o tomcat1, tomcat2 e tomcat3, onde todos eles apontam para a mesma maquina, mas com portas diferentes.

Tomcat 1

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_prod" type="java.lang.String" />
<Environment name="totvs.envprop.group" value="tomcat1" type="java.lang.String" />
<Environment name="totvs.config.server.host" value="JV-CAT-TST01" type="java.lang.String" />
<Environment name="totvs.config.server.webport" value="8080" type="java.lang.String" />

Tomcat 2

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_prod" type="java.lang.String" />
<Environment name="totvs.envprop.group" value="tomcat2" type="java.lang.String" />
<Environment name="totvs.config.server.host" value="JV-CAT-TST01" type="java.lang.String" />
<Environment name="totvs.config.server.webport" value="8180" type="java.lang.String" />

Tomcat 3

<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_12133_prod" type="java.lang.String" />
<Environment name="totvs.envprop.group" value="tomcat3" type="java.lang.String" />
<Environment name="totvs.config.server.host" value="JV-CAT-TST01" type="java.lang.String" />
<Environment name="totvs.config.server.webport" value="8280" type="java.lang.String" />

Podemos utilizar esse mesmo conceito para a montagem de ambientes de testes, desenvolvimento e homologação, onde podemos ter alguns tomcats apontando para os mesmos bancos de testes.

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