SERVIÇOS DO WINDOWS
SERVIÇOS DO WINDOWS
MASTERSAF DFE
ÍNDICE
INICIANDO OS MÓDULOS COMO SERVIÇO DO WINDOWS VIA APACHE PROCRUN....................................... 3
INSTALAÇÃO ...................................................................................................................................................... 3
CONFIGURAÇÕES AVANÇADAS....................................................................................................................... 5
REMOVER SERVIÇO........................................................................................................................................... 6
INICIANDO OS MÓDULOS COMO SERVIÇO DO WINDOWS VIA WRAPPER ..................................................... 7
MENSAGERIA ..................................................................................................................................................... 7
INTEGRADOR ..................................................................................................................................................... 7
PORTAL (TOMCAT) ............................................................................................................................................ 8
EXTRATOR......................................................................................................................................................... 15
PRINTER SERVICE ............................................................................................................................................ 16
PRINTER CONSOLE .......................................................................................................................................... 16
OBSERVAÇÕES ..................................................................................................................................................... 17
SUPORTE TÉCNICO................................................................................................................................................ 18
Versão: 3.30.1
2
SERVIÇOS DO WINDOWS
MASTERSAF DFE
INICIANDO OS MÓDULOS COMO SERVIÇO DO
WINDOWS VIA APACHE PROCRUN
Para executar os módulos: Mensageria, Integrador, Extrator, PrinterService e PrinterConsole como serviços
do Windows utilizando a ferramenta Apache Daemons Procrun, siga os passos abaixo que mostram como a
configuração deve ser realizada.
INSTALAÇÃO
Finalize a Instalação dos módulos do Mastersaf DFE (versão 3.30.1 ou superior).
Por padrão, os arquivos “.bat” vem preparados para sistemas operacionais 64 bits (x64).
Em ambientes 32 bits (x86) é necessário editar o arquivo “<modulo> - criar servico.bat” de cada
módulo, segue exemplo:
“extrator – criar servico.bat” - Encontrado na pasta “servico-windows” de cada módulo (por exemplo:
“c:/mastersaf/extrator/servico-windows/extrator – criar servico.bat”) e alterar a variável “executavel”
de “procrun-x64.exe” para “procrun-x86.exe”, como mostrado abaixo:
Versão: 3.30.1
3
SERVIÇOS DO WINDOWS
MASTERSAF DFE
O instalador configura estes arquivos “.bat”, conforme o caminho da instalação informado. Se o local
onde os processos forem executados não for o caminho original, é necessário alterar também a
variável “caminhoInstalacao”, informando o caminho do módulo, como mostrado a seguir:
Realizadas as verificações dos passos acima, basta apenas executar o arquivo “.bat” alterado. Se tudo
ocorrer bem, receberá a seguinte mensagem:
Versão: 3.30.1
4
SERVIÇOS DO WINDOWS
MASTERSAF DFE
CONFIGURAÇÕES AVANÇADAS
Se for necessário alterar a configuração de inicialização dos serviços ou as configurações do Java após
a instalação de um serviço, é possível visualizar a sua janela de configuração, abrindo o arquivo
“<modulo> - editar servico.bat” disponível na pasta “servico-windows” de cada módulo. Exemplo:
“c:/mastersaf/extrator/servico-windows/extrator – criar servico.bat”.
Navegando pelas as abas desta tela, é possível alterar todas as propriedades avançadas do serviço,
tais como: o nome de exibição do serviço, inicialização manual ou automática, nível de log e caminhos
para os arquivos de log, configurações da JVM, parâmetros de memória, inicialização do Java, entre
outras opções.
Versão: 3.30.1
5
SERVIÇOS DO WINDOWS
MASTERSAF DFE
REMOVER SERVIÇO
Para remover um serviço existente você tem duas opções:
 Executar o arquivo “<modulo> - remover servico.bat” disponível na pasta “servico-windows” de
cada módulo. Exemplo: “c:/mastersaf/extrator/servico-windows/extrator – remover
servico.bat”.
 Se o arquivo acima não existir mais, é possível executar o comando de exclusão do serviço pelo
prompt de comando do windows, navegando até a pasta onde estão os arquivos executáveis do
Apache Procrun. Exemplo: “c:/mastersaf/extrator/servico-windows”.
Em seguida execute o comando abaixo, substituindo “nomeDoServico” pelo nome do serviço
que deseja excluir:
Versão: 3.30.1
6
SERVIÇOS DO WINDOWS
MASTERSAF DFE
INICIANDO OS MÓDULOS COMO SERVIÇO DO
WINDOWS VIA WRAPPER
MENSAGERIA
Para iniciar o módulo da ‘Mensageria’ como ‘Serviço’, execute os procedimentos abaixo:
Obs.: Os arquivos em questão são gerados pelo instalador na pasta ‘raiz’ da mensageria.
 Configurar o arquivo ‘wrapper.conf’ de acordo com timezone da região (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;
 Executar o arquivo ‘installService.bat’;
 Iniciar o serviço do Windows chamado ‘Mastersaf DF-e Mensageria - V3’.
INTEGRADOR
Para iniciar o módulo do ‘Integrador’ como ‘Serviço’, execute os procedimentos abaixo:
Obs.: Os arquivos em questão são gerados pelo instalador na pasta ‘raiz’ do integrador.
 Configurar o arquivo ‘wrapper.conf’ de acordo com timezone da região (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;
 Executar o arquivo ‘installService.bat’;
 Iniciar o serviço do Windows chamado ‘Mastersaf DF-e IntegradorTxt – V3’.
Versão: 3.30.1
7
SERVIÇOS DO WINDOWS
MASTERSAF DFE
PORTAL (TOMCAT)
Para iniciar o módulo do ‘Portal (Tomcat)’ como ‘Serviço’, execute os procedimentos abaixo:
 Antes de prosseguir verifique se o Tomcat foi instalado corretamente através do instalador e
faça o backup de suas configurações do banco de dados.
Salve o arquivo ‘tomcat/conf/context.xml’ com outro nome, por exemplo: ‘Copy of context.xml’;
 Pare o serviço do Tomcat executando o arquivo ‘tomcat/bin/shutdown.bat’;
 Download do Tomcat.
Faça o download do Tomcat Windows Service Installer clicando aqui.
 Executar o Instalador do Tomcat e clicar no botão ‘NEXT’.
Versão: 3.30.1
8
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Selecionar o ‘Service Startup’. Clique no “+” para abrir a opção de selecionar o ‘Service Startup’
e marque-o. Clique em seguida no botão ‘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 contrário, deixe como está.
Clique no botão ‘Next >’:
Versão: 3.30.1
9
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Procure a pasta onde está instalado o’ jdk 1.6’. Selecione a pasta do ‘JDK’, pois o sistema não será
executado somente com o JRE.
Versão: 3.30.1
10
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Procure e selecione a pasta onde está instalado o Tomcat da MASTERSAF:
Versão: 3.30.1
11
SERVIÇOS DO WINDOWS
MASTERSAF DFE
Importante: O Instalador pode perguntar se deseja substituir o conteúdo da pasta. Confirme clicando
no botão ‘Yes’.
Versão: 3.30.1
12
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Configurar o Tomcat. Verifique que o instalador cria um ícone na área de notificação do Windows
(Aquele espaço perto do relógio do Windows no canto inferior direito).
Clique com o botão direito e irá aparecer o menu abaixo. Clique na opção Configure.
 Configurando variáveis de ambiente:
a. Clique na aba ‘Java’.
b. Acrescente na ‘Text Área’ chamada ‘Java Options’ as seguintes variáveis 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: Não apagar o conteúdo do ‘Java Options’. Apenas acrescente as variáveis,
considerando uma por linha.
Versão: 3.30.1
13
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Configurar inicialização automática:
a. Clique na aba ‘General’;
b. Selecione o modo ‘Automatic’ em ‘Startup type’;
c. Se o Tomcat estiver em execução, pare-o clicando no botão ‘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 botão ‘Start ‘.
Versão: 3.30.1
14
SERVIÇOS DO WINDOWS
MASTERSAF DFE
EXTRATOR
Para iniciar o módulo do ‘Extrator’ como ‘Serviço’, execute os procedimentos abaixo:
Obs.: Os arquivos em questão são gerados pelo instalador.
 Criar, se não existir, a pasta ‘log’ dentro da pasta ‘raiz’ do extrator;
 Se necessário, executar o arquivo ‘configurar-extrator.bat’ para realizar as configurações do
módulo;
 Configurar o arquivo ‘wrapper.conf’ de acordo com timezone da região (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;
 Executar o arquivo ‘installService.bat’;
Versão: 3.30.1
15
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Iniciar o serviço do Windows chamado “Mastersaf DF-e Extrator de E-mail - V3”.
PRINTER SERVICE
Para iniciar o módulo do ‘Printer Service’ como ‘Serviço’, execute os procedimento abaixo:
Obs.: Os arquivos em questão são gerados pelo instalador.
 Crie a variável de ambiente ‘PRINTER_DIR’, apontando para o diretório onde os arquivos do
‘Printer Service’ devem ser gerados;
 Configurar o arquivo ‘wrapper.conf’ de acordo com timezone da região (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: Configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;
 Executar o arquivo ‘installService.bat’;
 Iniciar o serviço do Windows chamado ‘Printer Service’;
 Os novos arquivos devem ser gerados na pasta apontada pela variável de ambiente
‘PRINTER_DIR’;
 Se necessária alguma alteração na configuração do modulo, deve-se parar o serviço e realizar
as alterações necessárias no arquivo de configuração que se encontra na pasta parametrizada
na variável de ambiente “PRINTER_DIR”/config/ config.properties.
PRINTER CONSOLE
Para iniciar o módulo do ‘Printer Service’ como ‘Serviço’, execute os procedimentos abaixo (Arquivos em
questão são gerados pelo instalador):
Versão: 3.30.1
16
SERVIÇOS DO WINDOWS
MASTERSAF DFE
 Criar a variável de ambiente ‘PRINTER_SERVICE_URL’, que deve indicar a ‘url’, cujo ‘Printer
Service’ estará acessível. Exemplo: ‘http://localhost:9092/printerservice’;
 Configurar o arquivo ‘wrapper.conf’ de acordo com timezone da região (Ex: Duser.timezone=America/Sao_Paulo).
Obs.: configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;
 Executar o arquivo ‘installService.bat’;
 O modulo ‘PrinterService’ deve estar iniciado para que o ‘printerconsole’ funcione;
 Iniciar o serviço do Windows chamado ‘Printer Console’;
OBSERVAÇÕES
Em alguns ambientes pode ocorrer uma situação, em que, o servidor onde o serviço esta instalado,
pertença a um domínio e o usuário não tenha permissão para que todas as tarefas do serviço sejam
executadas corretamente. Neste caso, acessar as propriedades do serviço em questão e, na aba ‘Logon’
atribuir uma conta válida, conforme imagem a seguir:
Versão: 3.30.1
17
SERVIÇOS DO WINDOWS
MASTERSAF DFE
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 02 (Atendimento das Soluções DFE).
Nosso horário de atendimento é de segunda à sexta-feira de 09h às 18h.
Versão: 3.30.1
18