Objetivo 

O objetivo deste documento é apresentar as configurações necessárias para configuração e instalação do TOTVS Conecta Dados

1 - Instalação

1.1 - Requisitos de instalação em sistema operacional Windows:

1 - Descompacte o arquivo agro-data-client-windows.zip, de preferência no C:\

2 - Abra o CMD como adminstrador, acesse a pasta "agro-data".

3 - Digite o comando para instalar o serviço:
agro-data-client.exe install service

4 - Realize a configuração do arquivo "application.yml" conforme os requisitos de configuração que estão no tópicos 2.1, 2.2 e 2.3

5 - Digite o comando para iniciar o serviço (lembre-se de iniciar o serviço somente após tem feito a configuração do arquivo "application.yml"):
net start agro-data-client-service

1.2 - Requisitos de instalação em sistema operacional Linux:

1 - Salve o arquivo "agro-data-client-linux.jar" em /srv/agro-data/

2 - Digite:
nano /srv/agro-data/agro-data-client-start.sh

3 - Digite:
java -jar /srv/agro-data/agro-data-client-linux.jar

4 - Digite:
CTRL + O para salvar o arquivo e CTRL + X para sair.

5 - Digite:
nano /srv/agro-data/agro-data-client-stop.sh

6 - Digite:
pid=`ps aux | grep agro-data-client | awk '{print $2}'`
kill -9 $pid

7 - Digite:
CTRL + O para salvar o arquivo e CTRL + X para sair.

8 - Digite:
nano /etc/init.d/agro-data-cliente

9 - Digite:
case $1 in
start)
/bin/bash /srv/agro-data/agro-data-client-start.sh
;;
stop)
/bin/bash /srv/agro-data/agro-data-client-stop.sh
;;
restart)
/bin/bash /srv/agro-data/agro-data-client-stop.sh
/bin/bash /srv/agro-data/agro-data-client-start.sh
;;
esac
exit 0

10 - Digite:
CTRL + O para salvar o arquivo e CTRL + X para sair.

11 - Digite o seguinte comando como usuário root:
update-rc.d agro-data-client defaults

12 - Realize a configuração do arquivo "application.yml" localizado em /srv/agro-data/ conforme os requisitos de configuração que estão no tópicos 2.1, 2.2 e 2.3 (pode-se utilizar o nano como editor de texto ou algum de sua preferência)

13 - Digite 
nano /srv/agro-data/application.yml

14 - Após editar, digite:
CTRL + O para salvar o arquivo e CTRL + X para sair.

15 - Por fim, para iniciar o serviço, digite:

service agro-data-cliente start

2 - Configurações

2.1 - Requisitos de configuração do banco de dados do PIMSMC:

É necessário acessar a pasta "agro-data" localizado geralmente em C:\agro-data\ e editar o arquivo "application.yml", pode-se abrir o arquivo com um bloco de notas ou algum editor de texto de sua preferência.

Depois de feito isso edite o arquivo "application.yml" e forneça as informações destacadas com "Digite aqui".

agro-data:
url: http://agrodata-gateway.agro.totvs.io:8092/api
organization-id: Digite aqui
produto:
tipo: PIMSMC
db:
username: Digite aqui
password: Digite aqui
url: Digite aqui
type: Digite aqui


Essas informações são de conexão com o banco do PIMSMC, nesse caso, se for Oracle ou SQL Server, basta seguir o exemplo abaixo para inserir as informações nos campos "Digite aqui".

Exemplos:

agro-data:
url: http://agrodata-gateway.agro.totvs.io:8092/api
organization-id: 248042
produto:
tipo: PIMSMC
db:
username: totvs
password: totvs
url: jdbc:jtds:sqlserver://127.0.0.1:1433/APPRD_PIMS_TESTE
type: MSSQLSERVER


agro-data:
url: http://agrodata-gateway.agro.totvs.io:8092/api
organization-id: 427473
produto:
tipo: PIMSMC
db:
username: totvs
password: totvs
url: jdbc:oracle:thin:@127.0.0.1:1521:TIETE
type: ORACLE12C

2.2 - Requisitos de configuração do banco de dados do TOTVS Conecta Dados

É necessário primeiramente, criar um "database" com o nome de "AGRO-DATA" , geralmente deve ser criado no mesmo banco que esta o PIMSMC.
Depois de feito isso edite o arquivo "application.yml" e forneça as informações destacadas com "Digite aqui".

datasource:
driver-class-name: Digite aqui
url: Digite aqui
username: Digite aqui
password: Digite aqui
jpa:
database-platform: Digite aqui

O TOTVS Conecta Dados, tem suporte a 3 bancos de dados (Oracle, Postgres e SQL Server), para facilitar vou deixar aqui exemplos de como configurar cada banco, para facilitar o preenchimento das informações no "Digite aqui".


Oracle
driver-class-name: oracle.jdbc.OracleDriver
url: jdbc:oracle:thin:@127.0.0.1:1521:orcl
username: AGRO-DATA
password: teste@123
jpa:
database-platform: org.hibernate.dialect.Oracle10gDialect

SqlServer
driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
url: jdbc:sqlserver://localhost:1433;databaseName=AGRO-DATA
username: sa
password: teste@123
jpa:
database-platform: org.hibernate.dialect.SQLServer2012Dialect

Postgres
driver-class-name: org.postgresql.Driver
url: jdbc:postgresql://localhost:5432/AGRO-DATA
username: postgres
password: admin
password: teste@123
jpa:
database-platform: org.hibernate.dialect.PostgreSQLDialect

2.3 - Requisitos de configuração da API Solinfitec

solinftec:
url:
auth: https://integracao.saas-solinftec.com/auth/token
api: http://agrodata-gateway.agro.totvs.io:8092/api/solinftec/saas/v1/pull/paged/v2
login:
user: Digite aqui
password: Digite aqui
tenant: Digite aqui
id-filter: Digite aqui

Fontes

https://rodrigonunesdev.wordpress.com/2017/03/23/instalando-um-jar-como-servico-no-windows/#:~:text=Uma%20forma%20pr%C3%A1tica%20de%20colocar,(ou%20outras%20aplica%C3%A7%C3%B5es%20compat%C3%ADveis).

https://zarelli.wordpress.com/2013/06/09/linux-executar-jar-na-inicializacao-do-sistema-jar-como-servico-how-to-make-a-jar-file-run-on-startup/