Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO


Configurações

  1. AppServer
  2. Java
  3. Tomcat
  4. TOTVS CORS Valve
  5. Primeiro Acesso
  6. Propriedades
    1. Como acessar
    2. Lista de propriedades disponíveis
    3. Agrupador de propriedades
    4. Propriedades Acesso
    5. Propriedades Atalhos de Execução
    6. Propriedades Central de Ajuda
    7. Propriedades de Ambiente
    8. Propriedades de E-MAIL
    9. Propriedades EAI
    10. Propriedades Fluig
    11. Propriedades Gerais
    12. Propriedades Integrações TOTVS
    13. Propriedades Jornalização
    14. Propriedades JWT
    15. Propriedades de licença
    16. Propriedades Menu
    17. Propriedades Relatórios
    18. Propriedades RPW
    19. 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ávelConteú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ávelConteúdo de exemplo

JAVA_HOME

c:\dlc117\jreCLASSPATH;%JAVA_HOME%\bin;%JAVA_HOME%\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

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.


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

...

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



b. Lista de Propriedades do Sistema

4. Dentro das Propriedades do Sistema, temos os seguintes agrupamentos de Propriedades:

...

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

...

Propriedades de Ambiente

...

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

...

Propriedades E-mail

...

  • 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

...

Propriedades Jornalização

...

Propriedades Jwt

...

Propriedades Licença

...

Propriedades Menu

...

Propriedades Relatórios

...

Propriedades RPW

...

Propriedades Segurança

...

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
titleIMPORTANTE

As propriedades que forem especificadas nas telas de Propriedades Do Sistema serão 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 prioridades propriedades cadastradas em banco.



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

image2021-1-27_15-30-55.pngImage 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 RPW


r. Propriedades de Segurança

Para acessar a documentação das propriedades de segurança, clique no link Propriedades de Segurançahttps://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