Mastersafdfe 1

Mastersaf DFE
Instalação
RIO DE JANEIRO SÃO PAULO

Av. Presidente Vargas, 309 - 11º andar Av. Dr. Cardoso de Melo, 1855 – 13º - Cj. 131 e 132 – Vila Olímpia
Tel: (0xx21) 3094-9300 / Fax: (0xx21) 3094-9350 - CEP: 20040-010 Tel: (0xx11) 2159-0500 / Fax: (0xx11) 2159-0582 – CEP: 04548-005
www.mastersaf.com.br
Índice
1. VISÃO GERAL E REQUISITOS PARA INSTALAÇÃO .................................................................3
1.1. AMBIENTE ..............................................................................................................................3
1.2. BANCO DE DADOS..................................................................................................................5
2. BAIXANDO OS INSTALADORES DO DFE MASTERSAF ...........................................................6
3. INICIANDO O INSTALADOR DO MASTERSAF DFE .................................................................7
4. INICIANDO O PORTAL MASTERSAF DFE ...............................................................................8
5. INICIANDO O INTEGRADOR MASTERSAF DFE ....................................................................13
6. INICIANDO A MENSAGERIA MASTERSAF DFE ....................................................................15
7. ARQUIVOS DE CONFIGURAÇÃO ..........................................................................................15
7.1. INSTALADOR ........................................................................................................................15
7.2. PORTAL.................................................................................................................................16
7.3. MENSAGERIA .......................................................................................................................17
7.4. INTEGRADOR........................................................................................................................18

1. VISÃO GERAL E REQUISITOS PARA INSTALAÇÃO
Visão geral dos módulos
1.1. AMBIENTE
 JDK 1.6 (Java Development Kit) instalado.
 Variável de ambiente PATH com o caminho da pasta “Bin” do JDK adicionado.

o Exemplo Windows: C:\Program Files\Java\jdk1.6\Bin
o Exemplo Linux: /usr/lib/jvm/Java-6-sun/bin
 Variável de ambiente JAVA_HOME apontando para o diretório de instalação do Java JDK.

o Exemplo Windows: C:\Program Files\Java\jdk1.6
o Exemplo Linux: /usr/lib/jvm/Java-6-sun

Variáveis de ambiente no Windows
Variáveis de ambiente no Linux
 Permissão de sistema para executar o script/bat de instalação.

 Permissão para editar arquivos texto como os de extensão .properties e .xml.
 Permissão para colocar os executáveis do produto para serem chamados durante a inicialização do
sistema (seguir documentação fornecida pela Mastersaf).

1.2. BANCO DE DADOS
 Criar um banco de dados para o Mastersaf DFE.

Nota: Necessário criar um SCHEMA com o nome msaf_dfe
Sentença SQL: create schema msaf_dfe
No MS SQL Server é possível:

 Clicar sobre o Banco de dados >> Segurança >> Esquemas;
 Com botão direito do mouse >> Novo Esquema.
Exemplo de esquema

2. BAIXANDO OS INSTALADORES DO DFE MASTERSAF
Acessar portal Contact Center Mastersaf, com usuário e senha fornecidos. Baixar o
instalador na área de “Atualização de Versão” do DF-e.

3. INICIANDO O INSTALADOR DO MASTERSAF DFE
 Acessar a pasta onde os arquivos baixados foram salvos.

 Descompactar o mastersaf_dfe-X.X.zip
 Via prompt de comando, executar o arquivo:
o iniciar-instalador.bat para Windows.
o iniciar-instalador.sh para Linux.
 No prompt de comando escolher um diretório de instalação do produto (<ENTER> para padrão).
 A seguir, usuário e senha concedidos pela Mastersaf, de acordo figura que segue.
Nota: A senha não aparece em tela, portanto, assegurar-se que está sendo digitada corretamente.
Windows

Linux
 Aguardar processamento até receber a mensagem perguntando se deseja instalar todos os módulos:
o Se foi adquirido no modelo SaaS, responder “N” e instalar somente o módulo Integrador.
o Caso tenha sido adquirido para instalação In House, responder “S”.
 Depois, escolher qual o Sistema Gerenciador de Banco de Dados (Oracle, SQL Server ou Postgres).
 Preencher as informações relativas ao banco criado para o produto.
Nota: A senha de banco de dados não aparece em tela, portanto, assegurar-se que esteja sendo digitada
corretamente.
 Aguardar processamento até que a mensagem “Fim...” seja exibida.

 Executar o comando para atualização da base de dados, como segue abaixo (posicionar na pasta do
instalador):
Windows
Linux
 IMPORTANTE: caso seja necessário gerar o script para um arquivo, para encaminhar ao
administrador do banco de dados, executar:
o Windows: atualizar-bt.bat updateSQL 1> arquivo.sql 2> erros.log
o Linux: ./atualizar-bd.sh updateSQL > arquivo.sql
(esse comando irá gerar um arquivo chamado “arquivo.sql” contendo o script de criação/atualização
do banco)
4. INICIANDO O PORTAL MASTERSAF DFE
 Após a instalação do produto, vamos dar início aos módulos que compõe o produto.
8

 Para iniciar o portal da Mastersaf, na pasta tomcat\bin, executar o arquivo :
o startup.bat para Windows;
o startup.sh para Linux;
Windows
Linux
 A mensagem que deve ser mostrada com a inicialização do portal segue abaixo.
 Com o portal iniciado, acessar em um navegador o link http://localhost:8080/portal/mvc/login (onde

localhost é o ip ou nome da máquina no qual ele foi iniciado)

 Caso não tenha um login e senha para acesso, clique em “Minha Empresa não tem Cadastro” e
cadastre os seus dados para acesso, onde o arquivo de Licença liberado para sua empresa deverá ser
localizado através do botão Procurar, conforme abaixo:
10

 Confirme os dados apresentados após a seleção da Licença:
11

 Na próxima tela, clique em Habilitar as empresas cadastradas.
 Em seguida, selecionar o arquivo do certificado digital e digite sua senha.
12

5. INICIANDO O INTEGRADOR MASTERSAF DFE
 Para iniciar o Integrador, módulo responsável pela integração ERP <> Mastersaf DFE, abra o prompt
de comando.
 Posicione no diretório da instalação e execute o arquivo:
o iniciar-integrador.bat para Windows;
o iniciar-integrador.sh para Linux;
Windows
Linux
 O serviço monitora as pastas de ENTRADA (exemplo: txt/nfse_entrada), processando os arquivos que

contém as notas e enviando-as ao sistema.
 Depois que um arquivo é processado ele é movido de acordo com o resultado do processamento:
o Enviadas: quando o arquivo foi enviado com sucesso para o produto.
o Erro: quando ocorre um erro no arquivo processado – analisar logs.
13

Windows
Linux
14

6. INICIANDO A MENSAGERIA MASTERSAF DFE
 O módulo de Mensageria é responsável por toda a comunicação transmissão dos documentos.

 Para iniciá-lo, abrir o prompt de comando indicando o diretório da instalação e execute o arquivo:
o iniciar-mensageria.bat para Windows;
o iniciar-mensageria.sh para Linux;
Windows
Linux
7. ARQUIVOS DE CONFIGURAÇÃO
7.1. INSTALADOR
O arquivo de configuração do instalador Mastersaf DFE se encontra em:
config\settings.xml
Nele estão as configurações de Proxy, caso o instalador esteja sendo executado em uma máquina
com acesso restrito à Internet.
15

Configurações de Proxy no arquivo settings.xml
7.2. PORTAL
O arquivo de configuração do portal Mastersaf DFE se encontra em:
tomcat\conf\context.xml
Nele estão as configurações para:
 conexão com a base de dados;

 conta utilizada para envio dos emails pelo portal;
Arquivo de configuração context.xml
16

7.3. MENSAGERIA
Os arquivos de configuração do portal Mastersaf DFE se encontram em:
mensageria\config\db.properties
mensageria\config\email.properties
Neles estão as configurações para:
 db.properties: armazena as configurações de conexão com o banco;
Arquivo db.properites
 email.properties: armazena as configurações para os envios de email da mensageria

(quando um documento é aprovado, por exemplo).
17

Arquivo email.properties
7.4. INTEGRADOR
Os arquivos de configuração do integrador Mastersaf DFE se encontram em:
Integrador\integrador.properties
Neles estão as configurações do integrador, explicadas no manual de parametrização.
18


Mastersafdfe 1

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Mastersafdfe 1

Enviado por

Direitos autorais:

Formatos disponíveis

Mastersaf DFE

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

Visão geral dos módulos

 JDK 1.6 (Java Development Kit) instalado.

 Variável de ambiente PATH com o caminho da pasta “Bin” do JDK adicionado.

 Variável de ambiente JAVA_HOME apontando para o diretório de instalação do Java JDK.

RIO DE JANEIRO SÃO PAULO

Variáveis de ambiente no Linux

 Permissão de sistema para executar o script/bat de instalação.

RIO DE JANEIRO SÃO PAULO

 Criar um banco de dados para o Mastersaf DFE.

No MS SQL Server é possível:

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

 Acessar a pasta onde os arquivos baixados foram salvos.

RIO DE JANEIRO SÃO PAULO

 Aguardar processamento até que a mensagem “Fim...” seja exibida.

o Linux: ./atualizar-bd.sh updateSQL > arquivo.sql

4. INICIANDO O PORTAL MASTERSAF DFE

RIO DE JANEIRO SÃO PAULO

 Com o portal iniciado, acessar em um navegador o link http://localhost:8080/portal/mvc/login (onde

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

 O serviço monitora as pastas de ENTRADA (exemplo: txt/nfse_entrada), processando os arquivos que

RIO DE JANEIRO SÃO PAULO

RIO DE JANEIRO SÃO PAULO

 O módulo de Mensageria é responsável por toda a comunicação transmissão dos documentos.

O arquivo de configuração do instalador Mastersaf DFE se encontra em:

RIO DE JANEIRO SÃO PAULO

O arquivo de configuração do portal Mastersaf DFE se encontra em:

Nele estão as configurações para:

 conexão com a base de dados;

Arquivo de configuração context.xml

RIO DE JANEIRO SÃO PAULO

Os arquivos de configuração do portal Mastersaf DFE se encontram em:

Neles estão as configurações para:

 db.properties: armazena as configurações de conexão com o banco;

 email.properties: armazena as configurações para os envios de email da mensageria

RIO DE JANEIRO SÃO PAULO

Os arquivos de configuração do integrador Mastersaf DFE se encontram em:

Neles estão as configurações do integrador, explicadas no manual de parametrização.

RIO DE JANEIRO SÃO PAULO

Você também pode gostar