Ejecución de una aplicación de servidor o cliente de WebSphere eXtreme Scale con Apache Tomcat en Rational Application Developer

Tanto si tiene una aplicación de servidor como una aplicación cliente, utilice los mismos pasos básicos para ejecutar la aplicación en Apache Tomcat en Rational Application Developer. Para una aplicación cliente, desea configurar y ejecutar una aplicación web para utilizar un cliente de WebSphere eXtreme Scale en Rational Application Developer. Siga estas instrucciones para crear un proyecto web para ejecutar un servicio de catálogo o contenedor de WebSphere eXtreme Scale. Para una aplicación de servidor, desea habilitar una aplicación Java EE en la interfaz de Rational Application Developer con una instalación autónoma de WebSphere eXtreme Scale. Siga estas instrucciones para configurar un proyecto de aplicación Java EE utilizando la biblioteca de cliente de WebSphere eXtreme Scale.

Antes de empezar

Instale el producto WebSphere eXtreme Scale de prueba o completo.

Procedimiento

  1. Añada la biblioteca de tiempo de ejecución de WebSphere eXtreme Scale a la vía de acceso de compilación de Java EE.

    Aplicación cliente En este escenario, desea configurar y ejecutar una aplicación cliente para utilizar un cliente WebSphere eXtreme Scale en Rational Application Developer.

    1. Ventana > Preferencias > Java > Vía de acceso de compilación > Bibliotecas de usuario. Pulse Nueva.
    2. Introduzca un Nombre de biblioteca de usuario de eXtremeScaleClient y pulse Aceptar.
    3. Pulse Añadir Jars... y navegue hasta el archivo wxs_home/lib/ogclient.jar y selecciónelo. Pulse Abrir.
    4. Opcional: (Opcional) Para añadir un Javadoc, seleccione la ubicación del Javadoc y pulse Editar..... En la vía de acceso de ubicación del Javadoc, puede introducir el URL de la documentación de la API o puede descargar la documentación de la API.
      • Para utilizar la documentación de la API en línea, introduzca http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ en la vía de acceso de ubicación del Javadoc.
      • Para descargar la documentación de la API, vaya a la página de descargas WebSphere eXtreme Scale API documentation. En la vía de acceso de ubicación del Javadoc, introduzca su ubicación de descarga local.
    5. Pulse Aceptar.
    6. Pulse Aceptar para cerrar el diálogo Bibliotecas de usuario.
    7. Pulse Proyecto > Propiedades.
    8. Pulse Vía de acceso de compilación Java.
    9. Pulse Añadir biblioteca.
    10. Seleccione Biblioteca de usuario. Pulse Siguiente.
    11. Seleccione la biblioteca eXtremeScaleClient y pulse Finalizar.
    12. Pulse Aceptar para cerrar el diálogo Propiedades del proyecto.

    Aplicación de servidor En este escenario, desea configurar y ejecutar una aplicación web para ejecutar un servidor WebSphere eXtreme Scale incorporado en Rational Application Developer.

    1. Pulse Ventana > Preferencias > Java > Vía de acceso de compilación > Bibliotecas de usuario. Pulse Nueva.
    2. Introduzca un Nombre de biblioteca de usuario de eXtremeScale y pulse Aceptar.
    3. Pulse Añadir Jars... y seleccione inicio_wxs/lib/objectgrid.jar. Pulse Abrir.
    4. (Opcional) Para añadir un Javadoc, seleccione la ubicación del Javadoc y pulse Editar..... En la vía de acceso de ubicación del Javadoc, introduzca http://www.ibm.com/developerworks/wikis/extremescale/docs/api/.
    5. Pulse Aceptar.
    6. Pulse Aceptar para cerrar el diálogo Bibliotecas de usuario.
    7. Pulse Proyecto > Propiedades.
    8. Pulse Vía de acceso de compilación Java.
    9. Pulse Añadir biblioteca.
    10. Seleccione Biblioteca de usuario. Pulse Siguiente.
    11. Seleccione la biblioteca eXtremeScaleClient y pulse Finalizar.
    12. Pulse Aceptar para cerrar el diálogo Propiedades del proyecto.
  2. Defina Tomcat Server para el proyecto.
    1. Asegúrese de que se encuentra en la perspectiva J2EE y pulse el separador Servidores en el panel inferior. Puede pulsar también Ventana > Mostrar vista > Servidores.
    2. Pulse el botón derecho del ratón en el panel Servidores y seleccione Nuevo > Servidor.
    3. Seleccione Apache, Tomcat v6.0 Server. Pulse Siguiente.
    4. Pulse Examinar... Seleccione raíz_tomcat. Pulse Aceptar.
    5. Pulse Siguiente.
    6. Seleccione la aplicación Java EE en el panel izquierdo Disponibles y pulse Añadir > para moverla al panel derecho Configuradas en el servidor, y pulse Finalizar.
  3. Resuelva los errores restantes del proyecto. Utilice los pasos siguientes para eliminar errores en el panel Problemas:
    1. Pulse Proyecto > Limpiar > nombre_proyecto. Pulse Aceptar. Compile el proyecto.
    2. Pulse con el botón derecho del ratón en el proyecto Java EE y elija Vía de acceso de compilación > Configurar vía de acceso de compilación.
    3. Pulse el separador Bibliotecas. Asegúrese de que la vía de acceso está configurada correctamente:
      • Para aplicaciones cliente: asegúrese de que Apache Tomcat, eXtremeScaleClient y Java 1.5 JRE estén en la vía de acceso.
      • Para aplicaciones de servidor: asegúrese de que Apache Tomcat, eXtremeScale y Java 1.5 JRE estén en la vía de acceso.
  4. Cree una configuración de ejecución para ejecutar la aplicación.
    1. En el menú Ejecutar, seleccione Ejecutar configuraciones.
    2. Pulse con el botón derecho del ratón en la categoría Aplicación Java y seleccione Nueva.
    3. Seleccione la nueva configuración de ejecución, denominada Nueva_configuración.
    4. Configure el perfil.
      •  Proyecto (en la página tabulada principal): su_nombre_proyecto
      • Clase principal (en la página tabulada principal): su_clase_principal
      • Argumentos de VM (en la página tabulada de argumentos): -Djava.endorsed.dirs=raíz_wxs/lib/endorsed

      Suelen ocurrir problemas con los Argumentos VM porque la vía de acceso de java.endorsed.dirs debe ser absoluta sin variables ni atajos.

      Otros problemas comunes de configuración están relacionados con el intermediario de solicitud de objetos (ORB). Podría aparecer el error siguiente. Consulte Configuración de un intermediario de solicitud de objetos personalizado para obtener más información:
      Caused by: java.lang.RuntimeException: The ORB that comes with the 
      Java implementation does not work with ObjectGrid at this time.
      Si no tiene los archivos objectGrid.xml o deployment.xml accesibles para la aplicación, podría aparecer el error siguiente:
      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. Pulse Aplicar y cierre la ventana o pulse Ejecutar.

Qué hacer a continuación

Después de configurar y ejecutar una aplicación web con el cliente de WebSphere eXtreme Scale en Rational Application Developer, puede desarrollar un servlet. Este servlet utiliza las API de WebSphere eXtreme Scale para almacenar y recuperar datos de una cuadrícula de datos remota.

Después de habilitar una aplicación Java EE en la interfaz de Rational Application Developer con una instalación autónoma de WebSphere eXtreme Scale, puede desarrollar un servlet que utilice las API del sistema de WebSphere eXtreme Scale para iniciar y detener servicios de catálogo.