MANUAL DE DEPLOY DFE V3 SERVIDOR DE APLICAÇÃO GLASSFISH
SUMÁRIO OBJETIVO... 3 PRÉ-REQUISITOS... 3 CONFIGURANDO GLASSFISH... 4 CONFIGURANDO APLICAÇÃO PARA CODIFICAÇÃO UTF-8... 4 REALIZANDO O DEPLOY... 11 SUPORTE TÉCNICO... 13 2
OBJETIVO Este documento tem como objetivo orientar sobre os procedimentos necessários para realizar o DEPLOY do MASTERSAF DFE V3 através do servidor de aplicação Glassfish. PRÉ-REQUISITOS Glassfish instalado conforme recomendações do fornecedor (consulte manual de Requisitos e Sizing para saber versões estão homologadas para o DFE V3); MASTERSAF DFE V3 (instalado, conforme manual padrão de instalação, disponível no site do Contact Center > Base de Conhecimento Cliente > Mastersaf DFE > Manuais Técnicos). 3
CONFIGURANDO GLASSFISH Iniciar o domain default do glassfish: C:\java\glassfishv3\bin>asadmin start-domain domain1 Acessar o painel de administração do Glassfish (http://localhost:4848), conforme imagens a seguir: CONFIGURANDO APLICAÇÃO PARA CODIFICAÇÃO UTF-8 A seguir é necessário configurar encoding UTF-8. Etapas para executar esta tarefa: Para realizar as configurações de JVM para encoding UTF-8, acesse o menu Configuration > JVM Settings no menu lateral e adicione a opção -Dfile.encoding=UTF-8 no campo Valor para o servidor que será utilizado pelo MASTERSAF DFE, conforme imagem a seguir: 4
Importante: Quando utilizado o banco de dados Oracle 12 deve ser configurado um argumento adicional ao UTF-8, conforme abaixo: Dhibernate.dialect_resolvers=br.com.mastersaf.pacote.resolver.DfeDialectResolver Salve a alteração. Copiar o arquivo.jar do driver JDBC do Oracle para o diretório glassfish\domains\domain1\lib do domínio a ser utilizado pelo MASTERSAF DFE. Até a versão 3.43.0 utilizar o arquivo ojdbc-14.jar. Após esta versão utilizar o arquivo ojdbc-6.1.jar que esta disponível com o produto. Reiniciei o domínio e instâncias para o driver ficar disponível. 5
Em seguida, para configurar os Pools de conexão JDBC, acesse o menu Resources > JDBC > Connection Pools no menu lateral e abra a lista JDBC selecionando a opção Connection Pools, botão New..., como mostra a imagem a seguir. Informar os dados do pool de conexões para o Oracle, conforme abaixo: Na próxima tela informar os dados da conexão e finalizar. 6
Informe os dados de conexão com o banco de dados do MASTERSAF DFE V3: URL contendo driver, IP do servidor, porta e instância; Usuário para conexão com banco de dados; Senha para conexão com banco de dados. Em seguida, para criar um novo recurso de JDBC, acesse o menu Resources > JDBC > JDBC Resources no menu lateral e crie um novo JDBC Resources, como mostra a imagem a seguir. Crie o JNDI Name jdbc/dfe para o pool criado no passo anterior. 7
Obs.: Repita esse procedimento para criação dos datasources de Autenticação (jdbc/auth) e Segurança (jdbc/security). Para configurar os valores padrões de conexão com o banco de dados, abra a aba Connection Pools clique na conexão criada e configura os seguintes parâmetros: Initial and Minimum Pool Size: 10; Maximum Pool Size: 100; Max Wait Time: 1000. Segue exemplo abaixo. 8
Ao concluir a configuração do Data Source, acesse o menu Resources > JMS Resources > JavaMail Sessions no menu lateral e, em seguida, clique no botão New, como mostrado na imagem. Lembrando que a configuração do e-mail é obrigatória para realizar o Deploy. A seguir, informe os dados de configuração de e-mail: *JNDI Name Deve ser mail/session ; 9
As propriedades abaixo são inseridas clicando em Add Property. mail.smtp.auth=true; mail.user=endereceo_email@provedor E-mail utilizado para autenticar o envio de e-mails do produto; mail.password=senha_email Senha do e-mail; mail.transport.protocol=smtp; mail.smtp.host=servidor_smtp Servidor smtp para envio de e-mails; mail.smtp.starttls.enable=true. Obs.: Reiniciar o domínio para as alterações terem efeito no servidor. 10
REALIZANDO O DEPLOY Para iniciar o processo de deploy do produto é necessário enviar o artefato war para o servidor. Para isso, clique em Applications no menu lateral (Common Tasks) e, em seguida, em Deploy, como mostra a imagem a seguir. Na tela de Assistente de Instalação da Aplicação, faça o upload do war, conforme demonstrado na imagem abaixo. 11
O instalador do MASTERSAF DFE V3 sempre gera um backup dos artefatos que foram baixados. Por isto, recomendamos sempre realizar o deploy no glassfish dos arquivos portal.war e webservice.war e ignorar os arquivos que tem a versão do produto. Após os passos descritos acima, clique em OK. Ao finalizar o processo de instalação, será possível acessar a aplicação. Ao acessar o MASTERSAF DFE via browser (ex.: http://localhost:8080/portal), você visualizará a tela inicial de login de acesso, conforme abaixo: Digite as informações de login e senha. A senha de acesso será disponibilizada pela MASTERSAF juntamente com o arquivo de licenciamento. Obs.: Repita o procedimento acima para realizar o deploy do WebService. 12
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 2 (Atendimento das Soluções DFE). Nosso horário de atendimento é de segunda a sexta-feira das 9h às 18h. 13