AppServer
Java
Tomcat
TOTVS CORS Valve
Primeiro Acesso
Propriedades
1. Como acessar
2. Lista de propriedades disponíveis
3. Agrupador de propriedades
4. Propriedades Acesso
5. Login Automático
6. Fluig Identity
7. LDAP
8. Propriedades Atalhos de Execução
9. Propriedades Central de Ajuda
10. Propriedades de Ambiente
11. Propriedades de E-MAIL
13. Autenticação
14. Remetente Padrão
15. Enviar Email
16. Inicialização
17. Leitura da fila do EAI
18. Notificação do EAI
19. Propriedades Fluig
20. Propriedades Gerais
21. Propriedades Integrações TOTVS
22. Configuração
23. Propriedades GeraisJornalização
24. API ManagerPropriedades JWT
25. Central Propriedades de Documentoslicença
26. OfficePropriedades Menu
27. ImpressãoPropriedades Relatórios
28. Mapas
29. RFI
30. Snowden
31. Configuração Servidor
32. Datasul Interactive
33. Mashup
34. WebService
35. Propriedades Integrações TOTVS
  1. TOTVS Apps
  2. TOTVS Reports
  3. TOTVS Assinatura
36. Propriedades Jornalização
37. Propriedades JWT
38. Propriedades de licença
39. Propriedades Menu
40. Propriedades Relatórios
  1. Gerais
  2. Serviços - BIRT
41. Propriedades RPW
42. Propriedades de Segurança
  1. Senha - Recuperação de senha
  2. Senha - Segurança Avançada
  3. Senha - Senha Expirada
  4. Sessão - Segurança de Sessão
  5. Sessão - Controle de Sessão
  6. Sessão - Timeout

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:

Image Removed

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

Image Removed

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.

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

Adicionar as seguintes variáveis de ambiente no servidor:

...

JAVA_HOME

...

Adicionar as seguintes variáveis de ambiente na máquina client: - será que temos que fazer essa configuração na maquina client? Pois em algum momento no DI podem ser chamadas rotinas que utilizam .jar ????????????????????????????????????????????????????????

...

JAVA_HOME

...

03. Tomcat

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

...

1. Propriedades RPW
2. 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

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:

Image Added

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

Image Added

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.

Image Added

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

Image Added

Informações adicionais para a configuração do Appserver Progress para o Datasul for THF, 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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

03. Tomcat

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

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, você 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:

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:

Bloco de código

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

Bloco de código

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

Bloco de código

<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

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.

...

Definindo o AppServer para a sua instância do Tomcat

Para definir qual o AppServer que o Tomcat irá utilizar, você 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:

Bloco de código
<Environment name="totvs.appserver" type="java.lang.String" value=/>

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:

Bloco de código
<Environment name="totvs.appserver" value="AppServer://JV-CAT-TST01:5162/Datasul_1212133_1EMP_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.

...

Bloco de código

<?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="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" 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:

Bloco de código

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

Bloco de código

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

Bloco de código

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

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="*"
            allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
            allowCredential="true" />

Informações

title	Nota

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.

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 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 Sistema, conforme as imagens abaixo:

1. Faça o login no produto:

Image Removed

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

Image Removed

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

Image Removed

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

title	IMPORTANTE

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:

Image Removed

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

Nas propriedades de ambiente você pode eliminar as propriedades de um determinado agrupador. Esta opção serve para limpeza e/ou organização do seu ambiente.

Image Removed

g. Propriedades E-Mail

i. Autenticação

Servidor E-mail, onde deverá ser especificado a URL do servidor de email
Porta, onde deverá ser especificado qual a porta que esta sendo utilizada pelo servidor de email
Serviço de E-Mail, que pode ser: Datasul Mail Service, BLAT, Exchange
SSL, onde devemos especificar se utiliza ou não SSL
TLS, onde devemos especificar se utiliza ou não TLS
Debug, onde especificamos se utiliza ou não o modo debug, onde mensagens adicionanis aparecerão no log do produto
Usuário, onde especificamos o usuário que será autenticado no servidor de email
Senha, onde especificamos a senha do usuário que será autenticado no servidor de email

Image Removed

ii. Remetente Padrão

Remetente Padrão, aqui especificamos o remetente padrão que será utilizado caso ao tentar enviar algum email e o remetente não tenha sido especificado
Utiliza sempre este remetente, onde podemos ativar ou desativar se esse remetente será sempre utilizado

Image Removed

iii. Enviar Email

Para realizarmos testes de envio de email com as configurações atualizadas, podemos clicar no botão Teste envio de e-mail

Image Removed

Ao clicar neste botão, será aberta a seguinte tela:

Image Removed

Nesta tela poderemos confirmar se as configurações informadas estão corretas e integrando corretamente com o servidor de email.

h. Propriedades EAI

Para acessar a documentação das propriedades do EAI, clique no link Propriedades EAI

i. Propriedades Fluig

i. Configuração

Habilitar integração, onde podemos ativar ou desativar a integração com o Fluig ECM
URL Base, onde podemos infromar qual a URL de acesso ao Fluig ECM
Código da Empresa, onde podemos informar qual será o código da empresa que receberá esses arquivos dentro do Fluig ECM
Parâmetros do servidor, onde podemos informar parâmetros adicionais para acesso ao servidor do Fluig ECM

Image Removed

ii. Usuário Integrador

Usuário Integrador, onde devemos especificar um usuário que tenha acesso ao Fluig ECM
Senha, onde informamos a senha desse usuário integrador para acesso ao Fluig ECM

Image Removed

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

Nas propriedades JWT (JSON Web Token), podemos especificar as seguintes propriedades:

URL do certificado (Mingle), que é a URL de onde será retornado o certificado mingle
Alias Default, que você deverá eleger qual dos alias sera o defaul
Utilizar este Alias como default, onde podemos especificar se este alias será utilizado como padrão
Alias, onde podemos adicionar um ou mais alias para os certificados

Image Removed

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

Nas propriedades Menu, temos as seguintes propriedades:

Cor de fundo do menu, onde podemos especificar a cor de fundo da interface WEB do menu
Habilita atualização automática do menu do usuário, onde podemos realizar a atualização automática do menu do usuário, caso seja alterado algum grupo de segurança do usuário, grupo de segurança dos programas ou adicionado ou removido algum programa do menu
Habilita menu localizado, onde podemos ativar a localização do menu
Habilita alteração da logomarca da empresa, onde devemos criar um arquivo de imagem com a logomarca da empresa com o nome menu-logo-999.png (999=Código da empresa) e ele deverá ser gravado no diretório /custom/assets/img/logo-menu/
Número máximo de recentes, onde podemos especificar o número máximo de programas acessados/recentes
Modo de abertura de programas WebSpeed, onde eles podem ser abertos em forma pop-up ou em uma Nova aba do navegador.

Image Removed

p. Propriedades Relatórios

Para acessar a documentação das propriedades de relatórios, clique no link Propriedades de Relatório

q. Propriedades RPW

Nas propriedades do RPW, podemos configurar alguns comportamentos que o RPW poderá executar, como:

Habilitar Segurança RPW, onde será validado se o programa da agenda RPW possui permissão de execução ou não ??????????????????????????
Reconectar bancos, onde este conceito vem da forma que o RPW foi criado, em 1-1 ou 1-N ?????????????????????????????
Habilitar impressão em escala, caso exista um servidor de impressão para alto volume de impressão
Habilitar Agenda Automática Multi-Empresa, onde é possível criar uma agenda RPW que poderá ser utilizada em várias empresas diferentes.

/>

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:

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

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

Informações

title	Nota

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.

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 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 Sistema, conforme as imagens abaixo:

1. Faça o login no produto:

Image Added

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

Image Added

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

Image Added

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

title	IMPORTANTE

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:

Image Added

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 RPWImage Removed

r. Propriedades de Segurança

...

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 25

Nova versão Atual

Chave

Configurações

01. AppServer

02. JAVA

03. Tomcat

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

Configurações

01. AppServer

02. JAVA

03. Tomcat

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

Definindo o AppServer para a sua instância do Tomcat

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

Definindo o AppServer para a sua instância do Tomcat

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

04. TOTVS CORS Valve

IMPORTANTE!

05. Primeiro Acesso

06. Propriedades

b. Lista de Propriedades do Sistema

c. Agrupador de Propriedades

g. Propriedades E-Mail

i. Autenticação

Image Removed

ii. Remetente Padrão

iii. Enviar Email

h. Propriedades EAI

i. Propriedades Fluig

i. Configuração

ii. Usuário Integrador

j. Propriedades Gerais

k. Propriedades Integrações TOTVS

l. Propriedades Jornalização

m. Propriedades JWT

n. Propriedades de Licença

o. Propriedades Menu

p. Propriedades Relatórios

q. Propriedades RPW

04. TOTVS CORS Valve

IMPORTANTE!

05. Primeiro Acesso

06. Propriedades

b. Lista de Propriedades do Sistema

c. Agrupador de Propriedades

g. Propriedades E-Mail

h. Propriedades EAI

i. Propriedades Fluig

j. Propriedades Gerais

k. Propriedades Integrações TOTVS

l. Propriedades Jornalização

m. Propriedades JWT

n. Propriedades de Licença

o. Propriedades Menu

p. Propriedades Relatórios

q. Propriedades RPW

r. Propriedades de Segurança