Índice

Introdução

        A partir da versão 12.1.2306, foi disponibilizado um novo serviço externo para o TOTVS Update (Servidor de Atualização) que será responsável por fazer a atualização dos ambientes Smart de forma mais rápida e isolada do RM.Host. O novo serviço conta com uma melhor gerenciamento do download dos arquivos reduzindo a leitura em disco e é capaz de suportar mais conexões que o antigo proporcionando uma atualização mais rápida e eficiente.

        A utilização do novo serviço externo não exclui a utilização do serviço antigo no RM.Host pois a instalação de um novo ambiente pelo SmartClient ainda depende dessa comunicação, mas será tratada em evoluções do novo serviço buscando a melhoria contínua.

Como configurar 

       O executável do novo serviço se encontra na pasta rm-update da instalação padrão. Ele pode ser utilizado a partir de seu executável ou como serviço. Para utilizá-lo a partir de seu executável, basta rodar o executávelrodá-lo. Ele executará o serviço utilizando 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 (appsettings.json) que também existe na pasta.

      Para que a atualização utilize o novo serviço, o endereço do "Servidor de Atualização" (a tag UpdateServer) no RM.exe.config deve ser alterado para o novo endereço: <protocolo>://<endereço-do-host>:<porta>. Exemplo: , como no exemplo abaixo:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <appSettings>
    <add key="JobServer3Camadas" value="false" />
    <add key="Port" value="8050" />
    <add key="Host" value="localhost" />
    <add key="ActionsPath" value="C:\RM\Atual\Release\Bin;C:\RM\Atual\Release\Corpore.Net\Bin" />
    <add key="LibPath" value="C:\RM\Atual\Release\Bin" />
	<add key="UpdateServer" value="http://

localhost:5001" />
  </appSettings>
  <runtime>
    <generatePublisherEvidence enabled="false" />
    <loadFromRemoteSources enabled="false" />
  </runtime>
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" />
  </startup>
</configuration>

      Essa configuração pode ser feita diretamente no RM.exe.config do "Servidor de Atualização", assim, na próxima atualização automática o arquivo *.config será baixado e as máquinas clientes já passarão a utilizar o novo endereço.

Arquivo de configuração

Âncora
config-file config-file

Na pasta rm-update é encontrado o arquivo appsettings.json, que define as configurações da aplicação. Exemplo de arquivo:

{
  "UseCompression": "true",
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "UseSwagger": "true",
  "Update": {
    "BasePath": "C:\\RM\\Atual\\Release\\Bin",
    "CacheEnabled": "true"
  },
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:5000"
      },
      "Https": {
        "Url": "https://localhost:5001"
      }
    }
  }
}

Pontos importantes de configuração:

• BasePath: é o caminho para a pasta base do RM, de onde os arquivos de atualização serão obtidos.
• Endpoints: dentro dessa propriedade, as urls e portas para os protocolos http e https são definidas. Como padrão, as portas são definidas para 5000 (http) e 5001 (https).

Configurando como serviço

Âncora
as-service as-service

     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 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. Um exemplo de comando que pode ser utilizado para tal, está a seguir:

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:

Image Added

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. 

     Com as dependências instaladas, é necessário criar o arquivo de serviço, utilizando o comando a seguir:

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):

[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:

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:

sudo systemctl status updatemanager.service 

     E para visualizar os logs do serviço, o seguinte comando pode ser utilizado:

sudo journalctl -fu updatemanager.service 

     Para atualizar o serviço:

sudo systemctl restart updatemanager.service 

     E para parar o serviço:

sudo systemctl stop updatemanager.service