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

Transcrição

1 MANUAL DE DEPLOY DFE V3

2 SUMÁRIO OBJETIVO... 3 PRÉ-REQUISITOS... 3 CONFIGURANDO O WEBLOGIC... 4 REALIZANDO O DEPLOY JROCKIT FAQ ORACLE RAC SUPORTE TÉCNICO

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

4 CONFIGURANDO O WEBLOGIC Acessar o painel de administração do Weblogic e efetuar login como Administrador. 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. 4

5 Selecionar o servidor que irá disponibilizar o DFE. Selecionar a opção Configuration > Server Start e informar -Dfile.encoding=UTF-8 no campo Arguments. 5

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

7 No próximo passo, selecione no campo Database Driver o driver de conexão com o banco de dados. Na tela a seguir, somente clicar no botão Next. 7

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

9 Clique no botão Next. 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. 9

10 A próxima tela traz um resumo do processo de criação do Data Source e apresentará a mensagem 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. 10

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

12 A seguir, informe os dados de configuração de *Name: Deve ser mail/session *JNDI Name Deve ser mail/session mail.smtp.auth=true; utilizado para autenticar o envio de s do produto mail.password=senha_ Senha do mail.transport.protocol=smtp mail.smtp.host=servidor_smtp Servidor smtp para envio de s 12

13 mail.smtp.starttls.enable=true. Marque a seguir, no campo Servers, o servidor para vincular as configurações de , como demonstrado na imagem abaixo. Após esses passos, clique no botão Finish. 13

14 A próxima tela traz um resumo do processo de configuração de e apresentará a mensagem informando que todas as configurações foram realizadas. Após concluir a configuração de 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. 14

15 Ao concluir as configurações, será exibida a tela abaixo. No menu lateral, abra a opção jdbc. Devera conter os seguintes datasources : auth, dfe e security como mostrado na imagem abaixo. 15

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

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

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

19 Clique no botão Next. Marque a opção Install this deployment as an application e clique no botão Next. 19

20 Na próxima tela não é necessária nenhuma configuração, apenas clique no botão Next. Após esses passos, clique no botão Finish. 20

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

22 Ao finalizar o processo de instalação, será possível acessar a aplicação. Ao acessar o produto via browser (ex.: você visualizará a tela inicial de login de acesso ao produto. 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. 22

23 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: 3) Ao iniciar o Weblogic, configurar a variável JAVA_VENDOR com o valor Oracle e reiniciar o Weblogic. 23

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

25 FAQ Importante: Não e 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: 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> 25

26 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: 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 26

27 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 ORACLE RAC

28 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) opção 2 (Atendimento das Soluções DFE). Nosso horário de atendimento é de segunda a sexta-feira das 9h às 18h. 28