MFG/PRO GUIA DE INSTALAÇÃO DE

Industry-specifid
QAD SOLUTIONS
Manufacturing Applications
MFG/PRO
GUIA DE INSTALAÇÃO DE PATCHES
LOCALIZAÇÃO BRASILEIRA
Progress
78-0647A
Março 2007, Versão 1.0
1. Organização dos patches na Internet
Os patches da localização brasileira estão disponíveis no link Brazil Localizations –
Atualização de Produto do site http://support.qad.com (ServiceLinQ). O acesso a este link só
pode ser feito com login/senha (WebAccount).
Neste local você encontrará subdiretórios tais como:
eB0103/
eB20502/
eB210301/
standard-eB21/
Os patches da localização brasileira estão organizados em diretórios de acordo com cada
versão. Por exemplo: no subdiretório eB20502 você encontrará todos os patches relativos à
versão eB2 SP5 release 02. No caso de existir um novo corte de release, por exemplo,
eB20503, será criado um diretório com este nome contendo todos os eventuais patches desta
nova release.
Quanto aos diretórios de nomenclatura “standard-XX”, veja ao final deste documento (item 5)
mais detalhes referente a disponibilização e instalação de patches standard.
Dentro de cada subdiretório relativo à versão, você encontrará a estrutura de subdiretórios
listada abaixo:
doc/
nt/
gui/
unix/
conv/ ou mfgutil/ (*)
(*) Estes diretórios não são encontrados em todas releases.
Por fim, ainda existem mais dois outros subdiretórios dentro de cada pasta mencionada acima
que se referem aos pacotes de patches. São os chamados weekpacks e monthpacks.
1.1. O diretório DOC
O diretório DOC é o diretório de documentação dos patches.
Neste nível de diretório estão os arquivos ‘.txt ’ que descrevem a finalidade de cada patch
bem como algumas ações que devem ser tomadas antes, durante e/ou após a atualização
do ambiente. É também neste diretório que estão os arquivos “.wrk” que contém a lista de
programas que devem ser compilados para aplicação do patch.
1.2. O diretório GUI
No diretório GUI você encontrará os patches relativos à versão Windows Client (GUI).
Os patches desta interface estão em formato self-extract (.exe).
1.3. Os diretórios UNIX e NT
Dentro dos diretórios UNIX e NT, você encontrará os patches relativos à versão
Character (ChUI).
Usuários Unix encontrarão os patches em formato cpio, enquanto que usuários DOS,
Netware e Windows NT encontrarão os patches em formato self- extract (.exe).
1.4. Os diretórios CONV e MFGUTIL
Estes diretórios podem ser encontrados em subdiretórios de algumas releases (eB2 e
eB2.1 por exemplo). Os arquivos/programas destes diretórios são utilizados para atua lizar
o ambiente antes do processo de instalação e/ou conversão do MFG/PRO, por isso NÃO
precisam ser acessados periodicamente para a atualização/instalação de patches.
2. Ordem de aplicação dos Patches
A ordem de aplicação dos patches é de extrema importância para que o sistema funcione
perfeitamente.
O nome do arquivo de patch é composto por 3 dígitos + o nome do patch e a extensão (cpio,
exe). Por exemplo: 003-9b3w.cpi
Os 3 dígitos iniciais indicam uma ordem numérica de aplicação do patch, ou seja, no exemplo
anterior, para que seja possível a aplicação do patch 003-9b3w.cpi é necessário que você já
tenha aplicado os patches 002-xxxx e 001- xxxx (xxx representa o nome do patch que consta no
diretório).
A QAD recomenda a aplicação de patch seqüencial, ou seja, seguir a ordem numérica descrita
acima. Entretanto, a partir de Abril/2006, se tornou possível aplicar um patch específico fora da
ordem. Para isso é obrigatório ter o ambiente atualizado com todos os patches liberados até o
mês anterior (o que pode ser feito via weekpack e/ou monthpack) e também é preciso verificar
a interdependência do patch com os anteriores do mês em questão. Esta interdependência pode
ser identificada no texto do patch a ser aplicado no item “Pré-requisitos”.
Além dos patches individuais, a QAD fornece pacotes de patches semanais e mensais
(weekpack e monthpack, respectivamente). Estes também devem ser aplicados na seqüência e
sua identificação é representada pelo número do patch inicial e final contido no pacote, como
por exemplo: 238-252.cpi, o qual significa que todos os patches entre o 238-xxxx e o 252-yyyy
(inclusive) estão disponíveis neste pacote. Podendo ser este um weekpack ou monthpack,
dependendo em qual diretório o mesmo se encontra.
Observação: Quando uma nova release é criada (ex: eB20503), é necessário instalar todos os
patches da release anterior (eB20502) para então iniciar a aplicação dos patches da nova
release.
3. Somente para usuários da interface GUI - Windows
Caso a versão cliente GUI esteja sendo utilizada, tanto com Unix quanto com NT, é necessário
que o patch seja aplicado nos DOIS ambientes: cliente e servidor. Por exemplo:
Supondo que você utilize Unix para o servidor e GUI para o cliente e que deseje aplicar o
patch 003-9b3w em seu ambiente de produção: você deve fazer o download do arquivo 0039b3w.cpi do diretório /unix (observando sempre se os patches anteriores já estão instalados de
acordo com os requisitos de “Ordem de aplicação de Patches”) e depois fazer também o
download dos respectivos arquivos de patch no diretório /gui, neste caso, 003-9b3w.exe, a ser
instalado na estação cliente.
Lembre-se que num ambiente como o descrito acima, existem alguns usuários utilizando os
programas instalados no servidor UNIX e outros utilizando os programas instalados em um
servidor de arquivos. Como o arquivo .cpi atualiza o servidor UNIX e o .EXE o servidor de
arquivos, se ambos não estiverem sincronizados existirão usuários executando versões
diferentes dos mesmos programas.
4. Como aplicar o(s) patch(es)
A aplicação do patch é vinculada à leitura do texto explicativo do mesmo, que se encontra no
diretório DOC. Sendo assim, ANTES da execução dos passos a seguir leia atentamente o
arquivo de extensão .TXT ou .DOC para verificar as instruções adicionais (cadastro de
mensagens, itens de menu, execução de utilitários, restrições, etc).
Para facilitar o controle, sugerimos a criação de um diretório para manter todos os patches. Por
exemplo: Se você está na versão eB20502, crie um diretório patcheB20502 logo abaixo da
estrutura do <mfg_install_dir> ou em algum outro diretório de sua preferência. Coloque neste
diretório, que chamaremos a seguir de <mfgpatchdir>, todos os arquivos de patch que serão
aplicados no sistema.
Para compilar os programas localizados, o Database Set de compilação deve conter, além dos
bancos standards (mfg, adm, hlp, aud(*) ), o banco da localização (loc) cujo nome lógico é
qadloc. Estes bancos são criados durante o processo de instalação/conversão do MFG/PRO.
Trata-se de bancos vazios cujo nome físico pode ser diferente (mfgempty, mfgus, mfgpo,
locempty, locpo, locus, etc).
(*) O banco aud somente é utilizado para a versão eB2.1.
IMPORTANTE:
1) É fortemente recomendado que a aplicação do patch seja feita em um ambiente de testes
antes de aplicá- lo ao ambiente de produção.
2) Sugerimos que a aplicação do patch em produção seja planejada de forma que um número
mínimo de usuários estejam conectados ao sistema, isto pois existem programas de
biblioteca (exemplo: *rx.p e *rx1.p) que ficam em memória e podem ficar desincronizados
ocasionando erros. Além disso, uma transação iniciada com um programa antigo e
finalizada com um programa atualizado, pode causar inconsistencia do sistema.
4.1. Abrindo os arquivos de patch e compilando os programas
4.1.1. UNIX/LINUX
•
Fazer download dos arquivos
Conectar-se ao site com a WebAccount, ir ao diretório da release instalada em seu
ambiente e baixar todos os arquivos referente ao patch/weekpack/monthpack que será
instalado. (veja item 1. deste manual).
IMPORTANTE: Utilize sempre o formato binário ao utilizar o FTP para transferir
os arquivos de patch entre servidores.
•
Extrair os arquivos
Se você utiliza o sistema UNIX host-based ou UNIX/GUI client então você deve ter o
arquivo no formato cpio. Para abrir os programas e arquivos contidos no patch, no
prompt do unix digite:
cd mfgpatchdir
cpio –idvcuBm < “arquivo.cpi”
Exemplo: cpio –idvcuBm < 003-9b3w.cpi
Para ambiente LINUX as variáveis do comando devem ser:
cpio –idv < “arquivo.cpi”
Após a execução deste comando serão abertos arquivos dentro de subdiretórios XRC
e SRC. Vale ressaltar que o diretório SRC somente será criado caso algum programa
de relatório ou consulta tenha sido alterado por este patch.
•
Salvar os programas em local apropriado
Mova o conteúdo de cada subdiretório para o respectivo diretório (XRC e SRC) de
/<mfg_install_dir>/po (ou para o respectivo diretório do ambiente de teste:
<mfg_TEST_dir>/po).
Nota: Neste caso estamos supondo que o ambiente esteja no idioma Português. Caso
o ambiente possua tanto o idioma PO como US, este procedimento deve ser feito em
ambos os idiomas para garantir que as versões no xrc e src estejam sempre
compatíveis.
•
Lista de compilação
A seguir copie o arquivo de patch (xxx-xxxx.wrk) para o diretório de instalação do
MFG/PRO, substituindo seu nome para utcompil.wrk. Ex: cp 003-9b3w.wrk
/<mfg_install_dir>/utcompil.wrk
•
Compilação
Compile então o patch com o utilitário MFGUTIL. Para executa-lo basta ir até o
diretório de instalação do MFG/PRO (<mfg_install_dir>) e digitar:
./mfgutil
Entre no menu Program -> Compile Procedures, conforme ilustrado.
Após preencher os campos conforme ilustração/detalhes abaixo, selecione <compile>:
Compiler options: (mantenha as opções default)
(X) Verbose / (X) Use Existing Compile List
R-Code Destination: (mantenha o default)
(X) Staggered MFG/PRO Default
Compile List File: Indique a lista de compilação bem como o diretório que ela se
encontra.
Compile Propath: Preencha com o caminho de seu /<mfg_install_dir>/po/xrc. Caso
tenha baixado os patches em um outro diretório e também tenha os programas
localizados em diretório separado, o campo Compile Propath deve ter a seguinte
ordem: primeiro o diretório com patches, depois o diretório comprogramas
localizados, na seqüência o diretório com programas standard e por fim, caso haja,
diretório de customizações. Não é necessário listar o diretório com os fonte abertos
(conforme apresentado na figura anterior). Este diretório só foi apresentado na figura
para exemplificar a listagem de mais de um diretório neste campo.
IMPORTANTE: A maioria dos problemas decorrentes de compilação de
programas é proveniente do preenchimento incorreto do Compile Propath.
Mesmo sem apresentar erro durante a compilação, o programa pode, por
exemplo, acessar uma include desatualizada trazendo problemas durante o uso
do MFG/PRO.
Language Code: po ou us (dependendo da linguagem utilizada).
Database Set: Compile(po)
O nome do Database Set pode variar dependendo da instalação e configuração do
cliente. O Database Set de compilação deve ser configurado para agrupar os bancos
vazios: mfg, adm, hlp, loc e aud (este último só para a eB2.1).
Destination Directory: Preencha este campo com o diretório que deverá salvar os
compilados (.r). Não é necessário colocar o diretório da linguagem, pois o utilitário
irá considerar a linguagem do campo Language Code para enviar os r-code.
Após esta tela serão mostradas todas as informações digitadas. Confirme os dados
clicando em <Continue>.
4.1.2. Windows/NT
•
Fazer download dos arquivos
Conectar-se ao site com a WebAccount, ir ao diretório da release instalada em seu
ambiente e baixar todos os arquivos referente ao patch/weekpack/monthpack que será
instalado. (veja item 1. deste manual).
IMPORTANTE: Utilize sempre o formato binário ao utilizar o FTP para transferir
os arquivos de patch entre servidores.
•
Extrair os arquivos
Posicione-se no diretório x:\<mfgpatchdir> e execute o arquivo no formato EXE
autoextract. Todos os arquivos serão extraídos sob um novo subdiretório com o nome
do patch. Ex: x:\<mfgpatchdir>\9b3w\.
Após a execução do arquivo EXE serão abertos arquivos dentro de subdiretórios XRC
e SRC. Vale ressaltar que o diretório SRC somente será criado caso algum programa
de relatório ou consulta tenha sido alterado por este patch.
•
Salvar os programas em local apropriado
Mova o conteúdo de cada subdiretório para o respectivo diretório (XRC e SRC) de
x:\<mfg_install_dir>\po (ou para o respectivo diretório do ambiente de teste:
x:\<mfg_TEST_dir>\po).
Nota: Neste caso estamos supondo que o ambiente esteja no idioma Português. Caso
o ambiente possua tanto o idioma PO como US, este procedimento deve ser feito em
ambos os idiomas para garantir que as versões no xrc e src estejam sempre
compatíveis.
•
Lista de compilação
A seguir copie o arquivo de patch (xxx-xxxx.wrk) para o diretório de instalação do
MFG/PRO, substituindo seu nome para utcompil.wrk. Ex: cp 003-9b3w.wrk
x:\<mfg_install_dir>\utcompil.wrk
•
Compilação
Siga as mesmas instruções detalhadas acima para um ambiente Unix/Linux.
5. Patches standard
Além da liberação dos patches da Localização Brasileira, a QAD Brasil também disponibiliza
no site Brazil Localizations – Atualização de Produto alguns patches standards.
Não havendo interdependência com os programas da localização brasileira, os patchs são
disponbilizados no site dentro dos diretórios conforme estruturado abaixo:
MFG/PRO eB2 SP5 -> Diretório: standard-eB2
MFG/PRO eB2.1 SP3 -> Diretório: standard-eB21
MFG/PRO eB2.1 SP4 -> Diretório: standard-eB21SP4
Algumas considerações quanto a instalação dos patches standard:
•
É fortemente recomendada a instalação do patch standard primeiramente em um ambiente
de teste;
•
Não há uma seqüência pré-definida para instalação dos patches standard;
•
A QAD recomenda a instalação de todos os patches standards, porém não é obrigatória a
instalação dos mesmos; (*)
•
Leia atentamente os textos dos patches para identificar a que ajuste o mesmo se refere;
•
Todos os clientes serão notificados por email quando um patch standard for disponibilizado
em nosso site;
•
Sugerimos a utilização do mfgutil para compilação dos patches standard (siga as mesmas
instruções de instalação dos patches localizados).
(*) Existem patches que se referem a módulos específicos os quais podem não estar instalados
em todos os clientes, por isso, podem haver casos em que o patch não agregará valor ao
sistema. Porém, quando for identificado que um patch standard é vital para a funcionalidade
geral do sistema, os clientes serão notificados por email quanto a importância do mesmo.