Í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
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. 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
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
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
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
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; 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
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
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
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