Histórico da Página
...
- UseCompression: Ativa ou desativa a compactação de resposta. Ativado pode reduzir o tamanho da resposta e aumentar capacidade de performance do serviço.
- Logging: Propriedades de registro de Log padrão do .Net, Veja mais informações:
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/logging/?view=aspnetcore-6.0
https://learn.microsoft.com/en-us/aspnet/core/fundamentals/logging/?view=aspnetcore-6.0#llvl - AllowedHosts: Configuração de uma lista de Host permitidos para acessar o Totvs Update. Lista separada por ponto e vírgula de nomes de host sem número de porta.
- UseSwagger: Ativa ou desativa a página de documentação de APIs, http://localhost:5000/swagger
- Update
- BasePath: É o caminho para a pasta base do RM, de onde os arquivos de atualização serão obtidos.
Este é o local principal onde deverá ter a versão mais recente do RM, que será utilizada como base de atualização. - CacheEnabled: Ativa ou desativa o gerenciamento de cache do serviço de atualização. Ativado poderá reduzir a quantidade de leitura em disco e reduzir o tempo total de atualização.
- BasePath: É o caminho para a pasta base do RM, de onde os arquivos de atualização serão obtidos.
- Kestrel.Endpoints
- Http
- Url: Configuração de endereço do Servidor de Atualização e porta http, não seguro. Como padrão, 5000 (http).
- Https
- Url: Configuração de endereço do Servidor de Atualização e porta https, seguro. Padrão, 5001 (https).
- Http
...
...
Ao executar "RM.UpdateManager.Runtime.exe" serão utilizadas as portas configuradas (os padrões são 5000 para http e 5001 para https).
Estas portas, assim como a url, podem ser alteradas no arquivo de configuração, conforme a seção Arquivo de configuração.
Quando o aplicativo executar será exibido um console, informando o nome do host configurado e exposto, como o exemplo abaixo:
Configurando o RM.exe.Config
...
Essa configuração pode ser feita diretamente no RM.exe.config do Host "Servidor de Atualização", assim, na próxima atualização automática o arquivo *.config será atualizado e as máquinas clientes já passarão a utilizar o novo endereço.
Utilizando como aplicativo
Âncora | ||||
---|---|---|---|---|
|
...
Ao executar "RM.UpdateManager.Runtime.exe" serão utilizadas as portas configuradas (os padrões são 5000 para http e 5001 para https).
Estas portas, assim como a url, podem ser alteradas no arquivo de configuração, conforme a seção Arquivo de configuração.
Quando o aplicativo executar será exibido um console, informando o nome do host configurado e exposto, como o exemplo abaixo:
Utilizando como serviço
Âncora | ||||
---|---|---|---|---|
|
...
O servidor de atualização utilizando o novo TOTVS Update pode ser utilizado em um sistema operacional Windows ou Linux, e as etapas serão diferentes para veja abaixo como configurar cada um.
Serviço no Windows
...
Para subir o TOTVS Update como serviço no Windows, basta criar um serviço que aponta para o
...
executável RM.UpdateManager.Runtime.exe.
...
Exemplo de comando que pode ser utilizado
...
:
Bloco de código | ||
---|---|---|
| ||
sc.exe create TotvsUpdateService binPath="C:\TOTVS\RM.NET\rm-update\RM.UpdateManager.Runtime.exe" |
...
Com o serviço criado, e as configurações corretas, basta iniciar o serviço:
Nota |
---|
Para que o serviço funcione corretamente, é necessário que o usuário do serviço possua permissões necessárias de acesso a disco, e caso seja utilizado o protocolo HTTPS, também tenha acesso ao certificado instalado na máquina. Caso contrário, o serviço não irá subir corretamente. |
Serviço no Linux
...
Para subir o TOTVS Update como serviço no Linux, é necessário que as dependências do .NET Core 6.0 estejam instaladas na máquina.
O passo a passo abaixo tem como objetivo instalar essas dependências; no entanto, como as distribuições de Linux são muitas, mudanças podem ocorrer.
Expandir | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
|
Com as dependências instaladas, é necessário criar o arquivo de serviço, utilizando o comando a seguir:
Bloco de código | ||
---|---|---|
| ||
sudo nano /etc/systemd/system/updatemanager.service |
Neste arquivo criado, insira o conteúdo a seguir, modificando os parâmetros do serviço, especificamente o WorkingDirectory (diretório que contém o RM.UpdateManager.Runtime) e o ExecStart (caminho absoluto para o arquivo RM.UpdateManager.Runtime):
Nota |
---|
Pela diretiva do Linux, não é recomendado que arquivo de serviço fique em uma pasta a partir do diretório /home, pois em muitas distribuições tal caminho não é permitido para a utilização como serviço. |
Bloco de código | ||
---|---|---|
| ||
[Unit] Description=RM Update Service [Service] WorkingDirectory=/caminho/para/sua/pasta/publish ExecStart=/caminho/para/sua/pasta/publish/RM.UpdateManager.Runtime Restart=always RestartSec=10 KillSignal=SIGINT SyslogIdentifier=RM.UpdateManager User=www-data Environment=ASPNETCORE_ENVIRONMENT=Production Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false [Install] WantedBy=multi-user.target |
Salve o arquivo utilizando as teclas: CTRL+X, Y para confirmar, e em seguida, pressione Enter.
Habilite e Inicie o Serviço:
Bloco de código | ||
---|---|---|
| ||
sudo systemctl enable updatemanager.service sudo systemctl start updatemanager.service |
A partir deste momento, o serviço já está de pé e rodando.
Comandos para manutenção do serviço no Linux
Para verificar o status do serviço, a qualquer momento o seguinte comando pode ser utilizado:
Bloco de código | ||
---|---|---|
| ||
sudo systemctl status updatemanager.service |
E para visualizar os logs do serviço, o seguinte comando pode ser utilizado:
Bloco de código | ||
---|---|---|
| ||
sudo journalctl -fu updatemanager.service |
Para atualizar o serviço:
Bloco de código | ||
---|---|---|
| ||
sudo systemctl restart updatemanager.service |
E para parar o serviço:
Bloco de código | ||
---|---|---|
| ||
sudo systemctl stop updatemanager.service |
...