Vous êtes sur la page 1sur 35

Procedimento atualizao de pacotes

Pgina 1 de 35

Sumrio
1 Usurio NLCONNECT..........................................................................................................2
1.1 Criar usurio de banco chamado NLCONNECT......................................................................................2
1.2 Conceder permisses para o usurio NLCONNECT.................................................................................2
1.3 Criar sinonimos no usurio NLCONNECT...............................................................................................2

2 Configurar cone para acessar o programa de atualizao de pacotes..............................3


3 Acesso ao Administrador........................................................................................................4
4 Configurar conexes...............................................................................................................6
5 Configuraes do cadastro de mquina................................................................................7
5.1 Detalhes dos campos..................................................................................................................................9

6 Atualizao do sistema.........................................................................................................14
7 Log da Atualizao...............................................................................................................20
8 Liberar o sistema..................................................................................................................21
9 Atualizao do Sistema em Lojas com replicao de dados.............................................22
9.1 Configuraes..........................................................................................................................................23
9.2 Gerar Pacotes...........................................................................................................................................25
9.3 Copiar para Homologao.......................................................................................................................26
9.4 Liberar Homologao.............................................................................................................................27
9.5 Finalizar Homologao............................................................................................................................28
9.6 Liberar /Copiar para as lojas....................................................................................................................29
9.7 Liberar atualizao da Matriz(EC)
.........................................................................................................................................................................30
9.8 Liberar atualizao lojas..........................................................................................................................31
9.9 Atualizao das lojas................................................................................................................................32
9.10 Liberar RD (Matriz => Loja).................................................................................................................33
9.11 Consulta atualizao...............................................................................................................................33

10 Resumo do processo............................................................................................................34

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


1

Pgina 2 de 35

Usurio NLCONNECT
1.1

Criar usurio de banco chamado NLCONNECT

SQL> conne system/senha@owner as sysdba


SQL> CREATE USER NLCONNECT IDENTIFIED BY NL
DEFAULT TABLESPACE TBNL
TEMPORARY TABLESPACE TEMP
QUOTA UNLIMITED ON TBNL;
SQL> GRANT CREATE SESSION,
ALTER SESSION,
CREATE SYNONYM
TO NLCONNECT;
SQL> GRANT EXECUTE ON UTL_RAW TO NLCONNECT;

1.2

Conceder permisses para o usurio NLCONNECT


Conectar no usurio PRODUO. Os dados para conexo (usurio/senha@host) depende de

cada cliente)
SQL> conne nl/nl@nlprod
GRANT EXECUTE ON NL_UTL_RAW_SP TO NLCONNECT;
GRANT ALL PRIVILEGES ON NL_CONEXOES TO NLCONNECT;
GRANT ALL PRIVILEGES ON GE_GRUPOS_OBJETOS TO NLCONNECT;
GRANT SELECT ON NL_MENSAGENS TO NLCONNECT;
GRANT ALL PRIVILEGES ON GE_MAQUINA TO NLCONNECT;

1.3

Criar sinonimos no usurio NLCONNECT

SQL> conne nlconnect/nl@nlprod


CREATE SYNONYM ge_maquina FOR <USER>.GE_MAQUINA;
CREATE SYNONYM nl_utl_raw_sp FOR <USER>.NL_UTL_RAW_SP;
CREATE SYNONYM nl_mensagens FOR <USER>.NL_MENSAGENS;
CREATE SYNONYM nl_conexoes FOR <USER>.NL_CONEXOES;
CREATE SYNONYM ge_grupos_objetos FOR <USER>.GE_GRUPOS_OBJETOS;
Observao: nos comandos acima deve ser substitudo o <USER> pelo nome do usurio de
produo.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


2

Pgina 3 de 35

Configurar cone para acessar o programa de atualizao de pacotes

Target/Destino
C:\oracle\dev6i\BIN\ifrun60.EXE P1 P2
onde: p1=<local do nlgestao>\cs\cs_administracao
p2 =NLCONNECT/SENHA@HOST
Start in/Iniciar em:
<local do nlgestao>\principal
Algumas observaes:
- No necessrio criar vrios cones para acessar bases diferentes, por exemplo: base de teste, base de
produo
- Sugerimos que o <local do nlgestao> sempre aponte para a pasta de produo

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


3

Pgina 4 de 35

Acesso ao Administrador

Ao acessar o administrador (na primeira vez) ser necessrio rever/configurar as opes do cadastro de
mquinas e tambm criar as conexes para as bases de dados.

Sero exibidas as mensagens abaixo:

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 5 de 35

Inicialmente deve ser clicar no boto adicionar conexes:

O objetivo do cadastro de conexes informar os dados referentes ao acesso as diferentes bases disponveis.
Ao clicar no boto Adicionar conexo ser mostrada a tela abaixo:

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


4

Pgina 6 de 35

Configurar conexes

Adiciona
nova
conexo

Valida os
dados da
conexo

Nesta tela ser possvel configurar at 8 conexes para diversos usurios de banco de dados
Informao sobre os campos:
Conexo
Usurio
Senha
Host

= Nome da conexo, exemplo Base de produo


= Usurio para acesso a base
= Senha para acesso a base
= Host string para acesso a base ( cfe TNSNAMES)

Cada conexo criada ser listada no bloco abaixo

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 7 de 35

Para selecionar a conexo deve ser clicado no semforo da respectiva conexo.


Ao clicar, se o cadastro de mquinas ainda no foi configurado, ser mostrada a mensagem abaixo:

Configuraes do cadastro de mquina

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 8 de 35

O objetivo do cadastro de mquinas informar os parmetros necessrios para atualizao do sistema.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


5.1

Pgina 9 de 35

Detalhes dos campos

Mquina: o cdigo da mquina que identifica o ambiente do cliente. Normalmente o cdigo da


mquina zero, exceto em ambientes que utilizam replicao de dados. Nestes ambientes
cada unidade
deve possuir um cdigo distinto de mquina. Normalmente o cdigo da mquina
o mesmo da
unidade.
Empresa: Informar o cdigo que identifica a empresa do cliente.
Lngua: Informar o cdigo da lngua para exibir as mensagens de aviso durante a atualizao do
sistema.
Logo do Cliente : Neste parmetro pode ser informada a localizao do arquivo que contem o logo
do cliente. (obsoleto)
Cdigo do cliente na NL: Cada cliente possui um cdigo de identificao junto NL. Este cdigo
utilizado na atualizao do sistema para identificar o nome do arquivo de atualizao. Este
cdigo
determinado pela mscara 12 de pessoas. (Cadastro da NL).
Cdigo da unidade: O cdigo da unidade, como o prprio nome diz, determina o cdigo da
unidade da respectiva mquina. Est informao somente utilizada quando o cliente utiliza a
replicao de dados e tambm quando o cdigo da mquina no corresponde ao cdigo da
unidade.
URL: Url para atualizao das licenas de uso do sistema. https://nlservices.nl.com.br/NlServices
E-mail: Endereo de e-mail da(s) pessoa(s) responsveis pelo sistema. Esta conta de e-mail ser
utilizada para enviar avisos referentes as licenas de uso do NlGesto.
Licenas atualizadas: Data da ltima atualizao das licenas. Campo apenas informativo.
Dblink: Nome do Database Link utilizado para comunicao entre ambientes distintos. Este
parmetro utilizado em ambientes que possuem replicao de dados. A partir deste Dblink a
loja/unidade consegue "ler" informaes da matriz.
Serv Aplicao: Neste parmetro deve ser informado o nome do servidor de aplicao utilizado pelo
cliente para executar o NLWEB.
Sist Operacional: Este parmetro determina o sistema operacional da mquina utilizada para
executar a atualizao do sistema.

Patchs: No campo patchs deve ser informada a localizao dos arquivos de atualizao do
sistema. Os arquivos de atualizao do sistema so disponibilizados na rea de FTP da NL.
N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 10 de 35

Clicando-se no boto
mostrar os campos abaixo permitindo informar os dados da conexo FTP.
Solicitar ao suporte da NL os valores para cada um dos campos abaixo.

Sqlplus: No campo sqlplus deve ser informada a localizao do sqlplus. A partir do sqlplus so
executados os comandos responsveis pela atualizao da base de dados. recomendvel que o
sqlplus possua verso superior a 10. Para identificar a verso do sqlplus necessrio acess-lo e
clicar na opo Help (barra de ferramentas)

Ambiente de Produo

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 11 de 35

Usurio: informar o nome do usurio de banco de dados que identifica a base de produo
Senha: Informar a senha do usurio de banco de dados de produo. Est senha armazenada
criptografada.
Host: O host identifica as configuraes de conexo ao servidor onde esta instalado o banco de dados.
O host deve estar configurado no TNSNAMES da mquina utilizada para a atualizao do
sistema.
Instncia: Identifica o nome da instncia do banco de dados de produo. Este parmetro
opcional e normalmente configurado quando o cliente possui mais de um servidor de banco dados,
ou seja, um servidor de banco de dados especfico para o ambiente de produo e
outro especifico para
o ambiente de homologao/testes. Podemos identificar o nome da
instncia a partir do seguinte
comando: select instance_name from v$instance
Workspace: Nome que identifica a Workspace de produo utilizada para atualizao de
objetos
APEX. Normalmente o nome da Workspace de produo o mesmo nome do usurio de produo.
Usurio: Nome do usurio de banco de dados que identifica o dono dos objetos APEX. Normalmente
este usurio identificado pelo nome apex_040100;
Senha: Senha do usurio informado acima
URL APEX: A url apex identifica o local onde foi instalado o servidor HTTP responsvel por
responder as requisies dos processos/consultas desenvolvido em apex.
Ambiente de Homologao/Testes

Obs.: As descries dos campos acima so as mesmas citadas anteriormente, a particularidade que
aqui devem ser informados os valores referentes ao ambiente de homologao/testes.
Localizao dos grupos de objetos

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 12 de 35

Atualmente o NLGesto possui os seguintes tipos de objetos:


N&LGesto
N&LGesto
secundrio
NLWEB
EDServer7
PDV
ConsoleNFe
Rel Jasper/Helps
XML
Apex

Produo
X
X

Teste
X
X

Atualizao

X
X
X
X
X

...
...

Cada um dos grupos de objetos citados, possui uma localizao especfica no servidor do cliente. No
momento da atualizao do sistema os respectivos objetos so copiados para as respectivas pastas levando-se
em considerao a base que esta sendo atualizada(Produo ou Testes/Homologao).
De acordo com a tabela acima, o X representa o campo que precisa ser informado/configurado, exemplo:
O grupo de objetos NLGestao deve ser informado os campos referentes Produo e Teste
O grupo de objetos DaemonNL deve ser informafo o campo atualizao.
Obs.: Somente so atualizados os grupos de objetos que possuem o Box atualizar marcado.
Ao configurar o grupo de objetos NLWeb, deve ser informado o campo atualizao e em seguida clicar no
boto

e informar os campos abaixo:

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 13 de 35

Ao configurar o grupo de objetos DaemonNL, deve ser informado o campo atualizao e em seguida clicar no
boto

e informar os campos abaixo:

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


6

Pgina 14 de 35

Atualizao do sistema

O processo de atualizao do sistema consiste em aplicar no ambiente do cliente as implementaes


realizadas pela equipe de desenvolvimento da NL. Sugerimos que o cliente sempre tenha uma base de
Homologao para fazer uma bateria de testes antes de aplicar as alteraes no ambiente de produo:
O processo sempre vai exigir que as atualizaes inicialmente sejam aplicadas na base de
Homologao e posteriormente na base de produo.

Cada semforo representa uma


conexo. Para selecionar a base
clique no semforo

Ao executar o programa de Atualizao, sero mostradas as conexes disponveis. Para selecionar a conexo
deve ser selecionado o semforo correspondente.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 15 de 35

Para iniciar a atualizao clique


no boto Atualizar NlGesto

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 16 de 35

Permite Trocar Conexo

O Box ltima atualizao mostra informaes do ltimo pacote atualizado.


Clicando no boto
, o sistema verifica se existem atualizaes disponveis na rea de FTP da NL. Os
dados de acesso devem ser configurados no cadastro de mquina.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 17 de 35

Divulgao
Divulgao
Marca p/
p/ atualizar
atualizar
Marca

Iniciar
atualizao

Na tela acima, mostra a relao de pacotes disponveis para atualizao.


Ao lado de cada pacote, tem o boto

, nele mostra as informaes de cada pacote.

O check box determina se o pacote deve ou no ser atualizado.


Ao clicar no Boto Iniciar atualizao

, ser mostrada a mensagem abaixo

recomendvel que o processo de atualizao seja executado em um momento que os usurios no estejam
utilizando o sistema.
N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 18 de 35

Durante o processo de atualizao podem ocorrer algumas mensagens:

Ao clicar no boto repetir, o comando ser executado novamente,


Ao clicar no boto cancelar, ser mostrada a mensagem abaixo

Ao clicar Sim, permite verificar o Log do comando executado.

Nas mensagens acima recomendvel clicar:


Cs-00326 - Erro na validao do objeto
=> Cancelar
Cs-00321 - Verificar aquivo de log
=> Sim ou No
Cs-00327 - Continuar atualizao
=> Sim
Obs.: Todas as mensagens podem ser configuradas para no mostrar e continuar o processo de atualizao sem
confirmaes.
Ao concluir o processo de atualizao, se ocorreram alteraes em parmetros de sistema ser mostrada a tela
abaixo solicitando a confirmao dos parmetros

Alem da atualizaes no banco de dados, podem existir atualizaes no NLWEb, Daemons e PDV. Neste caso
ser mostrada a mensagem abaixo:

Para realizar as atualizaes necessrio clicar nos botes correspondentes:

Aps atualizar o sistema necessrio verificar se existem objetos invlidos:

OG
G
LL O
LlLog
LlLog

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 19 de 35

O Arquivo contendo o log dos objetos invlidos chama-se OBJETOS_INVALIDOS_<USER>.SQL.


Onde: <User> o nome da base de dados que esta sendo atualizada.
Este arquivo encontra-se na pasta de atualizao de pacotes definida no cadastro de mquina, campo
Patch's.
Enviar o respectivo arquivo para a equipe de atendimento da NL.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


7

Pgina 20 de 35

Log da Atualizao

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


8

Pgina 21 de 35

Liberar o sistema
Antes de Sair necessrio liberar o sistema

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9

Pgina 22 de 35

Atualizao do Sistema em Lojas com replicao de dados

O processo de atualizao do sistema em lojas que utilizam replicao de dados pode ser feito
conforme descrito acima, ou de forma automatizada. Abaixo ser descrito o processo automatizado.

Ao clicar no boto Gerencia lojas ser executado o programa gerencia lojas, a partir dele sero definidas as
configuraes do ambiente de loja e tambm o acompanhamentos dos processos de atualizao.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

9.1

Pgina 23 de 35

Configuraes

Atualizao automatizada das lojas?


Este box, quando marcado determina que a lojas sero atualizadas pelo processo automtico.
Escolher o momento da atualizao do PDV
Este box determina se todos os pdv's sero atualizados no momento da atualizao do sistema, ou se o
administrador responsvel pela atualizao ir determinar quais Pdv's sero atualizados.
Forma de envio de pacotes para as lojas
Esta opo identifica como os arquivos de atualizao do sistema sero enviados para as lojas. Quando
a opo escolhida for NLGesto, os arquivos sero copiados via FTP. Esta opo j esta implementada no
sistema. No outro caso, Opo Outra, no implementamos, apenas citaremos quais indicadores devem ser
atualizados para que o fluxo do processo siga normalmente.
Sistema operacional da loja
Esta opo identifica o sistema operacional do servidor de banco de dados da loja, que pode ser Linux
ou Windows. Esta opo importante para definir o script que ser responsvel pela atualizao automtica da
loja.
Usurio loja/filial
Nome do usurio para conexo no banco de dados da loja/unidade. necessrio que todas as
lojas/unidades tenham o mesmo nome de usurio, pois os scripts de atualizao so idnticos para todas as
lojas/unidades.
Localizao sqlplus
Neste parmetro deve ser informado o caminho no servidor da loja/unidade onde se encontra o sqlplus.
Localizao do pacotes nas lojas
Nestes parmetros devem ser informados os caminhos base onde se encontra o NLGesto nas
lojas/unidades.
Localizao destino dos grupos de objetos
Cada grupo de objeto do NLGestao possui uma localizao especfica.
A localizao destes grupos devem respeitar a localizao citada acima, ou seja, o grupos so subpastas
pertencentes a localizao base.
De acordo com a TELA acima, os grupos de objetos estaro localizados em:
Homologao
c:\teste\homologacao\nlgestao
c:\teste\homologacao\nlgestao\nlweb

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 24 de 35

Produo
c:\nlgestao\producao\nlgestao
c:\nlgestao\producao\nlgestao\nlweb
Importante: dentro dos caminhos base necessariamente deve ser criada uma pasta chamada patch.
Nesta pasta sero descompactados os arquivos de atualizao.
No sero informados os grupos de objetos no informados.
Requisito Importante:
No ambiente de homologao (loja/unidade) e em todas as lojas/unidades deve ser criado um database link
que aponte para o ambiente de produo. Este database link deve ser criado com as seguintes caracteristicas;
CREATE PUBLIC DATABASE LINK nome
CONNECT TO usuario IDENTIFIED BY senha
USING '(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = ???.???.???.???)(PORT = 1521))
(CONNECT_DATA =
(SID = ??? )))';

O objetivo deste database link permitir ler/gravar informaes na tabela rd_pacotes na base de
produo a partir das bases de homologao da loja/unidade, e tambm apenas ler informaes da tabela
ge_maquina.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.2

Pgina 25 de 35

Gerar Pacotes

O processo de gerar pacotes consiste em gerar um nico pacote a partir dos N pacotes atualizados na
base de Homologao da matriz (Escritrio central).
Requisitos: Atualizar os pacotes na base de homologao da matriz
Cada pacote atualizado na base de homologao da matriz, gera um registro na tabela rd_pacotes com
as seguintes caractersticas:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 0 => atualizado na base de homologao da Matriz
=0

De acordo com o exemplo acima, foram atualizados os pacotes 333 ao 337 na base de Homologao e ser
gerado o pacote 00001 para a loja de homologao.
Ao clicar no boto processar ser gerado o pacote NLGESTAO_LOJA_00001.ZIP. Este pacote gerado na
pasta Patchs definida no cadastro de mquinas. A partir deste momento liberado o copiar para
homologao.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.3

Pgina 26 de 35

Copiar para Homologao

O objetivo desta fase copiar o arquivo gerado para o ambiente de homologao.


Requisitos: Pacote de atualizao para a loja de homologao gerado, ou seja, os registros da tabela
rd_pacotes devem esta com as seguintes informaes:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 1 => atualizado na base de homologao da Matriz
= nmero do pacote gerado

Ao clicar no boto Sim, o pacote ser copiado para o servidor de FTP na pasta configurada no cadastro de
mquinas do RD (mquina 9999 campo diretrio de FTP).
Neste momento os registros da tabela rd_pacotes alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 2 => copiado p/ o FTP de homologao da loja
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.4

Pgina 27 de 35

Liberar Homologao

O objetivo desta fase liberar o processo de homologao da loja. Ou seja, o ambiente de


homologao da matriz foi atualizado e neste momento necessrio atualizar o ambiente de homologao da
loja/unidade.
Nesta fase, enquanto o semforo estiver amarelo, significa que a loja de homologao ainda no buscou o
arquivo na rea de FTP.
A loja busca o arquivo na rea de FTP a partir da execuo do script nl_busca_ftp_homol.sh (linux) ou
nl_busca_ftp.bat.
Observao: necessrio editar o arquivo para informar alguns parmetros especficos
A execuo pode ser feita de forma manual:
./nl_busca_ftp_homol.sh ou nl_busca_ftp.bat
ou atravs do agendamento via crontab no linux ou agendador de tarefas no windows. Neste momento o script
somente executa se o status da tabela rd_pacotes estiver com ind_status= 2
Aps a execuo do script os registros da tabela rd_pacotes sero alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 3 => Liberar a homologao
= nmero do pacote gerado

Neste momento a possvel liberar a Homologao

Ao clicar no boto Sim, a homologao esta liberada, os registros da tabela rd_pacotes alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 4 => Liberar a homologao
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.5

Pgina 28 de 35

Finalizar Homologao

O processo de finalizar homologao consiste em realizar os testes nos principais processos do


sistema.

Nesta fase, enquanto o semforo estiver amarelo, significa que a loja/unidade de homologao ainda no
realizou a atualizao do sistema. A atualizao do sistema na loja/unidade de homologao feita a partir da
execuo do script nl_atualiza_homol.sh (linux) ou nl_atualiza_loja.bat.
Observao: necessrio editar o arquivo para informar alguns parmetros especficos
A execuo pode ser feita de forma manual:
./nl_atualiza_homol.sh ou nl_atualiza_loja.bat
ou atravs do agendamento via crontab do linux ou agendador de tarefas do windows. O script somente
executa se o status da tabela rd_pacotes estiver com ind_status= 4
Aps a execuo do script os registros da tabela rd_pacotes alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 5 => Liberar a homologao
= nmero do pacote gerado

Quando o semforo estiver verde, possvel finalizar a homologao


Ao clicar no boto Sim, encerrada a fase de homologao. Neste momento os registros da tabela rd_pacotes
so alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 6 => Homologao finalizada
= nmero do pacote gerado

Ao clicar no boto LOG, possvel verificar o log da atualizao

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.6

Pgina 29 de 35

Liberar /Copiar para as lojas

Esta fase consiste em copiar o pacote gerado/homologado para que as lojas/unidades copiem o
respectivo pacote.
Requisitos: Pacote de atualizao para as lojas gerado e homologado ou seja, os registros da tabela
rd_pacotes devem esta com as seguintes informaes:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 6 => atualizado na base de homologao da Matriz
= nmero do pacote gerado

Ao clicar no boto Sim, o pacote ser copiado para o servidor de FTP na pasta configurada no cadastro de
mquinas do RD (mquina 9999 campo diretrio de FTP).
Neste momento os registros da tabela rd_pacotes alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 7 => copiado p/ o FTP das loja
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.7

Pgina 30 de 35

Liberar atualizao da Matriz(EC)

Esta fase consiste em liberar o processo de atualizao de pacotes na Matriz.


Requisitos: A liberao somente pode ser feita a partir do momento que todas as lojas copiarem o
pacote de atualizao. Enquanto isto no ocorrer o semforo estar amarelo. Neste momento se for clicado no
boto Liberar Atualizao EC ser mostrada a tela abaixo listando as lojas que ainda no copiaram o pacote de
atualizao.

As lojas copiam o pacote a partir da execuo do script nl_busca_ftp_loja.sh (linux) ou nl_busca_ftp.bat


A execuo pode ser feita de forma manual:
./nl_busca_ftp_loja.sh ou nl_busca_ftp.bat
ou atravs do agendamento via crontab no linux ou agendados de tarefas no windows. O script somente
executa se o status da tabela rd_pacotes estiver com ind_status= 7
Aps a execuo do script os registros da tabela rd_pacotes alterados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina na loja
= 8 => Copia para a loja
= nmero do pacote gerado

A partir do momento que todas as lojas copiaram o pacote de atualizao pode ser liberada a atualizao da
Matriz:

Aps clicar em Sim os registros da tabela rd_pacotes alterados para:


num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina na loja
= 9 => Copia para a loja
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.8

Pgina 31 de 35

Liberar atualizao lojas

A liberao da atualizao das lojas ocorre somente a partir do momento que a Matriz(EC) atualizou os
pacotes. Enquanto isto no ocorrer o semforo estar amarelo aguardando a atualizao

A partir do momento que a matriz atualizar os pacotes o mdulo de replicao de dados deixa de enviar os
arquivos para as lojas. Neste momento os registros da tabela rd_pacotes devem esta com as seguintes
informaoes:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 10 => atualizado na base de homologao da Matriz
= nmero do pacote gerado

Aps a atualizao da Matriz(Ec)


Acima mostra a relao das lojas/unidades. A partir deste momento pode ser liberada a atualizao. Pode ser
escolhida 1 ou N lojas/unidades, para isto necessrio selecionar a loja/unidade a partir do Box ao lado do
campo loja e clicar no boto Liberar.
Cada loja liberada os registros da tabela rd_pacotes devem esta com as seguintes informaes:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 11 => atualizado na base de homologao da Matriz
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes


9.9

Pgina 32 de 35

Atualizao das lojas

A partir do momento que a loja recebe a indicao que a atualizao esta liberada ocorre o processo de
atualizao.
O processo executado a partir do script nl_atualiza_loja.sh (linux) ou nl_atualiza_loja.bat (widows)
Observao: necessrio editar o arquivo para informar alguns parmetros especficos
A execuo pode ser feita de forma manual:
./nl_atualiza_loja.sh ou nl_atualiza_loja.bat
ou atravs do agendamento via crontab no linux ou agendador de tarefas do windows. O script somente
executa se o status da tabela rd_pacotes estiver com ind_status= 11
O script executa as seguintes funes:
Finaliza os processo pendentes
Retira o banco de dado do ar (shutdown)
Parar o listener
Subir o banco ( startup)
executar exportacoes/importacoes pendentes
parar o Jboss
atualizar sistema
compilar objetos invalidos
subir jboss
subir o listener
confirmar atualizao a loja ( mudar o status da rd_pacotes para 12)
Aps atualizar o sistema na loja os registros da tabela rd_pacotes sero modificados para:
num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 12 => atualizao na loja concluda
= nmero do pacote gerado

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 33 de 35

9.10 Liberar RD (Matriz => Loja)


A partir do momento que a Matriz(ec) inicia a atualizao o processo de exportao da matriz
desativado. A ativao do respectivo processo somente permitida quando a(s) loja(s) concluem a atualizao.
Para cada loja que efetuou a atualizao disponibilizada a opo para liberar o RD.

A clicar no boto liberar os registros da tabela rd_pacotes sero modificados para:


num_patch
cod_maquina
ind_status
num_patch_loja

= nmero do pacote atualizado


= cdigo da mquina da matriz
= 13 => atualizao concluda e rd liberado
= nmero do pacote gerado

9.11 Consulta atualizao


Mostra um resumo do processo de atualizao nas lojas.

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 34 de 35

10 Resumo do processo
A NL disponibiliza os pacotes de atualizao do sistema na rea de ftp de cada cliente. A partir do
programa de atualizao do sistema(cs_administracao), o cliente faz download dos pacotes disponveis para
atualizao.
A primeira etapa do processo consiste em fazer a atualizao do sistema no ambiente de Homologao
e tambm homologar com os usurios chave de cada departamento da empresa os processos crticos.
Os pacotes so atualizados de forma sequencial ascendente. No possvel "pular" sequencia de
pacotes.
Aps esta etapa, o processo de atualizao do sistema no ambiente de produo j pode ser executado.
Neste momento da atualizao recomendvel que os usurios no estejam utilizando o sistema.
De forma resumida, descrevemos acima o processo de atualizao do sistema, quando o cliente possui
a sua infraestrutura de informtica centrada em servidor de banco de dados.
Quando o cliente possui em sua infraestrutura unidades/lojas que no esto conectadas diretamente ao
servidor principal (matriz), a NL disponibiliza o mdulo de replicao de dados. Neste caso o processo de
atualizao do sistema ocorre da seguinte forma:
1. Download das atualizaes do sistema
2. Aplicar as atualizaes do sistema na base de homologao
3. Homologar com os usurios chave
4. Gerar/disponibilizar pacote de atualizao para a unidade de homologacao
5. Liberar atualizao da unidade de homologao
6. Homologar com usurios chave
7. Confirmar que a homologao foi realizada
8. Liberar copia do pacote gerado no item 4
9. Aguardar lojas copiarem o pacote
10. Ao final do item 9, quando todas lojas copiaram, atualizar base de produo
11. Liberar atualizao das lojas
12. Atualizao da loja ( processo automtico via agendamento)
13. Quando as lojas atualizaram o pacote liberar replicao de dados para as respectivas lojas

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br

Procedimento atualizao de pacotes

Pgina 35 de 35

N&L Informtica Ltda. Rua ngelo Michelin, 31 Bairro Universitrio Caxias do Sul - RS CEP: 95.041-050
Fone: +55 (54) 3290-2100 Fax: +55 (54) 3290-2188 - www.nl.com.br