Despliegue del servicio de datos REST en WebSphere Application Server Community Edition

Puede configurar los servicios de datos REST de eXtreme Scale en WebSphere Application Server Community Edition Versión 2.1.1.3 o posterior.

Antes de empezar

Procedimiento

  1. Configure e inicie una cuadrícula de datos.
    1. Para obtener más información sobre cómo configurar una cuadrícula de datos de eXtreme Scale para su uso con el servicio de datos REST, lea sobre Inicio de una cuadrícula de datos autónoma para servicios de datos REST.
    2. Compruebe que un cliente de eXtreme Scale se pueda conectar y acceder a las entidades de la cuadrícula de datos. Si desea ver un ejemplo, consulte Guía de aprendizaje: Cómo empezar con WebSphere eXtreme Scale.
  2. 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 el tema Instalación del servicio de datos REST para obtener los detalles.
  3. Inicie el servidor WebSphere Application Server Community Edition:
    1. Para iniciar el servidor sin la seguridad Java SE habilitada, ejecute el mandato siguiente:

      [Unix][Linux] raíz_wasce/bin/startup.sh

      [Windows] raíz_wasce/bin/startup.bat

    2. Para iniciar el servidor con la seguridad Java SE habilitada, siga los pasos que se indican a continuación: [Unix][Linux]
      1. Abra una ventana de línea de mandatos o de terminal y ejecute el mandato de copia siguiente (o copie el contenido del archivo de política especificado en la política existente): cp inicio_restservice/gettingstarted/wasce/geronimo.policy raíz_wasce/bin
      2. Edite el archivo raíz_wasce/bin/setenv.sh
      3. Después de la línea que contiene "WASCE_JAVA_HOME=", añada lo siguiente: export JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

      [Windows]
      1. Abra una ventana de línea de mandatos y ejecute el siguiente mandato copy o bien copie el contenido del archivo de política especificado en la política existente:

        copy inicio_restservice\gettingstarted\wasce\geronimo.policy\bin

      2. Edite el archivo raíz_wasce\bin\setenv.bat
      3. Después de la línea que contiene "set WASCE_JAVA_HOME=", añada lo siguiente:

        set JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

  4. Añada el JAR de tiempo de ejecución del cliente ObjectGrid al depósito de WebSphere Application Server Community Edition:
    1. Abra la consola de administración de WebSphere Application Server Community Edition e inicie sesión. El URL predeterminado es: http://localhost:8080/console, el ID de usuario predeterminado es system y la contraseña es manager.
    2. Pulse el enlace Depósito del lado izquierdo de la ventana de la consola, en la carpeta Servicios.
    3. En la sección Añadir archivo al depósito, introduzca los datos siguientes en los recuadros de texto de entrada:
      Tabla 1. Añadir archivo al depósito
      Recuadro de texto Valor
      Archivo wxs_home/lib/ogclient.jar
      Grupo com.ibm.websphere.xs
      Artefacto ogclient
      Versión 7.1
      Tipo JAR
    4. Pulse el botón Instalar

    Consulte la nota técnica siguiente para obtener información detallada sobre los distintos métodos que se pueden utilizar para configurar las dependencias de clase y biblioteca: Specifying external dependencies to applications running on WebSphere Application Server Community Edition (Especificación de dependencias externas con aplicaciones que se ejecutan en WebSphere Application Server Community Edition).

  5. Despliegue el módulo del servicio de datos REST, el archivo wxsrestservice.war, en el servidor WebSphere Application Server Community Edition.
    1. Copie y edite el archivo XML de plan de despliegue de ejemplo: inicio_restservice/gettingstarted/wasce/geronimo-web.xml para incluir las dependencias de vía de acceso del JAR o directorio de configuración del servicio de datos REST. Consulte la sección para ver un ejemplo de cómo definir la vía de acceso de clases para incluir el archivo wxsRestService.properties y otros archivos de configuración y clases de metadatos.
    2. Abra la consola de administración de WebSphere Application Server Community Edition e inicie sesión.
      Consejo: El URL predeterminado es: http://localhost:8080/console. El ID de usuario predeterminado es system y la contraseña es manager.
    3. Pulse el enlace Desplegar nuevas del lado izquierdo de la ventana de la consola.
    4. En la página Instalar aplicaciones nuevas, escriba los valores siguientes en los recuadros de texto:
      Tabla 2. Instalar aplicaciones nuevas
      Recuadro de texto Valor
      Archivo inicio_restservice/lib/wxsrestservice.war
      Plan inicio_restservice/gettingstarted/wasce/geronimo-web.xml
      Consejo: Utilice la vía de acceso al archivo geronimo-web.xml que ha copiado y editado en el paso 3.
    5. Pulse el botón Instalar. La página de la consola indica entonces que la aplicación se ha instalado e iniciado satisfactoriamente.
    6. Examine la consola o el registro de salida del sistema WebSphere Application Server Community Edition para comprobar que el servicio de datos REST se haya iniciado satisfactoriamente. Debe aparecer el mensaje siguiente:

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

  6. Inicie el servidor WebSphere Application Server Community Edition ejecutando el mandato siguiente:
    • [Unix][Linux] raíz_wasce/bin/startup.sh
    • [Windows] raíz_wasce/bin/startup.bat
  7. Instale el servicio de datos REST de eXtreme Scale y el ejemplo proporcionado en el servidor WebSphere Application Server Community Edition:
    1. Añada el JAR de tiempo de ejecución del cliente ObjectGrid al depósito de WebSphere Application Server Community Edition:
      1. Abra la consola de administración de WebSphere Application Server Community Edition e inicie sesión. El URL predeterminado es: http://localhost:8080/console. El ID de usuario predeterminado es system y la contraseña es manager.
      2. Pulse el enlace Depósito del lado izquierdo de la ventana de la consola, en la carpeta Servicios.
      3. En la sección Añadir archivo al depósito, introduzca los datos siguientes en los recuadros de texto de entrada:
        Tabla 3. Añadir archivo al depósito
        Recuadro de texto Valor
        Archivo wxs_home/lib/ogclient.jar
        Grupo com.ibm.websphere.xs
        Artefacto ogclient
        Versión 7.1
        Tipo JAR
      4. Pulse el botón Instalar.
        Consejo: Consulte la nota técnica siguiente para obtener información detallada sobre los distintos métodos que se pueden utilizar para configurar las dependencias de clase y biblioteca: Specifying external dependencies to applications running on WebSphere Application Server Community Edition (Especificación de dependencias externas con aplicaciones que se ejecutan en WebSphere Application Server Community Edition).
    2. Despliegue el módulo del servicio de datos REST: wxsrestservice.war en el servidor WebSphere Application Server Community Edition.
      1. Edite el archivo XML de despliegue de ejemplo restservice_home/gettingstarted/wasce/geronimo-web.xml para incluir las dependencias de vía de acceso a los directorios de vía de acceso de clases del ejemplo de iniciación:
        • Cambie los "classesDirs" para los dos GBeans del cliente de iniciación:
        La vía de acceso "classesDirs" para el GBean GettingStarted_Client_SharedLib se debe definir como: inicio_restservice/gettingstarted/restclient/bin

        La vía de acceso "classesDirs" para el GBean GettingStarted_Common_SharedLib se debe definir como: inicio_restservice/gettingstarted/common/bin

      2. Abra la consola de administración de WebSphere Application Server Community Edition e inicie sesión.
      3. Pulse el enlace Desplegar nuevas del lado izquierdo de la ventana de la consola.
      4. En la página Instalar aplicaciones nuevas, escriba los valores siguientes en los recuadros de texto:
        Tabla 4. Instalar aplicaciones nuevas
        Recuadro de texto Valor
        Archivo inicio_restservice/lib/wxsrestservice.war
        Plan inicio_restservice/gettingstarted/wasce/geronimo-web.xml
      5. Pulse el botón Instalar.

        La página de la consola indica entonces que la aplicación se ha instalado e iniciado satisfactoriamente.

      6. Examine el registro de salida del sistema WebSphere Application Server Community Edition para verificar que el servicio de datos REST se ha iniciado satisfactoriamente comprobando si el mensaje siguiente está presente:

        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 de contexto>/restservice/<nombre de cuadrícula>

    El puerto predeterminado para WebSphere Application Server Community Edition es 8080 y se define utilizando la propiedad "HTTPPort" en el archivo /var/config/config-substitutions.properties.

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

Resultados

Aparecerá el documento de servicio de AtomPub.