Executando um Aplicativo Cliente ou do Servidor do WebSphere eXtreme Scale com o Apache Tomcat no Rational Application Developer

Independente se você tiver um aplicativo cliente ou do servidor, use as mesmas etapas básicas para executar o aplicativo no Apache Tomcat no Rational Application Developer. Para um aplicativo cliente, você deseja configurar e executar um aplicativo da web para usar um cliente do WebSphere eXtreme Scale no Rational Application Developer. Siga estas instruções para criar um projeto da Web para executar um contêiner ou serviço de catálogo do WebSphere eXtreme Scale. Para um aplicativo do servidor, você deseja ativar um aplicativo Java EE na interface do Rational Application Developer com uma instalação independente do WebSphere eXtreme Scale. Siga estas instruções para configurar um projeto do aplicativo Java EE para usar a biblioteca do cliente do WebSphere eXtreme Scale.

Antes de Iniciar

Instale o Teste do WebSphere eXtreme Scale ou o produto integral.

Procedimento

  1. Inclua a biblioteca de tempo de execução do WebSphere eXtreme Scale no caminho de construção do Java EE.

    Aplicativo cliente Neste cenário, você deseja configurar e executar um aplicativo da web para usar um cliente do WebSphere eXtreme Scale no Rational Application Developer.

    1. Janela > Preferências > Java > Caminho de Construção > Bibliotecas de Usuário. Clique em Novo.
    2. Digite um Nome da biblioteca de usuário de eXtremeScaleClient e clique em OK.
    3. Clique em Incluir Jars..., navegue para o arquivo wxs_home/lib/ogclient.jar e selecione-o. Clique em Abrir.
    4. Opcional: (Opcional) Para incluir Javadoc, selecione o local Javadoc e clique em Editar.... No caminho do local Javadoc, é possível digitar a URL da documentação da API ou pode fazer download da documentação da API.
    5. Clique em OK.
    6. Clique em OK para fechar o diálogo Bibliotecas de Usuário.
    7. Clique em Projeto > Propriedades.
    8. Clique em Caminho de Construção Java.
    9. Clique em Incluir Biblioteca.
    10. Selecione Biblioteca de Usuário. Clique em Avançar.
    11. Marque a biblioteca eXtremeScaleClient e clique em Concluir.
    12. Clique em OK para fechar o diálogo Propriedades do Projeto.

    Aplicativo do servidor Neste cenário, você deseja configurar e executar um aplicativo da web para executar um servidor WebSphere eXtreme Scale integrado no Rational Application Developer.

    1. Clique em Janela > Preferências > Java > Caminho de Construção > Bibliotecas de Usuário. Clique em Novo.
    2. Digite um Nome de biblioteca de usuário de eXtremeScale e clique em OK.
    3. Clique em Incluir Jars... e selecione wxs_home/lib/objectgrid.jar. Clique em Abrir.
    4. (Opcional) Para incluir Javadoc, selecione o local Javadoc e clique em Editar.... No caminho do local Javadoc, digite http://www.ibm.com/developerworks/wikis/extremescale/docs/api/.
    5. Clique em OK.
    6. Clique em OK para fechar o diálogo Bibliotecas de Usuário.
    7. Clique em Projeto > Propriedades.
    8. Clique em Caminho de Construção Java.
    9. Clique em Incluir Biblioteca.
    10. Selecione Biblioteca de Usuário. Clique em Avançar.
    11. Marque a biblioteca eXtremeScaleClient e clique em Concluir.
    12. Clique em OK para fechar o diálogo Propriedades do Projeto.
  2. Defina Tomcat Server para nosso projeto.
    1. Certifique-se de estar na perspectiva J2EE e clique na guia Servidores na área de janela inferior. Você também pode clicar em Janela > Mostrar Visualização > Servidores.
    2. Clique com o botão direito do mouse na área de janela Servidores e escolha Novo > Servidor.
    3. Escolha Apache, Tomcat v6.0 Server. Clique em Avançar.
    4. Clique em Procurar e selecione tomcat_root. Clique em OK.
    5. Clique em Avançar.
    6. Selecione seu aplicativo Java EE na área de janela Disponível à esquerda, clique em Incluir > para movê-lo para a área de janela Configurado à direita no servidor e clique em Concluir.
  3. Resolva quaisquer erros restantes para o Projeto. Use as seguintes etapas para eliminar erros na área de janela Problemas:
    1. Clique em Projeto > Limpar > project_name. Clique em OK. Construa o projeto.
    2. Clique com o botão direito no projeto Java EE e escolha Caminho de Construção > Configurar Caminho de Construção.
    3. Clique na guia Bibliotecas. Certifique-se de que o caminho seja configurado adequadamente:
      • Para aplicativos cliente: Certifique-se de que o Apache Tomcat, o eXtremeScaleClient e o Java 1.5 JRE estejam no caminho.
      • Para aplicativos de servidor: Certifique-se de que o Apache Tomcat, o eXtremeScale e o Java 1.5 JRE estejam no caminho.
  4. Crie uma configuração de execução para executar seu aplicativo.
    1. No menu Executar, selecione Executar Configurações.
    2. Clique com o botão direito do mouse na categoria Aplicativo Java e selecione Novo.
    3. Selecione a nova configuração de execução, denominada New_Configuration.
    4. Configure o perfil.
      •  Projeto (na página tabulada principal): your_project_name
      • Classe Principal (na página tabulada principal): your_main_class
      • Argumentos VM (na página tabulada de argumentos): -Djava.endorsed.dirs=wxs_root/lib/endorsed

      Problemas com os Argumentos VM ocorrem com frequência porque o caminho para java.endorsed.dirs deve ser um caminho absoluto sem variáveis ou atalhos.

      Outros problemas comuns de configuração envolvem o Object Request Broker (ORB). Você deve ver o seguinte erro. Consulte o Configurando um Object Request Broker Customizado para obter mais informações:
      Caused by: java.lang.RuntimeException: The ORB that comes with the
      Java implementation does not work with ObjectGrid at this time.
      Se você não tiver os arquivos objectGrid.xml ou deployment.xml acessíveis ao aplicativo, poderá ver o seguinte erro:
      Exception in thread "P=211046:O=0:CT" com.ibm.websphere.objectgrid.ObjectGridRuntimeException: 
      Cannot start OG container
      	at Client.startTestServer(Client.java:161)
      	at Client.main(Client.java:82)
      Caused by: java.lang.IllegalArgumentException: The objectGridXML must not be null
      	at com.ibm.websphere.objectgrid.deployment.DeploymentPolicyFactory.createDeploymentPolicy
        (DeploymentPolicyFactory.java:55)
      	at Client.startTestServer(Client.java:154)
      	... 1 more
  5. Clique em Aplicar e feche a janela ou clique em Executar.

O que Fazer Depois

Depois de configurar e de executar um aplicativo da web com o cliente do WebSphere eXtreme Scale no Rational Application Developer, será possível desenvolver um servlet. Esse servlet usa as APIs do WebSphere eXtreme Scale para armazenar e recuperar dados de uma grade de dados remota.

Depois de ativar um aplicativo Java EE na interface do Rational Application Developer com uma instalação independente do WebSphere eXtreme Scale, será possível desenvolver um servlet que use as APIs de sistema do WebSphere eXtreme Scale para iniciar e parar serviços de catálogo.