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 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
    5. Propriedades RPW
    6. Propriedades Relatórios
      1. Gerais
      2. Serviços - BIRT
    7. Propriedades Menu
    8. Propriedades de licença
    9. Propriedades JWT
    10. Propriedades Jornalização
    11. Propriedades Integrações TOTVS
      1. TOTVS Apps
      2. TOTVS Reports
      3. TOTVS Assinatura
    12. Propriedades Gerais
      1. API Manager
      2. Central de Documentos
      3. Office
      4. Impressão
      5. Mapas
      6. RFI
      7. Snowden
      8. Configuração Servidor
      9. Datasul Interactive
      10. Mashup
      11. WebService
    13. Propriedades Fluig
      1. Configuração
      2. Usuário Integrador


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:

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:  - será que temos que fazer essa configuração na maquina client? Pois em algum momento no DI podem ser chamadas rotinas que utilizam .jar ????????????????????????????????????????????????????????

VariávelConteú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, 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:

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

Onde temos no exemplo:


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:

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


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:


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.


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.


Propriedades EAI


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


Propriedades Fluig


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


Propriedades Gerais


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


Propriedades Integrações TOTVS


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


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.


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.


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.


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:

image2021-1-27_15-30-55.png


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:

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

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 vários tomcats apontando para os mesmos bancos de dados de testes.


d. Propriedades de Segurança

i. Senha - Recuperação de Senha

Em Senha → Recuperação de senha, conseguimos habilitar ou desabilitar o recurso de "Esqueci minha senha".


ii. Senha - Segurança Avançada

Em Senha → Segurança Avançada, podemos especificar várias regras para o tratamento das senhas utilizadas no login do usuário, como:


iii. Senha - Senha Expirada

Em Senha → Senha Expirada, podemos especificar se caso a senha do usuário tenha expirado, se bloquearemos o login desse usuário ou permitiremos que ele efetue a troca de senha.

iv. Sessão - Segurança de Sessão

Na Sessão → Segurança de Sessão, podemos bloquear as execuções de programas Progress que não estão cadastrados.

Também podemos habilitar ou desabilitar se na tela de login deverá ou não sugerir o último usuário logado.


v. Sessão - Controle de Sessões

Na Sessão → Controle de Sessões , podemos habilitar ou desabilitar o controle das sessões.

Também podemos especificar o número máximo de sessões permitidas por usuário, o intervalo de verificação da situação dessas sessões e o grupo de segurança de exceção.


vi. Sessão - Timeout

Na Sessão → Timeout, temos o processo de timeout do Datasul que consiste no controle da última interação do usuário com o produto, onde, após o tempo configurado será apresentado ao usuário uma mensagem informando que a sessão expirará. Com isso ele terá tempo para tomar sua decisão: clicar na janela para continuar o seu trabalho ou deixar a sessão expirar. O funcionamento do timeout é em conjunto entre a sessão Web (menu HTML) e sessão cliente Progress, onde o controle é realizado por meio da sessão Web. Enquanto o usuário interagir com o produto, será mantida sua sessão, a partir do momento que o usuário parar de interagir no menu HTML ou na sessão client Progress, o timeout ocorrerá após determinada quantidade de minutos de inatividade (de acordo com a configuração).

Nesta tela você tem que especificar o tempo de Timeout (em minutos) e o tempo que a mensagem de aviso de timeout deverá ser apresentada. Temos também o grupo de exceção do Timeout, onde deverão ser especificados quais grupos de segurança não serão afetados pelo timeout.


Caso você queira desligar o timeout, você deverá especificar o valor 0 (Zero) minutos no Timeout.



e. Propriedades RPW

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



f. Propriedades Relatórios

Nas propriedades de Relatórios, temos em Gerais, a possibilidade de habilitar ou desabilitar a Exportação para Planilha, onde caso esteja habilitado, também poderemos informar um grupo de segurança que será a restrição de exportação para PDF


Temos também Serviços, onde especificamos em que diretório está o engine do BIRT e também o diretório dos templates de relatório utilizados pelo produto.



g. Propriedades Menu

Nas propriedades Menu, temos as seguintes propriedades:


h. Propriedades de Licença

Nas propriedades de LicençaMenu, temos as seguintes propriedades:


O arquivo de liberação emergencial permitirá a utilização temporária do sistema. Para obtê-lo acesse:  https://totvscst.zendesk.com/hc/pt-br/#home

Ao clicar na opção Aplicar arquivo emergencial, irá aparecer a seguinte tela:


Onde poderemos selecionar um arquivo de liberação emergencial do license server, desabilitando temporáriamente o consumo de licença até que o servidor do LS esteja disponível novamente.

Para a geração desse arquivo de liberação emergencial, devemos utilizar a opção de Exportar empresas, onde pode ser selecionado uma ou mais empresas para a criação desse arquivo de liberação emergencial.


i. Propriedades JWT

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


j. Propriedades Jornalização

Nas propriedades Jornalização, podemos especificar as seguintes propriedades:


k. Propriedades Integrações TOTVS

Nas propriedades de Integrações TOTVS, podemos especificar as seguintes integrações:

i. TOTVS Apps


ii. TOTVS Reports


iii. TOTVS Assinatura



l. Propriedades Gerais

Nas propriedades Gerais, podemos especificar as seguintes configurações:

i. API Manager

Aqui devemos especificar qual o caminho para o certificado de acesso à API Manager


ii. Central de Documentos

Aqui devemos especificar qual o diretório de repositório de documentos, onde todos os documentos que foram enviados para a central de documentos ficarão armazenados.


iii. Office

Nas Propriedades gerais - Office, temos a possibilidade de utilizar ou não o Apache POI, que é um substituto para geração de planilhas e documentos do Office, sem que o Office esteja instalado.


iv. Impressão

Nas Propriedades gerais - Impressão, temos o Histórico de impressão, onde podemos especificar se o histórico de todas as impressões deverá ser ativado ou desativado.


v. Mapas

Nas Propriedades gerais - Mapas, temos os recursos de geolocalização, podemos especificar as seguintes informacoes:


vi. RFI

Nas Propriedades gerais - RFI, podemos especificar as seguintes informações:


vii. Snowden

Nas Propriedades Gerais - Snowden, podemos especificar as seguintes informações:


viii. Configuração Servidor

Nas Propriedades gerais - Configuração Servidor, podemos especificar as seguintes informações:

ix. Datasul Interactive

x. Mashup


xi. WebService

Permite login WebService, podemos ativar ou desativar o login no WebSerivce



m. Propriedades Fluig

i. Configuração


ii. Usuário Integrador











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