Histórico da Página
CONTEÚDO
Configurações
- AppServer
- Java
- Tomcat
- TOTVS CORS Valve
- BIRT
- Propriedades
- Primeiro Acesso
- Propriedades
- Como acessar
- Lista de propriedades disponíveis
- Agrupador de propriedades
- Propriedades Acesso
- Propriedades Atalhos de Execução
- Propriedades Central de Ajuda
- Propriedades de Ambiente
- Propriedades de E-MAIL
- Propriedades EAI
- Propriedades Fluig
- Propriedades Gerais
- Propriedades Integrações TOTVS
- Propriedades Jornalização
- Propriedades JWT
- Propriedades de licença
- Propriedades Menu
- Propriedades Relatórios
- Propriedades RPW
- Propriedades de Segurança
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
...
Informações adicionais para a configuração do Appserver Progress para o Datasul for THF:Framework - Linha Datasul - TEC - , clique no link 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
...
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?
...
...
De:
Bloco de código |
---|
tomcat.util.scan.StandardJarScanFilter.jarsToSkip=\ |
Para:
Bloco de código |
---|
tomcat.util.scan.StandardJarScanFilter.jarsToSkip=*.jar\ |
...
De:
Bloco de código |
---|
tomcat.util.scan.StandardJarScanFilter.jarsToScan=\ |
Para:
Bloco de código |
---|
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:
Bloco de código |
---|
<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.Para maiores informações de como melhorar a performance da carga do Tomcat, acesse o link Performance no processo de carga do Tomcat
Definindo o AppServer para a sua instância do Tomcat
...
Para definir qual o AppServer que o Tomcat irá utilizar, voce você terá que realizar os seguintes passos:
...
Bloco de código |
---|
<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:
...
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.
...
No exemplo acima, configuramos três instâncias do Tomcat, onde cada uma está apontando para um AppServer e Servidor de Licenças diferentes.
Maiores informações sobre essa funcionalidade, voce acará no link Sobreposição das Propriedades do Produto no Tomcat
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:
...
Bloco de código |
---|
<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="*<inserir aqui os IPs/ DNS dos servidores que se comunicam com o ERP>" 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.
Informações |
---|
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.
...
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 a esta senha deverá ser alterada mais adiante.
06. 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.
a. Como Acessar
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=507017154Sistema, conforme as imagens abaixo:
1. Faça o login no produto:
2. Uma vez logado, clique no ícone Configurações:
3. Será apresentado a janela abaixo onde você acessará Propriedades Do Sistema:
b. Lista de Propriedades do Sistema
Dentro das Propriedades do Sistema, temos as 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 de Ambiente
...
Efetua a eliminação de todas as propriedades especificas de um determinado agrupador de propriedades.
...
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
- Office - Versão BETA
- Impressão
- Mapas
- RFI
- Web Service
- Snowden
- Configuração Servidor
- Datasul Interactive
- Mashup
- WebService
...
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 Datasul 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
- Timeout
Aviso | ||
---|---|---|
| ||
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 propriedades cadastradas em banco. |
5. A tela de propriedades possui um filtro que permite acessar mais facilmente as propriedades desejadas, conforme o exemplo abaixo:
c. Agrupador de Propriedades
Temos um recurso 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 instâncias 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 endereço IP (Web) interno e externo, se possuirmos várias instâncias do Tomcat, teremos que especificar em cada instância o respectivo agrupador e o endereço IP (Web) interno e externo
- Veja como ficou isso nas configurações 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
Bloco de código |
---|
<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
Bloco de código |
---|
<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
Bloco de código |
---|
<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 vários tomcats apontando para os mesmos bancos de dados de testes.
d. Propriedades Acesso
Para acessar a documentação das propriedades de acesso, clique no link Propriedades de Acesso
Para realizar um teste se as configurações estão corretas, acesse o link Como testar as configurações do serviço de domínio para autenticação do usuários no Datasul
e. Propriedades Atalhos de Execução
Para acessar a documentação das propriedades de atalhos de execução, clique no link Propriedades Atalhos de Execução
f. Propriedades de Ambiente
Para acessar a documentação das propriedades de ambiente, clique no link Propriedades de Ambiente
g. Propriedades E-Mail
Para acessar a documentação das propriedades E-mail, clique no link Propriedades E-mail
h. Propriedades EAI
Para acessar a documentação das propriedades do EAI, clique no link Propriedades EAI
i. Propriedades Fluig
Para acessar a documentação das propriedades fluig, clique no link Propriedades Fluig
j. Propriedades Gerais
Para acessar a documentação das propriedades gerais, clique no link Propriedades Gerais
k. Propriedades Integrações TOTVS
Para acessar a documentação das propriedades de Integrações TOTVS, clique no link Propriedades Integrações Totvs
l. Propriedades Jornalização
Para acessar a documentação das propriedades de Jornalização, clique no link Propriedades de Jornalização
m. Propriedades JWT
Para acessar a documentação das propriedades JWT, clique no link Propriedades JWT
n. Propriedades de Licença
Para acessar a documentação das propriedades de licença, clique no link Propriedades de Licenças
o. Propriedades Menu
Para acessar a documentação das propriedades menu, clique no link Configurações de Menu
p. Propriedades Relatórios
Para acessar a documentação das propriedades de relatórios, clique no link Propriedades de Relatório
q. Propriedades RPW
Para acessar a documentação das propriedades RPW, clique no link Propriedades RPW
r. Propriedades de Segurança
Para acessar a documentação das propriedades de segurança, clique no link Propriedades de Segurança