Despliegue del servicio de datos REST en Apache Tomcat

Este tema describe cómo configurar el servicio de datos REST de WebSphere eXtreme Scale en Apache Tomcat Versión 5.5 o posterior.

Acerca de esta tarea

Procedimiento

  1. Si utiliza un JRE o JDK de Oracle, instale el ORB de IBM en Tomcat:
    1. Tomcat versión 5.5:

      Copie todos los archivos JAR de:

      el directorio inicio_wxs/lib/endorsed

      a:

      el directorio raíz_tomcat/common/endorsed

    2. Tomcat versión 6.0:

      Cree un directorio "endorsed":

      [Unix][Linux] mkdir raíz_tomcat/endorsed

      [Windows] md raíz_tomcat/endorsed

      Copie todos los archivos JAR de:

      inicio_wxs/lib/endorsed

      a:

      raíz_tomcat/common/endorsed

  2. Configure e inicie una cuadrícula de datos.
    1. Para obtener información sobre cómo configurar una cuadrícula de datos para su uso con el servicio de datos REST, consulte Configuración.
    2. Verifique que un cliente de eXtreme Scale se pueda conectar a entidades de la cuadrícula y acceder a ellas. Si desea ver un ejemplo, consulte Configuración de servicios de datos REST.
  3. Cree el archivo JAR o el directorio de configuración del servicio REST de eXtreme Scale. Consulte la información sobre empaquetamiento y despliegue en Instalación del servicio de datos REST para obtener los detalles.
  4. Despliegue el módulo del servicio de datos REST: wxsrestservice.war al servidor Tomcat.

    Copie el archivo wxsrestservice.war de:

    inicio_servicioRest/lib

    a:

    raíz_tomcat/webapps

  5. 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, separándolos mediante comas:
  6. Si utiliza la seguridad Java 2 y añade permisos de seguridad al archivo de política tomcat:
    • Si utiliza Tomcat versión 5.5:

      Fusione el contenido del archivo de política catalina 5.5 de ejemplo que se encuentra en

      inicio_servicioRest/gettingstarted/tomcat/catalina-5_5.policy con el archivo raíz_tomcat/conf/catalina.policy.

    • Si utiliza Tomcat versión 6.0:

      Fusione el contenido del archivo de política catalina 6.0 de ejemplo que se encuentra en

      inicio_servicioRest/gettingstarted/tomcat/catalina-6_0.policy con el archivo raíz_tomcat/conf/catalina.policy.

  7. Inicie el servidor Tomcat:
    • Si utiliza Tomcat 5.5 en UNIX o Windows o la distribución en ZIP de Tomcat 6.0:

      1. cd raíz_tomcat/bin
      2. Inicie el servidor:
        • Sin la seguridad Java 2 habilitada:

          [Unix][Linux] ./catalina.sh run

          [Windows] catalina.bat run

        • Con la seguridad Java 2 habilitada:

          [Unix][Linux] ./catalina.sh run -security

          [Windows] catalina.bat run -security

      3. Los registros de Apache Tomcat se muestran en la consola. Cuando el servicio de datos REST se haya iniciado con éxito, aparecerá el mensaje siguiente en la consola administrativa:

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

    • Si utiliza Tomcat 6.0 en Windows utilizando la distribución del instalador de Windows:
      1. cd /bin
      2. Inicie la herramienta de configuración de Apache Tomcat 6:

        tomcat6w.exe

      3. Para habilitar la seguridad Java 2 (opcional):

        Añada las entradas siguientes a las Opciones de Java en el separador Java en la ventana de propiedades de Apache Tomcat 6:

        -Djava.security.manager

        -Djava.security.policy=\conf\catalina.policy

      4. Pulse el botón Inicio de la ventana de propiedades de Apache Tomcat 6 para iniciar al servidor Tomcat.
      5. 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.

      6. 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.

  8. Verifique que el servicio de datos REST funcione.
    Abra un navegador web y acceda al URL siguiente:
    http://host:puerto/raíz_contexto/restservice/nombre_cuadrícula

    El puerto predeterminado para Tomcat es 8080 y se configura en el archivo raíz_tomcat/conf/server.xml en el elemento <Connector>.

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

Resultados

Aparecerá el documento de servicio de AtomPub.