mastersaf dw internos/aplica… · mastersaf dw procedimentos para aplicaÇÃo de patch ....

MASTERSAF DW

Versão do Documento: 13.0 Publicado em: 13/07/2020

PROCEDIMENTOS PARA APLICAÇÃO DE PATCH

MASTERSAF DW PROCEDIMENTOS PARA APLICAÇÃO DE PATCH

PROCEDIMENTOS PARA APLICAÇÃO DE PATCH – VERSÃO 14

Página 2 de 34

SUMÁRIO

PROCEDIMENTOS .................................................................................................................................3

CENÁRIOS DE EXCEÇÃO ................................................................................................................. 8

INFORMAÇÕES COMPLEMENTARES .......................................................................................... 10

TELAS COMPLEMENTARES .................................................................................................... 12

| SUPORTE TÉCNICO .......................................................................................................................... 34



Página 3 de 34

PROCEDIMENTOS

1. Para saber até qual patch semanal está aplicado na base, executar select abaixo:

select * from saf_controle_patch

where dsc_patch like 'V2%'

order by dsc_patch;

Obs.: Esse exemplo foi utilizado para o MasterSAF 2011.

2. Baixar o patch acumulativo disponível em:

Caminho de acesso: Contact Center - Cliente Patches. Posteriormente salvar em uma pasta.



Página 4 de 34

3. Descompactar arquivos em uma pasta:

4. Procedimento para atualização do Banco de Dados.

Para dar andamento ao processo de atualização do banco de dados, disponibilizamos duas

formas para iniciar o aplicativo que executa o Patch Acumulativo:

− ApplyPatchAcumulativo.bat: Este arquivo é um chamador para a versão java do atualizador.



Página 5 de 34

A aplicação abrirá a tela do menu principal para iniciar a aplicação do Patch Acumulativo:

Obs.: Incluída a opção para atualizar as tabelas fixas e tabelas acessórias a partir do pacote de

atualização.

− Ao clicar no menu “Atualizar Banco de dados”, aparecerá à tela abaixo:

− No campo Usuário deve ser inserido o usuário definido para aplicação.

− No campo senha deve ser inserida a senha do usuário mencionado acima.



Página 6 de 34

− Os campos “Servidor”, “Porta” e “SID ou Service_Name” podem ser obtidos com auxílio de

seu DBA e/ou utilizando o seguinte comando:

HOST: Servidor; PORT: Porta; SERVICE_NAME ou SID: Serviço.

Obs.: O default é “serviço”, mas mudando o flag no arquivo de controle pode-se utilizar SID, a

tendência é descontinuar SID.

Obs.: O Oracle Client deverá ser instalado obrigatoriamente na versão 32 bits e na modalidade

'Administrator' ou 'Runtime'.

O tipo de instalação 'Instant Client' não é suportado e poderá ocorrer erros no produto caso esta

modalidade de instalação seja utilizada.

Na tela de atualização foi incluído um check box, previamente selecionado, indicando sobre a

atualização automática de TFIX/TACES: “Deseja atualizar TFIX/TACES nessa etapa?”.

ATENÇÃO: A partir do patch 210 de 11/12/2018, quando da aplicação do patch pela primeira vez,

a importação de tabelas fixas passa a ser obrigatória e, mesmo desmarcando a pergunta, o

processo só será executado com este consentimento. Após a importação, havendo necessidade de

reaplicar o patch, este processo passa a ser opcional.

Obs.: No patch 232 de 15/10/2019 liberamos, juntamente com tabelas fixas, o processo de

importação automatizado de tabelas acessórias apenas para registros novos. No entanto,



Página 7 de 34

algumas tabelas acessórias continuam no processo padrão de importação a partir do módulo

Ferramentas., menu Tabela Interna > Importar > Tabelas Acessórias.



Página 8 de 34

CENÁRIOS DE EXCEÇÃO

1. O banco do cliente não está no patch corrente e o usuário desmarca o flag de atualização de

TFIX/TACES. Neste caso, ao clicar no botão APLICAR, o usuário irá receber a mensagem da

imagem:

− Se o usuário clicar em “YES (Sim)” o patch será aplicado e as TFIX/TACES são atualizadas;

− Se o usuário clicar em “NO (Não)” o mesmo será informado, via “PopUp” e mensagem no

arquivo de log, que a atualização do patch foi cancelada;

Alertamos que na aplicação do patch, este processo de atualização de tabelas fixas e tabelas

acessórias é obrigatório.



Página 9 de 34

...

*** Atualização de Patch Cancelada pelo Usuário em função da obrigatoriedade de atualização

de TFIX/TACES

...

2. O banco do cliente está no patch atual e o usuário deseja reaplicar o patch, nesse caso não há

obrigatoriedade de atualizar as TFIXs/TACES, a marcação do flag na tela é respeitada, uma vez

aplicado com sucesso não é necessário abrir chamado no Contact Center, pode utilizar o

MASTERSAF DW normalmente após atualizar os Executáveis:



Página 10 de 34

No arquivo de log fica documentado que o usuário desabilitou a atualização de TFIX/TACES:

...

*** Atualização de TFIX/TACES desabilitada pelo usuário

Para Patch aplicado com sucesso temos:

PatchApplyLogs.txt

0/08/2019 11:59 AM: ***

30/08/2019 11:59 AM: *** *********** Status Report:

30/08/2019 11:59 AM: *** ----------------------------------

30/08/2019 11:59 AM: *** *********** Banco de dados: OK

30/08/2019 11:59 AM: *** *********** Compilação: OK

30/08/2019 11:59 AM: *** *********** Tfixes: OK

30/08/2019 11:59 AM: *** ----------------------------------

30/08/2019 11:59 AM: *** Patch atualizado com sucesso. Banco de dados disponível para uso

após atualização dos Executáveis

PatchAtualizaTfix.txt

Importando o arquivo TFIX17 ou TACES

Processo: 5658551. Lidos: 11; inseridos: 0; alterados: 0; ignorados: 11; erros: 0

INFORMAÇÕES COMPLEMENTARES

1. Informações complementares a respeito da atualização de TFIX/TACES inseridas no arquivo de

log PatchAtualizaTfix.txt:

Importando o arquivo TFIX02






Arquivo não encontrado.



Página 11 de 34

2. Informações complementares a respeito dos objetos inválidos do no schema do produto

MastersadDw que não foram fornecidos pela Thomson Reuters, nesse caso esses objetos

inválidos não são de responsabilidade da Thomson Reuters, o Cliente não deve abrir chamado

no Contact Center para esse cenário.

Desconectado de Oracle Database 12c Enterprise Edition Release 12.2.0.1.0 - 64bit Production

05/11/2019 02:21 PM: *** Objetos inválidos que não pertencem ao produto MastersafDw.

05/11/2019 04:47 PM: *** *********** Status Report:

05/11/2019 04:47 PM: *** ----------------------------------

05/11/2019 04:47 PM: *** *********** Banco de dados : OK

05/11/2019 04:47 PM: *** *********** Banco de dados - Compilação: OK

05/11/2019 04:47 PM: *** *********** Tfixes : OK

05/11/2019 04:47 PM: *** Patch atualizado com sucesso. Banco de dados disponível para uso após

atualização dos Executáveis,

Objetos Inválidos não pertencem ao produto MastersafDW, favor não abrir chamado no Contact Center.



Página 12 de 34

TELAS COMPLEMENTARES

Tela processando a importação de tabelas fixas/TACES:

Tela informando que o patch foi aplicado com erro na importação de tabelas fixas/tabelas

acessórias:



Página 13 de 34

Tela informando que o processo de importação de TFIX/TACES foi concluído e o patch foi

aplicado com sucesso:

Os arquivos realçados em azul (PatchApplyLogs.txt, PatchAtualizaTfix.txt, patch.lst, erros.lst)

devem ser anexados no chamado para que, caso necessário, seja feita uma análise da execução

do Patch Acumulativo.



Página 14 de 34

3. Procedimento para atualização dos Executáveis e Help Online.

* Se a pasta não existir pular para o passo 6.

− No menu principal, ao clicar em “Atualiza Executáveis” aparecerá à tela abaixo:

−

− No campo Usuário deve ser inserido o usuário definido para aplicação.

− No campo senha deve ser inserida a senha do usuário mencionado acima.



Página 15 de 34

− Os campos “Servidor”, “Porta” e “SID ou SERVICE_NAME” podem ser obtidos com auxílio de

seu DBA.

Clicar no botão aplicar deve aparecer à tela abaixo para você selecionar o diretório destino:

4. Procedimento para atualização das Tabelas mastersafdw (TFIX/TACES/SAFX)

* Caso a pasta não exista, aplicação do patch finalizada.

** Caso exista a pasta CTL em Atualizacao, só deverá ser utilizada pelos clientes que utilizam SQL

LOADER. Para os clientes que não utilizam, pode desconsiderar.

Se existir a pasta CTL em Atualizacao,

só deverá ser utilizada pelos clientes

que utilizam SQL LOADER



Página 16 de 34

A importação das tabelas fixas/acessórias a partir do módulo Ferramentas passa a ser opcional,

pois as tabelas são importadas obrigatoriamente na atualização do patch, exceto algumas

tabelas acessórias que se mantiveram no processo padrão de importação através do menu

Tabelas Acessórias.

Acesse o módulo Ferramentas.

Se existir a pasta TXT em Atualizacao,

seguir os passos abaixo.

Acesse o menu para importar os arquivos TXTs das

tabelas fixas e tabelas acessórias.



Página 17 de 34

Informe o diretório onde os arquivos TXTs das tabelas fixas e

acessórias se encontram. Em seguida clique no botão « Importar »

Escolha o diretório Atualizacao.



Página 18 de 34

Obs.: Em caso de estouro de memória em processamento de importação de alguma tabela fixa,

pode haver a necessidade de ajustar os parâmetros de memória para a JVM (-Xms e -Xmx), no

arquivo “ImportaTfix.bat”, localizado junto com os executáveis, porém esse ajuste pode ocasionar

baixa performance no processamento. Exemplo:

java -XmsAAAM -XmxAAAAM -jar ImportaTfix.jar %1 %2 %3 %4 %5

Xms -> Alocação de memória inicial (AAA).

Xmx -> Alocação máxima de memória (AAAA).



Página 19 de 34

Acesse o menu para importar os arquivos TXTs de algumas tabelas

acessórias que não fazem parte do processo automatizado de

importação de tabelas fixas/acessórias.

Escolha o diretório Atualizacao.



Página 20 de 34

Selecione um arquivo e clique em Abrir.



Página 21 de 34

Obs.: Como as tabelas acessórias passaram a fazer parte do processo de importação

automatizado na atualização do patch, juntamente com as tabelas fixas, o sistema passa a

apresentar a mensagem acima das tabelas que não são mais importadas e libera o acesso à

algumas tabelas que ainda se mantém no processo padrão de importação.

Clique em Não para que sejam

recuperados todos os arquivos do

diretório.

Clique em Marcar Todos para importar

todos os arquivos em uma única vez.



Página 22 de 34

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.

Caso não saiba a data inicial do grupo, ver

páginas 20 e 21.


Exemplo do Estabelecimento 01, utilizado

para importação.



Página 23 de 34

Clique no botão para importar.



Página 24 de 34

Após concluir o processo deve-se verificar se o

Imp. Status está com OK para todos os arquivos.

Caso todos estejam com OK, ir para a tela com a

orientação “Acesse o menu Job Servidor”.

Caso não estejam, devem-se seguir os passos

abaixo.

Acesse o menu para verificar

o log.

Ao clicar sobre o Imp. Status ERR, aparecerá o

número do processo

Informe o número do processo em NUM PROCESSO

e clique em OK.



Página 25 de 34

Será aberto o log com o erro do processo

informado.

Deve-se acessar o menu para salvar o relatório em

formato (.psr).

Informe o nome da TFIX/TACES com erro e escolha a opção

em Salvar como Powersoft Report (.psr).



Página 26 de 34

Acesse o menu Job Servidor.

Acesse o menu para programar a

carga.

Clique em Novo Job e em

para localizar os arquivos que

serão importados.



Página 27 de 34

Selecione um arquivo e clique em OK.

Todos os arquivos do diretório serão

apresentados.

Selecione todos os arquivos e clique em

Adicionar Arquivos e no botão salvar ( ).



Página 28 de 34

Acesse o menu para executar a Programação.

Selecione o Job de Carga criado e clique em

executar.

Após ser exibida a mensagem de

Job de Carga Finalizado deve-se

realizar a importação.

Acesse o menu para Programar a Importação.



Página 29 de 34

Clique em Novo Job e depois em

Somente tabelas carregadas.

Selecione apenas as tabelas que

constam na pasta Base de

dados\TXT\Tbasicas, e clique em

Adicionar Arquivos.

Clique no botão Generalizar ( ).



Página 30 de 34

Na a janela aberta, em período a Data

Inicial deverá ser informada a data da

validade inicial do grupo do

estabelecimento.


*Se houver mais de um grupo, a

importação deverá ser feita novamente

com a Data Inicial do outro grupo.

Clique no botão Confirmar ( ).

Acesse o menu para executar a Programação da

Importação.



Página 31 de 34

Selecione o Job de Importação previamente

criado.

Clique em executar.

Após a importação será

apresentada a mensagem

demonstrando os números de

processos. Esses números devem

ser anotados.



Página 32 de 34

Analisar cada processo verificando se a coluna Status

está como OK.

Caso todos estejam com OK, prosseguir para a tela

com a orientação “Acessar o módulo Parâmetros”.

Caso apresente WAR ou ERR, todos os logs devem

ser enviados.

Acesse o menu para verificar a data de validade inicial do grupo.

Acessar o módulo Parâmetros.



Página 33 de 34

Clique no botão relatório ( ).

Informe 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.



Página 34 de 34

| SUPORTE TÉCNICO

Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa

equipe de Suporte Técnico pelo Telefone:

(11) 2159-0600 opção 1 (Atendimento das Soluções Fiscais).

Nosso horário de atendimento é de segunda à sexta-feira de 9h as 18h.

mastersaf dw internos/aplica… · mastersaf dw procedimentos para aplicaÇÃo de patch ....

Documents