MASTERSAFDFE_10 - SERVIÇOS DO WINDOWS.pdf
-
Upload
jorgecarvalho -
Category
Documents
-
view
36 -
download
5
Transcript of 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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
Procure e selecione a pasta onde está instalado o Tomcat da MASTERSAF:
Versão: 3.30.1 11
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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
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;
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
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’;
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
MASTERSAF DFE SERVIÇOS DO WINDOWS
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