Linha Datasul

Árvore de páginas

Conteúdo



01. Pré-requisitos


Java 11.

Datasul 12.1.2403 ou superior.

01- Datasul - Configurando credenciais TOTVS Apps

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

A instalação do smartlink-service deve ser única por instância do ERP.

Caso exista mais de um serviço apontando para um broker appserver que esteja conectado ao mesmo banco EMSFND poderão ocorrer divergências inesperadas.


02. Instalação

smartlink-service

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



Windows

  • Abrir Prompt de Comando como administrador na pasta \"local-onde-projeto-foi-extraido"\smartlink-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\smartlink-service\ TOTVS-SMART-LINK-CLIENT 8777


  • Por padrão temos o nome do serviço definido como "TOTVS-SMART-LINK-CLIENT"
  • 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"\smartlink-service\service\Windows\

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

      Exemplo
      .\start.bat TOTVS-SMART-LINK-CLIENT

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

      Exemplo
      .\stop.bat TOTVS-SMART-LINK-CLIENT
  • Abrir Prompt de Comando como administrador na pasta \"local-onde-projeto-foi-extraido"\smartlink-service\service\Windows\

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

    .\uninstall.bat TOTVS-SMART-LINK-CLIENT


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"\smartlink-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/smart-link-client/ 'TOTVS-SMART-LINK-CLIENT' 8777
  • 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-SMART-LINK-CLIENT"
  • 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"/smart-link-client/service/Linux/

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

      Exemplo
      sudo bash start.sh 'TOTVS-SMART-LINK-CLIENT'

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

      Exemplo
      sudo bash stop.sh 'TOTVS-SMART-LINK-CLIENT'

  • Abrir terminal no diretório /"local-onde-projeto-foi-extraido"/smart-link-client/service/Linux/

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

    Exemplo
    sudo bash uninstall.sh 'TOTVS-SMART-LINK-CLIENT'

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.

logging.file.name=log/smartlink-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 smartlink-service. Exemplo: C:\totvs\smartlink-service.

logging.logback.rollingpolicy.max-file-size=100MB

Alteração opcional.

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

Limite de tamanho de cada arquivo de log, após alcançar o limite é criado um novo arquivo. Arquivos de logs anteriores são mantidos no diretório.


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
INFO 19980 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8777 (http)
INFO 19980 --- [main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
INFO 19980 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
INFO 19980 --- [main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 2435 ms
INFO 19980 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8777 (http) with context path ''
INFO 19980 --- [scheduling-1] com.totvs.link.client.Waiter     : Running...
INFO 19980 --- [main] c.t.f.d.s.s.SmartLinkServiceApplication  : Started SmartLinkServiceApplication in 6.464 seconds (JVM running for 10.737)
INFO 19980 --- [grpc-default-executor-0] com.totvs.link.client.LinkService: Server is ON
INFO 19980 --- [grpc-default-executor-0] com.totvs.link.client.LinkService: Server completed
INFO 19980 --- [grpc-default-executor-0] com.totvs.link.client.LinkService: Client setup
INFO 19980 --- [grpc-default-executor-2] com.totvs.link.client.LinkService: Client setup result: true
INFO 19980 --- [grpc-default-executor-2] com.totvs.link.client.LinkService: Wait for messages
INFO 19980 --- [grpc-default-executor-1] com.totvs.link.client.LinkService: Client setup completed
INFO 19980 --- [grpc-default-executor-0] com.totvs.link.client.LinkService: Wait for messages