Atualização Automática do Protheus Remote

Ambiente : Protheus Remote

Versão : Protheus 8.11
País : Todos
Data da Revisão : 23/02/05

Para agilizar a atualização do Protheus Remote nas estações, é possível configurar uma máquina
com a versão mais recente e, a partir dela, efetuar a atualização automática nas estações. Para
habilitar este procedimento, é necessário incluir a seção "UPDATE", no arquivo MP8SRV.INI, com
as seguintes chaves:

[UPDATE]
Enable=1
PathWindows=<localização do Remote atualizado> (Se utilizado ambiente remote em Windows)
PathLinux=<localização do Remote atualizado> (Se utilizado ambiente remote em Linux)

Exemplo de Configuração – Servidor Protheus no Windows:

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

Exemplo de Configuração – Servidor Protheus no Linux:

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

Boletim Técnico – Protheus Remote – Atualização Automática - 1

Quando uma estação carregar o Protheus Remote, o sistema irá verificar se a versão do Remote é
compatível com o servidor. Caso não sejam compatíveis e o recurso de atualização automática
estiver devidamente configurado, será apresentada ao usuário a seguinte mensagem:

Ao confirmar a atualização, será apresentada uma janela com a progressão do processo.

Todos os arquivos gravados no diretório informado para atualização no Protheus Server serão
copiados para a estação onde encontra-se o Protheus Remote, inclusive os arquivos INI. O
Protheus Server enviará à estação remota os arquivos correspondentes ao sistema operacional que
o Protheus Remote utiliza, Windows ou Linux.

Requisitos para Atualização Automática

Para que a atualização automática seja realizada corretamente, é importante observar:

• Os arquivos constantes nas pastas de atualização no Protheus Server deverão estar

descompactados;

• O usuário deve ter direito de gravação no diretório do Protheus Remote da estação onde este
aplicativo está sendo executado / atualizado;

• Quando utilizamos o Protheus Server em ambiente Linux, os arquivos das pastas de atualização
automática devem conter apenas letras minúsculas, mesmo que se destinem à atualização 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 específica para esta finalidade, e não utilizá-la para execução
do Protheus Remote na estação servidora.

2 – Boletim Técnico – Protheus Remote – Atualização Automática

Características da Atualização Automática
• Não é necessário utilizar FTP, CABs ou compartilhamentos de rede para esta atualização, pois o
Remote utilizará o próprio protocolo de conexão do Protheus para fazer a atualização.

• Os arquivos são copiados para uma pasta temporária na estação remota, criada a partir da
pasta onde está sendo executado o Protheus Remote. A aplicação Remote cria
automaticamente uma pasta de backup, onde é realizada uma cópia de segurança de todos os
arquivos da pasta atual do Protheus Remote, antes de efetivar a atualização. São mantidas na
estação 03 (três) cópias de segurança dos arquivos do Protheus Remote, referente às três
últimas atualizações efetuadas. As pastas são criadas seqüencialmente, a cada atualização
efetuada, com os nomes de “backup.001”, “backup .002” e “backup .003”. Caso as três
pastas já existam no momento da execução da atualização, a pasta “backup.001” é eliminada,
as pastas “.002” e “.003” são renomeadas para “.001” e “.002”, respectivamente, e uma
nova pasta backup “.003” é criada para conter a cópia de segurança mais recente dos
arquivos.

• Em caso de impossibilidade ou falha da rotina de atualização automática, o Protheus Remote

exibirá uma janela contendo a mensagem “Não foi possivel atualizar automaticamente o
Remote”. Neste caso, o administrador do sistema deve ser notificado, e verificar se os
requisitos para o funcionamento da atualização foram preenchidos.

Mensagens da Rotina de Atualização Automática

A partir do Protheus 8, build 7.00.050131a, as mensagens de falha na execução da rotina de
atualização automática passaram a fornecer maiores detalhes sobre a ocorrência, tanto na
aplicação Protheus Remote, como também no console do Protheus Server, de modo a auxiliar o
administrador do ambiente a identificar a causa da ocorrência.

Ocorrência: “Não foi recebido nenhum arquivo a atualizar.“

Boletim Técnico – Protheus Remote – Atualização Automática - 3

Possíveis causas:

• O diretório especificado para a atualização, na configuração do Protheus Server, não

contém nenhum arquivo a atualizar. Verifique se o diretório informado existe no ambiente
do servidor, e se os arquivos do Protheus Remote para atualização encontram-se no
diretório 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, porém o diretório especificado para a atualização dos
arquivos do Protheus Remote não foi atualizado. Quando uma estação remota iniciar o
Protheus Remote, e proceder com a atualização automática, caso os arquivos da estação
estejam atualizados em relação aos arquivos informados no Protheus Server, o servidor não
enviará nenhum arquivo à estação remota. Verifique se os arquivos colocados na pasta
configurada para atualização no Protheus Server são compatíveis 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 diretório de atualização configurado no Protheus Server, que possuem em
seu nome catacteres em letra maiúscula. Todos os arquivos colocados nos diretórios de
atualização automática configurados no Protheus Server, quando trabalhamos com o
mesmo em ambiente Linux, devem ser colocados em letras minúsculas. Neste caso, os
nomes de todos os arquivos inválidos são exibidos no console do Protheus Server, através
da seguinte mensagem:

*** WARNING : Invalid update file

[/protheus8/bin/remote_windows/ApExcel.xla]

4 – Boletim Técnico – Protheus Remote – Atualização Automática

Ocorrência: “Não foi possível atualizar o executável do Protheus Remote”

Possíveis causas:

• O diretório especificado para a atualização, na configuração do Protheus Server, não

contém o executável do Protheus Remote. Verifique no servidor, se o arquivo executável do
remote encontra-se na pasta de atualização.

• O arquivo executável do Protheus Remote está com um atributo de “somente-leitura”

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

• O usuário logado na estação remota não tem direito de escrita no diretório de trabalho do
Protheus Remote. Verifique os direitos do usuário logado na estação remota.

Ocorrência: “Não foi possível atualizar um arquivo do Protheus Remote”

“Arquivo [xxxxxxxx]”

Possíveis causas:

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

o atributo de “somente-leitura” do arquivo.

Boletim Técnico – Protheus Remote – Atualização Automática - 5

 • O arquivo informado na mensagem pode estar em uso por outra aplicação da estação.
Verifique se não existe outra aplicação que esteja realizando algum acesso a este arquivo.
Feche os demais aplicativos da estação para certificar-se disso.

• O usuário logado na estação remota não tem direito de escrita no diretório de trabalho do
Protheus Remote. Verifique os direitos do usuário logado na estação remota.

Ocorrência: “Não foi possível atualizar o atributo de execução do Protheus Remote.”

Observação: Ocorrência reproduzida apenas na atualização remota de estações Linux.

Possíveis causas:

• Verificar se o usuário atualmente logado na estação remota possui direitos para alteração do
atributo do executável do Protheus Remote.

Ocorrência: “Não foi possível identificar os arquivos no diretório do Protheus Remote”

Possíveis causas:

• Verificar se o usuário atuamente logado na estação remota possui direitos de leitura no

diretório de trabalho do Protheus Remote.

• Verificar a localização física dos arquivos do Protheus Remote na estação remota, e de que
maneira a aplicação Protheus Remote está sendo executada; caso esteja sendo executado a
partir de um 'atalho', verificar se o diretório de trabalho do atalho é o mesmo em que se
encontra o executável do Protheus Remote.

6 – Boletim Técnico – Protheus Remote – Atualização Automática