SERVIOS DO WINDOWS

SERVIOS DO WINDOWS

MASTERSAF DFE

NDICE
INICIANDO OS MDULOS COMO SERVIO DO WINDOWS VIA APACHE PROCRUN....................................... 3
INSTALAO ...................................................................................................................................................... 3
CONFIGURAES AVANADAS....................................................................................................................... 5
REMOVER SERVIO........................................................................................................................................... 6
INICIANDO OS MDULOS COMO SERVIO DO WINDOWS VIA WRAPPER ..................................................... 7
MENSAGERIA ..................................................................................................................................................... 7
INTEGRADOR ..................................................................................................................................................... 7
PORTAL (TOMCAT) ............................................................................................................................................ 8
EXTRATOR......................................................................................................................................................... 15
PRINTER SERVICE ............................................................................................................................................ 16
PRINTER CONSOLE .......................................................................................................................................... 16
OBSERVAES ..................................................................................................................................................... 17
SUPORTE TCNICO................................................................................................................................................ 18

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

INICIANDO OS MDULOS COMO SERVIO DO

WINDOWS VIA APACHE PROCRUN
Para executar os mdulos: Mensageria, Integrador, Extrator, PrinterService e PrinterConsole como servios
do Windows utilizando a ferramenta Apache Daemons Procrun, siga os passos abaixo que mostram como a
configurao deve ser realizada.

INSTALAO
Finalize a Instalao dos mdulos do Mastersaf DFE (verso 3.30.1 ou superior).
Por padro, os arquivos .bat vem preparados para sistemas operacionais 64 bits (x64).
Em ambientes 32 bits (x86) necessrio editar o arquivo <modulo> - criar servico.bat de cada
mdulo, segue exemplo:
extrator criar servico.bat - Encontrado na pasta servico-windows de cada mdulo (por exemplo:
c:/mastersaf/extrator/servico-windows/extrator criar servico.bat) e alterar a varivel executavel
de procrun-x64.exe para procrun-x86.exe, como mostrado abaixo:

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

O instalador configura estes arquivos .bat, conforme o caminho da instalao informado. Se o local
onde os processos forem executados no for o caminho original, necessrio alterar tambm a
varivel caminhoInstalacao, informando o caminho do mdulo, como mostrado a seguir:

Realizadas as verificaes dos passos acima, basta apenas executar o arquivo .bat alterado. Se tudo
ocorrer bem, receber a seguinte mensagem:

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

CONFIGURAES AVANADAS
Se for necessrio alterar a configurao de inicializao dos servios ou as configuraes do Java aps
a instalao de um servio, possvel visualizar a sua janela de configurao, abrindo o arquivo
<modulo> - editar servico.bat disponvel na pasta servico-windows de cada mdulo. Exemplo:
c:/mastersaf/extrator/servico-windows/extrator criar servico.bat.

Navegando pelas as abas desta tela, possvel alterar todas as propriedades avanadas do servio,
tais como: o nome de exibio do servio, inicializao manual ou automtica, nvel de log e caminhos
para os arquivos de log, configuraes da JVM, parmetros de memria, inicializao do Java, entre
outras opes.

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

REMOVER SERVIO
Para remover um servio existente voc tem duas opes:
Executar o arquivo <modulo> - remover servico.bat disponvel na pasta servico-windows de
cada mdulo. Exemplo: c:/mastersaf/extrator/servico-windows/extrator remover
servico.bat.
Se o arquivo acima no existir mais, possvel executar o comando de excluso do servio pelo
prompt de comando do windows, navegando at a pasta onde esto os arquivos executveis do
Apache Procrun. Exemplo: c:/mastersaf/extrator/servico-windows.
Em seguida execute o comando abaixo, substituindo nomeDoServico pelo nome do servio
que deseja excluir:

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

INICIANDO OS MDULOS COMO SERVIO DO

WINDOWS VIA WRAPPER
MENSAGERIA
Para iniciar o mdulo da Mensageria como Servio, execute os procedimentos abaixo:
Obs.: Os arquivos em questo so gerados pelo instalador na pasta raiz da mensageria.
Configurar o arquivo wrapper.conf de acordo com timezone da regio (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horrio for diferente do fuso de So Paulo;
Executar o arquivo installService.bat;
Iniciar o servio do Windows chamado Mastersaf DF-e Mensageria - V3.

INTEGRADOR
Para iniciar o mdulo do Integrador como Servio, execute os procedimentos abaixo:
Obs.: Os arquivos em questo so gerados pelo instalador na pasta raiz do integrador.
Configurar o arquivo wrapper.conf de acordo com timezone da regio (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horrio for diferente do fuso de So Paulo;
Executar o arquivo installService.bat;
Iniciar o servio do Windows chamado Mastersaf DF-e IntegradorTxt V3.

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

PORTAL (TOMCAT)
Para iniciar o mdulo do Portal (Tomcat) como Servio, execute os procedimentos abaixo:
Antes de prosseguir verifique se o Tomcat foi instalado corretamente atravs do instalador e
faa o backup de suas configuraes do banco de dados.
Salve o arquivo tomcat/conf/context.xml com outro nome, por exemplo: Copy of context.xml;
Pare o servio do Tomcat executando o arquivo tomcat/bin/shutdown.bat;
Download do Tomcat.
Faa o download do Tomcat Windows Service Installer clicando aqui.
Executar o Instalador do Tomcat e clicar no boto NEXT.

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

Selecionar o Service Startup. Clique no + para abrir a opo de selecionar o Service Startup
e marque-o. Clique em seguida no boto Next >:

Escolha a porta do Tomcat. Se o Glassfish estiver sendo executado na porta 8080, altere a
porta default do Tomcat para outra, por exemplo: 9090. Caso contrrio, deixe como est.
Clique no boto Next >:

Verso: 3.30.1

SERVIOS DO WINDOWS

MASTERSAF DFE

Procure a pasta onde est instalado o jdk 1.6. Selecione a pasta do JDK, pois o sistema no ser
executado somente com o JRE.

Verso: 3.30.1

10

SERVIOS DO WINDOWS

MASTERSAF DFE

Procure e selecione a pasta onde est instalado o Tomcat da MASTERSAF:

Verso: 3.30.1

11

SERVIOS DO WINDOWS

MASTERSAF DFE

Importante: O Instalador pode perguntar se deseja substituir o contedo da pasta. Confirme clicando
no boto Yes.

Verso: 3.30.1

12

SERVIOS DO WINDOWS

MASTERSAF DFE

Configurar o Tomcat. Verifique que o instalador cria um cone na rea de notificao do Windows
(Aquele espao perto do relgio do Windows no canto inferior direito).
Clique com o boto direito e ir aparecer o menu abaixo. Clique na opo Configure.

Configurando variveis de ambiente:

a. Clique na aba Java.
b. Acrescente na Text rea chamada Java Options as seguintes variveis de ambiente:
-Dfile.encoding=UTF-8
-Duser.timezone=America/Sao_Paulo
-Duser.language=pt
-Duser.country=BR
-Xmx1g
-Xms512m
-XX:PermSize=256m
-XX:MaxPermSize=256m
Importante: No apagar o contedo do Java Options. Apenas acrescente as variveis,
considerando uma por linha.

Verso: 3.30.1

13

SERVIOS DO WINDOWS

MASTERSAF DFE

Configurar inicializao automtica:

a. Clique na aba General;
b. Selecione o modo Automatic em Startup type;
c. Se o Tomcat estiver em execuo, pare-o clicando no boto Stop;
d. Volte o backup do arquivo context.xml, apagando o arquivo criado pelo instalador do
Tomcat e renomeie seu backup para context.xml na pasta tomcat/conf;
e. Inicialize o Tomcat clicando no boto Start .

Verso: 3.30.1

14

SERVIOS DO WINDOWS

MASTERSAF DFE

EXTRATOR
Para iniciar o mdulo do Extrator como Servio, execute os procedimentos abaixo:
Obs.: Os arquivos em questo so gerados pelo instalador.
Criar, se no existir, a pasta log dentro da pasta raiz do extrator;
Se necessrio, executar o arquivo configurar-extrator.bat para realizar as configuraes do
mdulo;
Configurar o arquivo wrapper.conf de acordo com timezone da regio (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: configure, somente, se seu fuso-horrio for diferente do fuso de So Paulo;
Executar o arquivo installService.bat;

Verso: 3.30.1

15

SERVIOS DO WINDOWS

MASTERSAF DFE

Iniciar o servio do Windows chamado Mastersaf DF-e Extrator de E-mail - V3.

PRINTER SERVICE
Para iniciar o mdulo do Printer Service como Servio, execute os procedimento abaixo:
Obs.: Os arquivos em questo so gerados pelo instalador.
Crie a varivel de ambiente PRINTER_DIR, apontando para o diretrio onde os arquivos do
Printer Service devem ser gerados;
Configurar o arquivo wrapper.conf de acordo com timezone da regio (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horrio for diferente do fuso de So Paulo;
Executar o arquivo installService.bat;
Iniciar o servio do Windows chamado Printer Service;
Os novos arquivos devem ser gerados na pasta apontada pela varivel de ambiente
PRINTER_DIR;
Se necessria alguma alterao na configurao do modulo, deve-se parar o servio e realizar
as alteraes necessrias no arquivo de configurao que se encontra na pasta parametrizada
na varivel de ambiente PRINTER_DIR/config/ config.properties.

PRINTER CONSOLE
Para iniciar o mdulo do Printer Service como Servio, execute os procedimentos abaixo (Arquivos em
questo so gerados pelo instalador):

Verso: 3.30.1

16

SERVIOS DO WINDOWS

MASTERSAF DFE

Criar a varivel de ambiente PRINTER_SERVICE_URL, que deve indicar a url, cujo Printer
Service estar acessvel. Exemplo: http://localhost:9092/printerservice;
Configurar o arquivo wrapper.conf de acordo com timezone da regio (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: configure, somente, se seu fuso-horrio for diferente do fuso de So Paulo;
Executar o arquivo installService.bat;
O modulo PrinterService deve estar iniciado para que o printerconsole funcione;
Iniciar o servio do Windows chamado Printer Console;

OBSERVAES
Em alguns ambientes pode ocorrer uma situao, em que, o servidor onde o servio esta instalado,
pertena a um domnio e o usurio no tenha permisso para que todas as tarefas do servio sejam
executadas corretamente. Neste caso, acessar as propriedades do servio em questo e, na aba Logon
atribuir uma conta vlida, conforme imagem a seguir:

Verso: 3.30.1

17

SERVIOS DO WINDOWS

MASTERSAF DFE

SUPORTE TCNICO
Para dvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe de
Suporte Tcnico MASTERSAF pelo Telefone:

(11) 2159-0600 opo 02 (Atendimento das Solues DFE).

Nosso horrio de atendimento de segunda sexta-feira de 09h s 18h.

Verso: 3.30.1

18