MASTERSAFDFE_10 - SERVIÇOS DO WINDOWS.pdf

SERVIÇOS DO WINDOWS

MASTERSAF DFE SERVIÇOS DO WINDOWS

Í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


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

MASTERSAF DFE SERVIÇOS DO WINDOWS 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


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


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


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.





Iniciar o serviço do Windows chamado ‘Mastersaf DF-e IntegradorTxt – V3’.

Versão: 3.30.1 7


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

http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.32/bin/apache-tomcat-6.0.32.exe

MASTERSAF DFE SERVIÇOS DO WINDOWS 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

MASTERSAF DFE SERVIÇOS DO WINDOWS 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


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

Versão: 3.30.1 11


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

MASTERSAF DFE SERVIÇOS DO WINDOWS 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


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


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;



Obs.: configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;


Versão: 3.30.1 15

MASTERSAF DFE SERVIÇOS DO WINDOWS 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;





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

MASTERSAF DFE SERVIÇOS DO WINDOWS 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’;



Obs.: configure, somente, se seu fuso-horário for diferente do fuso de São Paulo;


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


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

Documents

MASTERSAFDFE_10 - SERVIÇOS DO WINDOWS.pdf