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.
- Instale a versão independente do produto WebSphere eXtreme
Scale.
- Faça download e extraia a versão de teste do WebSphere eXtreme
Scale.
- Instale o Apache Tomcat Versão 6.0 ou posterior.
- Instale o Rational Application Developer e crie um aplicativo da web
Java EE.
Procedimento
- 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.
- . Clique em Novo.
- Digite um Nome da biblioteca de usuário de eXtremeScaleClient
e clique em OK.
- Clique em Incluir Jars..., navegue para
o arquivo wxs_home/lib/ogclient.jar e selecione-o.
Clique em Abrir.
- 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.
- Para usar a documentação da API on-line, digite http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ no
caminho do local Javadoc.
- Para fazer download da documentação da API, vá para a WebSphere eXtreme
Scale Página de download de documentação da
API. Para o caminho do local Javadoc, digite seu local de download
local.
- Clique em OK.
- Clique em OK para fechar o diálogo
Bibliotecas de Usuário.
- Clique em .
- Clique em Caminho de Construção Java.
- Clique em Incluir Biblioteca.
- Selecione Biblioteca de Usuário. Clique em Avançar.
- Marque a biblioteca eXtremeScaleClient e
clique em Concluir.
- 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.
- Clique em .
Clique em Novo.
- Digite um Nome de biblioteca de usuário de eXtremeScale
e clique em OK.
- Clique em Incluir Jars... e selecione wxs_home/lib/objectgrid.jar.
Clique em Abrir.
- (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/.
- Clique em OK.
- Clique em OK para fechar o diálogo
Bibliotecas de Usuário.
- Clique em .
- Clique em Caminho de Construção Java.
- Clique em Incluir Biblioteca.
- Selecione Biblioteca de Usuário. Clique em Avançar.
- Marque a biblioteca eXtremeScaleClient e
clique em Concluir.
- Clique em OK para fechar o diálogo Propriedades
do Projeto.
- Defina Tomcat Server para nosso projeto.
- Certifique-se de estar na perspectiva J2EE e clique na guia Servidores na área de janela inferior. Você também
pode clicar em .
- Clique com o botão direito do mouse na área de janela Servidores e escolha .
- Escolha Apache, Tomcat v6.0 Server.
Clique em Avançar.
- Clique em Procurar
e selecione tomcat_root. Clique em OK.
- Clique em Avançar.
- 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.
- Resolva quaisquer erros restantes para o Projeto. Use as seguintes etapas para eliminar erros na área de janela Problemas:
- Clique em . Clique em OK. Construa o projeto.
- Clique com o botão direito no projeto Java EE e escolha .
- 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.
- Crie uma configuração de execução para executar seu aplicativo.
- No menu Executar, selecione Executar Configurações.
- Clique com o botão direito do mouse na categoria Aplicativo Java
e selecione Novo.
- Selecione a nova configuração de execução, denominada New_Configuration.
- 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
- 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.