MANUAL DE DEPLOY DFE V3
SUMÁRIO OBJETIVO... 3 PRÉ-REQUISITOS... 3 CONFIGURANDO O WEBLOGIC... 3 REALIZANDO O DEPLOY... 15 JROCKIT... 20 FAQ... 21 ORACLE RAC... 23 SUPORTE TÉCNICO... 24 2
OBJETIVO Este documento tem como objetivo descrever os procedimentos para realizar o processo de Deploy em servidor de aplicação Weblogic para o produto MASTERSAF DFE V3. PRÉ-REQUISITOS Weblogic instalado conforme recomendações do fornecedor (consulte manual de Requisitos e Sizing para saber versões estão homologadas para o DFE V3); Instalação do MASTERSAF DFE V3 (ver manual padrão de instalação do produto). CONFIGURANDO O WEBLOGIC Acessar o painel de administração do Weblogic e efetuar login como Administrador. 3
Se o Weblogic estiver em modo de Produção, é necessário clicar no botão Lock & Edit. Configurar o encoding UTF-8 para o servidor que será utilizado pelo DFE. Selecionar o servidor que irá disponibilizar o DFE. Selecionar a opção Configuration > Server Start e informar -Dfile.encoding=UTF-8 no campo Arguments. 4
IMPORTANTE: Quando utilizado o banco de dados Oracle 12 deve ser configurado um argumento adicional ao UTF-8 para a JVM, conforme abaixo: Dhibernate.dialect_resolvers=br.com.mastersaf.pacote.resolver.DfeDialectResolver Salvar e Ativar as alterações. Em seguida, clique em Data Sources no menu lateral (Domain Structure) e abra a lista New na Aba Configuration, selecionando a opção Generic Data Source, como demonstrado na imagem abaixo. 5
Na tela a seguir, crie o JDBC Data Source, informando no campo Name e JNDI Name do Data Source a seguinte informação: jdbc/dfe. Após informar o nome do Data Source, clique no botão Next. No próximo passo, selecione no campo Database Driver o driver de conexão com o banco de dados. 6
Na tela a seguir, somente clicar no botão Next. Informe os dados de conexão com o banco de dados do MASTERSAF DFE V3: Nome da base de dados, SID ou Serviço; Endereço do servidor onde se encontra o banco de dados; Porta de conexão com o banco de dados; Usuário para conexão com banco de dados; Senha para conexão com banco de dados. Clique no botão Next. 7
Na próxima tela é possível testar a conexão com o banco de dados. Para isso, clique no botão Test Configuration, conforme demonstrado na imagem abaixo. Ao finalizar o teste de conexão o sistema deverá apresentar a tela a seguir com a mensagem de conexão bem sucedida (Connection test succeeded). Clique no botão Next e marque no campo Servers o servidor para vincular as configurações do banco de dados, conforme mostra a imagem. A próxima tela traz um resumo do processo de criação do Data Source e apresentará a mensagem 8
informando que todas as configurações foram realizadas. Recomendamos aumentar para a configuração acima a quantidade máxima de conexões. Clique em Data Sources no menu lateral (Domain Structure) e, em seguida, selecione o Data Source a ser configurado. Acessar Configuration > Connection Pool e aumentar o valor do campo Maximum Capacity para o valor desejado. Salvar e Ativar as alterações. ATENÇÃO: Repita esse procedimento para criação dos datasources de Autenticação (jdbc/auth) e Segurança (jdbc/security). 9
Ao concluir a configuração do Data Source clique em Mail Sessions no menu lateral e, em seguida, clique no botão New, como mostrado na imagem. A seguir, informe os dados de configuração de e-mail: *Name: Deve ser mail/session *JNDI Name Deve ser mail/session mail.smtp.auth=true; mail.user=endereceo_email@provedor 10
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. Inserir as informações a seguir no JavaMail Properties, que devem ser inseridas entre os delimitadores {code} e o final de cada parâmetro tem que ser separado por ;, conforme o exemplo abaixo: {code} mail.from=teste@dfe.mastersaf.com.br; mail.smtp.port=porta; mail.debug=true; mail.transport.protocol=smtp; mail.user=endereço_email@provedor; mail.smtp.host=servidor_smtp; mail.smtp.auth=false; {code} 11
Marque a seguir, no campo Servers, o servidor para vincular as configurações de e-mail, como demonstrado na imagem abaixo. Após esses passos, clique no botão Finish. A próxima tela traz um resumo do processo de configuração de e-mail e apresentará a mensagem informando que todas as configurações foram realizadas. 12
Após concluir a configuração de E-mail e Data Source, confirmar as alterações clicando no botão Activate Changes. O próximo passo é para verificar as configurações dos servidores. Clique em Servers no menu lateral e selecione AdminServer na Aba Configuration (O Nome do Server pode estar diferente), conforme mostrado na imagem a seguir. Ao concluir as configurações, será exibida a tela abaixo. 13
No menu lateral, abra a opção jdbc. Devera conter os seguintes datasources : auth, dfe e security como mostrado na imagem abaixo. A seguir, abra no menu lateral a opção mail e, clique em session. Após esse passo, deverá ser exibida uma tela semelhante à mostrada na figura abaixo. 14
REALIZANDO O DEPLOY Para iniciar o processo de deploy do produto é necessário enviar o artefato war para o servidor. Para isso, clique em Deployments no menu lateral (Domain Structure) e, em seguida, em Install, como mostra a imagem a seguir. Na tela de Assistente de Instalação da Aplicação, clique no link upload your file(s), conforme demonstrado na imagem abaixo. 15
No passo a seguir, clique no botão marcado para escolher o arquivo, conforme demonstrado na tela abaixo. Navegue até o diretório onde se encontra o artefato war do produto (\portal\portal.war) e o selecione. O instalador do DFE V3 sempre gera um backup dos artefatos que já foram baixados. Por isto, recomendamos sempre realizar o deploy no weblogic dos arquivos portal.war e webservice.war e ignorar os arquivos que tem a versão do produto. Após os passos descritos acima, ao lado do botão Escolher Arquivo, estará referenciado o nome do artefato war. 16
Clique no botão Next. Marque a opção Install this deployment as an application e clique no botão Next. Na próxima tela não é necessária nenhuma configuração, apenas clique no botão Next. 17
Após esses passos, clique no botão Finish. 18
Após executar os procedimentos para a instalação do produto, clique no botão Save como mostra a imagem abaixo. Ao final do processo, o Weblogic fará o Deploy da aplicação e na tela de resumo do Deployments, o indicador de Condições do Sistema exibirá OK, sinalizando que o Deploy foi realizado com sucesso. Ao finalizar o processo de instalação, será possível acessar a aplicação. Ao acessar o produto via browser (ex.: http://localhost:7001/portal), você visualizará a tela inicial de login de acesso ao produto. 19
Digite as informações de login e senha. A senha de acesso será disponibilizada pela MASTERSAF juntamente com o arquivo de licenciamento. ATENÇÃO: Repita o procedimento acima para realizar o deploy do WebService. JROCKIT A configuração do servidor Weblogic para utilizar a JVM JRockit, deve seguir as seguintes configurações: 1) Abrir o arquivo setdomainenv.sh localizado em <WEBLOGIC_INSTALL_DIR>/Oracle/user_projects/domains/dfe/bin/setDomainEnv.sh 2) Configurar a variável BEA_JAVA_HOME para o diretório base do JRockit, conforme imagem abaixo: 20
3) Ao iniciar o Weblogic, configurar a variável JAVA_VENDOR com o valor Oracle e reiniciar o Weblogic. Obs.: O valor Oracle para o JAVA_VENDOR pode ser diferente de acordo com a versão do Weblogic. Para ter certeza do valor que deve ser parametrizado, procurar pelo trecho JAVA_HOME="${BEA_JAVA_HOME}" no arquivo <WEBLOGIC_INSTALL_DIR>/Oracle/user_projects/domains/dfe/bin/setDomainEnv e verificar o valor testado no if na linha anterior. FAQ IMPORTANTE: Não é possível realizar login através do portal. Por padrão, o Weblogic está configurado para utilizar a autenticação básica, desta forma, impedindo que a requisição chegue à aplicação e seja utilizado o sistema de autenticação padrão do portal/webservice. Este problema pode ser resolvido com as seguintes opções: 21
ALTERAÇÃO DO ARQUIVO CONFIG.XML Abrir o arquivo config.xml do Weblogic disponível em: <Diretório Instalação Weblogic>\user_projects\domains\mydomain\config Adicionar dentro da tag security-configuration o seguinte elemento: <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> into the config.xml file (before closing tag </security-configuration>): <security-configuration>... <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> </security-configuration> Salvar arquivo config.xml e reiniciar o Weblogic. <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> VARIAVEL DE AMBIENTE Criar ou adicionar no texto da variável de ambiente JAVA_OPTS o valor: -Dweblogic.configuration.schemaValidationEnabled=false SCRIPT WSTL Criar um arquivo chamado ChangeEnforceValidBasicAuthCredentials.py no diretório <WEBLOGIC_INSTALL_DIR>/wlserver_10.3/common/bin com o seguinte conteúdo: 22
connect('username','password','weblogic_address') edit() startedit() cd('securityconfiguration') cd('base_domain') ls() set('enforcevalidbasicauthcredentials','false') save() activate() print 'Now Restart Your Server...' Neste exemplo acima, substituir os seguintes parâmetros: username = Usuário admin do weblogic (Exemplo: weblogic) password = Senha do admin do weblogic (Exemplo: welcome1) weblogic_address = Admin Server URL (Exemplo: t3://localhost:7001) base_domain = Nome do Domínio (Exemplo: dfe) Abrir um terminal, entrar no diretório <WEBLOGIC_INSTALL_DIR>wlserver_10.3/server/bin e executar o comando abaixo:./wlst.sh ChangeEnforceValidBasicAuthCredentials.py No terminal, entrar no diretório <WEBLOGIC_INSTALL_DIR>/wlserver_10.3/common/bin e executar o comando abaixo:./wlst.sh ChangeEnforceValidBasicAuthCredentials.py Reiniciar o Weblogic. ORACLE RAC Recomendamos à leitura da documentação oficial do Weblogic para realizar a configuração de utilização do 23
ORACLE RAC. http://docs.oracle.com/cd/e17904_01/web.1111/e13737/oracle_rac.htm http://docs.oracle.com/cd/e13222_01/wls/docs103/jdbc_admin/jdbc_multidatasources.html 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. 24