Configurando o Websphere Application Server para Executar Aplicativos do Build Forge

Configure o WebSphere Application Server para executar o aplicativo de serviços e o aplicativo de ajuda.

Sobre Esta Tarefa

Execute as etapas no procedimento a seguir no Console Administrativo do WebSphere.
A partir do WebSphere versão 8.0, a interface com o usuário do Console Administrativo do WebSphere foi sutilmente alterada. As instruções abaixo são para a versão 7 e anterior. As seguintes diferenças na versão 8.0 afetam este procedimento:
  • Para acessar um aplicativo, use Aplicativos > Tipos de Aplicativo > Aplicativos Corporativos.
  • O ponto em que a raiz de contexto é configurada foi alterado para depois da seleção do aplicativo.
  • Não aparece uma caixa de seleção para Criar MBeans para recursos.

Procedimento

  1. Abra o console administrativo do WebSphere. Estas são as URLs para o console:
    • http://<was_host>:<was_port>/ibm/console; 9060 é a porta padrão
    • https://<was_host>:<was_port>/ibm/console; a porta padrão é 9043. Use esta URL se a Segurança Administrativa do WebSphere estiver ativada.
  2. Configure o suporte para o driver JDBC.
    1. Crie uma nova variável, RBF_JDBC_DRIVER_PATH. Crie a variável em Ambiente > Variáveis do WebSphere. Seu escopo deve ser o nó e o servidor WAS. Defina o valor para o diretório que contém os arquivos JAR do driver de banco de dados.
    2. Salve a alteração na configuração principal.
    3. Pare e reinicie o servidor WebSphere para tornar a nova variável disponível.
    4. Crie uma nova biblioteca compartilhada, RBF_JDBC_LIBRARY.

      Crie a biblioteca em Ambiente > Bibliotecas Compartilhadas. Inclua os nomes dos arquivos JAR para o driver de dispositivo JDBC, usando a variável RBF_JDBC_DRIVER_PATH que você acabou de criar. Se você tiver mais de um arquivo jar para listar, coloque cada arquivo jar em sua própria linha (como é o caso com o DB2).

      O exemplo a seguir refere-se a um driver de banco de dados MySQL:

      ${RBF_JDBC_DRIVER_PATH}\mysql-connector-java-5.0.5-bin.jar

      O próximo exemplo é para o DB2:

      ${RBF_JDBC_DRIVER_PATH}\db2jcc.jar
      ${RBF_JDBC_DRIVER_PATH}\db2jcc_license_cu.jar

      Com Unix ou Linux, nestes exemplos, use a barra (/), em vez da barra invertida (\).

    5. Salve a alteração na configuração principal.
  3. Instale o arquivo WAR do aplicativo Build Forge.
    1. Abra Aplicativos > Aplicativos Corporativos.
    2. Clique em Instalar.
    3. Navegue até o arquivo rbf-services.war. Use rbf-services como a raiz de contexto.
      • Sistemas Windows:
        <bfinstall>\PrepForExternal\rbf-services.war
      • Sistemas UNIX e Linux:
        <bfinstall>/Platform/PrepForExternal/rbf-services.war
    4. Clique em Avançar e desmarque a caixa de opção a seguir, se ela estiver selecionada:
      • Criar MBeans para recursos
    5. Clique em Avançar até ver um botão Concluir e, em seguida, clique em Concluir.
    6. Clique em Salvar na parte inferior do texto de instalação.
  4. Instale o arquivo WAR da Ajuda do Build Forge.
    1. Abra Aplicativos > Aplicativos Corporativos.
    2. Clique em Instalar.
    3. Procure o arquivo BuildForgeHelp.war no diretório de instalação do Build Forge. Use /BuildForgeHelp as como a raiz de contexto.
    4. Clique em Avançar e desmarque a caixa de opção a seguir, se ela estiver selecionada:
      • Criar MBeans para recursos
    5. Clique em Avançar até ver um botão Concluir e, em seguida, clique em Concluir.
    6. Clique em Salvar na parte inferior do texto de instalação.
  5. Defina RBF_JDBC_LIBRARY como uma referência de biblioteca compartilhada.
    1. Abra Aplicativos > Aplicativos Corporativos.
    2. Clique no link rbf-services.war.
    3. Clique em Referências de Biblioteca Compartilhada.
    4. Selecione a caixa Um Servlet de Login da Camada de Serviços.
    5. Clique em Bibliotecas Compartilhadas de Referência.
    6. Inclua RBF_JDBC_LIBRARY na lista.
  6. Configure a ordem do carregador de classes. Em Gerenciar Módulos, selecione Um Servlet de Login da Camada de Serviços e localize Ordem do Carregador de Classes na caixa suspensa. Altere esse valor para Classes carregadas com o carregador de classes local primeiro (pai por último).
  7. Salve as alterações na configuração principal.
  8. Verifique o arquivo de configuração do Build Forge. Assegure-se de que a entrada services_url no arquivo aponte para a URL correta. Se você estiver usando o WAS, o valor dessa propriedade em buildforge.conf deverá ser semelhante a https://<hostname>:9443/rbf-services ou https://<hostname>:9080/rbf-services. O arquivo buildforge.conf fica neste local:
    • Sistemas Windows
      <bfinstall>\
    • Sistemas UNIX e Linux
      <bfinstall>/Platform/
  9. Inclua permissões de execução para todos os arquivos no diretório bin para rbf-services. (Sistemas UNIX e Linux). Nesse exemplo, o perfil AppSrv01 é usado. Use seu nome de perfil caso não seja AppSrv01.
    chmod -R 755 <WAS-install>/AppServer/profiles/AppSrv01/installedApps/<node>/rbf-services_war.ear/rbf-services.war/bin
  10. Atualize a variável PATH para incluir o diretório de bibliotecas de token.
    • Sistemas Windows
      <bfinstall>\token_libs
    • Sistemas UNIX e Linux
      <bfinstall>/Platform/token_libs
  11. Se um Linux de 64 bits ou WAS estiver em uso, é necessário copiar as bibliotecas de 64 bits fornecidas.
    1. Renomeie o arquivo de biblioteca de 32 bits.
      • Sistema Windows: renomeie <bfinstall>\token_libs\rcl_rational.dll para <bfinstall>\token_libs\rcl_rational.dll.old.
      • Sistemas UNIX e Linux: renomeie <bfinstall>/Platform/token_libs/librcl_rational.so para <bfinstall>/Platform/token_libs/librcl_rational.so.old.
    2. Copie os arquivos d biblioteca de 64 bits de token_libs_64 para token_libs. Não use quebras de linhas nos comandos. Elas são usadas aqui para capacidade de leitura.
      • Sistemas Windows
        copy <bfinstall>\token_libs_64\rcl_rational.dll 
             <bfinstall>\token_libs\rcl_rational.dll
      • Sistemas UNIX e Linux
        cp <bfinstall>/Platform/token_libs_64/librcl_rational.so 
           <bfinstall>/Platform/token_libs/librcl_rational.so

Feedback