Os arquivos necessários para a instalação devem ser requisitados para o time de Framework SupplyAgro MATIV da TOTVS Assis.
Instalação
Com os arquivos necessários localizados na máquina que ocorrerá a instalação é necessário descompactar o arquivo minha-borracharia-installer.zip e executar o script install.bat (como Administrador).
O script irá solicitar algumas informações, seguem abaixo instruções sobre algumas dessas configurações:
Nome do serviço Windows: informe um sufixo para o nome do serviço que será instalado. Exemplo: PRD, o serviço terá o seguinte nome: TOTVS Agro Minha Borracharia - PRD.
Porta da aplicação: informe uma porta livre, essa será a porta da aplicação para realizar as configurações necessárias.
String de conexão JDBC: URL de conexão para a aplicação se conectar com o banco de dados, exemplo:
- Postgres: jdbc:postgresql://localhost:5432/minha-borracharia-api
Usuário do banco de dados: Informe o usuário utilizado para acessar o banco de dados criado para a aplicação, exemplo:
- Postgres: postgres.
Senha do banco de dados: Informe a senha utilizada para acessar o banco de dados criado para a aplicação, exemplo:
- Postgres: postgres.
Porta do RabbitMQ: Informe a porta onde o RabbitMQ foi instalado, RabbitMQ é um software de mensageria que troca/armazena informações em formato de fila. Utilizado para envio e recebimento dos dados transacionados entre as aplicações (Manfro SK, Minha Borracharia API e TOTVS Connector Client).
Usuário, senha, porta e virtual host do RabbitMQ: Informe o usuário e senha utilizada para acessar o RabbitMQ para envio e recebimento dos dados e a porta de acesso, exemplo:
- Usuário padrão: guest.
- Senha padrão: guest.
- Porta padrão: 5672.
- Virtual host: /
Configuração Certificado SSL (https) (Opcional)
O Certificado SSL
O certificado SSL (Secure Sockets Layer) é um certificado digital utilizado para autenticar a identidade de um site, permitindo uma conexão criptografada entre o servidor web e o navegador, garantindo a privacidade e a segurança das informações.
Pressione Enter ou digite 'false' para desabilitar o certificado digital e utilizar o serviço via 'http://'.
Se optar por não informar o certificado, pressione Enter para continuar a instalação.
Durante a configuração do certificado a ser utilizado, o script solicitará algumas informações. Se optar por informar o certificado, digite 'true' e forneça o local do arquivo.
Exemplo: C:\caminho\do\arquivo\keystore.p12
.
Apelido que identifica a chave no armazenamento de chaves: Apelido que identifica a chave no keystore.
- Exemplo:
myKeyAlias
.
Senha para acessar o armazenamento de chaves: Senha para acessar o keystore (arquivo que contém as chaves e certificados).
- Exemplo:
minhaSenhaKeystore
.
Senha usada para acessar a chave no armazenamento de chaves: Senha para acessar a chave privada dentro do keystore.
- Exemplo:
minhaSenhaChavePrivada
.
Tipo do certificado: Tipo de keystore que está sendo usado (formato do arquivo).
- Exemplo:
JKS
ouPKCS12
.
Após a finalização da instalação, será criado um serviço no Windows (TOTVS Agro Minha Borracharia) e já iniciado. Caso tenha sido informado algum dado errado, basta parar o serviço e executar novamente o script install.bat.
Inicialização do serviço
Durante a inicialização do serviço, ele faz o download do aplicativo mais recente (minha-borracharia-api.jar) e o executa, para verificar se correu tudo certo com o serviço deve-se verificar o log minha-borracharia-api.wrapper.
Dica
Crie uma schedule/job que reinicie o serviço uma vez por dia, assim a cada reinicialização o software irá baixar a última versão do TOTVS Agro Minha Borracharia, logo você não irá precisar se preocupar com atualizações do software.
Acompanhamento da aplicação
Os logs do aplicativo ficarão no arquivo minha-borracharia-api.log, nele pode-se verificar se ocorreu algum erro durante a execução.