MASTERSAF DW

MANUAL DE INSTALAÇÃO
MASTERSAF DW MANUAL DE INSTALAÇÃO

ÍNDICE

QUE VALORES [MASTERSAF DW] TRAZEM PARA VOCÊ?

INFORMAÇÕES IMPORTANTES ...................................................................................................................... 3

PROCEDIMENTOS PARA INSTALAÇÃO DA BASE DE DADOS ......................................................................5
CRIAÇÃO DE TABELAS, SEQUÊNCIAS, ÍNDICES E VISÕES .......................................................................5
CRIAÇÃO DOS PROCESSOS DE BASE ........................................................................................................5
ARQUIVOS DE SAÍDA (SPOOL) ....................................................................................................................6
PROCEDIMENTOS PARA VALIDAÇÃO DA BASE DE DADOS (OBRIGATÓRIO) ...........................................6
PROCEDIMENTOS DE INSTALAÇÃO DA PARTE CLIENTE - APLICAÇÃO.....................................................8
PRIMEIRO LOGIN PARA CADA CONEXÃO .....................................................................................................8
CONEXÃO DE BANCO DE DADOS ...............................................................................................................9
USUÁRIO .......................................................................................................................................................9
SENHA ...........................................................................................................................................................9
CRIAÇÃO DO ARQUIVO SAFDW.INI .......................................................................................................... 10
Obs.: Aconselhamos a mudança da senha após o primeiro acesso.CONFIGURAÇÃO DO POWERLOCK . 12
ATUALIZAÇÃO DE TABELAS FIXAS, BÁSICAS E ACESSÓRIAS................................................................... 15
DOCUMENTAÇÃO.......................................................................................................................................... 28
CARTA DE ATUALIZAÇÃO ......................................................................................................................... 28
HELP ON LINE ............................................................................................................................................ 28
USO DO MASTERSAF DW ............................................................................................................................. 28

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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 3.1.3.7.4 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: O Suporte Premier da Oracle para 10gR2 encerrou em dezembro de 2010 (Fonte:
http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf).
A versão do banco de dados Oracle suportada deve ser 11G Release 2 (64 bits), preferencialmente,
11.2.0.4.

Obs. 2: Ao fazer atualização de Release não deve ser aplicado nenhum Patch até que os DBAs da
MASTERSAF analisem os arquivos com extensão do tipo .LST e .MSF.

Obs. 3: O character set recomendado pela MASTERSAF é o WE8MSWIN1252. Não utilizar UTF8.

Obs. 4: A versão do MASTERSAF 2011 não é compatível com o sistema operacional Windows 2000.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Atenção: O esquema no qual os objetos do aplicativo MASTERSAF 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>
 GRANT READ ON DIRECTORY SYS.DATA_PUMP_DIR TO <MSAF>
 GRANT WRITE ON DIRECTORY SYS.DATA_PUMP_DIR TO <MSAF>
 GRANT EXECUTE ON SYS.DBMS_SCHEDULER TO <MSAF>
 GRANT CREATE JOB 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: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

PROCEDIMENTOS PARA INSTALAÇÃO DA BASE DE DADOS

Para instalar a base de dados é necessário:

 Nome e senha do usuário Oracle em que serão criados os objetos do aplicativo*.

 Nome da Tablespace de Dados e de índices a serem usadas pelo o aplicativo*.
 Usuário Oracle com direitos de Connect e Resource*.

* Desde o Release 27.0 o processo da Tablespace é solicitado automaticamente via script.

CRIAÇÃ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 Arquivo → Abrir, escolha o diretório: <Diretório de Destino Escolhido>\Mastersaf\Base de
Dados\Criacao>.

Selecione o script “msaf.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>@msaf.sql.

CRIAÇÃ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.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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 ou erros encontrados durante o processo.
Obs.: Caso seja necessário 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, bem como é preciso
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 aplicativo Java que necessita da instalação do Java Virtual
Machine (JVM) em sua máquina. Caso já tenha o JVM instalado em sua máquina, você pode chamar o
aplicativo diretamente. Por outro lado, caso não tenha o JVM instalado, ele pode instalado a partir do
utilitário “j2sdk-1_4_1_05-windows-i586.exe”, que está no diretório de utilitários.

 <Diretório de Destino Escolhido>\Base de Dados\Utilitários>.

Com o JVM corretamente instalado em seu computador, você deve executar o utilitário:

 <Diretório de Destino Escolhido>\Base de Dados\Utilitários\MSAFSCHEMADIFF_xx.exe>.

Atenção
É recomendável que a máquina em que este aplicativo é executado tenha no mínimo 2 GB de RAM.

Quando a janela principal aparecer, selecione a opção Arquivos → Comparar Base de Dados:

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃ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.

Em Esquema a comparar, informe os dados da conexão ao banco Oracle. Caso haja dúvida nos
valores a serem informados nessa tela, consulte o 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.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

O aplicativo irá 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, execute o script gerado para criar os objetos faltantes e repita esse
processo até que nenhum objeto esteja faltando, ou que os erros se tornem recorrentes. Nesse caso é
necessário enviar os arquivos gerados para o Suporte MASTERSAF.

* A opção “Gerar procedures e packages” não precisa ser selecionada. O script Criaproc já realizou esse
procedimento.

Depois da execução do script criado pelo Schemadiff deverá ser executado o script validar.sql, que
criará um arquivo chamado erros.lst.

PROCEDIMENTOS DE INSTALAÇÃO DA PARTE CLIENTE - APLICAÇÃO

Durante a execução do Setup, a parte Cliente do aplicativo já foi instalada. Se você desejar 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 MASTERSAF estão no diretório: “<Diretório de
Destino Escolhido>\Executáveis”.
Para executar o aplicativo basta chamar “<Diretório de Destino
Escolhido>\Executáveis\MANAGER.EXE”.

Para edição, criação e/ou alteração de conexões de Banco de Dados o usuário deve utilizar as
opções disponibilizadas na própria tela de login do sistema (Configurar a segurança desta
Conexão, Criar uma Nova Conexão, Editar esta Conexão).

PRIMEIRO LOGIN PARA CADA CONEXÃO

A escolha de qual Base de Dados (Conexão) será utilizada pelo usuário, acontecerá no momento
do login no aplicativo MASTERSAF, conforme a tela a seguir:

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

 Descrição dos campos:

CONEXÃO DE BANCO DE DADOS

Selecionar a conexão com o banco de dados que será utilizada para conectar-se ao aplicativo
MASTERSAF. Essas informações são obtidas por meio do arquivo de configuração do MASTERSAF
(SAFDW.INI).

USUÁRIO

Informar o usuário de conexão no aplicativo MASTERSAF. Esse usuário deve estar cadastrado no
módulo de Segurança (Powerlock) para a conexão selecionada.

SENHA

Informar a senha de acesso do usuário ao MASTERSAF. Essa senha inicialmente será fornecida pelo
administrador do sistema, que deverá gerar senhas para todos os usuários do aplicativo MASTERSAF,
utilizando o módulo de Segurança.
Ao preencher as informações e clicar em <OK> para realizar o login, o sistema verificará a existência da
conexão "Mastersaf Ativa", criada automaticamente no Powerlock para cada conexão selecionada. A

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

inexistência dessa conexão indica que esse banco está sendo acessado pela primeira vez, e por isso deve
ser devidamente tratado.

CRIAÇÃO DO ARQUIVO SAFDW.INI

Depois da instalação do aplicativo MASTERSAF, para utilização do sistema, ao clicar no executável

Manager.exe, o aplicativo MASTERSAF exibirá a seguinte mensagem:

 Clicando em Não, o sistema aborta o processo e na próxima tentativa de login exibirá a mesma
tela.
 Clicando em Sim, o sistema abrirá a tela de configuração do arquivo de conexão com a base de
dados:

 Nessa tela deve-se informar:

Conexão: Identificador da conexão do banco de dados. Nesse campo deverá ser descrito a
finalidade da conexão (por exemplo: Banco de Produção, Banco de Teste etc.).

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

DBMS: Indica o drive DBMS que deverá ser utilizado para a conexão com o banco de dados. Caso
seja escolhida a opção DBMS no tipo de conexão, estará disponível a opção de client do
Oracle (por exemplo: O84 oracle8).
Usuário Oracle: Indicar o nome do owner de conexão ao banco de dados do aplicativo
MASTERSAF.

Senha: Indicar a senha do owner de conexão ao banco de dados do MASTERSAF.

Servidor: Deverá ser informado o nome do servidor de banco de dados do aplicativo MASTERSAF.
Esse nome correspondente ao valor informado no arquivo TSNAMES.ORA do client.

Após o preenchimento dos dados é possível testar a conexão com o Banco de Dados, permitindo
que conexão com a base de dados seja testada antes da efetiva gravação da parametrização no
arquivo SAFDW.INI. Se for realizada com sucesso, o sistema retornará a mensagem Conexão
estabelecida com sucesso.

Obs.: Caso a conexão não seja estabelecida com sucesso, o sistema retornará à mensagem informando.
Contudo o aplicativo MASTERSAF faculta a opção de gravação dessa parametrização.
Para gravar a parametrização no arquivo de conexão (SAFDW.INI) deve-se clicar em Gravar, que o
sistema exibirá a mensagem mostrada abaixo.

Ao clicar em OK o sistema retornará para a tela de login, disponibilizando a conexão recém-cadastrada.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Depois de selecionar essa conexão, o administrador do sistema deve cadastrar os usuários do aplicativo
MASTERSAF que terão acesso ao mesmo, bem como as suas regras de utilização. Para tal, deve-se

acessar a opção Configurar a segurança desta Conexão ( ) na tela de login exibida

acima.
Ao clicar nessa opção o sistema abrirá a tela de login do módulo de Segurança (PowerLock).

 Para acesso ao módulo devem ser preenchidos os seguintes campos:

Login: admin
Password: powerlock.

Obs.: Aconselhamos a mudança da senha após o primeiro acesso.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

CONFIGURAÇÃO DO POWERLOCK

Para configurar a conexão, o usuário deve seguir os passos indicados abaixo:

 Ao clicar no botão Users ( ) será exibida a seguinte tela:

 Nessa tela deve-se informar:

 Login Name: Preencher com o login que será utilizado no aplicativo MASTERSAF.

 Password: Preencher com a senha que será utilizada pelo usuário acima.

 First Name: Informar o primeiro nome do usuário.

 Last Name: Informar o sobrenome do usuário.

 E-mail: Informar o e-mail do usuário.

 Status: Selecionar o status Active.

Lembre-se que os campos referidos acima são de preenchimento obrigatório. Depois de informar os
dados, clique no botão Save ( ) localizado no canto esquerdo da tela.
 Ao acionar o botão Profiles ( ) deve-se relacionar a conexão existente com o usuário criado
anteriormente.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

No quadro localizado do lado esquerdo da tela selecione a opção Users, e no quadro localizado do
lado direito selecione a opção Connections. Em seguida, Arraste a Conexão Mastersaf Ativa para o
usuário previamente criado.
Ainda nessa tela deve-se relacionar o usuário com os módulos que podem ser utilizados por ele.

Selecione novamente no quadro à esquerda a opção Users, e no quadro à direita selecione a opção
Applications.
No quadro localizado do lado direito, selecione agora os módulos que poderão ser utilizados por esse
usuário. Em seguida, arraste esses módulos para o usuário em questão (quadro do lado esquerdo da
tela).
Para excluir um módulo já relacionado a um usuário, arraste o módulo (lado esquerdo da tela) para
a lixeira localizada abaixo do quadro.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

ATUALIZAÇÃO DE TABELAS FIXAS, BÁSICAS E ACESSÓRIAS

Depois da instalação é necessário executar a importação das tabelas fixas, básicas e acessórias.
Esse procedimento é extremamente importante, pois atualizarão 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 utilizada pelos usuários que
utilizam SQL LOADER. Já os usuários que a não utilizam devem desconsiderá-la.

Acessar o módulo Ferramentas.

Acessar o menu para importar

os arquivos TXT.

Escolher o diretório.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Selecionar um arquivo e clicar em Abrir.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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.

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 26 e 27.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Exemplo do Estabelecimento 01
utilizado para importação.

Clicar no botão para importar.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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

seguinte (pág. 20).

Caso não esteja, deverá seguir os passos abaixo.

Ao clicar em Imp. Status ERR aparecerá o número do

processo.

Acessar o menu para verificar o log.

Informar o número do processo em

NUM_PROCESSO e clicar em OK.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Será aberto o log com o erro do processo informado.

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

em formato .psr.

Informar o nome da TFIX com erro e escolher a

opção em Salvar Como Powersoft Report (.psr).

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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.

Selecionar um arquivo e clicar em OK.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Selecionar todos os arquivos, clicar em

Adicionar Arquivos e no botão Salvar.

Acessar o menu para Executar a Programação.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Selecionar o Job de Carga criado

anteriormente e clicar em executar.

Após apresentar a mensagem “Job

de Carga Finalizado” deve-se fazer
a importação.

Acessar o menu para Programar a Importação.

Clicar em Novo Job e depois em

Somente tabelas carregadas.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Selecionar apenas as tabelas que constam

na pasta Base de dados\TXT\Tbasicas e
clicar em Adicionar Arquivos.

Clicar no botão Generalizar.

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.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Clicar no botão Salvar.

Acessar o menu para Executar a

Programação da Importação.

Selecionar o Job de Importação criado.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

Clicar em Executar.
Depois da importação será
apresentada a mensagem
informando os números de
processos. Esses números
deverão ser anotados...

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: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

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.

Versão: 11
MASTERSAF DW MANUAL DE INSTALAÇÃO

DOCUMENTAÇÃO

CARTA DE ATUALIZAÇÃO

A carta de atualização contemplando o escopo do Release MASTERSAF está disponível no

subdiretório Help_on_line\Carta atualização, abaixo do diretório dos executáveis do sistema, com a
nomenclatura AT_V2Rxx.0.html.

AT: Atualização de Release.

V2Rxx.0: Versão/Release do sistema (xx corresponde ao número do Release - por exemplo:
V2R01.0 seria Versão 2 do Release 01.0).

HELP ON LINE

Para acesso ao Help-on-line do aplicativo MASTERSAF deve-se copiar o arquivo Help.ini localizado no
diretório Mastersaf\INI\HELP para o mesmo diretório em que está localizado o SAFDW.INI

USO DO MASTERSAF DW

Realizados os procedimentos relatados nos itens anteriores, o aplicativo MASTERSAF foi instalado com
sucesso. Agora, para utilizá-lo, execute o arquivo <Diretório de Destino
Escolhido>\Executáveis\MANAGER.EXE>.

Para mais esclarecimentos entre em contato com Suporte Técnico MASTERSAF:

 Tel.: (11) 2159-0600
 Fax: (11) 2159-0582
 e-mail: mastersaf.suporte-dw@thomsonreuters.com

Versão: 11