Manual de Atualização

AUTOMA Consultoria & Informática Ltda.

Curitiba – PR
Este manual apresenta um guia detalhado sobre as tarefas a serem
executadas durante o processo de atualização do AutoLab.
Recomenda-se o backup de todos os arquivos da instalação atual do AutoLab
antes da substituição pelas novas versões.

1) Atualização do executável e da base de dados

Antes de iniciar a atualização do AutoLab, é preciso verificar a necessidade de

atualização do arquivo executável e do banco de dados do sistema.

1.1 Verificação da versão atualmente instalada

Para verificar a versão atual do sistema, deve-se acessar a opção “Sobre ...”
localizada no menu “Ajuda” do AutoLab, de modo a exibir a tela apresentada na
Figura 1.

Figura 1

O código apresentado na primeira linha (Versão: 2.50.0.0) refere-se à versão

do arquivo executável atualmente instalado. O código exibido na segunda linha
(Versão do banco de dados: 336) indica a versão atual do banco de dados.
1.2 Atualização do arquivo executável

A atualização do arquivo executável está disponível no arquivo

“autolab_a_b_c_d.zip”, onde “a_b_c_d” indica o código da nova versão.
Exemplo: se o nome do arquivo de atualização é “autolab_2_52_0_0.zip”, o
código da nova versão é “2.52.0.0”.

Caso o código da versão do arquivo de atualização seja superior ao código da

versão atualmente instalada, é necessário atualizar o arquivo executável. Caso
seja igual, não é necessário atualizar.

Para atualizar a versão do executável, é necessário que todos os usuários

sejam desconectados do AutoLab, de maneira a permitir a substituição dos
arquivos localizados no servidor. Feito isso, deve-se descompactar o arquivo
“autolab_a_b_c_d.zip” na pasta compartilhada onde se encontra o arquivo
“AutoLab.exe” (geralmente a pasta “bin”), sobrescrevendo as versões atuais
dos arquivos.

1.2.1 Nota para usuários do Windows 98

Recomenda-se que o AutoLab seja executado somente em computadores com

sistema operacional Windows XP/2000 ou superior, visto que o Windows 98
não é 100% compatível com o AutoLab.

No entanto, para manter a compatibilidade em ambientes de execução que

possuem estações com Windows XP/2000 e Windows 98 simultaneamente, a
Automa pode eventualmente fornecer uma versão do AutoLab específica para
Windows 98, cujo arquivo “autolab_a_b_c_d.zip” pode ser encontrado na
subpasta “win98”, localizada na área de arquivos de atualização do cliente.

Para atualizar este arquivo, deve-se seguir os mesmos procedimentos

descritos no item 1.2, apenas levando-se em consideração que a pasta “bin”
para esta versão específica deve ser separada da pasta “bin” da versão oficial.

1.3 Atualização do banco de dados

O aplicativo de atualização do banco de dados do AutoLab está disponível no

arquivo “alupdate_xxx.zip”, onde “xxx” indica o código da nova versão do banco
de dados. Exemplo: se o nome do arquivo de atualização é “alupdate_339.zip”,
o código da nova versão do banco de dados é 339.

Caso o código da nova versão do banco de dados seja superior ao código da

versão atualmente instalada, é necessário realizar o procedimento de
atualização do banco. Caso seja igual, não é necessário atualizar.

Para atualizar a versão do banco de dados, é necessário que todos os usuários

sejam desconectados do AutoLab, de maneira a permitir as alterações
necessárias nas tabelas da base de dados.
Feito isso, deve-se seguir os passos enumerados abaixo:

a) Efetuar uma cópia de segurança (backup) do banco de dados do

AutoLab.

b) Descompactar o arquivo “alupdate_xxx.zip” na pasta compartilhada onde

se encontra o arquivo “AutoLab.exe” (geralmente a pasta “bin”),
sobrescrevendo a versão atual do arquivo “ALUpdate.exe” (caso exista).

c) A partir de um computador onde o AutoLab já se encontra configurado,

executar o aplicativo “ALUpdate.exe”. A tela inicial do atualizador de
banco de dados do AutoLab é então apresentada (Figura 2).

Figura 2

d) Dependendo do fornecedor do sistema gerenciador do banco de dados,

algumas opções podem estar disponíveis nesta tela inicial:

• Tablespace para índices (opcional): Disponível apenas para

bancos de dados Oracle, esta opção permite determinar um
tablespace específico para a criação dos índices.

• Gerar script SQL para atualização: Disponível para bancos de

dados Oracle e SQL Server, esta opção permite optar pela
atualização automática do banco através do ALUpdate ou pela
geração de um script de atualização para execução manual no
banco de dados.

e) Após configurar as opções disponíveis, deve-se clicar em “Atualizar”

para iniciar o processo. A seguir, uma tela de autenticação é exibida
(exceto para bancos Access), conforme a Figura 2. Deve-se digitar a
senha do banco de dados correspondente ao usuário com o qual foram
criadas as tabelas do AutoLab.
 Figura 3

f) Uma mensagem é então exibida para alertar sobre a necessidade de

realização do backup antes da atualização (Figura 3). Caso o backup já
tenha sido efetuado previamente (conforme orientado no item “a”), basta
clicar em “OK” e prosseguir a atualização.

Figura 4

g) A seguir, a tela de autenticação é novamente exibida (exceto para

bancos Access). Deve-se digitar novamente a senha do banco de dados
correspondente ao usuário com o qual foram criadas as tabelas do
AutoLab.

h) Após a confirmação da senha, o ALUpdate inicia o processo de

atualização, e uma barra de progresso é exibida (Figura 4) para indicar o
andamento do processo.

Figura 5

i) Caso o processo seja concluído com êxito, a mensagem “Atualização

realizada com sucesso.” é exibida. Caso seja exibida alguma mensagem
de erro durante qualquer etapa do processo de atualização do banco de
dados, consulte o item 3 deste manual, que apresenta soluções para
problemas comuns durante a atualização.
2) Atualização dos arquivos extras

Dependendo das características e customizações desenvolvidas para cada

cliente, o AutoLab pode necessitar da atualização de diversos outros arquivos
adicionais.

A seguir é apresentada uma lista dos principais tipos de arquivos extras,

incluindo informações sobre o procedimento de atualização de cada arquivo.

2.1 bpls_a_b_c_d.zip

Este arquivo contém as bibliotecas necessárias para a execução do AutoLab

em Windows 98. O sufixo “a_b_c_d” indica o código da versão das bibliotecas.

Para efetuar a atualização, basta descompactar este arquivo na pasta onde se

encontra o arquivo “AutoLab.exe” (geralmente a pasta “bin”). Caso as versões
do AutoLab para Windows XP/2000 e Windows 98 coexistam no mesmo
ambiente de execução, este arquivo deve ser descompactado na pasta “bin” e
específica para Windows 98.

2.2 scripts.zip

Este arquivo contém os scripts de customização do AutoLab, e deve ser

descompactado dentro da pasta específica dos scripts (geralmente a pasta
“scripts”).

2.3 relatorios.zip

Este arquivo contém os modelos de relatórios do AutoLab, e deve ser

descompactado dentro da pasta específica dos relatórios (geralmente a pasta
“relatorios”).

2.4 certificados.zip

Este arquivo contém os modelos de certificados do AutoLab, e deve ser

descompactado dentro da pasta específica dos certificados (geralmente a
pasta “certificados”).

2.5 avisos.zip

Este arquivo contém os scripts e arquivos de configuração do aplicativo “Task

Agent” do AutoLab, e deve ser descompactado dentro da pasta específica dos
avisos (geralmente a pasta “avisos”).

2.6 grupos.zip

Este arquivo contém arquivos de configuração e modelos de certificados do

AutoLab, e deve ser descompactado dentro da pasta específica dos grupos de
certificados (geralmente a pasta “grupos”).
3) Soluções para problemas comuns durante a atualização
A seguir são apresentadas soluções para os problemas que ocorrem com
maior freqüencia durante o processo de atualização do AutoLab.

3.1 Mensagem “Name not unique in this context.” ao executar o ALUpdate

Esta mensagem (Figura 6) está associada à execução do ALUpdate em um

computador que possui duplicidade na configuração do acesso ao banco de
dados.

Figura 6

Esta questão envolvendo duplicidade ocorre quando as situações abaixo

ocorrem simultaneamente:

a) O BDE (Borland Database Engine) instalado no computador já possui

uma conexão configurada para o banco de dados do AutoLab. Esta
conexão (Database Alias) é denominada “AutoLabSqlSrv” para SQL
Server, “OraAutoLab” para Oracle ou “AutoLabIB” para bancos InterBase
ou Firebird.

b) O arquivo “dbautolab.ini” (localizado na mesma pasta do arquivo

“AutoLab.exe”) contém a diretiva “ALIAS NAME=nome_da_conexão”,
onde “nome_da_conexão” varia de acordo com o tipo do banco de
dados, conforme o item anterior.

Para corrigir este problema, deve-se optar por uma das soluções apresentadas
abaixo:

a) Remover a configuração da conexão (Database Alias) do AutoLab do

BDE, de forma que o ALUpdate passe a utilizar apenas o arquivo
“dbautolab.ini” para conectar-se ao banco de dados.

b) Eliminar a diretiva “ALIAS NAME=nome_da_conexão” do arquivo

“dbautolab.ini”, de forma que o ALUpdate passe a utilizar apenas a
conexão configurada no BDE para conectar-se ao banco de dados.
3.2 Mensagem “Unknown user name or password.” durante a execução
do ALUpdate

Esta mensagem está associada a um erro de verificação de usuário ou senha

durante a primeira (Figura 7) ou segunda (Figura 8) etapa de autenticação do
ALUpdate em bancos de dados SQL Server.

Figura 7

Figura 8

Para corrigir o problema, deve-se verificar se o usuário (User Name) ou a

senha (Password) foram digitados corretamente na tela de autenticação do
ALUpdate.

3.3 Mensagem “ORA-01012: logon não estabelecido” durante a execução

do ALUpdate

Esta mensagem está associada a um erro de verificação de usuário ou senha

durante a primeira (Figura 9) ou segunda (Figura 10) etapa de autenticação do
ALUpdate em bancos de dados Oracle.

Figura 9
 Figura 10

Para corrigir o problema, deve-se verificar se o usuário (User Name) ou a

senha (Password) foram digitados corretamente na tela de autenticação do
ALUpdate.

3.4 Mensagem “Unknown database. Your user name and password are
not defined.” durante a execução do ALUpdate

Esta mensagem está associada a um erro de verificação de usuário ou senha

durante a primeira (Figura 11) ou segunda (Figura 12) etapa de autenticação
do ALUpdate em bancos de dados InterBase ou Firebird.

Figura 11

Figura 12

Para corrigir o problema, deve-se verificar se o usuário (User Name) ou a

senha (Password) foram digitados corretamente na tela de autenticação do
ALUpdate.
3.5 Outras mensagens de erro de conexão ao executar o ALUpdate

Estas mensagens podem apresentar variação dependendo da versão e do

fornecedor do banco de dados. Algumas delas são apresentadas nas figuras
13 a 15, e normalmente estão associadas à problemas na configuração da
conexão com o banco de dados do AutoLab.

Figura 13

Figura 14

Figura 15

Para corrigir este problema, deve-se configurar corretamente uma conexão

para o banco de dados do AutoLab no computador onde o ALUpdate está
sendo executado.
Para maiores detalhes, consulte o manual de instalação do AutoLab, que pode
ser obtido nos endereços abaixo:

• Versão Oracle:
http://suporte.automa.com.br/download/AutoLab - Manual de Instalação Oracle.pdf

• Versão SQL Server:

http://suporte.automa.com.br/download/AutoLab - Manual de Instalação SQL Server.pdf

• Versão Access:
http://suporte.automa.com.br/download/AutoLab - Manual de Instalação Access.pdf

• Versão InterBase / Firebird:

http://suporte.automa.com.br/download/AutoLab - Manual de Instalação Firebird.pdf