Atualizao Automtica do Protheus Remote

Ambiente

: Protheus Remote

Verso

: Protheus 8.11

Pas

: Todos

Data da Reviso

: 24/02/05

Para agilizar a atualizao do Protheus Remote nas estaes, possvel configurar uma mquina
com a verso mais recente e, a partir dela, efetuar a atualizao automtica nas estaes. Para
habilitar este procedimento, necessrio incluir a seo "UPDATE", no arquivo MP8SRV.INI, com
as seguintes chaves:
[UPDATE]
Enable=1
PathWindows=<localizao do Remote atualizado> (Se utilizado ambiente remote em Windows)
PathLinux=<localizao do Remote atualizado> (Se utilizado ambiente remote em Linux)

Exemplo de Configurao Servidor Protheus no Windows:

[UPDATE]
Enable=1
PathWindows=c:\protheus8\bin\remote
PathLinux=c:\protheus8\bin\remote_linux

Exemplo de Configurao Servidor Protheus no Linux:

[UPDATE]
Enable=1
PathWindows=/microsiga/protheus8/bin/remote
PathLinux=/microsiga/protheus8/bin/remote_linux

Boletim Tcnico Protheus Remote Atualizao Automtica - 1

Quando uma estao carregar o Protheus Remote, o sistema ir verificar se a verso do Remote
compatvel com o servidor. Caso no sejam compatveis e o recurso de atualizao automtica
estiver devidamente configurado, ser apresentada ao usurio a seguinte mensagem:

Ao confirmar a atualizao, ser apresentada uma janela com a progresso do processo.

Todos os arquivos gravados no diretrio informado para atualizao no Protheus Server sero
copiados para a estao onde se encontra o Protheus Remote, inclusive os arquivos INI. O
Protheus Server enviar estao remota os arquivos correspondentes ao sistema operacional que
o Protheus Remote utiliza: Windows ou Linux.

Requisitos para Atualizao Automtica

Para que a atualizao automtica seja realizada corretamente, importante observar:

Os arquivos constantes nas pastas de atualizao no Protheus Server devero estar

descompactados;

O usurio deve ter direito de gravao no diretrio do Protheus Remote da estao onde este
aplicativo est sendo executado / atualizado;

Quando utilizamos o Protheus Server em ambiente Linux, os arquivos das pastas de atualizao
automtica devem conter apenas letras minsculas, mesmo que se destinem atualizao de
um Protheus Remote para ambiente Windows;

Ao definir a(s) pasta(s) para conter os arquivos a serem atualizados do Protheus Remote no
servidor, devemos criar uma pasta especfica para esta finalidade, e no utiliz-la para execuo
do Protheus Remote na estao servidora.

2 Boletim Tcnico Protheus Remote Atualizao Automtica

Caractersticas da Atualizao Automtica

No necessrio utilizar FTP, CABs ou compartilhamentos de rede para esta atualizao, pois o
Remote utilizar o prprio protocolo de conexo do Protheus para fazer a atualizao.

Os arquivos so copiados para uma pasta temporria na estao remota, criada a partir da
pasta onde est sendo executado o Protheus Remote. A aplicao Remote cria
automaticamente uma pasta de backup, onde realizada uma cpia de segurana de todos os
arquivos da pasta atual do Protheus Remote, antes de efetivar a atualizao. So mantidas na
estao 03 (trs) cpias de segurana dos arquivos do Protheus Remote, referente s trs
ltimas atualizaes efetuadas. As pastas so criadas seqencialmente, a cada atualizao
efetuada, com os nomes de backup.001, backup .002 e backup .003. Caso as trs
pastas j existam no momento da execuo da atualizao, a pasta backup.001 eliminada,
as pastas .002 e .003 so renomeadas para .001 e .002, respectivamente, e uma
nova pasta backup .003 criada para conter a cpia de segurana mais recente dos
arquivos.

Em caso de impossibilidade ou falha da rotina de atualizao automtica, o Protheus Remote

exibir uma janela contendo a mensagem No foi possivel atualizar automaticamente o
Remote. Neste caso, o administrador do sistema deve ser notificado, e verificar se os
requisitos para o funcionamento da atualizao foram preenchidos.

Mensagens da Rotina de Atualizao Automtica

A partir do Protheus 8, build 7.00.050131a, as mensagens de falha na execuo da rotina de
atualizao automtica passaram a fornecer maiores detalhes sobre a ocorrncia, tanto na
aplicao Protheus Remote, como tambm no console do Protheus Server, de modo a auxiliar o
administrador do ambiente a identificar a causa da ocorrncia.
Ocorrncia: No foi recebido nenhum arquivo a atualizar.

Boletim Tcnico Protheus Remote Atualizao Automtica - 3

Possveis causas:

O diretrio especificado para a atualizao, na configurao do Protheus Server, no

contm nenhum arquivo a atualizar. Verifique se o diretrio informado existe no ambiente
do servidor, e se os arquivos do Protheus Remote para atualizao encontram-se no
diretrio informado. Neste caso, exibido no console do Protheus Server a seguinte
mensagem:
[02/02/2005 16:50:36] Starting Thread for remote update
*** WARNING: Update directory [c:\mp8\bin\rmtupd_windows\] EMPTY.
*** UNABLE TO PROCEED WITH AUTOMATIC REMOTE UPDATE
*** Please verify update server path.
[02/02/2005 16:50:54] Finishing Thread for remote update

O Protheus Server foi atualizado, porm o diretrio especificado para a atualizao dos
arquivos do Protheus Remote no foi atualizado. Quando uma estao remota iniciar o
Protheus Remote, e proceder com a atualizao automtica, caso os arquivos da estao
estejam atualizados em relao aos arquivos informados no Protheus Server, o servidor no
enviar nenhum arquivo estao remota. Verifique se os arquivos colocados na pasta
configurada para atualizao no Protheus Server so compatveis com o build do servidor
Protheus atualmente em uso. Neste caso, exibido no console do Protheus Server a
seguinte mensagem:
[02/02/2005 17:03:22] Starting Thread for remote update
*** WARNING : Build mismatch on files in update server.
*** Verify if remote update files math with this Protheus Build.
[02/02/2005 17:03:25] Finishing Thread for remote update

O Protheus Server est sendo executado em um ambiente Linux / Unix, e existem um ou

mais arquivos no diretrio de atualizao configurado no Protheus Server, que possuem em
seu nome catacteres em letra maiscula. Todos os arquivos colocados nos diretrios de
atualizao automtica configurados no Protheus Server, quando trabalhamos com o
mesmo em ambiente Linux, devem ser colocados em letras minsculas. Neste caso, os
nomes de todos os arquivos invlidos so exibidos no console do Protheus Server, atravs
da seguinte mensagem:
*** WARNING : Invalid update file
[/protheus8/bin/remote_windows/ApExcel.xla]

4 Boletim Tcnico Protheus Remote Atualizao Automtica

Ocorrncia: No foi possvel atualizar o executvel do Protheus Remote

Possveis causas:

O diretrio especificado para a atualizao, na configurao do Protheus Server, no

contm o executvel do Protheus Remote. Verifique no servidor, se o arquivo executvel do
remote encontra-se na pasta de atualizao.

O arquivo executvel do Protheus Remote est com um atributo de somente-leitura

ligado. Retire o atributo de somente-leitura do arquivo.

O usurio logado na estao remota no tem direito de escrita no diretrio de trabalho do

Protheus Remote. Verifique os direitos do usurio logado na estao remota.

Ocorrncia:

No foi possvel atualizar um arquivo do Protheus Remote

Arquivo [xxxxxxxx]

Possveis causas:

O arquivo informado na mensagem est com um atributo de somente-leitura ligado. Retire

o atributo de somente-leitura do arquivo.

Boletim Tcnico Protheus Remote Atualizao Automtica - 5

O arquivo informado na mensagem pode estar em uso por outra aplicao da estao.
Verifique se no existe outra aplicao que esteja realizando algum acesso a este arquivo.
Feche os demais aplicativos da estao para certificar-se disso.

O usurio logado na estao remota no tem direito de escrita no diretrio de trabalho do

Protheus Remote. Verifique os direitos do usurio logado na estao remota.

Ocorrncia:

No foi possvel atualizar o atributo de execuo do Protheus Remote.

Observao: Ocorrncia reproduzida apenas na atualizao remota de estaes Linux.

Possveis causas:

Verificar se o usurio atualmente logado na estao remota possui direitos para alterao do
atributo do executvel do Protheus Remote.

Ocorrncia:

No foi possvel identificar os arquivos no diretrio do Protheus Remote

Possveis causas:

Verificar se o usurio atualmente logado na estao remota possui direitos de leitura no

diretrio de trabalho do Protheus Remote.

Verificar a localizao fsica dos arquivos do Protheus Remote na estao remota, e de que
maneira a aplicao Protheus Remote est sendo executada; caso esteja sendo executado a
partir de um 'atalho', verificar se o diretrio de trabalho do atalho o mesmo em que se
encontra o executvel do Protheus Remote.

6 Boletim Tcnico Protheus Remote Atualizao Automtica