Atualização do Produto

PIMS Cana
14/04/2014
 Procedimentos de Atualização do Produto PIMS Cana

Título do documento

Sumário

Sumário ...................................................................................................................................................................................2
1.1 Objetivo ...................................................................................................................................................... 3
2. Documentos ............................................................................................................................................... 3
2.1 Backup ....................................................................................................................................................... 3
2.2 Procedimento ............................................................................................................................................. 4
2.3 Acessar a mídia de versão ......................................................................................................................... 4
2.3.1 Leitura do documento de Implementação .................................................................................................. 4
2.3.2 Leitura do documento de Nota de Versão .................................................................................................. 5
2.3.3 Leitura do documento de Release Notes ................................................................................................... 5
2.3.4 Documento de Evidência de Testes ........................................................................................................... 5
2.4 Atualizar arquivos dos diretórios (Copiar/Descompactar arquivos) ............................................................ 5
2.5 Execução de Comandos SQL .................................................................................................................... 6
2.6 Importações de arquivos TXT .................................................................................................................... 7
2.7 Geração do processo de Verificação de BD e Execução dos Comandos SQL Gerados ........................... 7
2.8 Importação de Parâmetros ......................................................................................................................... 8
2.9 Importação de Controle de LOG de Ocorrências ....................................................................................... 8
2.10 Execução do comando SQL - Pos Atualização .......................................................................................... 8
2.11 Finalização da atualização e Liberação aos usuários ................................................................................ 8

2 Versão 1.0
 Procedimentos de Atualização do Produto PIMS Cana

1.1 Objetivo

Este documento tem como objetivo descrever o procedimento necessário para atualização de versão do produto PIMS Cana.
O procedimento está estruturado em tópicos que deverão ser seguidos na seqüência indicada para o sucesso da atualização.

Qualquer dúvida ou esclarecimento, poderá ser obtido com nosso suporte. Para isso, entre no portal da TOTVS
HTTP:\\suporte.totvs.com. Caso haja algum problema no acesso a essa ferramenta, entre contato pelo telefone (11) 4003 – 0015
ou via email para suporte@proxima.agr.br.

2. Documentos

A seguir estão apresentados os procedimentos para o processo de Atualização de Versão. A leitura inicial do documento é
indispensável para uma perfeita execução dos itens.

Importante destacar a leitura dos templates abaixo:

Documentos de Implementações: documentos em extensão .xlsx, onde contem todas as implementações

realizadas no pacote que está sendo atualizado.

Notas de Versão: documento em extensão .pdf com referências a parametrizações, configurações, alterações do
produto, informações complementares e indicações conceituais, com intuito de realizar o perfeito funcionamento do
sistema;

Release Notes: documentos em extensão .pdf que demonstram as implementações por

solicitações/chamados/cliente realizadas, juntamente com os parâmetros, mensagens, objetos, relatórios QRP e
instruções de banco de dados incluídos, alterados e excluídos.

Evidências de Testes: documentos em extensão .docx, na qual apresentam o passo a passo da realização do
Testes Funcional, referente a implementação da respectiva solicitação.

2.1 Backup

I. Da base de dados atual (Verificar com DBA);

Este procedimento deve obrigatoriamente ser realizado, pelo DBA responsável pela base de dados do cliente;

II. Exportar arquivos:

a. Parâmetros:
Acessar o aplicativo PAR_PIMS.exe / Processo / Exportação de parâmetro.

Esta funcionalidade criará arquivo(s) no diretório APP, conforme instancia(s) criadas para utilização na base do
cliente, com os seguintes nome(s): PARAM_INST1.txt, PARAM_INST2.txt, etc..., onde INST1 e INST2, são as
respectivas instancias que contem parâmetros.

Caso seja necessário regressar o backup para uma das instancias, é preciso alterar o nome do arquivo da
respectiva instancia, retirando o código da instancia, ou seja, deixando somente com o nome PARAM.txt, logo
efetuar a importação dos parâmetros no aplicativo PAR_PIMS – Parâmetros Gerais PIMSCS na instancia
referenciada.

Versão 1.0 3
 Procedimentos de Atualização do Produto PIMS Cana

Título do documento
b. Dicionário de Dados:
Acessar o aplicativo GUTILIT.exe / Dicionário de dados / Exportação de Dicionário de dados

Será gerado o arquivo DDADOS.txt.

c. Mensagens:
Acessar o aplicativo GUTILIT.exe / Mensagem / Exportação de Mensagem

Será gerado o arquivo MENSAGEM.txt.

d. Módulos, Aplicativos e Objetos:

Acessar o aplicativo GUTILIT.exe / Segurança / Exportação de Objetos

-> selecionar Módulos -> clicar no botão OK

-> selecionar Aplicativos - > clicar no botão OK
-> selecionar Objetos -> clicar no botão OK

Serão gerados os respectivos arquivos MODULOS.txt, APLICAT.txt e OBJETOS.txt.

e. Fazer cópia dos arquivos TXT gerados (diretório APP);

f. Fazer cópia do diretório EXE, arquivos *.EXE;
g. Fazer cópia do diretório QRP, arquivos *.QRP;
h. Fazer cópia do diretório INI, arquivos *.INI;

Observação: Para verificar qual o diretório que estão sendo gerados os arquivos de backup, basta acessar o
aplicativo GUTILIT – Gerenciador de Utilidades, menu: Parâmetros/Instâncias campos de Diretório APP, onde caso não
houver informação do endereço da pasta, será adotado pelo sistema a informação que estiver no menu
Parâmetros/Ambiente, campo Diretório APP. Com isso, haverá possibilidade de conferir se os arquivos gerados estão com
a data atual

2.2 Procedimento

Listar os atuais arquivos EXE para posterior conferência e comparação, pois no CD de versão haverão EXE’s que não são utilizados
em seu ambiente, sendo desnecessária atualização dos mesmos. Porém, caso haja algum executável que não conste na mídia de
versão, é necessário que solicite-o(s) através do e-mail expedicao@proxima.agr.br ou através da abertura de chamado via Portal
TOTVS indicado no item de Objetivo deste documento.

2.3 Acessar a mídia de versão

A mídia de versão é expedida ao cliente pelos correios, porém caso o mesmo necessite de urgência no recebimento, entre em
contato pelo e-mail expedicao@proxima.agr.br solicitando o pacote de atualização via FTP.

2.3.1 Leitura do documento de Implementação

IMPORTANTE: Leia os arquivos abaixo, localizados no Diretório “Implementação”:

Demonstrativo_Analítico_Solicitacoes.xlsx;

4 Versão 1.0
 Procedimentos de Atualização do Produto PIMS Cana

Demonstrativo_Sintetico_Solicitacoes.xlsx; - Cliente.rtf;

Estes arquivos contém as implementações, instruções, parâmetros, objetos e mensagens referentes à nova versão, onde é
importante seguir as instruções relacionadas. Cada atualização geral possui sua “Listagem de Implementações”. Caso não tenha
executado a(s) atualização(ões) anterior(es), leia também o(s) outro(s) arquivo(s) anterior(es) à esta atualização.

2.3.2 Leitura do documento de Nota de Versão

IMPORTANTE: Leia o arquivo abaixo, localizado no Diretório “Docs\Documentos das Notas de Versão\Notas_Versao”:

Notas de Versao – “versão”.rtf;

Este arquivo contém as instruções, das quais são publicadas em Notas de Versão, tratando-se de informações importantes para o
sucesso da atualização e um perfeito funcionamento do sistema.

2.3.3 Leitura do documento de Release Notes

IMPORTANTE: Leia os arquivos abaixo, localizados no Diretório “Release Notes”:

ReleaseNotes_”Versão”_Cliente.pdf;
ReleaseNotes_”Versão”_Solicitacoes.pdf

Este arquivo contém as instruções de banco de dados, parâmetros, objetos, mensagens e QRP por solicitações.

2.3.4 Documento de Evidência de Testes

IMPORTANTE: Os arquivos localizados no Diretório “Planos de Teste \ Versao”, contem as instruções para realizar os testes
funcionais das implementações realizadas na versão. Caso não tenha executado a(s) atualização(ões) anterior(es), leia também
o(s) outro(s) arquivo(s) anterior(es) à esta atualização, dos quais estão no diretório “Planos de Teste”.

Interessante que estes arquivos sejam disponibilizados para o usuário, com intuito de auxiliar na homologação da implementação
solicitada.

2.4 Atualizar arquivos dos diretórios (Copiar/Descompactar arquivos)

Copiar/Descompactar os arquivos (nos diretórios correspondentes do ambiente do PIMS):

Acessar o diretório APP da mídia de versão:

TXT.ZIP (descompactar no diretório APP do PIMS)
RES.ZIP (descompactar no diretório APP do PIMS)

Acessar o diretório QRP da mídia de versão:

QRP.ZIP (descompactar no diretório QRP do PIMS)

Versão 1.0 5
 Procedimentos de Atualização do Produto PIMS Cana

Título do documento
Observação: Os arquivos FORMULAS.ZIP, INT.ZIP, VERBAS.ZIP contidos no CD, NÃO serão atualizados. Somente
fazê-lo se houver menção específica da TOTVS.

Acessar o diretório EXE da mídia de versão:

Atualize os arquivos EXE conforme lista mencionada no item 2. Observar que poderão haver Executáveis com
data MAIOR que data do CD. Neste caso, manter o mais recente (data mais atual).

Acessar o diretório SCRIPTS da mídia de versão:

Atualize os arquivos do diretório “Scripts‟.

Acessar o diretório HELP da mídia de versão:

Atualize os arquivos do diretório “Help‟.

Acessar o diretório DEPLOY/ATUALIZAÇÃO/”Versão Correspondente” da mídia de versão:

Atualize os arquivos do diretório “Deploy‟.

2.5 Execução de Comandos SQL – Alter_ORA.sql

I. Executar o arquivo ALTER_ORA.sql para usuários Oracle, localizado no diretório “Scripts‟:

Conteúdo de ALTER_ORA: comandos complementares à execução do arquivo SCRIDDMM.SQL, para atualização da base
de dados. Cada instrução traz data de alteração, responsável e o comando.

As instruções são cumulativas e estão em ordem de data de alteração. Inicie a execução dos comandos do
ALTER_ORA a partir de uma data de alteração maior ou igual à data da versão utilizada antes desta atualização.

Cada versão está marcada pelos REMARK’s abaixo:

REMARK *** INÍCIO DAS MODIFICAÇÕES PARA VERSÃO DE “XXX” ***

REMARK *** FIM DAS MODIFICAÇÕES DA VERSÃO DE “XXX” ***

O arquivo ALTER está dividido por ano, portanto caso a versão anteriormente em uso possua data de outro ano,
inicie a execução dos comandos pelo arquivo ALTER_ORAaaaa.SQL;

Todas as alterações estão mencionadas no arquivo Demonstrativo_Analítico_Solicitacoes ou

Demonstrativo_Sintetico_Solicitacoes.

Execute um comando de cada vez.

Comando ADD: pode ser executado sem restrição. Observar que a coluna pode ter sido incluída quando da
execução do script gerado via Verificação de BD.
Comando MODIFY: antes de executar verifique se o tamanho atual da coluna não é menor que o desta
instrução.
Comando UPDATE: analisar antes da execução. Qualquer dúvida, entrar em contato com o suporte registrando
seu chamado no portal TOTVS HTTP:\\suporte.totvs.com ou pelo telefone (11) 4003 – 0015.

II. Executar diretamente no Banco de Dados do PIMS, o arquivo SCRIMMDD.sql gerado no processo do
passo 2.6.

6 Versão 1.0
 Procedimentos de Atualização do Produto PIMS Cana

III. Abrir o arquivo PIMSVIEW.SQL e executar os comandos SQL (comandos DROP e CREATE);

Clientes que possuem alguma View específica de integração, abrir e executar arquivo PIMSVIEW_xxx.SQL, onde xxx
refere-se ao sistema (por exemplo Oracle Applications xxx=ORAAPP).

2.6 Importações de arquivos TXT

Acessar o módulo Gerenciador de Utilidades (GUTILIT.exe), logo executar as importações na sequência abaixo:

Em “MENSAGENS -> Importação de Mensagens”, clicar no botão Ok

Em “SEGURANÇA -> Importação de Objetos”,

o Selecione a opção “Módulos” – clique no botão OK

o Selecione a opção “Aplicativos” – clique no botão OK
o Selecione a opção “Objetos” – clique no botão OK

OBS: Na atualização de versão GERAL, sendo um cliente BRASIL, marcar opção “Atualizar descrições”.

O sistema gera no diretório APP, o arquivo: SEC_MMDD.LOG contendo novos Módulos, Aplicativos e Objetos desta versão.
Utilize-o para identificar quais objetos foram incluídos e por conseqüência, devem ser atualizados no controle de segurança pela
opção “SEGURANÇA -> Geração/Cópia de Autoridades”.

Em “DICIONÁRIO DE DADOS -> Importação do Dicionário de Dados” – Atenção na opção “Apagar antes de importar”: caso se trate
de atualização geral de versões, clique em “Sim” para que a rotina delete o dicionário de dados atual integralmente e atualize o
dicionário com o novo DDADOS.TXT. Caso não seja atualização geral, clique na opção “Não”.

2.7 Geração do processo de Verificação de BD e Execução dos Comandos SQL Gerados

Em “DICIONÁRIO DE DADOS -> Verificação de BD”, clicar no botão Ok.

Funções desta rotina:

Compara a estrutura das tabelas do dicionário de dados (importado) com a estrutura das tabelas do banco de dados (valida
existência, tipo e tamanho das colunas, chaves primária e estrangeira, índices, colunas nulas/não nulas);

Verifica se há tabelas a serem incluídas na base.

Antes de executar, verifique se as configurações para este processo estão adequadamente parametrizadas na opção
“DICIONÁRIO DE DADOS -> Parâmetros”. Em caso de dúvidas quanto a estas configurações, consultar o suporte registrando seu
chamado no portal TOTVS HTTP:\\suporte.totvs.com ou pelo telefone (11) 4003 – 0015.

Será gerado no diretório APP, o arquivo SCRIMMDD.SQL (DD: dia e MM: mês), no qual deverá ser executado na base de dados
que está sendo atualizada.

Versão 1.0 7
 Procedimentos de Atualização do Produto PIMS Cana

Título do documento
2.8 Importação de Parâmetros

Acessar o módulo “Parâmetros PIMS”:

Executar a importação de parâmetros do sistema na opção “PROCESSOS -> Importação de Parâmetros”.

OBS: Marcar “Atualizar descrições = Sim”.

Após importar, verificar os parâmetros que foram incluídos, logo confirmar ou alterar seu valor está de acordo com a
configuração dos controles na empresa.
Para identificar quais foram incluídos, consultar o arquivo Demonstrativo_Analitico_Solicitacoes.xlsx ou Release Notes
“Versão” Solicitações.pdf ou o arquivo “ParsMMDD.log‟ (gerado no diretório APP durante a importação dos parâmetros) onde MMDD
refere-se ao mês e dia da importação dos parâmetros.
Os novos parâmetros são importados com seu valor “padrão”, ou seja, valor que não modifica os critérios de utilização do
sistema atuais. Caso seja necessário alterar os critérios de utilização, os valores dos parâmetros deverão serem ajustados.
Qualquer dúvida, entrar em contato com o suporte registrando seu chamado no portal TOTVS HTTP:\\suporte.totvs.com ou
pelo telefone (11) 4003 – 0015.

2.9 Importação de Controle de LOG de Ocorrências

Acessar o módulo Gerenciador de Log´s - LOGFILE.EXE:

Executar a importação de LOG de Ocorrências do sistema na opção “PROCESSOS -> Importação de Tabelas de
Processamento de LOG”.

2.10 Execução do comando SQL - Pos Atualização

Abrir o arquivo Pos_Atualizacao.sql (diretório Scripts) e executar os comandos SQL.

Cada instrução traz data de alteração, responsável e o comando.

a. As instruções são cumulativas e estão em ordem de data de alteração. Inicie a execução dos comandos do
Pos_Atualizacao a partir de uma data de alteração maior ou igual à data da versão utilizada antes desta
atualização;

Execute um comando de cada vez: analisar antes da execução. Qualquer dúvida, entrar em contato com o suporte registrando
seu chamado no portal TOTVS HTTP:\\suporte.totvs.com ou pelo telefone (11) 4003 – 0015.

2.11 Finalização da atualização e Liberação aos usuários

Verificar o funcionamento geral das aplicações e liberá-la para utilização.

8 Versão 1.0