Agente de Atualização e Licenciamento

CONTEÚDO

01. VISÃO GERAL

O Agente de Atualização e Licenciamento automatiza o processo de download de novas versões, verificando se há novos pacotes de atualização disponíveis e o processo de renovação automática de licenças.

O serviço de atualização verifica por meio do CNPJ e de acordo com a última versão do cliente, se há novos pacotes de atualização disponíveis.

O serviço de licenciamento verifica de tempos em tempos se há uma nova licença disponível e faz a substituição automaticamente na base a qual o agente está configurado. ¹

O Agente de Atualização e Licenciamento possui controle de perda de conexão, reiniciando o download do ponto em que parou e baixa os arquivos simultaneamente.

02. DISPONIBILIZAÇÃO DE PACOTES

ERP linha Consinco

Os pacotes de atualização ficam disponíveis no seu Agente de Atualização assim que são disponibilizados pelo nosso processo de expedição, com cadência semanal.

ERP linha RMS

Os pacotes de atualização ficam disponíveis na Central de Downloads TOTVS assim que são disponibilizados pelo nosso processo de expedição, com cadência semanal.

03. DOWNLOAD DA FERRAMENTA

Faça o download do instalador na Central de Downloads e siga os passos informados durante a instalação.

A ferramenta é auto atualizável, não haverá a necessidade de atualizá-la manualmente posteriormente. 

04. PREMISSAS

• É necessário ter instalado na máquina o Oracle Client 32-bit com o arquivo tnsnames.ora configurado.
• É necessário acesso a internet (navegação HTTPS). Como a ferramenta é instalada como um Serviço Windows, é necessário certificar-se que a conta LOCAL SYSTEM consegue acesso a internet (incluindo quando há servidor proxy).
• Alguns antivírus (ex: Kaspersky, Symantec Norton) podem bloquear o download, a execução do instalador ou do próprio Agente de Atualização gerando um falso-positivo devido as características da ferramenta, portanto, caso isso ocorra, adicione o certificado digital no qual os arquivos binários são assinados nas exceções do antivírus.
• É necessário comunicação com as seguintes URL: https://download.totvs.com.br, https://deploy.consinco.com.br, https://deploy.supermercados.totvs.com.br, https://getmyip.cloudtotvs.com.br.
• O executável é assinado digitalmente pela TOTVS para garantir a segurança e a integridade da ferramenta, e o certificado pode ser consultado nas propriedades do próprio arquivo executável.
• O Agente de Atualização permite somente uma instância em execução por conexão com banco de dados.
• Recomenda-se que a ferramenta seja instalada no ambiente destinado a ser o servidor de aplicação, no qual é feito a distribuição dos executáveis e bibliotecas para as estações de trabalho.
• É recomendado que o serviço seja instalado e iniciado (“Fazer logon como”) com a conta de Administrador.
• Não é indicado a instalação do serviço em estação de trabalho desktop no qual o suporte TOTVS não tenha acesso a ferramenta ou que o acesso seja compartilhado com o usuário do ERP.
• A ferramenta deve sempre estar configurada para se conectar ao banco de dados de Produção do ERP. Não apontá-la para outros tipos de ambiente, como de Teste ou Homologação. 

05. EXEMPLO DE UTILIZAÇÃO

Após concluir a instalação, o ícone da interface gráfica do Agente de Atualização será visualizado na área de notificação do Windows e na área de trabalho. Clique no ícone para abrir o aplicativo

Ao abrir o Agente de Atualização, serão visualizados os menus ‘Atualizações’, ‘Configurações’, ‘Eventos’  e o botão ‘Checar atualização’, utilizado para checar se há novas atualizações disponíveis manualmente.

Checar atualizações

O Agente de Atualização verifica automaticamente se há novas atualizações disponíveis ao ser iniciado.

O botão ‘Checar atualização’ pode ser utilizado em situações em que há a necessidade de fazer uma verificação imediata.

Licenciamentos (linha Consinco)

Na aba licenciamentos, estará disponível a visualização das chaves de cada produto, exibindo as informações relevantes de cada uma.

O botão 'Checar licença', força o sincronismo das licenças, verificando no ambiente da Consinco se há uma nova chave disponível e, caso exista, o agente irá substituir essa chave de maneira automática.

06. RECURSOS E CONFIGURAÇÕES

Atualizações

Se houver mais de um pacote de atualização disponível, verifique e confirme qual o pacote e versão a ser baixada conforme demonstrado no exemplo abaixo.

Para realizar o download de um pacote de atualização disponível, clique com o botão direito e escolha 'Baixar atualização'

Quando o Agente de Atualização estiver realizando o download de um pacote de atualização, o status ficará como 'Pendente' e exibirá informações sobre o andamento do download.

Ao finalizar o download do pacote de atualização, o ícone do pacote em questão será atualizado e o status ficará como 'Baixado'.

Ao clicar em ‘Abrir local da atualização’, será direcionado para a pasta onde os pacotes de atualização são baixados, conforme exemplo demonstrado abaixo.

Caso seja necessário baixar novamente um pacote de atualização já baixado anteriormente, clique em 'Remover e baixar atualização'.

Para atualizar a versão, execute o procedimento para atualização de versão de acordo com pacote baixado. 

Banco de Dados

Nesta aba deverá ser informado as credencial de conexão com o banco de dados de produção do ERP.

Quando instalado no mesmo ambiente do Monitor de PDVs, essa configuração é opcional, uma vez que a ferramenta identificará automaticamente estes dados utilizando as configurações do próprio Monitor de PDVs.

Proxy

Essa configuração deve ser realizada somente quando a empresa utiliza proxy para navegação de internet. Nesse caso, informe os dados de proxy.

Eventos

Exibe as ocorrências e eventos gerados na execução do serviço do Agente de Atualização.

Status do Serviço

Quando por algum motivo o serviço do Agente de Atualização for interrompido, será exibida na tela inicial do aplicativo, uma mensagem informando tal situação e o ícone localizado na área de notificação do Windows mudará de cor (ficará vermelho) e piscará, conforme demonstrado nas imagens abaixo

Alteração nas Configurações do Serviço

Toda alteração realizada nas configurações do Agente de Atualização, como por exemplo, alteração nas informações de conexão como banco de dados já cadastrado, fará com que o serviço seja reiniciado, conforme demonstrado abaixo.

07. INSTALAÇÃO EM MODO SILENCIOSO

A aplicação pode ser inicializada em modo silencioso (sem interação humana) com passagem de parâmetros por linha de comando conforme descrito abaixo.

Exemplo de chamada

"Install TOTVS Varejo Supermercado - Agente de atualização.exe" /S /v/qn /v"DBSERVER=<bancodedados> DBUSER=<usuariobanco> DBPWD=<senhabanco>"

Códigos de Saída

A aplicação irá lançar um código de saída (exitCode) com o valor 0 caso tenha finalizado a execução com sucesso, ou valor conforme tabela abaixo caso tenha apresentado algum erro durante a execução.

 0 Success
-1 General error
-2 Invalid mode
-3 Required data not found in the Setup.iss file
-4 Not enough memory available
-5 File does not exist
-6 Cannot write to the response file
-7 Unable to write to the log file
-8 Invalid path to the InstallShield Silent response file
-9 Not a valid list type (string or number)
-10 Data type is invalid
-11 Unknown error during setup
-12 Dialogs are out of order
-51 Cannot create the specified folder
-52 Cannot access the specified file or folder
-53 Invalid option selected