manual de deploy dfe v3 servidor de … · mastersaf dfe manual de deploy dfe v3 ... caso esteja...
TRANSCRIPT
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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:
5 Versão: 3.63.1
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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.
13 Versão: 3.63.1
Atualizado em: 11/09/2018
MASTERSAF DFE MANUAL DE DEPLOY DFE V3 – GLASSFISH
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.