Implementando o aplicativo da web no WebSphere Application Server

É possível implementar o aplicativo da web Rational Publishing Engine no WebSphere Application Server versão 8.x ou posterior com o IBM® DB2.

Antes de Iniciar

Você deve instalar o WebSphere Application Server V8.x ou posterior e o Rational Publishing Engine com o recurso RPE Remote Services antes de implementar o aplicativo da web.
Você deve ter acesso aos seguintes arquivos de aplicativos da web no diretório RPE_HOME\remote-services:
  • com.ibm.rpe.web.app.ear (ou os arquivos rpeng.war e dgaas.war)
Lembre-se: O aplicativo corporativo com.ibm.rpe.web.app.ear é um pacote configurável dos dois aplicativos da web: rpeng.war e dgaas.war. Você tem uma das opções de implementação a seguir:
  • Implementar o único aplicativo corporativo com.ibm.rpe.web.app.ear
  • Implementar ambos os aplicativos da web rpeng.war e dgaas.war juntos
O cenário de implementação e os exemplos explicam como implementar o único aplicativo corporativo com.ibm.rpe.web.app.ear.

Procedimento

  1. Configurar segurança global.
  2. Configurar JVM.
  3. Configurar gerenciamento de sessão.
  4. Configurar a variável de ambiente.
  5. Reiniciar o servidor.
  6. Implementar o aplicativo da web no servidor.
  7. Criar uma biblioteca compartilhada para o aplicativo dgaas .
  8. Configurar usuários para o aplicativo da web no WebSphere Application Server.
  9. Associar as bibliotecas compartilhadas com os aplicativos.
  10. Configurar a variável de licenciamento.

Configurando a segurança global no WebSphere Application Server

Procedimento

  1. Inicie o WebSphere Application Server.
  2. Abra o console administrativo em um navegador: https://server:port/ibm/console

    Por exemplo: https://localhost:9043/ibm/console

  3. Expanda Segurança e clique em Segurança global.
  4. Na seção Segurança do aplicativo, verifique se a caixa de seleção Ativar segurança do aplicativo está marcada.
  5. Na seção Segurança Java™ 2, limpe todas as opções. Se a opção Avisar se os aplicativos receberem permissões customizadas estiver selecionada e não puder ser editada:
    1. Selecione a opção Usar segurança Java 2 para restringir o acesso ao aplicativo a recursos locais. A opção Avisar se os aplicativos receberem permissões customizadas é ativada.
    2. Desmarque a opção Avisar se os aplicativos receberem permissões customizadas.
    3. Limpe a opção Usar segurança Java 2 para restringir o acesso ao aplicativo aos recursos locais.
  6. Clique em Aplicar.
  7. Clique em Salvar para salvar as mudanças diretamente na configuração principal.

Resultados

Esta é uma captura de tela da página de segurança global no WebSphere Application Server

Configurando JVM

Sobre Esta Tarefa

Defina as configurações da Java virtual machine (JVM) a seguir nas propriedades customizadas de seu servidor de aplicativos:
  • com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
  • org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip

Procedimento

  1. Abra o console administrativo em um navegador: https://server:port/ibm/console

    Por exemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de Servidor e clique em WebSphere Application Servers.
  3. Na seção Servidores de Aplicativos, clique no link do seu servidor, por exemplo, server1.
  4. Na guia Configuração, na seção Infraestrutura do Servidor, expanda Gerenciamento de Java e de Processos e clique no link Definição do Processo.
  5. Na seção Propriedades Adicionais, clique no link Java Virtual Machine.
  6. Na seção Propriedades Adicionais, clique no link Propriedades Customizadas.
  7. Na tabela Propriedades Customizadas, clique em Novo.
  8. Na seção Propriedades Gerais, para cada entrada, especifique os valores a seguir e clique em OK:
    Tabela 1. Customizar propriedades JVM para WebSphere Application Server
    Nome Valor Descrição
    com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine true Desative o IBM JAXRS
    org.eclipse.emf.common.util.URI.archiveSchemes wsjar wszip jar zip  
  9. Clique em Salvar para salvar as mudanças diretamente na configuração principal.

Resultados

Esta é uma captura de tela da página de Propriedades Customizadas do console administrativo do WebSphere Application Server

Configurando gerenciamento de sessão

Sobre Esta Tarefa

Definir as seguintes configurações de Gerenciamento de Sessão nas propriedades customizadas para seu servidor de aplicativos:
  • InvalidateOnUnauthorizedSessionRequestException=true

Procedimento

  1. Abra o console administrativo em um navegador: https://server:port/ibm/console

    Por exemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de Servidor e clique em WebSphere Application Servers.
  3. Na seção Servidores de Aplicativos, clique no link do seu servidor, por exemplo, server1.
  4. Na guia Configuração, na seção Configurações do Contêiner, clique no link Gerenciamento de sessões.
  5. Na seção Propriedades Adicionais, clique no link Propriedades Customizadas.
  6. Na tabela Propriedades Customizadas, clique em Novo.
  7. Na seção Propriedades gerais, especifique o seguinte valor e clique em OK:
    Tabela 2. Propriedade de Gerenciamento de Sessões Customizadas para WebSphere Application Server
    Nome Valor Descrição
    InvalidateOnUnauthorizedSessionRequestException true Em resposta a uma solicitação desautorizada, o gerenciador de sessão invalida a sessão em vez de emitir uma mensagem de erro UnauthorizedSessionRequestException.
  8. Clique em Salvar para salvar as mudanças diretamente na configuração principal.

Resultados

Esta é uma captura de tela da página de propriedades de Gerenciamento de Sessões do console administrativo do WebSphere Application Server

Configurando a variável de ambiente

Procedimento

  1. Abra o console administrativo em um navegador: https://server:port/ibm/console

    Por exemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de Servidor e clique em WebSphere Application Servers.
  3. Na seção Servidores de Aplicativos, clique no link do seu servidor, por exemplo, server1.
  4. Na guia Configuração, na seção Infraestrutura do Servidor, expanda Gerenciamento de Java e de Processos e clique no link Definição do Processo.
  5. Na guia Configuração, na seção Propriedades Adicionais, clique no link Entradas de Ambiente.
  6. Na tabela Entradas do Ambiente, clique em Novo.
  7. Na seção Propriedades Gerais, para cada entrada, especifique os seguintes valores e clique em OK:
    Tabela 3. Propriedades de variável de ambiente para WebSphere Application Server
    Nome Valor Descrição
    DGAAS_URL http://<server IP>:<port>/dgaas/ Variável de ambiente de serviço de geração de documento
    VCAP_SERVICES {"sqldb": [{}]} Ao usar o DB2 como seu banco de dados, você deve configurar esta variável de ambiente.
    Esta é uma captura de tela da página Entradas do Ambiente no console administrativo para o WebSphere Application Server.
  8. Clique em Salvar para salvar as mudanças diretamente na configuração principal.

Reinicie o WebSphere Application Server

Sobre Esta Tarefa

Reinicie o perfil do WebSphere Application Server que você deseja para implementar o aplicativo da web (com.ibm.rpe.web.app.ear ou, como alternativa, os arquivos rpeng.war e dgaas.war):

Procedimento

  1. Pare o WebSphere Application Server.
  2. Inicie o WebSphere Application Server.

Implementando o aplicativo da web no WebSphere Application Server

Antes de Iniciar

  • Crie um banco de dados para o Rational Publishing Engine no DB2
  • Crie a origem de dados rpeng com o nome JNDI: RPENG_DB
  • Crie a origem de dados DGAAS com o nome JNDI: DGAAS_DB
Para obter detalhes, consulte Configurando o WebSphere Application Server com o DB2 como uma origem de dados.

Procedimento

  1. Abra o console administrativo em um navegador: https://server:port/ibm/console

    Por exemplo: https://localhost:9043/ibm/console

  2. Expanda Aplicativos e clique em Novo Aplicativo.
  3. Clique em Novo Aplicativo Corporativo.
  4. Na janela Preparando para a instalação do aplicativo, especifique o caminho para com.ibm.rpe.web.app.ear em um sistema de arquivos local ou remoto:
    • Se estiver usando um arquivo local, selecione Sistema de Arquivos Local.
    • Se estiver usando um arquivo remoto, selecione Sistema de Arquivos Remoto.
    Digite ou clique em Navegar para especificar o caminho para o arquivo com.ibm.rpe.web.app.ear. Por padrão, o archive está localizado em RPE_HOME\remote-services\com.ibm.rpe.web.app.ear.
  5. Clique em Avançar.
  6. Selecione Atalho - Solicitar somente quando forem necessárias informações adicionais e clique em Avançar.
  7. Na página Selecionar essas opções de instalação, aceite as configurações padrão e clique em Avançar.
    Esta é uma captura de tela da página Selecionar essas opções de instalação no console administrativo para o WebSphere Application Server
  8. Na página Mapear módulos para servidores, selecione os módulos Rational Publishing Engine e DGaaS e clique em Avançar.
  9. Na página Mapear referências de recursos para recursos, você deve especificar a origem de dados para os módulos Rational Publishing Engine e DGaaS.
    Dica: Para continuar com esta etapa, você deve concluir as etapas no tópico Configurando o WebSphere Application Server com o DB2 como uma origem de dados.
    1. Para a entrada de módulo do Rational Publishing Engine, na coluna Nome JNDI do Recurso de Destino, clique em Procurar.
      Esta é uma captura de tela da página Mapear referências de recursos para recursos no console administrativo do WebSphere Applicaiton Server.
    2. Na página Novo Aplicativo, selecione a opção rpeng com o nome JNDI configurado para RPENG_DB.
      Esta é uma captura de tela da página Novo Aplicativo do console administrativo para WebSphere Application Server.
    3. Clique em Aplicar.
    4. Repita as etapas de maneira semelhante para a entrada de módulo DGaaS, na coluna Nome JNDI do Recurso de Destino, clique em Procurar.
    5. Na página Novo Aplicativo, selecione a opção DGAAS com o nome JNDI configurado como DGAAS_DB.
    6. Clique em Aplicar.
    7. Clique em Avançar.
    Esta é uma captura de tela de referências de recurso de mapa para a página de recursos no console administrativo para o WebSphere Application Server.
  10. Na página Mapear hosts virtuais para módulos da web, selecione Rational Publishing Engine e DGaaS e clique em Avançar.
  11. Revise o Resumo e clique em Concluir.
    Esta é uma captura de tela da página Resumo no console administrativo no WebSphere Application Server.
  12. Para confirmar que seu aplicativo da web foi implementado no servidor com êxito, procure a seguinte mensagem de saída que é exibida no log de processo:
    Aplicativo com.ibm.rpe.web.app instalado com êxito.
  13. Clique em Salvar para salvar as mudanças diretamente na configuração principal.
    Esta é uma captura de tela da página de log de processo do console administrativo para o WebSphere Application Server.
  14. Expanda Aplicativos > Tipos de Aplicativos e clique em WebSphere Enterprise Applications. O aplicativo com.ibm.rpe.web.app incluído é listado como o nome do aplicativo inserido.
  15. Na coluna Nome, clique no link com.ibm.rpe.web.app.
    Esta é uma captura de tela da página Aplicativos Corporativos do console administrativo para o WebSphere Application Server.
  16. Na seção Propriedades de Detalhes, clique no link Carregamento de classe e detecção de atualização.
  17. Na seção Ordem do carregador de classes, selecione Classes carregadas com o primeiro carregador de classe local (pai por último) e clique em OK.
    Esta é uma captura de tela da página Carregador de Classes no console administrativo no WebSphere Application Server.
  18. Verifique as raízes de contexto do aplicativo com.ibm.rpe.web.app:
    1. Na seção Propriedades do Módulo da Web, clique em Raiz de Contexto para Módulos da Web.
    2. Verifique se a raiz de contexto especificada para os módulos da web correspondem aos seguintes valores e, em seguida, clique em OK:
      Tabela 4. Verificando raízes de contexto para o aplicativo com.ibm.rpe.web.app
      Módulo da web URI Raiz de Contexto
      Rational Publishing Engine com.ibm.rpe.web.ui.war, WEB-INF/web.xml rpeng
      DGaaS com.ibm.rpe.web.service.docgen.war, WEB-INF/web.xml dgaas
      Esta é uma captura de tela da página Raiz de Contexto no console administrativo para o WebSphere Application Server
    3. Na guia Configuração, clique em OK.
  19. Clique em Salvar para salvar as mudanças diretamente na configuração principal.
  20. Inicie o aplicativo da web no servidor:
    1. Marque a caixa de seleção com.ibm.rpe.web.app e clique em Iniciar.
    2. Se o aplicativo da web for iniciado no servidor com êxito, a mensagem a seguir será exibida:
      O aplicativo com.ibm.rpe.web.app no servidor server_name e o nó node_name foram iniciados com êxito.  A coleta pode precisar ser atualizada para mostrar o status atual.
      Esta é uma captura de tela da página de aplicativos corporativos do console administrativo para o WebSphere Application Server.

Configure usuários para o aplicativo da web no WebSphere Application Server

Sobre Esta Tarefa

Para concluir essa tarefa, deve-se concluir as etapas de Configurando usuários para o aplicativo da web no WebSphere Application Server

Criando uma biblioteca compartilhada para o aplicativo dgaas

Procedimento

  1. Vá para a página Bibliotecas Compartilhadas.
  2. Clique em Ambiente > Bibliotecas Compartilhadas na árvore de navegação do console.
  3. Selecione um escopo de biblioteca compartilhada. Altere o escopo da tabela de coleta para ver quais bibliotecas compartilhadas estão em uma determinada célula, nó ou servidor. Selecione as opções e Servidor.
    página de escopo de bibliotecas compartilhadas
  4. Clique em Novo.
  5. Especifique o nome, por exemplo, dgaas.ear.
  6. Especifique o caminho da classe para os arquivos .jar HTTP a seguir:
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpclient_<version>.jar
    <WAS_HOME>\profiles\AppSrv01\installedApps\<cell Name>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpcore_<version>.jar
  7. Selecione a opção de carregamento de classe Usar um carregador de classes isolado para essa biblioteca compartilhada e clique em OK.
    Página de bibliotecas compartilhadas para biblioteca compartilhada que abrange todo o contêiner
  8. Clique em Salvar para atualizar suas mudanças na configuração principal.

O que Fazer Depois

Dica: A partir do Rational Publishing Engine versão 2.0.1, não é mais necessário criar a biblioteca compartilhada adicional, rpe.lib, para consumir uma licença. Agora o produto automatiza essa tarefa.

Associando bibliotecas compartilhadas a aplicativos

Procedimento

  1. Clique em Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > com.ibm.rpe.web.app > Referências de bibliotecas compartilhadas para acessar a página Referências de Bibliotecas Compartilhadas.
    Página Bibliotecas Compartilhadas para rpe.lib
  2. Na página Referências de Bibliotecas Compartilhadas, selecione um aplicativo ao qual você deseja associar uma biblioteca compartilhada, neste caso, com.ibm.rpe.web.app .
  3. Clique em Bibliotecas Compartilhadas de Referência.
    página Referências de Bibliotecas Compartilhadas
  4. Na página Mapeamento de bibliotecas compartilhadas, selecione a biblioteca compartilhada dgaas.ear usada pelo aplicativo ou pelo módulo.
  5. Clique em >> para mover as bibliotecas da lista Disponível para a lista Selecionado.
    Página de mapeamento de bibliotecas compartilhadas
  6. Na página Referências de Bibliotecas Compartilhadas, clique em OK.
  7. Salve as mudanças na configuração principal.

Configurando a variável de licenciamento

Procedimento

  1. Verificando a variável de ambiente TELELOGIC_LICENSE_FILE.
  2. Reinicie o WebSphere Application Server.

Resultados

É possível confirmar que o aplicativo da web está implementado abrindo a seguinte URL em um navegador: http://server:port/rpeng/
Dica: Você poderá encontrar a seguinte mensagem de erro no navegador da web:
Erro 500:
com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
    SESN0008E: Um usuário autenticado como anônimo tentou acessar uma
sessão de propriedade do
    usuário:defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm.
Para resolver essa mensagem de erro, verifique se você configurou a propriedade de gerenciamento de sessão InvalidateOnUnauthorizedSessionRequestException como true nas propriedades customizadas para WebSphere Application Server. Para obter mais detalhes, consulte a seção Configurando gerenciamento de sessão deste tópico.

É possível efetuar login fornecendo o nome do usuário e a senha do usuário apropriado, como rpe_admin, rpe_designer ou rpe_user e clique em Efetuar Login.

Esta é uma captura de tela da tela de login do aplicativo da web.

O aplicativo da web do Rational Publishing Engine a seguir deve exibir em seu navegador:

Página inicial do aplicativo da web

É possível verificar o status do serviço de geração de documento inserindo http://server:port/dgaas/debug em um navegador.

Página inicial do aplicativo da web

O que Fazer Depois

Opcionalmente, é possível implementar e executar o aplicativo de amostra Newskeeper que usa a tecnologia de serviço de geração de documento para gerar documentos e fornece uma interface de armazenamento para os documentos e ativos de serviço de geração de documento. Para obter mais detalhes, consulte Executando a amostra do Newskeeper.

Configure o aplicativo da web Rational Publishing Engine listado na página http://server:port/rpeng/. Consulte URLs do aplicativo da web para obter uma explicação de como cada URL é usada e as tarefas para configuração de cada um dos recursos.