MASTERSAF
DW
PONTOS DE ATENÇÃO PARA
CLIENTES ATÉ O PATCH 100
PONTOS DE ATENÇÃO ... 3 SUPORTE TÉCNICO ...8
PONTOS DE ATENÇÃO
Com a liberação do Patch Acumulativo 100 do MASTERSAF DW, em 7 de outubro de 2014, pensando na
melhoria do produto, finalizamos as seguintes adequações:
1. Alteração no service name para atender o Oracle Database 12c e Rac. 2. Bloqueio da aplicação do patch para clientes com Oracle 10g.
3. Ajuste no produto visando adequar o patch e os processos internos com três dígitos. 4. Envio de todos os executáveis no patch.
5. Reenvio de todas as TFIX, TACES e HELPs remetidos do kit de instalação ao 100.
6. Criação de um Kit de instalação do produto MASTERSAF DW atualizado até o Patch
Acumulativo 100.
Observação:
Com a liberação do Patch Acumulativo 101, em 21 de outubro de 2014, todos os clientes que estiverem
em patches anteriores ao Patch Acumulativo 100, e forem atualizar o MASTERSAF DW, deverão, por
OBRIGATORIEDADE, aplicar o Patch Acumulativo 100 ANTES de aplicar o pacote do Patch Acumulativo
101.
É importante reforçar que para aplicar qualquer patch posterior ao Patch Acumulativo 100 (por exemplo:
101, 102, 103 etc.), será OBRIGATÓRIA à aplicação do Patch Acumulativo 100. Por esse motivo estará
disponível no Contact Center o pacote do Patch Acumulativo 100 e o da versão quinzenal acumulativa
correspondente.
O Patch Acumulativo 100 só deve ser aplicado uma vez. Portanto NÃO é necessário aplicá-lo após cada
nova liberação de patch.
Nota 1: Informamos que desde 1º de janeiro de 2013 a Thomson Reuters - MASTERSAF deixou de prestar
suporte à versão Oracle Database 10g. Por essa razão recomendamos que se faça a migração dos
bancos de dados que hospedam o aplicativo MASTERSAF DW para Release 11.2.0.4 ou Oracle Database 12c Release 1).
Reiteramos o informe de que o prazo de vigência do Suporte Premium da Oracle para a versão 10R2 expirou em julho de 2010 e que o suporte à versão 11R1 findou em agosto de 2012. Portanto, da mesma forma, sugerimos a migração do Oracle Database 11g Release 1 para Release 11.2.0.4 ou uma versão
fazer a leitura deste documento antes de aplicar o patch.
Para dirimir eventuais dúvidas sobre a interrupção do suporte para versões inferiores à 11g da Oracle entre em contato com mastersaf.dba@thomsonreuters.com.
Nota 2:
Atenção: Alertamos a quem estiver com sua base de dados em um patch acumulativo ANTERIOR ao
Patch Acumulativo 95, que será necessário realizarem os procedimentos abaixo informados.
Durante a instalação do Patch Acumulativo 95, de 29 de julho de 2014, por meio da OS3743-R, foi criado um objeto no Banco de Dados fazendo referência a um “DIRECTORY” com nome "MSAFIMP". Caso o mesmo não exista, ou o usuário de Banco de Dados (o aplicador do patch) não tenha permissão para sua utilização (leitura e escrita), esse deverá ser criado e/ou executada a devida permissão ANTES da
aplicação do Patch Acumulativo 95.
Lembramos que a atualização do Patch Acumulativo 94 poderá ser executada normalmente, pois o procedimento acima se refere à atualização do Patch Acumulativo 95, que foi disponibilizado em 29 de julho de 2014
Obs.: Em caso de dúvida, solicite orientações ao seu DBA.
Atenção: Alertamos a quem estiver com sua base em um patch acumulativo ANTERIOR ao Patch
Acumulativo 65, que será necessário realizar também os procedimentos abaixo informados.
Durante a instalação do Patch Acumulativo 65, de 4 de junho de 2013, foi criado um objeto no Banco de Dados fazendo referência a um DIRECTORY padrão "DATA_PUMP_DIR".
Caso o mesmo não exista, ou o usuário de Banco de Dados (o aplicador do patch) não tenha permissão para sua utilização, deverá ser criado e/ou executada a devida permissão ANTES da aplicação do Patch
Acumulativo 65.
Também foi criada uma funcionalidade, que pesquisará no Banco de Dados Oracle se o componente
Java está instalado.
Para a instalação (obrigatória) desse componente é necessário abrir um chamado no site de suporte da Oracle, solicitando instruções para instalá-lo. Para verificar se esse componente já está instalado, basta executar a consulta abaixo com uma conta no Banco de Dados com perfil de DBA.
SELECT COMP_ID ,COMP_NAME ,VERSION ,MODIFIED ,STATUS FROM DBA_REGISTRY ORDER BY COMP_ID,COMP_NAME
Para compilar um Stored Procedure com conteúdo em Java, o Banco de Dados deve ter os componentes destacados abaixo em laranja instalados. Isso deve ser verificado ANTES da aplicação do Patch
Acumulativo 65. A instalação desses componentes pode ser demorada e requer "indisponibilidade" do
Banco de Dados em questão.
COMP_ID COMP_NAME VERSION MODIFIED STATUS
CATALOG Oracle Database Catalog Views 11.2.0.3.0 24-ABR-2013 18:01:49 VALID
CATJAVA Oracle Database Java Packages 11.2.0.3.0 24-ABR-2013 18:12:43 VALID
JAVAVM JServer JAVA Virtual Machine 11.2.0.3.0 24-ABR-2013 18:10:23 VALID
CATPROC Oracle Database Packages and Types 11.2.0.3.0 24-ABR-2013 18:01:49 VALID EM Oracle Enterprise Manager 11.2.0.3.0 26-ABR-2013 10:54:18 VALID EXF Oracle Expression Filter 11.2.0.3.0 24-ABR-2013 18:13:12 VALID ORDIM Oracle Multimedia 11.2.0.3.0 24-ABR-2013 18:32:16 VALID OWM Oracle Workspace Manager 11.2.0.3.0 24-ABR-2013 18:02:36 VALID RUL Oracle Rules Manager 11.2.0.3.0 24-ABR-2013 18:19:25 VALID XDB Oracle XML Database 11.2.0.3.0 24-ABR-2013 18:18:37 VALID XML Oracle XDK 11.2.0.3.0 24-ABR-2013 18:12:02 VALID Caso não tenha instalado, por meio da OS3888-A1, essa funcionalidade foi disponibilizada no módulo Gerenciador de ISS (Movimento Serviços Tomados Upload de NFS-e) do grupo Municipal, na tela Upload
de NFS-e na qual há uma pastinha ( ) para seleção de um arquivo e/ou digitação do nome do
arquivo desejado. Caso contrário, na tela Upload de NFS-e será disponibilizada uma lista de arquivos a serem selecionados para o upload.
Em caso de dúvidas, solicite orientações ao seu DBA.
Execute os GRANT’s abaixo antes de atualizar o Patch Acumulativo 36: 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>
GRANT READ ON DIRECTORY SYS.DATA_PUMP_DIR TO <MSAF> GRANT WRITE ON DIRECTORY SYS.DATA_PUMP_DIR TO <MSAF>
Obs.: O diretório “DATA_PUMP_DIR“ é utilizado para conter um “modelo” de tabela que servirá para a
carga de dados utilizando external tables. No programa é realizado um ALTER TABLE para o directory selecionado na hora do upload dos dados.
No directory DATA_PUMP_DIR apenas conterá a estrutura desta tabela que ocupará um espaço mínimo.
Execute os GRANT’s abaixo antes de atualizar o Patch Acumulativo 75: GRANT EXECUTE ON SYS.DBMS_SCHEDULER TO <MSAF>
GRANT CREATE JOB TO <MSAF>
Obs.: Rever os privilégios solicitados no Manual de Infraestrutura Básica (Infra.pdf) e atualização de
Release para o schema hospedeiro do MASTERSAF DW, conforme descrito abaixo: 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>
Nota 4: No Patch Acumulativo 70 foi criada uma chave estrangeira nas tabelas DWTs (Tabelas temporárias de processamento – Datamart) para a tabela x2002_plano_contas (Tabela do Plano de Contas). Portanto recomendamos fortemente a aplicação do Manual de Boas Práticas
(Boas_Praticas.pdf) antes de se aplicar o referido patch. Senão esse patch levará um tempo considerável
para ser aplicado.
Nota 5: Caso na importação dos arquivos XML da SEFAZ-AM no módulo DIA-AM ocorra o erro Oracle:
“ORA-31159”, favor executar o seguinte procedimento:
SQL> select comp_name from dba_registry where comp_name like '%XML%';
Obs.: Se nenhuma linha for retornada, será necessário instalar a “feature” Oracle XML Database e/ou
abrir um chamado na Oracle para solicitar instrução sobre sua instalação.
Nota 6: Antes de aplicar o Patch Acumulativo 53 (OS3746-B) é necessário executar o script
“SAF_VERIFICA_X116.sql” para detectar eventuais inconsistências na base entre os documentos fiscais referenciados (SAFX116 - Documentos Fiscais Referenciados) e o cadastro de pessoas físicas/jurídicas (SAFX04 - Arquivo de Cadastro de Pessoas Físicas/Jurídicas).
O resultado do script é uma relação dos registros de documentos fiscais referenciados com pessoas físicas/jurídicas inexistentes. Ou seja, que não constam no cadastro da SAFX04 (Arquivo de Cadastro de Pessoas Físicas/Jurídicas).
As inconsistências listadas devem ser resolvidas antes de se aplicar o Patch Acumulativo 53 (OS3746-B), que criou a chave estrangeira na tabela SAFX116 (Documentos Fiscais Referenciados), referenciando a SAFX04 (Arquivo de Cadastro de Pessoas Físicas/Jurídicas).
Usuários que utilizam essas tabelas e com problemas de inconsistências na base, se não rodarem o script “SAF_VERIFICA_X116.sql” antes de implementar a atualização do Patch Acumulativo 53, podem se deparar com problemas na execução do patch. Executar os procedimentos do arquivo:
Orientação para execução do script SAF_VERIFICA_X116.sql.
Nota 7: No Patch 36 foi disponibilizada nova versão do atualizador de Patch. Sugerimos a leitura do
manual de aplicação de Patch (Procedimento_Aplicacao_Patch_Acumulativo.zip) disponibilizado na
Base de Conhecimento e no Patch.
Nota 9: Antes de aplicar o Patch Acumulativo 17 (OS2949), os procedimentos referentes às divisões para armazenar informações sobre os processos dos módulos EFD - Escrituração Contábil Digital e EFD - Escrituração Fiscal Digital devem ser realizados pelo responsável pela área de TI, específico do aplicativo MASTERSAF DW, conforme descrito no arquivo-link que deve ser enviado a esse profissional, para que ele siga os devidos procedimentos.
Nota 10: Estimado usuário, caso esteja atualizando o Release, não se esqueça de copiar os
“executáveis” do Kit de Atualização do MASTERSAF DW e, sobretudo, de importar as tabelas fixas/acessórias (TFIXs/TACEs).
Tantos os “executáveis” do Patch Acumulativo, como as tabelas fixas/acessórias (TFIXs/TACEs), não abrangem os objetos do Kit de Atualização. Portanto os “executáveis” do Patch Acumulativo só devem ser copiados para o “Diretório” da aplicação após finalizar todo o processo de atualização do Release, sendo esse bem-sucedido.
Nota 11: O manual Plano de Ação - Boas Práticas (Boas_Praticas.pdf) para uso do MASTERSAF visa
fornecer ao usuário um roteiro simplificado, com informações sobre a limpeza das principais tabelas consideradas temporárias para geração dos processos do aplicativo MASTERSAF.
Nota 12: É aconselhável a leitura e consulta dos manuais do sistema disponibilizados no Contact Center
por meio do endereço:
www.mastersaf.com.br, acessando o menu: Base de Conhecimento Cliente > MASTERSAF DW > Manuais Técnicos.
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 MASTERSAF pelo Telefone:
(11) 2159-0600 opção 01 (Atendimento das Soluções Fiscais). Nosso horário de atendimento é de segunda à sexta-feira de 9h às 18h.
