Manual Logix Update

Logix



Manual Logix Update
1


Prezado (a) Cliente,


A atualizao de software um processo de refinamento e aperfeioamento do produto, que
visa melhoria continua da sua utilizao e a correo das no conformidades identificadas.
Desta forma a execuo e simplificao deste processo so de grande importncia para manter
o produto na sua forma plena de utilizao.

Pensando na simplificao e garantia do processo de atualizao a TOTVS oferece a seus
clientes, utilizadores do produto Logix, a ferramenta Logix Update, que gerencia este processo,
tornando-o padro e uniforme, garantindo assim a confiabilidade da execuo.

Utilize este manual como guia na utilizao desta ferramenta, fazendo uso assim de forma
plena de seus benefcios e funcionalidades. Funcionalidades estas que podemos destacar:

Processo restrito a usurios administradores (utilizando usurio e senha do
produto).
Aplicao de atualizao de objetos PTM e XML (metadado) de forma unificada.
Gravao de controle de auditoria das atualizaes realizadas.
Visualizao dos objetos contidos no patch / pacote de atualizao.
Consulta do histrico de atualizaes.
Aplicao em multi-ambientes / bancos utilizando a mesma ferramenta.

Cordialmente,
TOTVS S.A.



Manual Logix Update
2
1. Instalao da ferramenta
1.1 A ferramenta Logix Update encontra-se disponvel para todos os clientes que
possuem o produto Logix com verso / release igual ou superior a 10.02.
1.2 Para efetuar a instalao do Logix Update necessrio efetuar o download de
uma das verses disponveis do mesmo na Central de Downloads TOTVS.
Para acessar a Central de Downloads TOTVS utilize o endereo:
suporte.totvs.com, utilize o usurio e senha e acesse a opo Download.
Escolha a linha Logix, ambiente / verso Logix-10.2 ou Logix-11.0 e plataforma
Windows / Linux. Est disponvel a verso do instalador tanto para plataforma
Windows (TOTVS LogixUpdate-1.0-Setup.exe) como Linux (TOTVS LogixUpdate-
1.0-Linux-x86-Install).
1.3 O processo de instalao automatizado, sendo apenas necessrio seguir um
guia de instalao, a primeira tela apresentada a pergunta sobre a confirmao
do incio do processo:

1.4 Aps a confirmao da execuo, apresentada uma tela de boas-vindas, onde
possvel iniciar o fluxo clicando em Prximo:





Manual Logix Update
3
1.5 Seguindo o fluxo da instalao, apresentada a tela onde dever ser informado o
diretrio de instalao atual do produto Logix. necessrio clicar em Navegar
para localizar caso o mesmo no esteja instalado no diretrio sugerido:

A validao da instalao do Logix feita atravs da verificao da
existncia de uma pasta appserver, sendo os seguintes nomes de pastas vlidos:
appserver, appserver1, appserver01 e appserver_atu. Caso no seu ambiente no
exista nenhuma dessas pastas, copie e altere o nome de uma das pastas
existentes para um dos nomes vlidos citados acima.
1.6 Na etapa final antes do inicio do processamento da instalao apresentado um
pequeno resumo com a informao do diretrio da instalao padro do Logix.
Caso esteja correto, clique em Prximo:





Manual Logix Update
4
1.7 A prxima etapa a execuo da instalao, cpia dos arquivos, criao dos
diretrios e atalhos de execuo. Ao finalizar, ser apresentada a tela de
finalizao com a opo final de Concluir.

1.8 Os atalhos criados para execuo do Logix Update encontram-se disponveis na
rea de trabalho, tanto o servidor de aplicao (TOTVS LogixUpdate Server)
como o atalho de execuo da aplicao (TOTVS LogixUpdate).
Junto com o instalador do Logix Update disponibilizado um patch
(PTM) um arquivo XML (Metadado) e um conversor de tabela (CNV) para
atualizao de cada um dos ambientes onde ser utilizado o Logix Update.
muito importante a aplicao destas atualizaes de forma ainda manual antes
da utilizao efetiva da nova ferramenta de atualizao. *Dever ser
atualizado cada ambiente que sofrer atualizao pelo LogixUpdate.
Caso o seu servidor seja Unix e a execuo do Logix Update ocorrer em
ambiente Windows o seguinte atalho poder ser criado, conforme parmetros e
configuraes a seguir:
Alterar o totvssmartclient.ini da mquina Windows, adicionando o seguinte
bloco:
[updater]
port = 4370
server = 0.0.0.0 (IP do Servidor)

Criar um atalho comum conforme exemplo:

Destino: <Diretrio de Instalao>\bin\smartclient\TotvsSmartClient.exe
-M -Q -C=updater -E=logixupd -P=logixupdate
Iniciar em: <Diretrio de Instalao>\bin\smartclient\



Manual Logix Update
5
2. Dicas de instalao

2.1 A porta padro da instalao do Logix Update a 4370. Caso a mesma entre em
conflito com algum servidor de aplicao TotvsTec existente a mesma poder ser
alterada. Para alterar a porta padro necessrio modificar o arquivo
totvsappserver.ini da pasta appserver_upd na opo Port=4370, referenciando
a porta desejada. necessrio tambm alterar o arquivo totvssmartclient.ini na
comunicao padro updater para utilizar a nova porta.
2.2 O Logix Update possui um RPO prprio, que se encontra disponvel na pasta
apo_upd dentro do diretrio appserver_upd. Este RPO no dever ser alterado de
lugar nem sofrer atualizaes.
2.3 Junto da instalao padro do Logix Update, so criados enviroments cpia de
um appserver existente, no arquivo totvsappserver.ini da pasta appserver_upd.
Importante frisar que o enviroment logixupd no dever ser alterado, pois o
ambiente que ir controlar as atualizaes feitas nos outros enviroments.
2.4 Para adicionar novos ambientes de atualizao (lista de ambientes disponveis no
Logix Update) basta alterar o arquivo totvsappserver.ini da pasta appserver_upd
para conter os enviroments desejados. A partir do enviroment logixupd ser
feito a atualizao dos outros ambientes existentes neste arquivo.
2.5 muito importante que o arquivo de atualizao PTM, o arquivo de metadado
XML e o arquivo CNV de estrutura de dados, includo no pacote de instalao do
Logix Update seja aplicado no formato antigo (TOTVS DevStudio e LOG00074
Sincronizador) antes da primeira execuo do Logix Update. A aplicao dever
ocorrer em cada ambiente que sofrer atualizao pela ferramenta.
2.6 Aps o processo de instalao padro, recomenda-se a reviso do arquivo
totvsappserver.ini da pasta appserver_upd para que seja removido ou adicionado
os enviroments necessrios e remoo de configuraes de LicenseServer e
ServerNetwork.
2.7 As informaes de auditoria do Logix Update so gravadas em base de dados, no
banco descrito na opo dbalias do enviroment logixupd. recomendado por
medida de segurana que este banco de dados seja o de produo.
2.8 Caso ocorra incompatibilidade da verso do TOTVS SmartClient e da build do
TOTVS AppServer do Logix Update, junto da instalao do Logix Update
enviada uma verso compatvel do TOTVS SmartClient. Neste caso necessrio
criar uma pasta chamada smartclient_upd cpia da pasta smartclient e atualizar
os arquivos enviados junto instalao. Como conseqncia, necessrio alterar
os atalhos do Logix Update para apontar para a nova pasta smartclient_upd.




Manual Logix Update
6
3. Logix Update
3.1 Para executar a ferramenta de atualizao Logix Update necessrio informar
um usurio e senha vlida para registro.

necessrio ser administrador do sistema Logix para ter acesso a
ferramenta de atualizao. O acesso de administrador pode ser liberado pela
central de usurios e permisses LOG05050.
3.2 A tela da ferramenta Logix Update est dividida em quatro grupos de
informaes: selo de integridade, ambientes, patch de atualizao e texto de
acompanhamento da execuo.





Manual Logix Update
7
3.3 A primeira opo da barra de ferramentas a ao Atualizar, ao clicar nesta
opo habilitado a tela para iniciar a execuo do processo, sendo necessrio
informar os seguintes campos:
Ambiente -> Ambientes disponveis no servidor de aplicao do Logix
possveis de receber uma atualizao.
Quando a atualizao possuir componentes metadados, haver
alterao de contedo do banco de dados, neste caso deve-se ficar atento ao
banco de dados que est relacionado ao ambiente selecionado.
Arquivo: Dever ser selecionado o arquivo MZP que contem a atualizao
atravs do cone Abrir Arquivo.
Para verificar o contedo do arquivo de atualizao, existe a opo de
informao, ao lado da opo de busca do arquivo de atualizao (Abrir Arquivo),
no grupo Patch Logix.

No grupo Informaes do Selo de Integridade constam informaes a
respeito do patch / pacote de atualizao, indicao se a atualizao um pacote
ou um patch, seu pacote de pr-requisito e sua verso.




Manual Logix Update
8
Ao concluir o preenchimento das informaes necessrio Confirmar a ao
de Atualizar.
O processo de atualizao pode demorar alguns minutos, dependendo
do tamanho do patch / pacote de atualizao.
Na finalizao do processo, ser exibido no grupo Log da aplicao o
resultado da execuo de atualizao.
3.4 Cada atualizao gera registros de auditoria, que podero posteriormente ser
consultados pelo administrador do produto. A opo de consulta est disponvel
na barra de ferramentas, com o nome Histrico.

Nesta opo de consulta est disponveis informaes a respeito do arquivo de
atualizao, entre elas:
O chamado que gerou a atualizao do produto.
O usurio responsvel pela atualizao.
O diretrio de controle de histrico (que contem uma cpia do arquivo
atualizado).
O ambiente no qual foi efetuado a atualizao.
Indicadores de contedo metadado e se a origem um pacote ou patch.
Os artefatos atualizados (fontes e metadados).
O histrico detalhado com o objetivo da atualizao.





Manual Logix Update
9
3.5 A ferramenta de atualizao conta com uma funcionalidade de reaplicao de
chamados aps a aplicao de uma atualizao do tipo Pacote. Este processo
garante a integridade das atualizaes efetuadas nos perodos de validao do
pacote por parte da TOTVS.
O processo de reaplicao de chamados utiliza os registros histricos
das atualizaes para efetuar o processo, desta forma s sero reaplicados os
chamados que forem atualizados via nova ferramenta Logix Update.
A reaplicao dos chamados utiliza arquivos de atualizaes (MZP)
salvos automaticamente em uma pasta interna da ferramenta. Fique atento para
no excluir estes arquivos das subpastas da ferramenta.