manual de deploy dfe v3 servidor de … · mastersaf dfe manual de deploy dfe v3 ... caso esteja...

MANUAL DE DEPLOY DFE V3 SERVIDOR DE APLICAÇÃO GLASSFISH

2 Versão: 3.63.1

Atualizado em: 11/09/2018

MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH

SUMÁRIO

OBJETIVO ......................................................................................................................................................................... 3

PRÉ-REQUISITOS ............................................................................................................................................................ 3

CONFIGURANDO GLASSFISH ........................................................................................................................................ 4

CONFIGURANDO APLICAÇÃO PARA CODIFICAÇÃO UTF-8 .................................................................................. 5

REALIZANDO O DEPLOY ............................................................................................................................................... 11

SUPORTE TÉCNICO ........................................................................................................................................................ 13

3 Versão: 3.63.1



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).

4 Versão: 3.63.1



CONFIGURANDO GLASSFISH

Caso esteja utilizando Java 8, antes de iniciar o serviço/domínio do Glassfish V3 é importante realizar a seguinte alteração: 1. Abrir o arquivo "osgi.properties" no seguinte caminho "<instalação do glassfish 3>/glassfish/config/"; 2. No final do arquivo adicionar o seguinte conteúdo: "jre-1.8=${jre-1.7}"; 3. Salvar e fechar o arquivo de configuração e seguir os passos abaixo deste manual. 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:

http://localhost:4848/

5 Versão: 3.63.1



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:

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.

6 Versão: 3.63.1



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.

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:

7 Versão: 3.63.1



Na próxima tela informar os dados da conexão e finalizar.

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.

8 Versão: 3.63.1



Crie o JNDI Name “jdbc/dfe” para o pool criado no passo anterior.

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.

9 Versão: 3.63.1



Segue exemplo abaixo.

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”;

10 Versão: 3.63.1



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.

11 Versão: 3.63.1



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.

12 Versão: 3.63.1



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.

http://localhost:8080/portal

13 Versão: 3.63.1



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.

manual de deploy dfe v3 servidor de … · mastersaf dfe manual de deploy dfe v3 ... caso esteja...

Documents