Console de Atualização Logix

24/01/2019
 Console de Atualização Logix

Sumário
Sumário ................................................................................................................................................................ 1
Atualização de Software ........................................................................................................................................ 3
Instalação/Configuração da ferramenta .................................................................................................................. 4
Configurando o arquivo TOTVSAPPSERVER.INI ....................................................................................................... 7
Configurando o arquivo TOTVSDBACCESS.INI ......................................................................................................... 7
Criação do atalho para execução do console ........................................................................................................... 8
Utilizando a ferramenta ....................................................................................................................................... 10
1.1. Atualizar.................................................................................................................................................... 10
1.2. Ambiente .................................................................................................................................................. 12
1.3. Exclusão Versão......................................................................................................................................... 13
1.4. Replicar ..................................................................................................................................................... 14
1.5. Conversão ................................................................................................................................................. 15
1.6. Histórico.................................................................................................................................................... 16

2
 Console de Atualização Logix

Atualização de Software
A atualização de software é um processo de refinamento e aperfeiçoamento do produto, que visa à melhoria continua
da sua utilização e a correção das não conformidades identificadas.
Desta forma a execução e simplificação deste processo são de grande importância para manter o produto na sua forma
plena de utilização.

Pensando na simplificação e garantia do processo de atualização a TOTVS oferece a seus clientes, utilizadores do
produto Logix, a ferramenta “Console de Gerenciamento de Ambientes - Logix”, que gerencia este processo, tornando-
o padrão e uniforme, garantindo assim a confiabilidade da execução.

Utilize este manual como guia na utilização desta ferramenta, fazendo uso assim de forma plena de seus benefícios e
funcionalidades. Funcionalidades estas que podemos destacar:

Processo restrito a usuários administradores (utilizando usuário e senha do produto).

Aplicação de atualização de objetos MZP, XML (metadado) e CNV (conversor) de forma unificada.
Gravação de controle de auditoria das atualizações realizadas.
Visualização dos objetos contidos no patch / pacote de atualização.
Consulta do histórico de atualizações.
Aplicação em multi-ambientes / bancos utilizando a mesma ferramenta.

3
 Console de Atualização Logix

Instalação/Configuração da ferramenta
Foi desenvolvido um instalador para facilitar a configuração da ferramenta. Segue passo a passo das teslas
apresentadas.

4
 Console de Atualização Logix

5
 Console de Atualização Logix

Após concluir a instalação, será criado duas pastas “APPSERVER_CONSOLE” e “SMARTCLIENT_CONSOLE”

6
 Console de Atualização Logix

Configurando o arquivo TOTVSAPPSERVER.INI

O arquivo totvsappserver.ini já contém as configurações básicas para a execução do console de atualização, porem
algumas configurações são necessárias para a correta execução da aplicação.

Dentro do diretório appserver_console, edite o arquivo totvsappserver.ini e localize as sessões [logixupd] e

[logixupd_temp]. Nestas duas sessões é necessário alterar a informação da chave DBALIAS

Inclua os ambientes que serão utilizados para atualização dos pacotes. Você pode copiar essas informações
do appserver_upd

Configurando o arquivo TOTVSDBACCESS.INI

O arquivo totvsdbaccess.ini contém as conexões com o banco de dados, basta copiar o arquivo que já está configurado
na pasta appserver_upd

7
 Console de Atualização Logix

Criação do atalho para execução do console

Dentro da pasta SMARTCLIENT_CONSOLE, localize o executável totvssmartclient.exe e crie um atalho.

8
 Console de Atualização Logix

Clique no atalho criado e acesse a opção Propriedades

Inclua ao final do campo DESTINO os seguintes comandos: -m -q -p=logixconsole -c=tcp_console -e=logixupd

9
 Console de Atualização Logix

Utilizando a ferramenta
A tela do Console de Atualização é dívida em 3 sessões: Dados Conexão, Processamento e Help.

Dados Conexão – Apresenta as informações da conexão e ambientes selecionados.

Processamento – Todas as telas de processamento são apresentadas nessa sessão.
Help – Cada tela da ferramenta possui um pequeno texto de ajuda que é apresentado para o usuário afim de facilitar
o entendimento da ferramenta.

O menu da ferramenta é composto pelas seguintes opções: Atualizar, Ambiente, Exclusão Versão, Replicar, Conversão
e Histórico. Cada uma dessas opções será descrita nos próximos tópicos

1.1. Atualizar
Na opção Atualizar são apresentados todos os pacotes que estão pendentes de aplicação, estes pacotes ficam
gravados no diretório (updater/console/atualizações/)
Também é possível buscar o pacote de atualização em qualquer outro diretório, para isso clique no ícone de
“Selecionar Arquivos”.

Após escolher o pacote será realizado uma validação do ambiente afim de garantir a integridade da atualização.
Caso não ocorra nenhuma inconsistência será apresentada a próxima tela da etapa de atualização.

10
 Console de Atualização Logix

Na tela apresentada, você pode verificar qual foi o pacote selecionado e alterar os parâmetros de aplicação do
pacote.

Parâmetros de Processamento:
Aplica Fontes? – Você pode indicar se deseja ou não aplicar as atualizações dos programas contidos no mzp.
Aplica XMLs? – Nesta opção, você pode definir se o sistema irá realizar a aplicação dos XMLs.
Aplica Conversores? – Define se a aplicação dos conversores será realizada.

Definido os parâmetros de processamento, você pode Iniciar a aplicação ou Cancelar o processamento.

Todo o processamento pode ser acompanhado na guia Etapas de Processamento

11
 Console de Atualização Logix

1.2. Ambiente
Nesta opção são apresentados todos os ambientes que estão configurados dentro do arquivo TOTVSAPPSERVER.INI
(localizado na pasta appserver_console)

A tela de Ambientes é a principal tela, pois somente selecionando um ambiente é possível ter acesso as demais
opções da barra de ferramentas.

Você pode gerenciar os ambientes cadastrados, para isso utilize as opções Incluir, Copiar ou Modificar.

Incluir – Inclui um novo ambiente no arquivo de configuração

Copiar – Copiar todas as configurações de um ambiente já cadastrado para um novo ambiente
Modificar – Modifica as informações do ambiente selecionado.

12
 Console de Atualização Logix

1.3. Exclusão Versão

A opção Exclusão de Versão permite que você possa remover fontes do seu repositório.

13
 Console de Atualização Logix

1.4. Replicar
Através da opção Replicar é possível mover o repositório atualizado para os demais appservers do seu ambiente.
O campo Origem indica o nome do ambiente e o diretório do repositório onde a aplicação da atualização foi realizada
(appserver_console).
Para montar o campo Destino o sistema busca as informações de ambiente em todos os appservers com exceção
do appserver_console
Em Subdiretório APO o usuário pode alterar o caminho padrão que a ferramenta definiu para o novo repositório.

Em tela é apresentado o caminho do appserver identificado, o diretório atual do repositório e a sugestão de novo
diretório.

Para efetivar as alterações basta clicar na opção Replicar.

14
 Console de Atualização Logix

1.5. Conversão
Na opção Conversão é possível visualizar todos os conversores que estão pendentes de processamento em seu
ambiente.
Sempre que sistema identifica algum conversor no pacote, os arquivos “cnv” são movidos para um subdiretório na
pasta updater.
Caso tenha ocorrido algum erro no processamento do conversor durante a aplicação do pacote, você pode visualizar
todos os conversores pendentes e realizar o processamento através dessa opção.

15
 Console de Atualização Logix

1.6. Histórico
A opção Histórico permite visualizar todas as atualizações realizadas em seu ambiente.
Você pode filtrar as atualizações por período de tempo e também buscar as atualizações por um determinado
programa.

Os históricos das atualizações são apresentados em 4 abas: Lista de Atualizações, Programas Atualizados, Fontes
Removidos e Conversores

16