Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Graziely de Lima Rodrigues do Nascimento

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Graziely de Lima Rodrigues do Nascimento

Gravado em

Chave

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

Conteúdo

Índice
minLevel2


01. Pré-requisitos


Aviso

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

smartlinkdatasync-service

Expandir
titleProcedimento
  • 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).
Bloco de código
languagetext
themeRDark
titleExemplo
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

Expandir
titleInstalador de serviço para 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.

    Bloco de código
    languagetext
    themeRDark
    .\install.bat C:\TOTVS\datasync-service\ TOTVS-DATA-SYNC-SERVICE 8895


Expandir
titleNome do serviço
  • 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.
Expandir
titleJAVA
  • Deve ser utilizado JAVA 11, definindo o caminho na variável de ambiente JAVA_HOME
Expandir
titleStart e Stop manuais
  • 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:

      Bloco de código
      languagetext
      themeRDark
      titleExemplo
      .\start.bat TOTVS-DATA-SYNC-SERVICE

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

      Bloco de código
      languagetext
      themeRDark
      titleExemplo
      .\stop.bat TOTVS-DATA-SYNC-SERVICE
Expandir
titleDesinstalador de serviço para Windows
  • 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.

    Bloco de código
    languagetext
    themeRDark
    .\uninstall.bat TOTVS-DATA-SYNC-SERVICE


Linux

Expandir
titleInstalador de serviço para 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.

    Bloco de código
    languagetext
    themeRDark
    titleExemplo
    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.


Expandir
titleNome do serviço
  • 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.
Expandir
titleJAVA
  • Deve ser utilizado JAVA 11, definindo o caminho na variável de ambiente JAVA_HOME
Expandir
titleStart e Stop manuais
  • 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:

      Bloco de código
      languagetext
      themeRDark
      titleExemplo
      sudo bash start.sh 'TOTVS-DATA-SYNC-SERVICE'

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

      Bloco de código
      languagetext
      themeRDark
      titleExemplo
      sudo bash stop.sh 'TOTVS-DATA-SYNC-SERVICE'
Expandir
titleDesinstalador de serviço para Linux

  • 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

    Bloco de código
    languagetext
    themeRDark
    titleExemplo
    sudo bash uninstall.sh 'TOTVS-DATA-SYNC-SERVICE'

03. Configuração

Arquivo de configuração application.properties


Bloco de código
languageyml
themeRDark
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.

Bloco de código
languageyml
themeRDark
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).

Bloco de código
languageyml
themeRDark
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.

Bloco de código
themeRDark
titleLog 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