Inicio de los servicios de datos REST en Apache Tomcat

Este tema describe cómo configurar e iniciar el servicio de datos REST de eXtreme Scale utilizando Apache Tomcat versión 5.5 o posterior.

Antes de empezar

Compruebe que se haya iniciado la cuadrícula de datos de ejemplo de eXtreme Scale. Consulte Habilitación del servicio de datos REST para obtener información detallada sobre cómo iniciar la cuadrícula de datos.

Procedimiento

  1. Descargue e instale Apache Tomcat Versión 5.5 o posterior en raíz_tomcat, por ejemplo: /opt/tomcat
  2. Instale el servicio de datos REST de eXtreme Scale y el ejemplo proporcionado en el servidor Tomcat tal como se indica a continuación:
    1. Si utiliza un JRE o JDK de Oracle, debe instalar el ORB de IBM® en Tomcat:
      • Para Tomcat versión 5.5

        Copie todos los archivos JAR de:

        inicio_wxs/lib/endorsed

        a

        raíz_tomcat/common/endorsed

      • Para Tomcat versión 6.0
        1. Cree un directorio "endorsed"
          • [Unix][Linux] mkdir raíz_tomcat/endorsed
          • [Windows] md raíz_tomcat/endorsed
        2. Copie todos los archivos JAR de:

          inicio_wxs/lib/endorsed

          a

          raíz_tomcat/endorsed

    2. Despliegue el módulo del servicio de datos REST: wxsrestservice.war al servidor Tomcat.

      Copie el archivo wxsrestservice.war de:

      inicio_restservice/lib

      a:

      raíz_tomcat/webapps

    3. Añada el JAR de tiempo de ejecución del cliente ObjectGrid y el JAR de la aplicación a la vía de acceso de clases compartida de Tomcat:
      1. Edite el archivo raíz_tomcat/conf/catalina.properties
      2. Añada los nombres de vía de acceso siguientes al final de la propiedad shared.loader en forma de lista delimitada por comas:
        • wxs_home/lib/ogclient.jar
        • inicio_restservice/gettingstarted/restclient/bin
        • inicio_restservice/gettingstarted/common/bin
        Importante: El separador de la vía de acceso debe ser una barra inclinada.

  3. Si se ha iniciado la cuadrícula de datos de eXtreme Scale con la seguridad de eXtreme Scale habilitada, establezca las propiedades siguientes en el archivo inicio_restservice/gettingstarted/restclient/bin/wxsRestService.properties.
    ogClientPropertyFile=inicio_restservice/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. Inicie el servidor Tomcat con el servicio de datos REST:
    • Si utiliza Tomcat 5.5 en UNIX o Windows, o bien Tomcat 6.0 en UNIX:
      1. cd raíz_tomcat/bin
      2. Inicie el servidor:
        • [Unix][Linux] ./catalina.sh run
        • [Windows] catalina.bat run
      3. La consola mostrará entonces los registros de Apache Tomcat. Cuando el servicio de datos REST se haya iniciado con éxito, aparecerá el mensaje siguiente en la consola de administración:

        CWOBJ4000I: Se ha iniciado el servicio de datos REST de WebSphere eXtreme Scale.

    • Si utiliza Tomcat 6.0 en Windows:
      1. cd raíz_tomcat/bin
      2. Inicie la herramienta de configuración de Apache Tomcat 6 con el mandato siguiente: tomcat6w.exe
      3. Pulse el botón Inicio de la ventana de propiedades de Apache Tomcat 6 para iniciar al servidor Tomcat.
      4. Examine los registros siguientes para verificar que el servidor Tomcat se haya iniciado con éxito:
        • raíz_tomcat/bin/catalina.log

          Muestra el estado del motor del servidor Tomcat

        • raíz_tomcat/bin/stdout.log

          Muestra el registro de salida del sistema.

      5. Cuando el servicio de datos REST se haya iniciado con éxito, aparecerá el mensaje siguiente en el registro de salida del sistema: CWOBJ4000I: Se ha iniciado el servicio de datos REST de WebSphere eXtreme Scale.
  5. Verifique que el servicio de datos REST funcione
    1. Abra un navegador y acceda a:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid

      Aparecerá el documento de servicio correspondiente a NorthwindGrid.

    2. Vaya a:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      Aparecerá el documento de extensiones de datos del modelo de entidad (EDMX).

  6. Para detener los procesos de la cuadrícula de datos, utilice CTRL+C en la ventana de mandatos correspondiente.
  7. Para detener Tomcat, utilice CTRL +C en la ventana en la cual lo haya iniciado.