Você está na página 1de 53

MASTERSAF GF

MANUAL DE INSTALAÇÃO
MASTERSAF GF MANUAL DE INSTALAÇÃO

SUMÁRIO

OBJETIVO........................................................................................................................................................... 3
INFORMAÇÕES INICIAIS .................................................................................................................................. 3
USUÁRIOS MASTERSAF GF ............................................................................................................................. 3
PRÉ-REQUISITOS PARA INSTALAÇÃO ...........................................................................................................4
INSTALAÇÃO .....................................................................................................................................................8
EXECUÇÃO DO SETUP DE INSTALAÇÃO........................................................................................................8
NOVA INSTALAÇÃO ................................................................................................................................. 10
CRIAÇÃO DAS ESTRUTURAS DE DADOS AUTOMÁTICA ....................................................................... 13
CRIAÇÃO DAS ESTRUTURAS DE DADOS MANUAL ............................................................................... 18
CRIAÇÃO DE TABELAS NO BANCO DE DADOS............................................................................................ 19
CRIAÇÃO DE ESTRUTURAS DE CONSULTA................................................................................................ 20
CONFIGURAR MÁQUINA CLIENTE ......................................................................................................... 20
CONFIGURAÇÃO ..........................................................................................................................................23
IMPORTAÇÃO DAS TABELAS PADRÃO ................................................................................................... 24
APÊNDICES .................................................................................................................................................... 26
MONITOR MASTERSAF GF – REINF E AGENDAMENTO DE PROCESSOS .................................................. 26
INSTALAÇÃO .......................................................................................................................................... 26
TEMPO DE VERIFICAÇÃO ...................................................................................................................... 26
DESINSTALAÇÃO .................................................................................................................................... 27
INSTALAÇÃO DO APPLICATION SERVER MASTERSAF GF EM SERVIDORES WINDOWS ........................... 27
PRÉ-REQUISITOS .................................................................................................................................... 27
ESQUEMAS ............................................................................................................................................. 29
MODELOS DE INSTALAÇÃO DE APPLICATION SERVER E SEUS COMPONENTES .......................... 29
ACESSOS E TRÂNSITO DE INFORMAÇÕES ......................................................................................... 30
CRIAÇÃO DO SERVIÇO (UNIFACE UROUTER).............................................................................................. 31
ALTERAÇÕES NOS ARQUIVOS DE CONFIGURAÇÃO DO SISTEMA MASTERSAF GF .................................. 31
SERVIDOR DA INSTALAÇÃO CLIENTE ..................................................................................................32
SERVIDOR DO APPLICATION SERVER ................................................................................................. 40
COMANDO PATHSCRAMBLER (PARA CRIPTOGRAFAR INFORMAÇÕES DE ACESSO) ................... 52
SUPORTE TÉCNICO ..........................................................................................................................................53

Versão: 9 2
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

OBJETIVO

Este documento tem como objetivo descrever um roteiro operacional com os passos necessários para
execução do instalador do produto MASTERSAF GF a partir do Patch 37 da versão 2.3.0.

INFORMAÇÕES INICIAIS

O MASTERSAF GF é o aplicativo sucessor ao GF Alliance versão 2.2.0. Clientes licenciados para o GF


Alliance 2.2.0 podem efetuar a mudança para o MASTERSAF GF imediatamente e atualizá-lo para a
versão 2.3.0.

Favor ler atentamente este manual, com informações pormenorizadas do processo de instalação do
MASTERSAF GF, antes de abrir chamado no Contact Center.

Recomendamos que os procedimentos de atualização de Patch Acumulativo sejam realizados por um


DBA.

USUÁRIOS MASTERSAF GF

Os usuários que já possuem o MASTERSAF GF instalado devem utilizar os procedimentos descritos no


manual de atualização “MastersafGF_Manual_Atualizacao.pdf” para efetuar a atualização do aplicativo
e do Banco de Dados.

Os novos usuários que não possuem nenhuma instalação do MASTERSAF GF devem seguir os
procedimentos descritos neste manual, onde estão disponíveis os procedimentos para efetuar a
instalação do aplicativo e criação das tabelas no Banco de Dados.

Versão: 9 3
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

PRÉ-REQUISITOS PARA INSTALAÇÃO

Antes de iniciar a instalação, certifique-se que possui os itens abaixo relacionados:

 MANUAL DE INFRAESTRUTURA DO SISTEMA MASTERSAF GF

Aconselhamos a leitura do manual de infraestrutura “MastersafGF_Infraestrutura.pdf” antes de


executar os procedimentos de instalação. Caso não o possua, faça o download dos manuais do
produto através do site www.mastersaf.com.br.
Na página “Meus Serviços”, clique no link “Base de Conhecimento Cliente” e acesse o menu
MASTERSAF GF > Manuais Técnicos.

 SETUP DE INSTALAÇÃO

O Setup de instalação do software MASTERSAF GF 2.3.0 está disponível no Contact Center, através
do site www.mastersaf.com.br. Para download, execute os passos a seguir:

ATENÇÃO: É mandatória a utilização do browser Internet Explorer para realizar esses


procedimentos.

Selecione a opção SUPORTE na página principal do site da MASTERSAF:

Versão: 9 4
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Acesse através da opção Contac Center:

Digite nos campos solicitados o nome do seu usuário e senha e clique em Entrar:

Os passos a seguir descrevem o procedimento de visualização do informativo e download do pacote do


MASTERSAF GF:

O pacote do produto está disponível na área restrita do Contact Center, através do link “Atualização de
Versão/Patches – Mastersaf GF”:

Menu: Meus Serviços > Atualização de Versão/Patches – Mastersaf GF

Versão: 9 5
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Faça o download do pacote de instalação/atualização do produto MASTERSAF GF para o seu


computador, clicando no link correspondente:

Aba Atualização de Versão > GF, para baixar o pacote completo.

Ao clicar no menu, será possível visualizar as seguintes opções:

“Ver DOC”: Informativo para usuários. Aconselhamos a leitura antes de utilizar o produto.
“Baixar”: Download do produto.

Versão: 9 6
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Após Visualizar e ler o informativo orientando sobre as atualizações disponibilizadas no pacote realize o
download (baixar) do arquivo “GF_V2.3.0.zip”.

Em caso de dúvidas, aconselhamos a leitura dos manuais disponibilizados no pacote e na Base de


Conhecimento.

Faça o download acessando o menu: “Meus Serviços”, clique no link “Base de Conhecimento Cliente”
e acesse o menu MASTERSAF GF > Manuais Técnicos.

 USUÁRIO DO SISTEMA MASTERSAF GF

Observe as regras de segurança e mapeamentos necessários para acesso e cessão de direitos ao


usuário no diretório (leitura, gravação e exclusão).

Versão: 9 7
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

INSTALAÇÃO

O processo de instalação do MASTERSAF GF 2.3.0 está dividido em algumas etapas, conforme segue
abaixo:

 Execução do Setup de Instalação


 Criação de tabelas no Banco de Dados
 Criação de estruturas de consulta
 Configuração
× Importação das tabelas padrão

Obs.: Para o processo de Importação das tabelas padrão, acesse o menu CONFIGURAÇÃO.

EXECUÇÃO DO SETUP DE INSTALAÇÃO

Entre no diretório onde se encontra o setup de instalação e execute o arquivo “Setup.exe”.

Na tela Assistente de Instalação do MASTERSAF GF, clique em Avançar.

Versão: 9 8
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Na tela ‘Diretório de Instalação’, clique no botão Procurar para definir o diretório do Servidor onde
serão instalados os arquivos do MASTERSAF GF. Clique no botão Avançar.

ATENÇÃO: Ao selecionar o diretório do servidor, não utilize o nome da unidade local do servidor.
Utilize o nome do servidor ou unidade mapeada, conforme padrão de sua empresa.
Exemplo: \\<servidor>\mastersafGF
ou
Z:\mastersafGF (onde Z: é a unidade mapeada de \\<servidor>\mastersafGF)

Clique no botão Avançar.

Na tela Tipo de Instalação visualizaremos as seguintes opções:

× Nova Instalação
× Atualizar para versão 2.3.0 – Patch XX (Indisponível no processo de Instalação)
× Aplicar Patch XX (Indisponível no processo de Instalação)
× Configurar Máquina Cliente (Indisponível na primeira Instalação)

Para esta versão do manual, faremos a demonstração do processo de “Nova Instalação” e “Configurar
Máquina Cliente”.

Os procedimentos para “Atualizar para versão 2.3.0 – Patch XX” e “Aplicar Patch XX” estão descritos no
manual de atualização “MastersafGF_Manual_Atualizacao.pdf”.

Versão: 9 9
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

NOVA INSTALAÇÃO

Marque a opção Nova Instalação para iniciar o processo de instalação do MASTERSAF GF. Atente-se
para o espaço disponível em disco.

Clique no botão Avançar.

Tela Licença de Uso

Para continuar o processo, é necessário ter o arquivo com o código da licença de uso do software
MASTERSAF GF. Caso não disponha deste arquivo, solicitamos que entre em contato com o setor de
contratos da MASTERSAF.

Utilizaremos para o nosso exemplo, um arquivo TXT que se inicia com “8”. Esse arquivo deve ser copiado
para o mesmo diretório onde se encontra o executável do instalador.

Versão: 9 10
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Digite o Código da Licença e clique em Avançar.

Na mensagem de confirmação, clique em OK.

Na tela de Banco de Dados, as informações do Banco de Dados são referentes às máquinas Client e não
ao servidor.

Versão: 9 11
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Selecione o banco de dados que será utilizado e, se for necessário, selecione a versão correspondente.

Clique em Avançar.

Na tela Criação/Atualização das estruturas de dados disponibilizamos duas opções:

 Automática: Desta forma, o processo de instalação/atualização da base de dados será


realizado de forma automática pelo instalador.

 Manual: Desta forma, os scripts de criação/atualização da base de dados deverão ser


executados manualmente pelo usuário, após a execução deste instalador.

Versão: 9 12
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

CRIAÇÃO DAS ESTRUTURAS DE DADOS AUTOMÁTICA

Após selecionar a opção Automática, clique em Avançar.

Na tela Parâmetros de Conexão com o Banco de dados será necessário informar os parâmetros para a
criação das estruturas de dados. A tela abaixo traz as informações para banco de dados Oracle, mas
informamos a seguir, todos os campos que atendem também ao banco SQLServer.

UTILIZANDO BANCO DE DADOS ORACLE

Versão: 9 13
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

UTILIZANDO BANCO DE DADOS SQLSERVER

Informe os seguintes campos na tela a seguir e clique em Avançar:

Servidor (Nome ou IP): Nome ou caminho da máquina onde se encontra o SGBD.


Porta: Porta de comunicação utilizada pelo servidor.
Instância (Nome do Serviço): Nome da instância ou serviço do servidor onde se encontra a base de
dados.
Banco de Dados: Esquema da base de dados. Somente para banco SQLServer.
Usuário: Usuário de acesso à base de dados
Senha: Senha de acesso à base de dados

Se os dados forem informados de forma incorreta ou o usuário não tiver permissão para alterar a base de
dados, não será possível estabelecer a conexão. Para esta condição, reveja as informações da tela.

A tela Pronto para Instalar/Atualizar exibe um resumo geral dos parâmetros escolhidos nas telas
anteriores. Confira todos os parâmetros. Caso algum deles esteja incorreto, clique em Voltar e corrija-os.

Versão: 9 14
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Clique em Instalar e aguarde o processo de atualização do sistema.

Caso ocorra algum erro durante a atualização automática da base de dados, a mensagem a seguir será
apresentada:

Clicando no botão “Yes” será apresentado o log que contém os erros de execução. Se desejar visualizar
posteriormente o log, clique no botão “No”.

O arquivo gerado será criado no diretório de instalação do MASTERSAF GF, com a nomenclatura
“SetupGF_XXXXXXXXXXXXXX.log”.

Ainda na condição de caso de erro, a mensagem a seguir será apresentada:

Versão: 9 15
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Clicando no botão “Yes” a atualização da aplicação será realizada, porém a atualização da base de
dados deverá ser executada de forma Manual. Se clicar no botão “No”, a atualização da aplicação não
será realizada.

Clique em OK ou Sim nas mensagens de confirmação dos registros.

A tela Finalizando o Assistente de Instalação de MASTERSAF GF 2.3.0 exibe um resumo informando


sobre o término do processo de instalação. Clique em Concluir.

Versão: 9 16
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Após realizar os passos descritos acima para o processo de instalação “AUTOMÁTICA” realize os passos
descritos neste manual no tópico de menu “CONFIGURAÇÃO”.
Após clicar em Concluir na tela Finalizando o Assistente de Instalação de MASTERSAF GF 2.3.0 será
exibido um pop-up informativo com instruções para a geração do arquivo de

Log de Atualização da Aplicação. Memorize a instrução. Clique em OK.

Após realizar os passos descritos acima para o processo de instalação “AUTOMÁTICA”, realize os passos
descritos neste manual no tópico de menu “CONFIGURAÇÃO”.

Versão: 9 17
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

CRIAÇÃO DAS ESTRUTURAS DE DADOS MANUAL

Após selecionar a opção Manual, clique em Avançar.

Para instalação com a opção de execução “Manual” dos scripts, não há necessidade de informar os
parâmetros de conexão com o banco de dados. O instalador exibirá a tela de resumo.

A tela Pronto para Instalar/Atualizar exibe um resumo geral dos parâmetros escolhidos nas telas
anteriores. Confira todos os parâmetros. Caso algum deles esteja incorreto, clique em Voltar e corrija-os.

Clique em Instalar e aguarde o processo de atualização do sistema.

Clique em OK ou Sim nas mensagens de confirmação dos registros.

Versão: 9 18
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

A tela Finalizando o Assistente de Instalação de Mastersaf GF 2.3.0 – Patch XX exibe um resumo


informando sobre o término do processo de instalação. Clique em Concluir.

Após realizar os passos descritos acima para o processo de instalação “MANUAL”, realize os passos
descritos neste manual no tópico “CONFIGURAÇÃO”.

CRIAÇÃO DE TABELAS NO BANCO DE DADOS

Faça a criação das estruturas antes de iniciar o uso do MASTERSAF GF.


Acesse o diretório de instalação do MASTERSAF GF: \Diversos\GF2.3.0\Scripts

Selecione o Banco de Dados correspondente. Caso não localize a pasta referente ao seu Banco de Dados,
contate o Suporte do MASTERSAF GF.

ATENÇÃO: A pasta “Oracle” dentro do diretório de instalação do MASTERSAF GF


“Diversos\GF2.3.0\scripts\” contém scripts para as versões do Oracle, respectivamente.

Execute os seguintes scripts contidos dentro da pasta:


– CONTROL.SQL
– ICMS.SQL
– IN68.SQL
– LIVRO.SQL
– TEMPOR.SQL
– EPC.SQL
– SEFII.SQL

Versão: 9 19
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

CRIAÇÃO DE ESTRUTURAS DE CONSULTA

Após a execução dos scripts acima, execute o script 7_CRIA_ESTRUTURAS_<banco de dados>_GF230.


Acesse o script no diretório: \Diversos\GF2.3.0\scripts\<banco de dados>

A tela Finalizando o Assistente de Instalação de MASTERSAF GF 2.3.0 exibe um resumo informando


sobre o termino do processo de instalação. Clique em Concluir.

Após realizar os passos descritos acima para o processo de instalação “MANUAL” realize os passos
descritos neste manual no tópico de menu “CONFIGURAÇÃO”.

CONFIGURAR MÁQUINA CLIENTE

Esta opção estará liberada dependendo da instalação atual do MASTERSAF GF. Se for a primeira
instalação, essa opção não ficará disponível para seleção.
Após a instalação do MASTERSAF GF, ao executar novamente o instalador, esta será a opção padrão
para que sejam configuradas as máquinas clients da aplicação, ou seja, a instalação deve ser feita no
servidor e a configuração máquina client deve ser feita na máquina dos usuários.

Marque a opção Configurar Máquina Cliente para iniciar o processo de instalação do MASTERSAF GF.

Atente-se para o espaço disponível em disco.

Versão: 9 20
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

ATENÇÃO: Esta opção deve ser executada individualmente em cada máquina. Clique no
botão Avançar.

A tela Pronto para Instalar/Atualizar exibe um resumo geral dos parâmetros escolhidos nas telas
anteriores. Confira todos os parâmetros. Caso algum deles esteja incorreto, clique em Voltar e corrija-os.

Clique em Instalar e aguarde o processo de atualização do sistema.

Versão: 9 21
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Clique em OK ou Sim nas mensagens de confirmação dos registros.

A tela Finalizando o Assistente de Instalação de MASTERSAF GF 2.3.0 exibe um resumo informando


sobre o termino do processo de instalação. Clique em Concluir.

Após realizar os passos descritos acima para o processo de instalação “MANUAL” realize os passos
descritos neste manual no tópico “CONFIGURAÇÃO” a seguir.

Versão: 9 22
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

CONFIGURAÇÃO

Após realizar a instalação do sistema, para qualquer uma das opções “Automática” ou “Manual”, acesse
o MASTERSAF GF para realizar o processo de Conexão com o banco de Dados.

Ao entrar a primeira vez no sistema do MASTERSAF GF, é exibida a tela de Conexão com Banco de
Dados.

Preencha os campos da seguinte forma:

Caminho: $BBB
Usuário: Insira o Usuário de acesso do MASTERSAF GF com o Banco de Dados (o mesmo do ODBC)
Senha: Digite a senha do usuário
ASV: Função não implementada. Deve sempre ficar em branco
IP: Informe o IP do servidor de banco de dados.
Porta: Informe a porta de conexão com o banco de dados.

ATENÇÃO: Não deve haver Usuários ou Senhas com “_” (underline), pois pode não funcionar com
alguns bancos de dados. Crie usuários somente com letras e números.

O campo Banco de dados deve ser preenchido da seguinte forma, de acordo com o seu Banco de
Dados:

Oracle:
Nome do serviço/SID

SQL Server:
<Nome do ODBC>:<Esquema>

Clique em Gravação e depois feche essa tela.

A tela de Login do sistema é aberta.

Versão: 9 23
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

IMPORTAÇÃO DAS TABELAS PADRÃO

Neste passo você fará a carga da tabela Empresa.

Para realizar a carga é necessário seguir os passos descritos abaixo:

1. Na tela de login do MASTERSAF GF, digite no campo Usuário, a informação “MASTERSAFGF” e


no campo Senha, digite “CJKM3B”.

2. Na tela INICIA_IMPORT - Parâmetros de Importação clique no ícone da pasta e selecione o


arquivo que contém o código da licença (Ex: 810000.TXT) utilizado no processo de execução do
setup de instalação.

3. Clique em IMPORTAÇÃO.

4. Na tela de parametrização IMPORTGF31 - Parâmetros de Importação, “Controle de Arquivos


Históricos”, clique em Controle e ative as caixas de seleção EMPRESA e SEGURANCA. Clique no
ícone Sair com Gravação.
Todas as tabelas que deverão ser importadas estão selecionadas na tela, conforme abaixo:

IMPORTAÇÃO DAS TABELAS PADRÃO SEM SOBREPOSIÇÃO


REGISTROS GRUPO
2 Controle
0 Cadastros e Códigos
0 Movimento
0 CIAP/LC102
0 DIPI
0 Apuração e Livros

5. Na tela de importação IMPORTGF31 - Parâmetros de Importação, “Controle de Arquivos


Históricos”, clique no botão IMPORTA. Devem ser processados diversos registros e é gravada
a quantidade de empresas conforme disposto na licença.

Neste passo você fará a carga de todas as tabelas padrão executando o processo de importação.

Versão: 9 24
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Para realizar a carga é necessário executar os seguintes passos:

1. Na tela de login do MASTERSAF GF, digite no campo Usuário, a informação “IMPORTGF” e no


campo Senha, digite a informação “CJKM3B”.

2. O sistema exibe uma caixa de mensagem com a informação:


“Confirma o processamento de carga automática?”. Clique no botão SIM.

3. Aguarde a finalização do processo. Ao finalizar, a seguinte mensagem será mostrada “Processo


encerrado. Deseja ver o log de resultados?”. Clique em Sim para abrir o log de processamento ou
clique em NÃO para sair.

4. Clique em IMPORTA e confirme as mensagens. Devem ser processados e gravados 5.927


registros.

ATENÇÃO: Siga os procedimentos contidos no manual de instalação na seção


Configuração Máquina Cliente MASTERSAF GF, onde você encontrará as instruções para
configuração de todas as estações de trabalho que irão utilizar o aplicativo MASTERSAF
GF.

Ao final deste item, o processo de Instalação do MASTERSAF GF 2.3.0 está concluído.

Versão: 9 25
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

APÊNDICES

MONITOR MASTERSAF GF – REINF E AGENDAMENTO DE


PROCESSOS

Os procedimentos descritos neste tópico tratam do Monitor Mastersaf GF para o Agendamento de


Processos e Geração do arquivo ‘XML’ de Eventos para o REINF.

A instalação do Monitor faz parte do processo do REINF e é necessária para a geração dos arquivos
‘XML’ dos eventos, assim como, para possibilitar ao usuário agendar processos de geração de
obrigações. Sem este procedimento, os arquivos ‘XML’ não serão gerados.

INSTALAÇÃO

Acesse a pasta Agendamento localizada no caminho <Instalação do MASTERSAFGF>\Java

Dentro da pasta, execute o arquivo “installService.bat”.

Após o término da execução, acesse o SERVICES do Windows, e no serviço “Monitor Mastersaf GF”
clique com o botão direito em propriedades, entre na aba “LOGON” selecione a opção “Esta Conta” e
coloque um usuário que tenha permissão de administrador do servidor.

Inicie o serviço “Monitor Mastersaf GF”. Pronto, o serviço está instalado.

Obs.: Em caso de algum erro ao iniciar o serviço do Monitor Mastersaf GF, verifique o arquivo de log
dentro da pasta bin do MASTERSAF GF.

TEMPO DE VERIFICAÇÃO

O Monitor MASTERSAF GF por padrão verifica, de tempos em tempos, a necessidade de iniciar um


processo a cada 60 segundos.

Versão: 9 26
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Caso queira alterar o tempo de verificação, abra o arquivo “gfa.properties” na pasta Java da instalação
do MASTERSAF GF e altere a propriedade “monitor.timer”, colocando o tempo em segundos.

DESINSTALAÇÃO

Para desinstalar o Monitor MASTERSAF GF:

Acesse a pasta: <Instalação do MASTERSAF GF>\Java\Agendamento e execute o arquivo


“uninstallService.bat”.

INSTALAÇÃO DO APPLICATION SERVER MASTERSAF GF EM


SERVIDORES WINDOWS

Application Server é um sistema instalado e configurado em uma máquina remota (chamada de “servidor
do Application Server”) que recebe e executa uma parte dos processos iniciados pela estação de trabalho
que executa o MASTERSAF GF.

Indicamos a forma como o servidor do Application Server deve ser acessado e o que deve ser processado
pelo servidor através de apontamentos nos arquivos de configuração (arquivos .asn) existentes no
Servidor da Instalação Cliente.

O Application Server também utiliza arquivos de configuração .asn, mas estes tratam apenas das
configurações do Application Server

PRÉ-REQUISITOS

Instalação padrão do MASTERSAF GF no Servidor da Instalação Cliente (acessado pelas estações de


trabalho).

Caso não tenha o sistema instalado, efetue a instalação de acordo com os manuais disponibilizados no
site da MASTERSAF Thomson Reuters (www.mastersaf.com.br) na página “Meus Serviços”, clique no
link “Base de Conhecimento Cliente” e acesse o menu MASTERSAF GF > Manuais Técnicos.

Versão: 9 27
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Instalação padrão do MASTERSAF GF no Servidor do Application Server (acessado pelo Application


Server).

Caso não tenha o sistema instalado, efetue a instalação de acordo com os manuais disponibilizados no
site da MASTERSAF Thomson Reuters (www.mastersaf.com.br) na página “Meus Serviços”, clique no
link “Base de Conhecimento Cliente” e acesse o menu MASTERSAF GF > Manuais Técnicos.

Obs.: As instalações do MASTERSAF GF, sendo elas: A instalação cliente que é usada pelas estações e a
instalação que é usada pelo application Server, podem ser a mesma instalação, MAS DEVEM SER
TRATADAS COMO SE ESTIVESSEM EM EQUIPAMENTOS DIFERENTES.

No caso das duas instalações estarem no mesmo equipamento, deve ser criada uma pasta chamada
“app” dentro da pasta “adm” e, dentro desta, devem ser copiados todos os arquivos de extensão “.asn” e
extensão “.ini” que existirem no MASTERSAF GF.

Usuário cadastrado no servidor para uso nos processos do application Server:


Para isso, siga a documentação disponibilizada pelo próprio Sistema Operacional.
Deve-se criar um usuário no Windows, que será responsável por executar os processamentos que forem
solicitados pelas máquinas clientes.

Este usuário deverá ter as seguintes permissões:

 “Logon as batch job” (Efetuar logon como um trabalho em lotes);


 “Logon as service” (Efetuar logon como um serviço);
 Permissão total sobre a pasta do MASTERSAF GF;
 Permissão total sobre a pasta do cliente do banco de dados.

Se desejar que o application possa gerar arquivos de críticas na máquina local, o usuário do servidor
deve ser capaz de acessar o domínio.

Versão: 9 28
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

OBSERVAÇÃO IMPORTANTE PARA SERVIDORES WINDOWS

Abra o arquivo C:\WINNT\system32\drivers\etc\SERVICES. Inclua a linha abaixo no final do arquivo


citado. Certifique-se de existir um [ENTER] após a inclusão da mesma.

Urouter 13000/tcp #Porta utilizada pelo Application Server – MASTERSAF GF

ESQUEMAS

MODELOS DE INSTALAÇÃO DE APPLICATION SERVER E SEUS COMPONENTES

SERVIDOR DE ESTAÇÃO DE BANCO DE APPLICATION SERVER


ARQUIVOS TRABALHO DADOS
Executáveis do Atalho do Banco de Dados Executáveis do Application
MASTERSAF GF MASTERSAF GF Server
Arquivos de configuração Client do banco de Arquivos de configuração do
(.asn e .ini) do aplicativo dados Application Server (.asn e .ini)
Componentes (arquivos): Componentes (arquivos): .svc,
.frm, .svc, .rpt, .urr, .dol .urr, .dol
Client do banco de dados

SERVIDOR DE ARQUIVOS E APPLICATION ESTAÇÃO DE BANCO DE


SERVER TRABALHO DADOS
Executáveis do MASTERSAF GF e Application Server Atalho do MASTERSAF GF Banco de Dados
Arquivos de configuração (.asn e .ini) do aplicativo Client do banco de dados
Arquivos de configuração (.asn e .ini) do Application
Server
Componentes (arquivos): .frm, .svc, .rpt, .urr, .dol
Client do banco de dados

Versão: 9 29
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

ACESSOS E TRÂNSITO DE INFORMAÇÕES

Na estação de trabalho, quando o MASTERSAF GF é inicializado no atalho existente para o sistema, as


informações dos arquivos de configuração .asn e .ini são utilizadas para buscar os componentes do
MASTERSAF GF do servidor (onde está a Instalação utilizada pelos clientes) e carregam esses
componentes na memória da estação de trabalho.

Após isso, o sistema utiliza as informações de conexão com o banco de dados existentes no arquivo
connect.reg e o client do banco de dados instalado na estação de trabalho para acessar o próprio servidor
de banco de dados. Com isto, o sistema pode buscar e carregar os registros dos dados existentes no
banco na memória da estação de trabalho.

Quando há um apontamento nos arquivos de configuração que orienta o sistema a rodar processos no
Application Server, o sistema acessa o servidor do Application Server com o apontamento específico –
usuário e senha do servidor; apontamento $ASV. O programa responsável pela execução de processos do
MASTERSAF GF no servidor é iniciado e executa o processo indicado, existente nos arquivos de
componente .svc. O Application Server também necessita acessar o banco de dados utilizando um client
de banco de dados instalado no servidor e informações de conexão existentes nos arquivos de
configuração do próprio Application Server (apontamento $BBB). Quando é estabelecida a conexão
com o banco de dados, os registros do banco de dados retornam ao Application Server em memória.

Utilizando tanto os arquivos indicados (arquivos de componente .svc) e os registros do banco de dados, o
Application Server executa o processo solicitado pelo MASTERSAF GF. Neste momento, na estação de
trabalho, o sistema fica aguardando pelo final do processamento do Application Server, e não executa
outras operações durante este período de espera (o sistema chega a parecer que está “travado”, mas
simplesmente está aguardando o final do processamento no Application Server). Ao final deste
processo, o Application volta ao normal e a operação é finalizada.

1a Etapa Trânsito de informações entre a estação de trabalho e o servidor de instalação do


MASTERSAF GF
2a Etapa Trânsito de informações entre banco de dados e estação de trabalho
3a Etapa Solicitação de processamento da estação de trabalho ao Application Server
4a Etapa Trânsito de informações entre Application Server e banco de dados
5a Etapa Resposta do Application Server a estação de trabalho no fim do processamento

Versão: 9 30
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

CRIAÇÃO DO SERVIÇO (UNIFACE UROUTER)

Através do prompt do DOS, entre no diretório <Caminho de instalação do sistema MASTERSAF GF>\bin e
execute o seguinte comando no servidor application server: Urouter.exe /ins

Em seguida, verifique se o serviço “UNIFACE URouter” foi criado corretamente no Windows. Clique no
serviço citado e acesse as suas propriedades. Altere o tipo de inicialização para “Automático” e inicie o
serviço caso não esteja em execução.

Obs.: Todas as vezes que o servidor for reiniciado, torna-se necessário verificar se o serviço “UNIFACE
URouter” foi inicializado.

ALTERAÇÕES NOS ARQUIVOS DE CONFIGURAÇÃO DO


SISTEMA MASTERSAF GF

Segue abaixo uma lista das alterações a serem feitas em cada um dos arquivos. Tome cuidado ao trocar o
conteúdo de exemplo para o real. Os conteúdos de exemplo são:

<Servidor>: Nome do servidor ou seu IP de rede.

<Caminho_Rede>: Caminho de instalação do sistema MASTERSAF GF (nomenclatura UNC, ou seja, os


endereços de convenção universal de nomenclatura, que são usados para identificar o local de um arquivo
que reside em um servidor de rede. Esses endereços começam com dois caracteres de barra invertida [\\]
e fornecem o nome do servidor, o nome de compartilhamento e o caminho completo até o arquivo.)

<Caminho_Local>: Caminho de instalação do sistema MASTERSAF GF (nomenclatura local)

<Usuário_App>: Usuário do sistema operacional criado para utilização com o Application Server

<Senha_App>: Senha criada para utilização com o usuário

Versão: 9 31
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

<Mnemônico>: “Sigla” ou “Apelido” do Banco de Dados. Criado automaticamente na instalação do


sistema MASTERSAF GF. Maiores detalhes sobre esta configuração podem ser obtidas no item de
Instalação ou no manual de infraestrutura do MASTERSAF GF

<Usuário_Banco>: Usuário utilizado para conexão ao Banco de Dados

<Senha_Banco>: Senha utilizada para conexão ao Banco de Dados

<String_Banco>: String de conexão utilizada para conexão ao Banco de Dados. Verifique o manual de
infraestrutura do MASTERSAF GF para saber qual é o formato correto do seu banco de dados

<Módulo>: Código do Módulo.

<Application>: Módulo em execução do MASTERSAF GF no servidor do Application Server, definido no


“urouter.asn”, e utilizado em cada um dos arquivos .asn dos módulos existentes no Servidor de
Instalação Cliente do MASTERSAF GF.

SERVIDOR DA INSTALAÇÃO CLIENTE

Arquivo GF_SERVICES_EXEC.ASN – Localizado no diretório ADM de instalação do MASTERSAF GF

Neste arquivo, devem-se incluir os apontamentos dos componentes que podem ser processados
remotamente. Para verificar os possíveis apontamentos de componentes para cada um dos módulos,
consulte o Arquivo de Ajuda do MASTERSAF GF, sob o item “Arquivo ASN”

Original

[SERVICES_EXEC]
XCEEDZIP $COM:XCEEDZIP CLASS={4C836512-BB70-11D2-A5A7-00105A9C91C6} MD5
$COM:MD5 CLASS={F625023A-3411-4D7D-A1C9-C2114B0553B5}
;in*$ASV:in*
;cv*$ASV:cv*
;fvalf*$SRU:fvalf*
;fvalxaud$SRU:fvalxaud
;find*$SRU:find*

Versão: 9 32
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

;f*$ASV:f*
;l*$SRU:l*
;seg*$ASV:seg*
;scheda*$ASV:scheda*
*$SRU:*

Alterado

[SERVICES_EXEC]
XCEEDZIP $COM:XCEEDZIP CLASS={4C836512-BB70-11D2-A5A7-00105A9C91C6}
MD5 $COM:MD5 CLASS={F625023A-3411-4D7D-A1C9-C2114B0553B5}

; apontamento para execução do módulo IN86 no Application Server


;in*$ASV:in*
;cv*$ASV:cv*
;fvalf*$SRU:fvalf*
;fvalxaud$SRU:fvalxaud
;find*$SRU:find*
;f*$ASV:f*
;l*$SRU:l*
seg*$ASV:seg*
;scheda*$ASV:scheda*

; Apontamento para o módulo IN86


IN86*$ASV:IN86*

; Apontamento para o módulo XXX


XXX*$ASV:XXX*

; apontamento para execução LOCAL


* $SRU:*

Obs.: Os apontamentos específicos que devem ser feitos para cada módulo do MASTERSAF GF ser
executado em Application Server podem ser encontrados dentro do Arquivo de Ajuda do MASTERSAF
GF, sob o item “Arquivo ASN”.

Versão: 9 33
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Arquivo GF_IN86.ASN (GF_<Módulo>) – Localizado no diretório USYS de instalação do MASTERSAF GF

Utilizaremos como exemplo o módulo da IN86 do MASTERSAF GF. Para outros módulos, é preciso
refazer este passo adequando as configurações para cada um dos módulos escolhidos.
Onde no arquivo alterado lemos <Application>, é preciso substituir pelo nome correspondente ao
módulo que estamos configurando baseado no arquivo “urouter.asn”, a ser configurado no servidor
do Application Server.

Ou seja, na linha com o formato abaixo:

$ASVTCP:<Servidor>+13000|<Usuário_App>|<Senha_App>|<Application>

Devemos substituir o <Application> pelo módulo configurado no “urouter.asn” ainda a ser configurado,
como no exemplo “Alterado” abaixo:

Original

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS
[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG_GF_IN86.TXT

#file usys:..\adm\gf_settings.asn

[PATHS]
#file usys:..\adm\gf_paths.asn

Versão: 9 34
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[ENTITIES]
#file usys:..\adm\gf_entities.asn

[FILES]
#file usys:..\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm
*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt
usys:uana.urr usys:GF_IN86_uana.urr
usys:udesc.urr usys:GF_IN86_udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Alterado

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;

Versão: 9 35
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

; *** Este programa está protegido por leis de direitos autorais.


; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG_GF_IN86.TXT
#file usys:..\adm\gf_settings.asn

[PATHS]
$ASVTCP:<Servidor>+13000|<Usuário_App>|<Senha_App>|in86
#file usys:..\adm\gf_paths.asn

[ENTITIES]
#file usys:..\adm\gf_entities.asn

[FILES]
#file usys:..\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm
*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt
usys:uana.urr usys:GF_IN86_uana.urr
usys:udesc.urr usys:GF_IN86_udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

Versão: 9 36
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Arquivo GF.ASN – Localizado no diretório ADM de instalação do MASTERSAF GF

Original

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG.TXT
#file usys:..\adm\gf_settings.asn

[PATHS]
#file usys:..\adm\gf_paths.asn

[ENTITIES]
#file usys:..\adm\gf_entities.asn

[FILES]
#file usys:..\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm

Versão: 9 37
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt usys:uana.urr usys:uana.urr
usys:udesc.urr usys:udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Alterado

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG.TXT
#file usys:..\adm\gf_settings.asn

Versão: 9 38
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[PATHS]
$ASVTCP:<Servidor>+13000|<Usuário_App>|<Senha_App>|wasv
#file usys:..\adm\gf_paths.asn

[ENTITIES]
#file usys:..\adm\gf_entities.asn

[FILES]
#file usys:..\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm
*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt
usys:uana.urr usys:uana.urr
usys:udesc.urr usys:udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Versão: 9 39
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

SERVIDOR DO APPLICATION SERVER

Todos os apontamentos em arquivos de configuração (arquivos .asn) que indicarem outros arquivos
deve utilizar o endereço absoluto da máquina em questão (C:\, D:\, etc.)

Arquivo UROUTER.ASN – Localizado no diretório ADM de instalação do Application Server

Neste arquivo, deve-se incluir uma linha para cada módulo configurado no arquivo
GF_SERVICES_EXEC.ASN., utilizaremos como exemplo o módulo IN86.

Este passo precisa ser realizado para cada um dos módulos do MASTERSAF GF que serão executados
no Application Server, fazendo os ajustes necessários para endereços e nomes de arquivos de cada
módulo.

Obs. 1: Se a instalação do Application Server e do servidor de instalação cliente forem no mesmo


equipamento, e for utilizado o diretório “app” para os arquivos .asn do Application Server, quando
alterarmos o arquivo abaixo devemos contemplar essa alteração - inclusão do diretório “\adm\app”
nos caminhos de arquivos .asn – também neste arquivo.

Obs. 2: O parâmetro /asn abaixo SEMPRE deve ser em letras minúsculas, e não devem ser utilizados
espaços no parâmetro “/asn=<caminho_do_arquivo_asn>“, conforme exemplo abaixo.

Obs. 3: Para toda e qualquer modificação feita neste arquivo (“urouter.asn”), deve-se reiniciar o
serviço urouter no sistema operacional.

Original

[SETTINGS]
;$putmess_logfile = C:\urouter%p.log

[SERVERS]
; For UNIFACE WebApplication Server
wasv = “C:\GF\bin\userver.exe” -maxreq=1000 -dir=“C:\GF\project” -asn=usysadm:wasv.asn

Versão: 9 40
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Alterado

[SETTINGS]
$putmess_logfile = <Caminho_Local>\bin\log\urouter%p.log

[SERVERS]
; apontamento para execução do núcleo
wasv=<Caminho_Local>\bin\userver.exe /asn=<Caminho_Local>\adm\wasv.asn /maxreq=1000
; apontamento para execução do módulo IN86 no Application Server
in86=<Caminho_Local>\bin\userver.exe /asn=<Caminho_Local>\adm\GF_IN86.asn /maxreq=1000

; Observação:
; apontamento para execução do módulo XXX no Application Server
;<Application>=<Caminho_Local>\bin\userver.exe /asn=<Caminho_Local>\adm\gf_<módulo>.asn /
maxreq=1000

Arquivo WASV.ASN: Localizado no diretório ADM de instalação do Application Server (quando as


instalações são em máquinas diferentes) ou APP (quando as instalações estão na mesma máquina).

Este arquivo, originalmente, não é utilizado pelo sistema. Ele passa a ser útil somente para os clientes
que possuem o Application Ser- ver instalado.

Obs.: Se a instalação do Application Server e do servidor de instalação cliente forem no mesmo


equipamento, e for utilizado o diretório “app” para os arquivos .asn do Application Server, quando
alterarmos o arquivo abaixo, devemos contemplar essa alteração – inclusão do diretório “\adm\app”
nos caminhos de arquivos .asn – também neste arquivo.

Original

; *** Created by the Graphical Partitioning Manager


; *** Copyright (c) Compuware 1997
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.

Versão: 9 41
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG.TXT
#file <endereco>\adm\gf_settings.asn

[PATHS]
#file <endereco>\adm\gf_paths.asn

[ENTITIES]
#file <endereco>\adm\gf_entities.asn

[FILES]
#file <endereco>\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm<endereco>\FORMS\*.frm
*.svc<endereco>\SERVICES\*.svc
*.rpt<endereco>\UREPORTS2\*.rpt
usys:uana.urr<endereco>\usys\uana.urr
usys:udesc.urr<endereco>\usys\udesc.urr

[LOGICALS]
#file <endereco>\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file <endereco>\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file <endereco>\adm\gf_services_exec.asn

[USER_3GL]
#file <endereco>\adm\gf_user_3gl.asn

[TM]
#file <endereco>\adm\gf_tm.asn

Versão: 9 42
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Alterado

; *** Created by the Graphical Partitioning Manager


; *** Copyright (c) Compuware 1997
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = <Caminho_Local>\bin\log\wasv_log_%p.txt
#file <Caminho_Local>\adm\gf_settings.asn

[PATHS]
#file <Caminho_Local>\adm\gf_paths.asn

[ENTITIES]
#file <Caminho_Local>\adm\gf_entities.asn

[FILES]
#file <Caminho_Local>\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm <Caminho_Local>\FORMS\*.frm
*.svc <Caminho_Local>\SERVICES\*.svc
*.rpt <Caminho_Local>\UREPORTS2\*.rpt
usys:uana.urr <Caminho_Local>\USYS\uana.urr
usys:udesc.urr <Caminho_Local>\USYS\udesc.urr

[LOGICALS]
#file <Caminho_Local>\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file <Caminho_Local>\adm\gf_driver_settings.asn

Versão: 9 43
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[SERVICES_EXEC]
#file <Caminho_Local>\adm\gf_services_exec.asn

[USER_3GL]
#file <Caminho_Local>\adm\gf_user_3gl.asn

[TM]
#file <Caminho_Local>\adm\gf_tm.asn

Arquivo GF_PATHS: Localizado no diretório ADM de instalação do Application Server (ou dentro do
diretório \adm\app quando as duas instalações estiverem no mesmo equipamento).

Original

[PATHS]
$BBB <Mnemônico>:

;$ASV TCP:IP+13000|localuser|?|WASV
$LAY=OD2:DBT:||

$UUU $BBB
$SYS $BBB
$DEF $BBB
$IDF $BBB

Alterado

[PATHS]
$BBB <Mnemônico>:<String_Banco>|<Usuario_Banco>|<Senha_Banco>

$LAY=OD2:DBT:||
$UUU $BBB
$SYS $BBB
$DEF $BBB
$IDF $BBB

Versão: 9 44
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Arquivo GF_SERVICES_EXEC: Localizado no diretório ADM de instalação do Application Server (ou


dentro do diretório \adm\app quando as duas instalações estiverem no mesmo equipamento).

Original

[SERVICES_EXEC]
XCEEDZIP $COM:XCEEDZIP CLASS={4C836512-BB70-11D2-A5A7-00105A9C91C6}
MD5 $COM:MD5 CLASS={F625023A-3411-4D7D-A1C9-C2114B0553B5}
;in* $ASV:in*
;cv* $ASV:cv*
;fvalf* $SRU:fvalf*
;fvalxaud $SRU:fvalxaud
;find* $SRU:find*
;f* $ASV:f*
;l* $SRU:l*
;seg* $ASV:seg*
;scheda* $ASV:scheda*
* $SRU:*

Alterado

[SERVICES_EXEC]
* $SRU:*

Criação do Arquivo GF_Modulo.ASN (Servidor do Application Server e Servidor da Instalação


Cliente em equipamentos diferentes).

Se o Application Server e a instalação do MASTERSAF GF estiverem no mesmo servidor, favor considere


esse item.

Este passo precisa ser realizado para cada um dos módulos do MASTERSAF GF que serão executados
no Application Server, fazendo os ajustes necessários para endereços e nomes de arquivos de cada
módulo.
Realize a cópia do arquivo GF_<Módulo>, localizado no diretório USYS da instalação do MASTERSAF GF,
para a pasta “\adm” da instalação do Application Server.

Versão: 9 45
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Tendo como exemplo o módulo da IN86, é necessário duplicar o arquivo “GF_IN86.asn”, para a pasta
“\adm”.

Obs.: Se o arquivo de módulo do servidor da Instalação cliente já foi alterado e possui a linha $ASV, é
preciso apagar esta linha do arquivo.

Abra o arquivo \adm\GF_IN86.asn e realize as alterações conforme abaixo:

Original

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG_GF_IN86.TXT
#file usys:..\adm\gf_settings.asn

[PATHS]
#file usys:..\adm\gf_paths.asn

[ENTITIES]
#file usys:..\adm\gf_entities.asn
[FILES]
#file usys:..\adm\gf_files.asn

Versão: 9 46
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm
*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt
usys:uana.urr usys:GF_IN86_uana.urr
usys:udesc.urr usys:GF_IN86_udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Alterado

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0

Versão: 9 47
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

$PUTMESS_LOGFILE = <Caminho_Local>\bin\log\LOG_APP_IN86.TXT
#file <Caminho_Local>\adm\gf_settings.asn
[PATHS]
#file <Caminho_Local>\adm\gf_paths.asn

[ENTITIES]
#file <Caminho_Local>\adm\gf_entities.asn

[FILES]
#file <Caminho_Local>\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm <Caminho_Local>\FORMS\*.frm
*.svc <Caminho_Local>\SERVICES\*.svc
*.rpt <Caminho_Local>\UREPORTS2\*.rpt
usys:uana.urr <Caminho_Local>\usys\GF_IN86_uana.urr
usys:udesc.urr <Caminho_Local>\usys\GF_IN86_udesc.urr

[LOGICALS]
#file <Caminho_Local>\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file <Caminho_Local>\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file <Caminho_Local>\adm\gf_services_exec.asn

[USER_3GL]
#file <Caminho_Local>\adm\gf_user_3gl.asn

[TM]
#file <Caminho_Local>\adm\gf_tm.asn

Versão: 9 48
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Criação do Arquivo GF_Modulo.ASN (Servidor do Application Server e Servidor da Instalação


Cliente no mesmo equipamento)+

Realize a cópia do arquivo GF_<Módulo>, localizado no diretório USYS da instalação do MASTERSAF


GF, para a pasta “\adm\app”. Tendo como exemplo o módulo da IN86, é necessário duplicar o arquivo
“GF_IN86.asn”, para a pasta “\adm\app”.

Obs. 1: Se a instalação do Application Server e do servidor de instalação cliente forem no mesmo


equipamento, e for utilizado o diretório “app” para os arquivos .asn do Application Server, quando
alterarmos o arquivo abaixo, devemos contemplar essa alteração - inclusão do diretório “\adm\app”
nos caminhos de arquivos .asn – também neste arquivo.

Obs. 2: Se o arquivo de módulo do servidor da Instalação cliente já foi alterado e possui a linha $ASV, é
preciso apagar esta linha do arquivo.

Abra o arquivo \adm\app\GF_IN86.asn e realize as alterações conforme abaixo:

Original

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = C:\LOG_GF_IN86.TXT
#file usys:..\adm\gf_settings.asn

[PATHS]
#file usys:..\adm\gf_paths.asn

Versão: 9 49
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[ENTITIES]
#file usys:..\adm\gf_entities.asn

[FILES]
#file usys:..\adm\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm usys:..\FORMS\*.frm
*.svc usys:..\SERVICES\*.svc
*.rpt usys:..\UREPORTS2\*.rpt
usys:uana.urr usys:GF_IN86_uana.urr
usys:udesc.urr usys:GF_IN86_udesc.urr

[LOGICALS]
#file usys:..\adm\gf_logicals.asn

[DRIVER_SETTINGS]
#file usys:..\adm\gf_driver_settings.asn

[SERVICES_EXEC]
#file usys:..\adm\gf_services_exec.asn

[USER_3GL]
#file usys:..\adm\gf_user_3gl.asn

[TM]
#file usys:..\adm\gf_tm.asn

Versão: 9 50
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Alterado

; ***
; *** Created by the Graphical Partitioning Manager
; *** Copyright (c) Compuware 1997
; ***
;
; *** Este programa está protegido por leis de direitos autorais.
; *** As penas estão previstas em lei.
; *** Assinalamentos para o OPEN-RIS

[SETTINGS]
$IOPRINT =0
$PUTMESS_LOGFILE = <Caminho_Local>\bin\log\LOG_APP_IN86.TXT
#file <Caminho_Local>\adm\app\gf_settings.asn

[PATHS]
#file <Caminho_Local>\adm\app\gf_paths.asn

[ENTITIES]
#file <Caminho_Local>\adm\app\gf_entities.asn

[FILES]
#file <Caminho_Local>\adm\app\gf_files.asn

; ===== COMPONENTES DO MÓDULO =====


*.frm <Caminho_Local>\FORMS\*.frm
*.svc <Caminho_Local>\SERVICES\*.svc
*.rpt <Caminho_Local>\UREPORTS2\*.rpt
usys:uana.urr <Caminho_Local>\usys\GF_IN86_uana.urr
usys:udesc.urr <Caminho_Local>\usys\GF_IN86_udesc.urr

[LOGICALS]
#file <Caminho_Local>\adm\app\gf_logicals.asn

Versão: 9 51
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

[DRIVER_SETTINGS]
#file <Caminho_Local>\adm\app\gf_driver_settings.asn

[SERVICES_EXEC]
#file <Caminho_Local>\adm\app\gf_services_exec.asn

[USER_3GL]
#file <Caminho_Local>\adm\app\gf_user_3gl.asn

[TM]
#file <Caminho_Local>\adm\app\gf_tm.asn

Os itens Arquivo GF_IN86.ASN e Criação do Arquivo GF_Modulo.ASN (no mesmo ou em diferentes


equipamentos) precisam ser realizados para cada um dos módulos do MASTERSAF GF que serão
executados no Application Server, fazendo os ajustes necessários para endereços e nomes de arquivos
de cada módulo, bem como os nomes de <Application>.

Ao finalizar os procedimentos apresentados o Application Server estará configurado para ser utilizado.

COMANDO PATHSCRAMBLER (PARA CRIPTOGRAFAR INFORMAÇÕES DE


ACESSO)

Criptografia do usuário e senha de acesso ao servidor do Application Server

Como essa linha possui informações confidenciais como senha de administrador, podemos utilizar um
aplicativo chamado pathscrambler.exe localizado na pasta BIN do diretório de instalação para
criptografia destas informações, porém aconselhamos executar a criptografia após conclusão do
processo.

Para criptografar o arquivo deverão ser seguidos os procedimentos listados:

Acesse o prompt do DOS.

Configure o cursor para apontar para o diretório de instalação do MASTERSAF GF na pasta BIN.

Versão: 9 52
Atualizado em: 31/10/2017
MASTERSAF GF MANUAL DE INSTALAÇÃO

Digite “CD <Caminho_Local>\BIN”.

Execute o comando de criptografia do arquivo listado a baixo. pathscrambler –asn


<Caminho_Local>\adm\gf_paths.asn

Exemplo: C:\MASTERSAFGF\BIN>pathscrambler –asn C:\MASTERSAFGF\ADM\GF_PATHS.ASN


É criado um arquivo “gf_paths.asn.enc”.

Este arquivo possui o mesmo conteúdo do “GF_PATHS.asn”, porém criptografado.

Copie a linha referente ao apontamento $ASV do arquivo criptografado e substitua no arquivo


“GF_PATHS.asn” utilizado no equipamento do servidor de aplicativos;

Copie a linha referente ao apontamento $BBB do arquivo criptografado e substitua no arquivo


“GF_PATHS.asn” utilizado no equipamento do Application Server;

Repita esse processo para os arquivos gf.asn e todos os arquivos .asn referentes a módulos.

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 1 (Atendimento das Soluções Fiscais).


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

Versão: 9 53
Atualizado em: 31/10/2017