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).
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\installServices.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

  • Executar o script installServices.bat. Este script criará automaticamente os serviços TOTVS-SMART-LINK-CLIENT e TOTVS-DATA-SYNC-SERVICE. 
  • Serão solicitadas duas informações:
    • Informe o caminho do instalador do servico: C:\TOTVS
Informe a URL do appserver: http://SERVIDOR:PORTA/apsv

Apresentação dos serviços no Windows:


  • Por padrão temos o nome do serviço definido como "TOTVS-DATA-SYNC-SERVICE" e o nome de apresentação TOTVS | DATA SYNC SERVICE
  • Deve ser utilizado JAVA 11, definindo o caminho na variável de ambiente JAVA_HOME

Por padrão, o instalador criará os serviços nas seguintes portas:

  • SMART LINK CLIENT: 8777
  • DATA SYNC SERVICE: 8895

Caso as portas já estejam em utilização por outro serviço, é possível alterar através do Editor de Registros do Windows (regedit).

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

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

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

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

    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" e o nome de apresentação TOTVS | DATA SYNC SERVICE
  • 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:

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

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

      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

    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.

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)

Caso ocorra erro ao iniciar o serviço, é possível que a variável de ambiente JAVA_HOME esteja incorreta ou não exista. Neste caso, siga as orientações contidas nesta documentação: Serviço não inicia após instalação.