Índice

       

 

Objetivo

       O objetivo deste documento é auxiliar na configuração do Smart Client RM e da atualização automática (TOTVS Update) dos servidores e do próprio Smart Client.

Introdução

        O TOTVS Update é utilizado para realizar atualizações automáticas no ambiente 3 Camadas, seja Client (Smart Client) ou Server (Host).

        Como funciona:

        O TOTVS Update atualiza automaticamente o ambiente de acordo com a versão de uma máquina específica, utilizada como "Servidor de atualização". O Servidor de atualização é uma instalação Server do RM, portanto é necessário atualizar manualmente, através de um instalador, o "Servidor de Atualização" com a versão que será replicada para outras estações.

        O "Servidor de atualização" pode ser o próprio ou um dos servidores de aplicação, ou seja, onde estará sendo executado o HOST que irá responder pelo Smart Client RM.

(informação) Ao realizar a instalação inicial no "Servidor de atualização" utilize a camada "Server".

Como configurar 

Para uma melhor estabilidade e gestão de configuração do ambiente, sugerimos que utilizem o configurador global. Mais informações podem ser acessadas clicando aqui.

        Para que o TOTVS Update funcione é necessário alterações no arquivo .Config de acordo com a camada que receberá atualizações. 



Para habilitar o serviço de atualização insira a tag <add key=“UpdateServerEnabled” value=“true”/> no arquivo RM.Host.Service.exe.Config e reinicie o serviço do HOST.

 

 

(informação) O servidor de aplicação pode ser utilizado como servidor de atualização.



Para que um ambiente Server seja atualizado é necessário inserir no arquivo RM.Host.Service.exe.Config as tags:

<add key=“UpdateServer” value=“host:porta”/> - Informe o nome da máquina e porta que o HOST do Servidor de Atualização utilizará.

<add key=“UpdateStartTime” value=“HH:mm”/> - Informe o horário que o servidor iniciará a busca por atualizações no Servidor de Atualização.

<add key=“UpdateEndTime” value= “HH:mm”/> - Horário que o servidor finalizará a busca por atualizações no Servidor de Atualização.



(informação) O servidor de aplicação também pode ser utilizado como servidor de atualização simultaneamente.

(informação) Ao encontrar atualizações disponíveis, o serviço RM.Host.Service.exe será finalizado para que as atualizações sejam realizadas. Finalizadas as atualizações o serviço será reiniciado.

(aviso) ATENÇÃO:

Caso exista(m) usuário(s) ou serviço(s) utilizando o ambiente, ele(s) serão desconectado(s)!



Para que um ambiente Client seja atualizado é necessário inserir no arquivo RM.exe.Config a tag:

<add key=“UpdateServer” value=“host:porta”/> - Informe o nome da máquina e porta que o HOST do Servidor de Atualização está utilizando.



Ao iniciar o aplicativo RM.exe será exibida a tela de atualização do sistema. Ao finalizar as atualizações o sistema será executado normalmente.

 

 

Para download do RM.exe em ambientes na Nuvem, basta acessar o link conforme exemplo abaixo;

Http://Servidor_na_nuvem:8051/wsUpdate


(informação) Composição do link: Http://<endereço do host>:porta(8051 por default)/wsUpdate;


Caso não consiga acessar o link, verifique se a porta está liberada. Para isso, execute o seguinte comando no cmd do Server:

netsh http add urlacl url=http://+:8051/ user=NetworkService



A tag <add key="UpdateLogEnable" value="true" /> pode ser habilitada nas estações que serão atualizadas. Desta forma ao executar o TOTVS Update será gerado o arquivo de log "_updatelog.txt", na pasta do RM contendo informações da atualização.

 


Para otimizar o processo de instalação/atualização através do TOTVS Update é possível definir uma pasta compartilhada na rede que será utilizada como cache dos arquivos baixados do servidor de atualização.

 Para habilitar o cache, é necessário adicionar uma nova chave no arquivo de configuração do Host (RM.Host.Service.exe.config).

 <add key=“UpdateCachePath” value=“\\SERVIDOR\PASTA”/>

Quando esta opção é ativada, o cliente irá primeiro verificar se o arquivo a ser atualização já foi baixado por outro cliente e em seguida fará a cópia do mesmo a partir desta pasta da rede.

Para o correto funcionamento, todos os clientes deverão ter acesso de escrita e leitura nesta pasta compartilhada.

Caso o arquivo não tenha sido baixado, o primeiro cliente que fizer o download do servidor irá fazer a atualização do arquivo na pasta de cache para que outros clientes que forem fazer a atualização busquem o arquivo nesta pasta.

  • Caso o cliente não tenha acesso a esta pasta, o arquivo será baixado do servidor normalmente.
  • A atualização do client, só será executada caso o serviço de host do servidor de atualização esteja ativo, independente de existir ou não arquivos de atulização no diretório compartilhado.





O TOTVS Update atualizará os ambientes de acordo com a versão instalada/utilizada no Servidor de atualização.

 

(ideia) DICA:

Para melhor desempenho, quando ativo o serviço do Totvs Update, recomendamos habilitar a tag <add key="EnableCompression" value="true" /> em todas as estações envolvidas no processo de atualização.


Saiba como configurar o Totvs Update para acesso local e remoto. Clique aqui.




Produto: Framework


Versão: 12.1.18 ou superiores


Processo: Smart Client RM e Totvs Update




Status: Finalizado


Data: 22/09/2017


Autores:

Douglas Maxwell de Oliveira

Fábio Augusto Amaral Melo Nunes

Karina Dos Santos Costa

Stella Gleyse Macedo Vilaca

Wesley Avelino De Carvalho