Histórico da Página
Conteúdo
Índice | ||
---|---|---|
|
02. Instalação
Aviso |
---|
A instalação do 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. |
smartlink-service
title | Procedimento |
---|
Copiar arquivo compactado que está localizado no diretório do Foundation fnd/interfac/smartlink-service/smartlink-service.zip
Extrair os arquivos do arquivo compactado em um diretório de sua escolha.
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
C:/TOTVS/smart-link-client/client/application.properties
C:/TOTVS/smart-link-client/client/smartlink-service.jar
C:/TOTVS/smart-link-client/client/log
C:/TOTVS/smart-link-client/service/Windows/install.bat
C:/TOTVS/smart-link-client/service/Windows/JavaService.exe
C:/TOTVS/smart-link-client/service/Windows/uninstall.bat
C:/TOTVS/smart-link-client/service/Linux/install.sh
C:/TOTVS/smart-link-client/service/Linux/SmartLinkClient.service
C:/TOTVS/smart-link-client/service/Linux/SmartLinkClient.sh
C:/TOTVS/smart-link-client/service/Linux/start.sh
C:/TOTVS/smart-link-client/service/Linux/stop.sh
C:/TOTVS/smart-link-client/service/Linux/uninstall.sh |
Linux
title | Instalador de serviço para Linux |
---|
Para a instalação do serviço no Linux certifique-se de que os passos a seguir foram realizados:
- Definir a descrição do serviço:
- Edite o arquivo "service/Linux/SmartLinkClient.service", localizado no local onde o projeto foi extraído, e informe no atributo "Description", a descrição do serviço:
- 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.
- Configurar o arquivo application.yml
- Veja a sessão 04 deste documento.
- Editar o arquivo
"/service/Linux/install.sh" localizado onde o projeto foi extraído.
Informar na variável
PATH_SOURCE_SMART_LINK_CLIENT, localizado na linha 13, o local onde o projeto foi extraído.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
#!/bin/bash
ERRO="A instalação do Smart Link Client encontrou problema(s). Verifique o(s) aviso(s) acima."
checkCommandError(){
if [ $? -ne 0 ]; then
echo ""
echo "$ERRO"
exit 0
fi
}
PATH_SOURCE_SMART_LINK_CLIENT="local-onde-foi-extraido/smart-link-client"
PATH_SMART_LINK_CLIENT="/usr/local/smart-link-client"
checkCommandError
echo "Instalação do Smart Link Client"
echo 'Copiando SmartLinkClient.service para /etc/systemd/system'
sudo cp -p "$PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/SmartLinkClient.service" /etc/systemd/system/SmartLinkClient.service
checkCommandError
echo 'Copiando SmartLinkClient.sh para /usr/local/bin'
sudo cp -p "$PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/SmartLinkClient.sh" /usr/local/bin/SmartLinkClient.sh
checkCommandError
echo 'Concedendo permissao para execucao'
sudo chmod +x /usr/local/bin/SmartLinkClient.sh
checkCommandError
sudo mkdir "$PATH_SMART_LINK_CLIENT"
checkCommandError
sudo mkdir "$PATH_SMART_LINK_CLIENT/client"
checkCommandError
echo "Copiando $PATH_SOURCE_SMART_LINK_CLIENT/client para $PATH_SMART_LINK_CLIENT"
sudo cp -r "$PATH_SOURCE_SMART_LINK_CLIENT/client/" "$PATH_SMART_LINK_CLIENT"
checkCommandError
sudo mkdir "$PATH_SMART_LINK_CLIENT/service"
checkCommandError
echo "Copiando $PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/start.sh para $PATH_SMART_LINK_CLIENT/service"
sudo cp -r "$PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/start.sh" "$PATH_SMART_LINK_CLIENT/service"
checkCommandError
echo "Copiando $PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/stop.sh para $PATH_SMART_LINK_CLIENT/service"
sudo cp -r "$PATH_SOURCE_SMART_LINK_CLIENT/service/Linux/stop.sh" "$PATH_SMART_LINK_CLIENT/service"
checkCommandError
echo 'Habilitando SmartLinkClient ...'
sudo systemctl enable SmartLinkClient
sudo systemctl daemon-reload
echo 'Iniciando SmartLinkClient ...'
sudo systemctl start SmartLinkClient
echo 'Fim da instalacao.'
|
Instalando o serviço:
Abra um terminal e execute o arquivo
"/service/Linux/install.sh", que está localizado onde o projeto foi extraído.
- O comando ficaria como: sudo bash /"local-onde-projeto-foi-extraido"/smart-link-client/service/Linux/install.sh
- O script de instalação fará a inicialização do serviço automaticamente.
- Start e Stop manuais:
- Caso necessite interromper ou inicial o serviço manualmente.
- para iniciar o serviço, execute:
- sudo bash /usr/local/smart-link-client/service/start.sh
- para parar o serviço, execute:
sudo bash /usr/local/smart-link-client/service/stop.sh
title | Atenção |
---|
- O diretório ao qual o projeto foi extraído não é o mesmo local onde o projeto será instalado:
- A instalação do smart-link-client será em /usr/local/
- Após a instalação, o projeto extraído torna-se necessário somente para a execução do script de instalação e desinstalação, uma vez que os demais arquivos foram copiados para o destino /usr/local/smart-link-client
- A saída de logs do smart-link-client ocorrerá no diretório em que foi instalado, no caso, /usr/local/smart-link-client/client/log
Expandir | ||
---|---|---|
| ||
|
03. Configuração
Arquivo de configuração application.properties
Bloco de código | ||||
---|---|---|---|---|
| ||||
totvs.appserver=http://SERVIDOR:PORTA/apsv |
Alteração Obrigatória.
Deve ser preenchido com o nome do servidor de aplicação que atenderá as requisições.
Pode ser preenchido com informação de um servidor de aplicação já utilizado no ERP.
Bloco de código | ||||
---|---|---|---|---|
| ||||
server.port=8777 |
Alteração opcional.
A propriedade já possui um valor padrão informado no arquivo.
Porta que será utilizada para subir o serviço. Esta propriedade é opcional, e caso não exista no arquivo será assumida a porta padrão 8080.
Bloco de código | ||||
---|---|---|---|---|
| ||||
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.
Bloco de código | ||||
---|---|---|---|---|
| ||||
logging.file.max-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.
theme | RDark |
---|