Linha Datasul

Árvore de páginas

Conteúdo



01. Pré-requisitos


Java 11.

Datasul 12.1.2407 ou superior.

01- Datasul - Configurando credenciais TOTVS Apps

02- Datasul - Configurando usuário padrão de integração Smart Link


02. Instalação

datasync-service

  • Copiar arquivo compactado que está localizado no diretório do Foundation fnd/interfac/datasync-service/datasync-service.zip
  • Extrair os arquivos em um diretório de sua escolha (No exemplo utilizamos o C:/TOTVS).
Exemplo
C:\TOTVS\datasync-service\client\application.properties
C:\TOTVS\datasync-service\client\datasync-service.jar
C:\TOTVS\datasync-service\client\log
 
C:\TOTVS\datasync-service\service\Linux\install.sh
C:\TOTVS\datasync-service\service\Linux\start.sh
C:\TOTVS\datasync-service\service\Linux\stop.sh
C:\TOTVS\datasync-service\service\Linux\uninstall.sh
 
C:\TOTVS\datasync-service\service\Windows\install.bat
C:\TOTVS\datasync-service\service\Windows\JavaService.exe
C:\TOTVS\datasync-service\service\Windows\start.bat
C:\TOTVS\datasync-service\service\Windows\stop.bat
C:\TOTVS\datasync-service\service\Windows\uninstall.bat



Windows

  • Abrir Prompt de Comando como administrador na pasta \"local-onde-projeto-foi-extraido"\datasync-service\service\Windows\

  • Executar o script install.bat passando como parâmetro o caminho completo até a pasta client, nome do serviço e porta, respectivamente.

    .\install.bat C:\TOTVS\datasync-service\ TOTVS-DATA-SYNC-SERVICE 8895


  • Por padrão temos o nome do serviço definido como "TOTVS-DATA-SYNC-SERVICE"
  • Sugerimos o uso do nome do seu tenant para complementar e facilitar a organização do serviço.
  • Deve ser utilizado JAVA 11, definindo o caminho na variável de ambiente JAVA_HOME
  • Abrir Prompt de Comando como administrador na pasta \"local-onde-projeto-foi-extraido"\datasync-service\service\Windows\

    • para iniciar o serviço, execute o script de start passando o nome do serviço:

      Exemplo
      .\start.bat TOTVS-DATA-SYNC-SERVICE

    • para encerrar o serviço, execute o script de stop passando o nome do serviço:

      Exemplo
      .\stop.bat TOTVS-DATA-SYNC-SERVICE
  • Abrir Prompt de Comando como administrador na pasta \"local-onde-projeto-foi-extraido"\datasync-service\service\Windows\

  • Executar o script uninstall.bat passando como parâmetro o nome do serviço.

    .\uninstall.bat TOTVS-DATA-SYNC-SERVICE


Linux

Para a instalação do serviço no Linux certifique-se de configurar o arquivo application.properties antes, veja a sessão 03 deste documento

  • Abrir terminal no diretório  \"local-onde-o-projeto-foi-extraido"\datasync-service\service\Linux

  • Dar permissão de iniciar serviços para o arquivo install.bat  e executa-lo passando como parâmetro o caminho completo até a pasta client, nome do serviço e porta, respectivamente.

    Exemplo
    chmod +x install.sh
sudo bash install.sh /usr/local/data-sync-service/ 'TOTVS-DATA-SYNC-SERVICE' 8895
  • O script de instalação fará a inicialização do serviço automaticamente.


  • Por padrão temos o nome do serviço definido como "TOTVS-DATA-SYNC-SERVICE"
  • Sugerimos o uso do nome do seu tenant para complementar e facilitar a organização do serviço.
  • Deve ser utilizado JAVA 11, definindo o caminho na variável de ambiente JAVA_HOME
  • Abrir terminal no diretório /"local-onde-projeto-foi-extraido"/data-sync-service/service/Linux/

    • para iniciar o serviço, execute o script de start passando o nome do serviço:

      Exemplo
      sudo bash start.sh 'TOTVS-DATA-SYNC-SERVICE'

    • para encerrar o serviço, execute o script de stop passando o nome do serviço:

      Exemplo
      sudo bash stop.sh 'TOTVS-DATA-SYNC-SERVICE'

  • Abrir terminal no diretório /"local-onde-projeto-foi-extraido"/data-sync-service/service/Linux/

  • execute o script de uninstall passando o nome do serviço

    Exemplo
    sudo bash uninstall.sh 'TOTVS-DATA-SYNC-SERVICE'

03. Configuração

Arquivo de configuração application.properties


totvs.appserver=http://SERVIDOR:PORTA/apsv

Alteração Obrigatória. 

Deve ser preenchido com o nome do servidor de aplicação Progress que atenderá as requisições.

Pode ser preenchido com informação de um servidor de aplicação Progress já utilizado no ERP.

totvs.smartlink.client=http://SERVIDOR:PORTA

Alteração Obrigatória. 

Deve ser preenchido com o nome do servidor e porta do Smart Link Client.

A porta deve ser a mesma utilizada na criação do serviço Smart Link Client (exemplo: http://localhost:8777).

logging.file.name=log/datasync-service.log

Alteração opcional.

A propriedade já possui um valor padrão informado no arquivo.

Sub-diretório de geração dos logs, com base no diretório raiz onde foi instalado o datasync-service. Exemplo: C:\totvs\datasync-service.


04. Iniciar o serviço instalado

Após concluir as etapas anteriores, basta iniciar o serviço instalado e verificar no arquivo de log se a aplicação foi iniciada com sucesso.

Log de exemplo
2024-06-17 14:21:39.975  INFO 21088 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8895 (http)
2024-06-17 14:21:39.996  INFO 21088 --- [main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2024-06-17 14:21:39.996  INFO 21088 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.54]
2024-06-17 14:21:40.071  INFO 21088 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2024-06-17 14:21:40.071  INFO 21088 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1375 ms
2024-06-17 14:21:40.768  INFO 21088 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8895 (http) with context path ''
2024-06-17 14:21:40.780  INFO 21088 --- [main] c.t.f.d.d.s.DataSyncServiceApplication   : Started DataSyncServiceApplication in 2.844 seconds (JVM running for 3.485)
s