CONTEÚDO

  1. Requisitos
  2. Instalação
  3. Configurações


01. Requisitos

Abaixo apresentaremos a lista de requisitos necessários para instalar e configurar um ambiente Datasul for THF em um servidor e em uma sessão client:

Servidor


Client


02. Instalação

Para realizar a instalação do do Datasul, será necessário instalar e configurar o servidor e depois instalar e configurar em cada sessão client que for utilizado.

Abaixo mostraremos como realizar essas atividades.


Servidor

Para realizarmos a instalação do produto no servidor, teremos que instalar alguns programas conforme abaixo:

1) Instalar o Progress OpenEdge 11.7.5 ou superior com as respectivas licenças (As licenças abaixo são um exemplo para uma instalação padrão):


2) Instalar o Java 11 ou superior

Baixe e instale o Java 11 ou superior.

Link para download: https://jdk.java.net/17/

Configurar as variáveis de ambiente conforme descrito na sessão Configurações



3) Instalar o BIRT Runtime 4.6.0

Baixe e descompacte o Birt-runtime, colocando-o em um diretório que será posteriormente configurado nas propriedades do DTS4THF.

Link para download: https://download.eclipse.org/birt/downloads/drops/

Realizar as configurações necessárias conforme descrito na sessão Configurações



4) Instalar o Servidor de Licenças (LicenseServer TOTVS)

Baixe o instalador do TOTVS | License Server ou consulte o Guia de Relacionamento e Suporte.

Link para download: ftp://ftp.totvs.com.br/hlcloud/Instaladores/LicenseServerVirtual/


Ao executar o programa de instalação do License Server, será solicitado o idioma de instalação, conforme abaixo:















Após selecionar o idioma, será apresentada a tela abaixo:


Prosseguindo será exibido o EULA do software TOTVS. Estando de acordo, prossiga a instalação.


O instalador do TOTVS | License Server sugere um diretório padrão de instalação, que pode ser alterado pelo usuário sem prejuízo de uso.


Prosseguindo, são apresentadas as informações do espaço requerido para a instalação. Lembre-se que o TOTVS | License Server possui um banco de dados temporário que irá requerer mais espaço que o apresentado na instalação.


Na tela seguinte, é apresentada uma informação referente a numeração automática.


Na próxima tela serão apresentadas as portas de operação do TOTVS | License Server. As portas precisam estar disponíveis para os demais servidores da TOTVS, pois estas portas são utilizadas por eles para conexão com esta instalação.


Nesta tela temos as seguintes informações:


O TOTVS | License Server permite a instalação no mesmo hardware. Caso seja necessário, altere todas as portas nas instalações subsequentes.


Na tela seguinte terá início o processo de instalação do TOTVS | License Server, aguarde o término.


Após o termino da instalação será apresentada uma tela para a criação do atalho da interface de monitoramento do TOTVS | License Server.



Por último, será executado o Monitor do TOTVS | License Server, onde o mesmo deverá ser configurado.
Os componentes instalados do TOTVS | License Server são:


A versão atual do License Server solicita Usuário e Senha para acessar o Monitor de Licenças. O usuário inicial padrão é Admin com a senha em branco. Recomendamos alterar a senha do Admin no primeiro acesso.



5) Abrir o Console de Atualização do Datasul for THF (adicionar link):



Client



03. Configurações

Configurações do AppServer

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
















Configurações do 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:

VariávelConteúdo de exemplo

JAVA_HOME

c:\dlc117\jre
CLASSPATH;%JAVA_HOME%\bin;%JAVA_HOME%\lib


Configurações do Tomcat




Configurações do 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.




Configurações do BIRT









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/Datasul-Valve
https://tdn.totvs.com/display/LDT/TOTVS+CORS+Valve
BIRT: https://tdn.totvs.com/pages/viewpage.action?pageId=507017154