Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleObservação
Não é possível utilizar o Smart Client ou TOTVS Update para funcionalidades ainda em Delphi.

        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.
É necessário reiniciar os serviços Host do RM no Servidor de Atualização, para que os novos arquivos sejam disponibilizados para o SmartClient receber as atualizações.

        Exemplo: TOTVS Update é utilizado para atualizações automáticas do sistema RM entre Releases (Ex.: 12.1.12 para 12.1.13) e Patchs (Ex.: 12.1.12.111 para 12.1.12.112) em ambientes 3 camadas.

...

Informações
iconfalse
Deck of Cards
idPrincipal
Card
defaulttrue
id1
labelServidor de Atualização

Para habilitar o serviço de atualização insira a tag <add key="UpdateServerEnabled" value="true"/> no arquivo RM.Host.Service.exe.Config, no caminho: C:/TOTVS/CorporeRM/RM.net e reinicie o serviço do HOST.

Ainda no servidor de atualização, é preciso inserir a tag <add key="UpdateServer" value="host:porta"/> no arquivo RM.exe.Config.

(informação) Veja o exemplo dos arquivos de configuração para este cenário: RM.Host.Service.exe.config e RM.exe.config

Informações
iconfalse

O servidor de aplicação pode ser utilizado como servidor de atualização, entretanto neste cenário, onde a maquina de app é a mesma de atualização, não se deve realizar a configuração de atualização do server com as tags abaixo no arquivo RM.Host.Service.exe.config:

<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.

Tal apontamento é desnecessário, pois a atualização desta máquina deverá ser realizada manualmente.

Card
id2
labelServer

Para que um ambiente Server seja atualizado é necessário inserir no arquivo RM.Host.Service.exe.Config, no caminho C:\totvs\CorporeRM\RM.net, 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) Veja o exemplo do arquivo de configuração para este cenário: RM.Host.Service.exe.config

Informações
iconfalse

(informação) A partir da versão 12.1.13 o instalador do sistema, oferece a opção de instalação como JobServer ou AppServer. O Servidor de atualização pode ser configurado como JOB ou APP, pois nenhuma dessas opções interferem em sua execução.

Exemplo, em um ambiente N camadas os servidores seriam JobServer, Aplicação e Atualização.

(aviso) ATENÇÃO:

Não é recomendado a utilização do Servidor de Atualização como JobServer ou AppServer. Indicamos sua exclusividade para as atualizações.



(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.
É necessário reiniciar o serviço para que os novos arquivos sejam disponibilizados para o SmartClient receber as atualizações.

(aviso) ATENÇÃO:

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

Quando o Host estiver rodando com o usuário "NETWORK SERVICE" será necessário utilizar um usuário de rede ou da máquina com privilégios necessários para gerenciar os serviços, pois o RM.Update não tem permissão suficiente para subir novamente o serviço do Host.

Expandir
titleExemplo:

:





(informação) O servidor de aplicação pode ser utilizado como servidor de atualização, entretanto neste cenário, onde a maquina de app é a mesma de atualização, não se deve realizar a configuração de atualização do server com 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á.



(informação) Quando o ambiente utilizar balanceamento nativo, com múltiplos hosts (host1, host2), as tags do Totvs Update devem ser configuradas apenas no config de um dos hosts. Exemplo: RM.Host.Service.exe.config, RM.Host.Service1.exe.config ou  RM.Host.Service2.exe.config. Não se deve realizar a configuração em todos os configs, pois não existe balanceamento para o Totvs Update.

Caso o Sistema RM já esteja instalado no Servidor de Atualização, utilize o passo a passo contido no link abaixo:

   Configuração para simular 3 camadas - JobServer

Card
id3
labelClient

Para que um ambiente Client seja atualizado é necessário inserir no arquivo RM.exe.Config, no caminho: C:\totvs\CorporeRM\RM.net, 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.


(informação)Veja o exemplo do arquivo de configuração para este cenário: RM.exe.config

Informações

Enquanto o Sistema RM estiver atualizando, o serviço RM.Host.Service.exe será finalizado. Assim todos os usuários serão desconectados do sistema.

Ao iniciar o aplicativo RM.exe será exibida a tela de verificação de atualização do sistema.

Caso haja alguma alteração de versão, release ou patch do Sistema RM no Servidor de Atualização, o sistema irá iniciar o processo de atualização e depois abrirá normalmente.

Card
idDownload do SmartClient
labelDownload do SmartClient
titleDownload do SmartClient

Para download do RM.exe (smart client), 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;

A tag UpdateServerEnabled deve estar configurada = true, caso contrário o acesso a este link será desabilitado pelo Host.


Aviso
titleAmbientes que utilizam SSL

Em ambientes que utilizam SSL o link muda para:

https://Servidor_na_nuvem:8051/wsUpdate/Index


Aviso

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

Será apresentada a tela a seguir, clique em "Aqui":

Tela de Download do Client SmartClient:

A partir da versão 12.1.2209 será apresentada a tela abaixo, nesse caso, clique em "Download":

                                 

Após fazer o download do arquivo e execute-o. Será iniciada a instalação do Sistema RM.

Instalador do SmartClient:

Informações
titleObservação
  • Caso já exista instalação do Sistema RM no computador Client ou TS, faça a desinstalação do mesmo.
  • É necessária a configuração do Servidor de Atualização (TOTVS Update) para utilizar o TOTVS SmartClient.
  • O executável baixado não deve ser renomeado, para o correto funcionamento do Smart Client.


Caso a tela abaixo seja apresentada, siga os passos a seguir:

Página de erro SmartClient

  1. Acesse os serviços do Windows(Painel de Controle/ Ferramentas Administrativas/ Serviços), clique com o botão direito sobre RM.Host.Service, depois em Propriedades.

    Serviços do Windows











2. Na aba Logon marque a caixa Conta do Sistema Local e depois clique em OK.

Propriedade do serviço RM.Host.exe

Card
id4
labelLog

A tag <add key="UpdateLogEnabled" 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.

Card
id5
labelCache de Download

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.

Informações
titleObservações
  • 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 atulaização no diretório compartilhado.
  • A tag para utilização do cache de download deve ser adicionada apenas no arquivo de configuração do host do servidor de atualização. Não é necessário adicionar a tag nos clientes.

(informação) Veja o exemplo do arquivo de configuração para este cenário: RM.Host.Service.exe.config

...

Aviso
iconfalse
titleObservação

O TOTVS Update atualizará os ambientes de acordo com a versão instalada/utilizada no Servidor de atualização.
É necessário reiniciar os serviços Host do RM no Servidor de Atualização, para que os novos arquivos sejam disponibilizados para o SmartClient receber as atualizações.


(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.

Aviso
titleImportante:

A partir da versão 12.1.31.114, o parâmetro EnableCompression localizado nos arquivos de config do RM será descontinuado.
Para mais informações a respeito do novo parâmetro, clique aqui.

Importante: Após a definição do valor ideal da tag em seu ambiente, TODOS os arquivos de configuração devem possuir o mesmo valor, evitando erros de conflito de valores (algumas tags com valor true e outras com valor false).

...