Implementando o Document Builder no WebSphere Application Server

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

Antes de Iniciar

Deve-se instalar o WebSphere Application Server V8.x ou mais recente e o Rational Publishing Engine com o recurso RPE Document Builder antes de implementar o Document Builder.
Deve-se ter acesso aos seguintes arquivos Document Builder disponíveis no diretório RPE_HOME\document-builder:
  • 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. Para o DB2: Configurando o WebSphere Application Server com o DB2 como uma origem de dados.
  7. Para o Oracle: Configurando o WebSphere Application Server com o Oracle como uma origem de dados.
  8. Implemente o Document Builder no servidor.
  9. Criar uma biblioteca compartilhada para o aplicativo dgaas .
  10. Configure os usuários para o Document Builder no WebSphere Application Server.
  11. Associar as bibliotecas compartilhadas com os aplicativos.
  12. 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 ou o Oracle como o banco de dados, deve-se 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 implementar o Document Builder (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.

Configurando o WebSphere Application Server com o DB2 como uma origem de dados

Deve-se configurar um banco de dados DB2 e configurar a conexão com o Document Builder no WebSphere Application Server

Antes de Iniciar

Deve-se criar um banco de dados IBM DB2 para o Rational Publishing Engine Document Builder. O banco de dados deve ter páginas de 16K e o conjunto de códigos UTF-8. Por exemplo, para criar um banco de dados chamado rpedb2 com 16 mil páginas e o conjunto de códigos UTF-8, use o comando a seguir:
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
    TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
Neste exemplo, o banco de dados é denominado rpedb1. Consulte a documentação do produto DB2 para obter informações sobre como criar um banco de dados.

Criando um provedor JDBC

Procedimento

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

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

  3. Selecione Recursos > JDBC > Provedores JDBC.
  4. Configure o escopo para que seja a célula.
    Célula
  5. Clique em Novo.
  6. No assistente Criar novo provedor JDBC, selecione:
    1. Tipo de banco de dados: DB2
    2. Tipo de provedor: Provedor do Driver Universal JDBC DB2
    3. Tipo de implementação: origem de dados XA
    4. Tipo de implementação: Insira um nome, por exemplo, RPE.
    Assistente Criar novo provedor JDBC
  7. Clique em Avançar.
  8. Na seção Inserir informações do caminho da classe do banco de dados, insira o caminho da classe. Substitua DB2UNIVERSAL_JDBC_DRIVER_PATH pelo diretório no qual os arquivos .jar do DB2 estão localizados:
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cu.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cisuz.jar
  9. Insira o local do diretório para o arquivo "db2jcc.jar, db2jcc_license_cisuz.jar", que é salvo como a variável WebSphere ${DB2UNIVERSAL_JDBC_DRIVER_PATH}, por exemplo, C:\Program Files\IBM\SQLLIB\java.
  10. Insira o caminho da biblioteca nativa, por exemplo, C:\Program Files\IBM\SQLLIB\java.
  11. Clique em Aplicar.
    Insira as informações do caminho da classe do banco de dados
  12. Certifique-se de que o caminho da biblioteca nativa esteja correto e clique em Avançar.
    Caminho da biblioteca nativa
  13. Revise a página de resumo e clique em Concluir.
    Caminho da biblioteca nativa
  14. Salve as mudanças na configuração principal.

Criando uma origem de dados para o aplicativo rpeng

Procedimento

  1. Vá para o provedor JDBC que você acabou de criar.
    1. Clique em Origens de Dados.
      Link Origens de Dados
    2. No campo Nome da Origem de Dados, insira rpeng.
    3. No campo nome JNDI, insira RPENG_DB e clique em Avançar.
      Inserir informações de origem de dados básicas
  2. Insira propriedades específicas do banco de dados para a origem de dados e clique em Avançar.
    1. Configure o valor de Tipo de Driver como 4.
    2. No campo Nome do Banco de Dados, insira o nome do banco de dados.
    3. No campo Nome do servidor, insira o nome do host da máquina em que o DB2 está em execução.
    4. No campo Número da porta, insira o número da porta para seu banco de dados DB2.
      Insira propriedades específicas do banco de dados para a origem de dados
  3. Na seção Configurar aliases de segurança, clique em Avançar .
  4. Revise a página de resumo e clique em Concluir.
    Resumo da origem de dados
  5. Salve as mudanças na configuração principal.

Criando uma origem de dados para o aplicativo dgaas

Procedimento

Repita as etapas no Criando uma origem de dados para o aplicativo rpeng, configurando DGAAS como o Nome da Origem de Dados e DGAAS_DB como o Nome JNDI.
Insira informações básicas da origem de dados

Criando uma entrada de dados de autenticação

Procedimento

  1. Acesse o provedor RPE JDBC e clique em Origens de dados.
  2. Na página Origens de Dados, clique na origem de dados rpeng.
  3. Na seção Itens Relacionados, clique em Dados de Autenticação JAAS-J2C.
  4. Clique em Novo.
  5. Insira os detalhes da autenticação para o banco de dados:
    • Para o DB2: insira o alias, ID do usuário e senha do DB2 e clique em OK.
      Novos dados de autenticação
    • Para o Oracle: insira o alias, ID do usuário e senha do Oracle e clique em OK
      Novos dados de autenticação
  6. Salve as mudanças na configuração principal.
  7. Volte para sua origem de dados do rpeng.
  8. Nas configurações de Segurança, selecione o banco de dados rpedb1 para as seguintes opções:
    1. Alias de autenticação para recuperação XA
    2. Alias de autenticação gerenciado por componente
    3. Alias de autenticação gerenciado por contêiner
    Configurações de Segurança
  9. Clique em OK e salve.
  10. Acesse a origem de dados do rpeng novamente e clique em Testar Conexão para testar a origem de dados.
    Teste de conexão bem-sucedido
  11. Repita as etapas 7-10 com a origem de dados do dgaas.

Configurando o WebSphere Application Server com o Oracle como uma origem de dados

Deve-se configurar um banco de dados Oracle e configurar a conexão com o Document Builder no WebSphere Application Server

Antes de Iniciar

  • Para criar e configurar um banco de dados Oracle, o usuário que está preparando o banco de dados deva ter autoridade de administração de banco de dados sobre o banco de dados e o banco de dados, o armazenamento de espaço de tabela e a configuração de armazenamento apropriada devem ser criados por um usuário com autoridade de administração do sistema.
  • Dependendo da versão do Oracle usada, o driver Java Database Connectivity (JDBC) necessário é ojdbc7.jar.
  • Para gerar uma lista de versões de banco de dados suportados e drivers JDBC, consulte http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html .
  • Os parâmetros de configuração e opções de espaço de tabela usados neste tópico são exemplos e podem não se aplicar inteiramente a seu ambiente. Por exemplo, se não for possível usar a configuração AUTOEXTEND, os arquivos deverão ser grandes o suficiente para permitir o crescimento. Ou se não for possível usar a cota de tamanho UNLIMITED para o usuário do banco de dados, em seguida, certifique-se de permitir espaço suficiente para crescimento rápido.
  • O banco de dados criado para o aplicativo Document Builder deve ser formatado para usar UTF-8 como o conjunto de caracteres. Por padrão, o Oracle não cria um banco de dados com o conjunto de caracteres UTF-8. Ao criar um novo banco de dados, assegure-se de ter selecionado AL32UTF8 na configuração do BD Oracle.

Criar um banco de dados e um espaço de tabela

Procedimento

  1. Como um administrador do sistema, crie um banco de dados, por exemplo rpedb, com a codificação UTF-8 para o Document Builder.
    1. Inicie o assistente do Assistente de Configuração do Banco de Dados e, na página de Boas-vindas, clique em Avançar.
    2. Na página Operações, selecione Criar um banco de dados e, em seguida, clique em Avançar.
    3. Na página Modelos, selecione Banco de dados customizado e clique em Avançar.
    4. Nos campos Nome do banco de dados global e SID, insira um nome para o banco de dados de armazenamento de conteúdo, por exemplo, CLMDB. Clique em Avançar.
    5. Para configurar o controle de banco de dados, insira as informações necessárias para notificação de alerta e, opcionalmente, ative o planejamento de backup de disco diário. Para continuar sem a configuração de controle do banco de dados, limpe a caixa de seleção ao lado de Configurar Enterprise Manager e, em seguida, clique em Avançar.
    6. Na página Credenciais do banco de dados, escolha uma opção para sua conta do usuário e, em seguida, clique em Avançar.
      Nota: A política de complexidade de senha do Oracle requer que as senhas tenham um mínimo de 8 caracteres de comprimento. Além disso, a senha deve conter pelo menos um caractere maiúsculo, um caractere minúsculo e um dígito.
    7. Na próxima página, selecione um tipo de armazenamento e o local para os arquivos de banco de dados. Clique em Avançar.
    8. Na próxima página, escolha uma opção de recuperação para o banco de dados e, em seguida, clique em Avançar.
    9. Na próxima página, especifique se deseja, ou não, incluir os Esquemas de Amostra em seu banco de dados. Clique em Avançar.
    10. Na próxima página, clique na guia Conjuntos de Caracteres e selecione Usar Unicode (AL32UTF8). Clique em Avançar.
      Nota: Configurar o conjunto de caracteres para Unicode (AL32UTF8) permite armazenar vários grupos de idiomas.
    11. Na página Armazenamento do banco de dados, verifique ou altere os objetos de banco de dados e clique em Avançar.
    12. Na próxima página, clique em Concluir para criar o banco de dados.
    13. Na janela Confirmação que é aberta, salve opcionalmente a página como um arquivo HTML e, em seguida, clique em OK. Uma barra de progresso é exibida para mostrar o progresso de criação do banco de dados.
  2. Abra uma janela SQL *Plus e efetue login como SYSTEM ou SYSDBA.
  3. Navegue para [OracleInstallDir]/dbhome_1/bin, por exemplo, /u01/app/oracle/product/12.1.0/dbhome_1/bin e insira o comando a seguir, em que password é a senha:
    ./sqlplus sys/[password]@RPEDB como sysdba
    Efetue login no Oracle
  4. Crie um espaço de tabela para o Rational Publishing Engine

    Para criar um espaço de tabela para o Rational Publishing Engine, insira o comando a seguir. Substitua RPE pelo nome do espaço de tabela, ORACLE_BASE pelo caminho absoluto em que o Oracle está instalado, RPEDB pelo nome do banco de dados criado na etapa 1 e RPE.DBF pelo nome do arquivo de dados que você deseja criar.

    CREATE TABLESPACE RPE 
    DATAFILE 'ORACLE_BASE/oradata/RPEDB/RPE.DBF' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    Por exemplo:
    CREATE TABLESPACE RPEDB_TS DATAFILE '/u01/app/oracle/oradata/RPEDB/RPEDB_TS.dbf' SIZE 1G
            AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Crie um espaço de tabela provisório para o Rational Publishing Engine Para criar um espaço de tabela provisório para o Rational Publishing Engine, insira o comando a seguir. Substitua RPE_TEMP pelo nome do espaço de tabela provisório, ORACLE_BASE pelo caminho absoluto em que o Oracle está instalado, RPEDB pelo nome do banco de dados criado na etapa 1 e RPE_TEMP.DBF pelo nome do arquivo temporário que você deseja criar.
    CREATE TEMPORARY TABLESPACE RPE_TEMP 
    TEMPFILE 'ORACLE_BASE/oradata/RPEDB/RPE_TEMP.DBF' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
    Por exemplo:
    CREATE TEMPORARY TABLESPACE RPEDB_TEMP TEMPFILE
            '/u01/app/oracle/oradata/RPEDB/RPEDB_TEMP.DBF' SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT
            LOCAL UNIFORM SIZE 1M
  6. Efetue login no portal Controle de Banco de Dados do Oracle Enterprise Manager como usuário do sistema. Clique em Armazenamento > Espaços de tabela e verifique se o espaço de tabela que você criou é exibido e está acessível.
    Oracle Enterprise Manager
  7. Depois que os espaços de tabela forem criados, um usuário Oracle especial deverá ser criado para que cada aplicativo use o banco de dados Oracle. Neste exemplo, um usuário chamado RPE_USER é criado e recebe permissão. O usuário do banco de dados Oracle deve poder criar objetos de banco de dados em seu espaço de tabela (ilimitado ou com uma cota de espaço) com privilégios para criar sessão, tabela, procedimento e visualizações. Para criar um usuário do banco de dados Oracle para cada novo espaço de tabela, insira o comando a seguir. Substitua USER_NAME pelo usuário que você deseja criar, PASSWORD pela senha do usuário, RPEDB_TS pelo nome do espaço de tabela criado na etapa 4 e RPEDB_TEMP pelo espaço de tabela provisório que você deseja criar.
    CREATE USER  USER_NAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED ON
          RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
    Por exemplo:
    CREATE USER  RPE_USER IDENTIFIED BY RPEt3st123 DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED
            ON RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
  8. Para conceder as permissões necessárias para o espaço de tabela, insira os seguintes comandos:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO RPE_USER
  9. Agora, efetue login no SQL *Plus Editor usando RPE_USER e certifique-se de poder autenticar com sucesso, por exemplo:
    ./sqlplus.sh rpe_user/RPEt3st123@RPEDB

Criando um provedor JDBC

Procedimento

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

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

  3. Selecione Recursos > JDBC > Provedores JDBC.
  4. Configure o escopo para que seja a célula.
    Célula
  5. Clique em Novo.
  6. No assistente Criar novo provedor JDBC, selecione:
    1. Tipo de banco de dados: Oracle
    2. Tipo de provedor: Driver Oracle JDBC
    3. Tipo de implementação: origem de dados XA
    4. Tipo de implementação: insira um nome, por exemplo RPE_Oracle.
    Assistente Criar novo provedor JDBC
  7. Clique em Avançar.
  8. Na seção Inserir informações do caminho da classe do banco de dados, assegure-se de que a seção do caminho de classe aponte para o local ojdbc7.jar. Se ela estiver mostrando ojdbc6.jar, atualize-a como ojdbc7.jar e clique em Aplicar. Por exemplo:
    ${ORACLE_JDBC_DRIVER_PATH}/odjbc7.jar 
  9. Insira o local do diretório no arquivo "ojdbc7.jar", que é salvo como a variável ${ORACLE_JDBC_DRIVER_PATH} do WebSphere, por exemplo, /oracle_jdbc.
    Insira as informações do caminho da classe do banco de dados
  10. Revise a página de resumo e clique em Concluir.
    Caminho da biblioteca nativa
  11. Salve as mudanças na configuração principal.

Criando uma origem de dados para o aplicativo rpeng

Procedimento

  1. Vá para o provedor JDBC que você acabou de criar.
    1. Clique em Origens de Dados.
      Link Origens de Dados
    2. No campo Nome da Origem de Dados, insira rpeng.
    3. No campo nome JNDI, insira RPENG_DB e clique em Avançar.
      Inserir informações de origem de dados básicas
  2. Insira propriedades específicas do banco de dados para a origem de dados e clique em Avançar.
    1. No campo URL, insira a URL do banco de dados Oracle, por exemplo jdbc:oracle:thin:@[server]:1521/RPEDB.
    2. Limpe a caixa de seleção Usar esta origem de dados na persistência gerenciada de contêiner (CMP) e clique em Avançar.
      Insira as propriedades específicas do banco de dados para a origem de dados
  3. Na seção Configurar aliases de segurança, clique em Avançar .
  4. Revise a página de resumo e clique em Concluir.
    Resumo da origem de dados
  5. Salve as mudanças na configuração principal.

Criando uma origem de dados para o aplicativo dgaas

Procedimento

Repita as etapas no Criando uma origem de dados para o aplicativo rpeng, configurando DGAAS como o Nome da Origem de Dados e DGAAS_DB como o Nome JNDI.
Insira informações básicas da origem de dados

Criando uma entrada de dados de autenticação

Procedimento

  1. Acesse o provedor RPE JDBC e clique em Origens de dados.
  2. Na página Origens de Dados, clique na origem de dados rpeng.
  3. Na seção Itens Relacionados, clique em Dados de Autenticação JAAS-J2C.
  4. Clique em Novo.
  5. Insira o alias do Oracle, ID do usuário e senha e clique em OK.
    Novos dados de autenticação
  6. Salve as mudanças na configuração principal.
  7. Volte para sua origem de dados do rpeng.
  8. Nas Configurações de segurança, selecione o banco de dados rpedb para as opções a seguir:
    1. Alias de autenticação para recuperação XA
    2. Alias de autenticação gerenciado por componente
    3. Alias de autenticação gerenciado por contêiner
    Configurações de Segurança
  9. Clique em OK e salve.
  10. Acesse a origem de dados do rpeng novamente e clique em Testar Conexão para testar a origem de dados.
    Teste de conexão bem-sucedido
  11. Repita as etapas 7-10 com a origem de dados do dgaas.

Implementando o Document Builder no WebSphere Application Server

Antes de Iniciar

Verifique se os seguintes ativos são criados:
  • Um banco de dados para o Rational Publishing Engine no DB2 ou Oracle
  • Uma origem de dados rpeng com o nome JNDI: RPENG_DB
  • Uma origem de dados DGAAS com o nome JNDI: DGAAS_DB

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\document-builder\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.
    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 se o seu Document Builder foi implementado no servidor com sucesso, procure a mensagem de saída a seguir 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 Document Builder no servidor:
    1. Marque a caixa de seleção com.ibm.rpe.web.app e clique em Iniciar.
    2. Se o Document Builder é iniciado com sucesso no servidor, a mensagem a seguir é 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 Aplicativos Corporativos do console administrativo para o WebSphere Application Server.

Configure os usuários para o Document Builder no WebSphere Application Server

Sobre Esta Tarefa

Para concluir essa tarefa, deve-se concluir as etapas em Configurando usuários para o Document Builder 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. Verifique a variável de ambiente TELELOGIC_LICENSE_FILE. Por exemplo, é possível criar uma variável de ambiente para o arquivo de licença no WebSphere Application Server na página Entradas de ambiente:
    incluindo a variável de ambiente Telelogic
    Para o Linux, o registro é localizado em $HOME/.flexlmrc para TELELOGIC_LICENSE_FILE.
  2. Reinicie o WebSphere Application Server.

Resultados

É possível confirmar se o Document Builder está implementado abrindo a URL a seguir 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 seguinte Document Builder para o Rational Publishing Engine 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 Rational Publishing Engine Document Builder listado na página http://server:port/rpeng/. Consulte URLs do Document Builder para obter uma explicação de como cada URL é usada e as tarefas para configuração de cada um dos recursos.