PROCEDIMENTOS PARA ATUALIZAÇÃO DE VERSÃO DO APLICATIVO

Transcrição

1 PROCEDIMENTOS PARA ATUALIZAÇÃO DE VERSÃO DO APLICATIVO MASTERSAFDW VERSÃO 5-25/04/12 PÁGINA 1

2 Índice Informações Importantes... 3 Atualizando o aplicativo... 4 Procedimentos para atualização da base de dados... 4 Requisitos... 4 Atualização de tabelas, sequências, índices e visões... 4 Atualização dos processos de base... 5 Arquivos de saída (Spool)... 5 Procedimentos para validação da base de dados (obrigatório)... 5 Procedimentos de atualização da parte cliente - Aplicação... 7 Atualização de tabelas fixas, básicas e acessórias... 7 Utilizando o mastersafdw VERSÃO 5-25/04/12 PÁGINA 2

3 Informações Importantes A criação das tabelas de trabalho e procedures de importação podem ser feita por meio do SQL*Plus pelo DBA. O SQL*PLUS deverá estar na versão e/ou superior. Recomendamos que o valor mínimo para o parâmetro Memory_Target seja de 8 Gb (SGA_Target + PGA_Aggregate_Target). Obs. 1: Desde 1 de janeiro de 2011 deixamos de prestar suporte para ambientes com banco de dados (BD) Oracle 7.x, 8.x, 9.x e 10G 32 bits Server. O Suporte Premier da Oracle para 10gR2 encerrou no segundo semestre de 2010 (Fonte: A versão do banco de dados Oracle suportada deve ser 10G Release 2 (64 bits) e 11G Release 2 (64 bits). Obs. 2: Ao fazer atualização de Release não deve ser aplicado nenhum Patch Semanal até que os DBAs da Mastersaf analisem os arquivos com extensão do tipo.lst e.msf. Ob. 3: Para fazer upgrade do Release mastersafdw não é necessário aplicar todos os patches semanais do Release em que o cliente se encontra. Por exemplo: se o cliente aplicou até o Patch Semanal 20 do Release 37.0, ele pode atualizar direto para o Release mastersafdw. Atenção O esquema no qual os objetos do mastersafdw serão armazenados deverá ter os seguintes privilégios: GRANT EXECUTE ON SYS.DBMS_PIPE TO <MSAF> GRANT SELECT ON SYS.V_$INSTANCE TO <MSAF> GRANT SELECT ON SYS.V_$VERSION TO <MSAF> GRANT CONNECT TO <MSAF> GRANT RESOURCE TO <MSAF> GRANT CREATE TABLE TO <MSAF> GRANT CREATE VIEW TO <MSAF> GRANT CREATE SEQUENCE TO <MSAF> GRANT CREATE TYPE TO <MSAF> GRANT SELECT ON SYS.V_$DATABASE TO <MSAF> GRANT SELECT ON SYS.NLS_DATABASE_PARAMETERS TO <MSAF> GRANT SELECT ON SYS.V_$PROCESS TO <MSAF> GRANT ALTER SESSION TO <MSAF> Obs.: Devido à execução dinâmica, via procedure, o banco de dados Oracle exige que os GRANTs dos itens 6, 7 e 8 sejam concedidos explicitamente, não sendo suficiente o GRANT concedido no item 5. VERSÃO 5-25/04/12 PÁGINA 3

4 ATUALIZANDO O APLICATIVO Para atualizar o aplicativo mastersafdw, inicialmente, deve-se realizar o download do kit do Release (arquivo compactado no formato zip) no Contact Center por meio da opção Atualização de Versão. Em seguida, esse arquivo compactado zip deve ser descompactado. A estrutura de pastas do kit do Release após a descompactação apresentará na pasta Diretório de Destino Escolhido os seguintes itens: Base de dados. Documentos. Executáveis. Manuais: Installation_Manual.pdf. Manual_de_Atualizacao.pdf. Manual_de_Instalacao.pdf. Update_Manual.pdf. PROCEDIMENTOS PARA ATUALIZAÇÃO DA BASE DE DADOS Requisitos Nome e senha do usuário Oracle em que serão criados os objetos do aplicativo. Nome da Tablespace de Índices a ser usada para os índices do aplicativo. *A partir do Release 27.0 o processo da Tablespace será solicitado automaticamente via script. Atualização de tabelas, sequências, índices e visões Execute o SQL*Plus conectando-se ao banco Oracle com o usuário definido para a aplicação. Selecione o Arquivo Abrir, escolha o diretório: <Diretório de Destino Escolhido>\Mastersaf\Base de Dados\Atualização>. Selecione o script msafupdate.sql. Importante Como o SQL*Plus não está no diretório corrente da instalação, é natural que seja apresentada a mensagem: Comando GET inválido favor execute manualmente o procedimento: SQL>@msafupdate.sql. VERSÃO 5-25/04/12 PÁGINA 4

5 Atualização dos processos de base Com o SQL*Plus conectado no procedimento anterior, selecione o Arquivo->Abrir, escolha o diretório: <Diretório de Destino Escolhido>\Mastersaf\Base de Dados\processos>. Selecione o script criaproc.sql. Importante Como o SQL*Plus não está no diretório corrente da instalação, é natural que apareça a mensagem: Comando GET inválido favor execute manualmente o procedimento: SQL>@criaproc.sql. Arquivos de saída (Spool) As execuções dos scripts geram arquivos de saída (spool) com o nome do script executado e extensão lst. Esses arquivos de saída garantem a execução dos scripts e armazenam as informações de sucesso e/ou erros encontrados durante o processo. Em se tratando de atualização de versão é gerado um arquivo de saída de saída para cada versão atualizada. Obs.: Caso haja necessidade de entrar em contato com o suporte da Mastersaf, esses arquivos são necessários para o diagnóstico. PROCEDIMENTOS PARA VALIDAÇÃO DA BASE DE DADOS (OBRIGATÓRIO) É necessário verificar se todos os objetos do Oracle foram corretamente criados. Além disso, deve-se rodar um aplicativo que comparará a base de dados criada com uma imagem da versão liberada. O aplicativo que faz essa verificação é um Java o qual necessita da instalação do Java Virtual Machine (JVM) em sua máquina. Se o usuário já tem o JVM instalado na máquina, ele pode chamar o aplicativo diretamente. Contudo, caso o usuário não tenha o JVM instalado, ele pode instalá-lo a partir do utilitário jdk-1_5_0_19-windows-i586-p.exe, que está disponível no diretório de Utilitários: <Diretório de Destino Escolhido>\Base de Dados\Utilitários>. Com a JVM corretamente instalada no computador, o usuário deve executar o utilitário: MsafSchemaDiff_XX.exe na pasta: <Diretório de Destino Escolhido>\Base de Dados\Utilitários. Há uma nova funcionalidade no SchemaDiff. Portanto, para refletir essa funcionalidade, o nome do executável foi VERSÃO 5-25/04/12 PÁGINA 5

6 alterado para MsafSchemaDiff_XX.exe. Nessa versão o script de comparação é salvo com a extensão.msf, e na atualização o cliente não deve mais executar diretamente o script na base. Para a conferência desse arquivo é necessário abrir chamado no Atendimento a Clientes. Se necessário, no chamado serão enviados os comandos essenciais para a execução. Na tela de comparação selecione como esquema base a opção Arquivo e verifique se o arquivo de imagem extensão DBI fornecido nessa versão está de acordo com o do Setup. Extensão DBI Em Esquema a comparar informe os dados da conexão ao banco Oracle. Se você tiver dúvida nos valores a serem informados nesta tela, consulte seu DBA (Administrador do Banco de Dados). Ao iniciar a comparação ele lhe perguntará o nome do script que será gerado, para corrigir as diferenças encontradas. O aplicativo verificará todos os objetos e apontará todos que estão faltando. Se a instalação ocorreu sem nenhum problema, nenhuma diferença deve ser detectada. Caso exista alguma diferença, é necessário enviar os arquivos gerados para o Suporte MasterSAF. VERSÃO 5-25/04/12 PÁGINA 6

7 Atenção É recomendável que a máquina em que este aplicativo é executado tenha no mínimo 2 GB de RAM. PROCEDIMENTOS DE ATUALIZAÇÃO DA PARTE CLIENTE - APLICAÇÃO Para atualizar a aplicação do aplicativo mastersafdw é necessário substituir a pasta Executáveis do sistema pela pasta atualizada de executáveis disponibilizada no Setup: <Diretório de Destino Escolhido>\Base de Dados\executaveis. Caso pretenda instalar os executáveis em outro diretório, basta copiar todo o conteúdo do diretório executáveis para o diretório desejado. Todos os arquivos executáveis do aplicativo mastersafdw estão no diretório: <Diretório de Destino Escolhido>\Executaveis Para executar o aplicativo basta chamar: <Diretório de Destino Escolhido>\Executaveis\MANAGER.EXE. ATUALIZAÇÃO DE TABELAS FIXAS, BÁSICAS E ACESSÓRIAS Depois da atualização é necessário executar a importação das tabelas fixas, básicas e acessórias. Esse procedimento é extremamente importante, pois atualizará leiautes, cadastros etc. Devem ser carregados todos os arquivos da pasta Base de dados\txt da versão corrente. Obs.: Caso exista a pasta CTL em Base de Dados, essa só deve ser usada pelos usuários que utilizam SQL LOADER. Já os usuários que a não utilizam devem desconsiderá-la. Acessar o módulo Ferramentas. VERSÃO 5-25/04/12 PÁGINA 7

8 Acessar o menu para importar os arquivos TXT. Escolher o diretório. VERSÃO 5-25/04/12 PÁGINA 8

9 Selecionar um arquivo e clicar em Abrir. Clicar em Não para que sejam recuperados todos os arquivos do diretório. Clicar em Marcar Todos para importar todos os arquivos em uma única vez. VERSÃO 5-25/04/12 PÁGINA 9

10 Caso não saiba a data inicial do grupo, ver página 20 e 20. Caso seja aberta a janela ao lado, para a Data Inicial deverá ser informada a data da validade inicial do grupo do estabelecimento. A Data Final deverá ser o dia atual. * Se houver mais de um grupo, a importação deverá ser feita novamente com a Data Inicial do outro grupo. A Data Final deverá ser o dia atual. Exemplo do Estabelecimento 01 utilizado para importação. Clicar no botão para Importar. VERSÃO 5-25/04/12 PÁGINA 10

11 Concluído o processo, deve-se verificar se o Imp. Status está com OK para todos os arquivos. Caso todos estejam OK, pular para o passo 6.2. Caso não esteja, deverá seguir os passos abaixo. Ao clicar sobre o Imp. Status ERR, aparecerá o número do processo. Acessar o menu para verificar o log. VERSÃO 5-25/04/12 PÁGINA 11

12 Informar o número do processo em NUM_PROCESSO e clicar em OK. Será aberto o log com o erro do processo informado. Deve-se acessar o menu para salvar o relatório em formato.psr. VERSÃO 5-25/04/12 PÁGINA 12

13 Informar o nome da TFIX com erro e escolher a opção em Salvar Como Powersoft Report (.psr). Acessar o menu Job Servidor. Acessar o menu para programar a carga. Clicar em Novo Job. E em para localizar os arquivos a serem importados. VERSÃO 5-25/04/12 PÁGINA 13

14 Selecionar um arquivo e clicar em OK. Todos os arquivos do diretório serão apresentados. Selecionar todos os arquivos, clicar em Adicionar Arquivos e no botão Salvar. VERSÃO 5-25/04/12 PÁGINA 14

15 Acessar o menu para Executar a Programação. Selecionar o Job de Carga criado anteriormente e clicar em executar. Após apresentar a mensagem de Job de Carga Finalizado, deve-se fazer a importação. Acessar o menu para Programar a Importação. VERSÃO 5-25/04/12 PÁGINA 15

16 Clicar em Novo Job e depois em Somente tabelas carregadas. Selecionar apenas as tabelas que constam na pasta Base de dados\txt\tbasicas e clicar em Adicionar Arquivos. Clicar no botão Generalizar. VERSÃO 5-25/04/12 PÁGINA 16

17 Na janela aberta no campo Período, como Data Inicial, deve ser informada a data da validade inicial do grupo do estabelecimento. A Data Final deverá ser o dia atual. *Se houver mais de um grupo, a importação deverá ser feita novamente com a Data Inicial do outro grupo. Clicar no botão Salvar. Acessar o menu para Executar a Programação da Importação. VERSÃO 5-25/04/12 PÁGINA 17

18 Selecionar o Job de Importação já criado. Clicar em Executar. Depois da importação será apresentada a mensagem informando os números de processos. Esses números deverão ser anotados. VERSÃO 5-25/04/12 PÁGINA 18

19 Para serem analisados para cada processo se na coluna Status consta OK. Caso apresente WAR ou ERR, deverão ser enviados todos os logs. Acessar o módulo Parâmetros. Acessar o menu para verificar a data de validade inicial do grupo. VERSÃO 5-25/04/12 PÁGINA 19

20 Clicar no botão Relatório. Informar o estabelecimento em COD_ESTAB. Nesse caso para o Estabelecimento 01 existem dois grupos. Grupo 01, com Data Inicial de Validade 01/01/1990. Grupo 02, com Data Inicial de Validade 01/06/2003. UTILIZANDO O MASTERSAFDW Realizados os procedimentos relatados nos itens anteriores, o aplicativo mastersafdw foi atualizado com sucesso. Agora, para utilizá-lo, execute o arquivo <Diretório de Destino Escolhido>\Executáveis\MANAGER.EXE>. VERSÃO 5-25/04/12 PÁGINA 20

21 Para mais esclarecimentos entre em contato com Suporte Técnico MasterSAF: Tel.: (11) Fax: (11) VERSÃO 5-25/04/12 PÁGINA 21