Despliegue del servicio de datos REST en WebSphere Application Server

Este tema describe cómo configurar el servicio de datos REST de WebSphere eXtreme Scale en WebSphere Application Server o WebSphere Application Server Network Deployment Versión 6.1.0.25 o posterior. Estas instrucciones se aplican también a despliegues donde WebSphere eXtreme Scale se integre con el despliegue de WebSphere Application Server.

Antes de empezar

Debe tener uno de los entornos siguientes en el sistema para configurar y desplegar el servicio de datos REST para WebSphere eXtreme Scale.

Procedimiento

  1. 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 Inicio de una cuadrícula de datos para servicios de datos REST en WebSphere Application Server.
    2. Compruebe que un cliente 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 cómo empaquetar y desplegar el servicio REST en Instalación del servicio de datos REST.
  3. Añada el archivo JAR o el directorio de configuración del servicio de datos REST a la vía de acceso de clases del servidor de aplicaciones:
    1. Abra la consola administrativa de WebSphere Application Server.
    2. Vaya a Entorno > Bibliotecas compartidas
    3. Pulse Nuevo
    4. Añada las entradas siguientes a los campos apropiados:
      • Nombre: extremescale_rest _configuration
      • Classpath: <jar o directorio de configuración del servicio REST>
    5. Pulse Aceptar
    6. Guarde los cambios en la configuración maestra
  4. Añada el archivo JAR del tiempo de ejecución del cliente de WebSphere eXtreme Scale, wsogclient.jar, y el archivo JAR o el directorio de la configuración del servicio de datos REST a la classpath del servidor de aplicaciones. Este paso no es necesario si WebSphere eXtreme Scale está integrado con la instalación de WebSphere Application Server.

    1. Abra la consola administrativa de WebSphere Application Server.
    2. Vaya a Entorno > Bibliotecas compartidas.
    3. Pulse Nueva.
    4. Añada las entradas siguientes a los campos:
      • Nombre: extremescale_client_v71
      • Classpath: inicio_wxs/lib/wsogclient.jar
      Recuerde: Añada cada vía de acceso a una línea distinta.
    5. Pulse Aceptar.
    6. Guarde los cambios en la configuración maestra.
  5. Instale el archivo EAR del servicio de datos REST, wxsrestservice.ear, en WebSphere Application Server con la consola administrativa:
    1. Abra la consola administrativa de WebSphere Application Server.
    2. Pulse Aplicaciones > Nueva aplicación.
    3. Vaya al archivo /lib/wxsrestservice.ear en el sistema de archivos, selecciónelo y pulse Siguiente.
      • Si utiliza WebSphere Application Server Versión 7.0, pulse Siguiente.
      • Si utiliza WebSphere Application Server Versión 6.1, especifique un valor de raíz de contexto con el nombre: /wxsrestservice y continúe al paso siguiente.
    4. Elija la opción de instalación detallada y pulse Siguiente.
    5. En la pantalla de avisos de seguridad de la aplicación, pulse Continuar.
    6. Elija las opciones de instalación predeterminadas y pulse Siguiente.
    7. Elija un servidor al que correlacionar la aplicación y pulse Siguiente.
    8. En la página de recarga de JSP, utilice los valores predeterminados y pulse Siguiente.
    9. En la página de bibliotecas compartidas, correlacione el módulo wxsrestservice.war con las bibliotecas compartidas que ha definido:
      • extremescale_rest_configuration
      • extremescale_client_v71
      Consejo: Esta biblioteca compartida solo es necesaria si WebSphere eXtreme Scale no está integrado con WebSphere Application Server.
    10. En la página de correlación de la relación de bibliotecas compartidas, utilice los valores predeterminados y pulse Siguiente.
    11. En la página de correlación de sistemas principales virtuales, utilice los valores predeterminados y pulse Siguiente.
    12. En la página de correlación de raíces de contexto, defina wxsrestservice como raíz de contexto
    13. En la pantalla Resumen, pulse Finalizar para completar la instalación.
    14. Guarde los cambios en la configuración maestra.
  6. Inicie la aplicación de servicio de datos REST wxsrestservice:
    1. Vaya a la aplicación en la consola administrativa.
      • WebSphere Application Server Versión 7.0: en la consola administrativa, pulse Aplicaciones > Tipos de aplicación > Aplicaciones WebSphere.
      • WebSphere Application Server Versión 6.1: en la consola administrativa, pulse Aplicaciones > Aplicaciones empresariales.
    2. Marque el recuadro de selección junto a la aplicación wxsrestservice y pulse Iniciar.
    3. Revise el archivo SystemOut.log para el perfil del servidor de aplicaciones. Cuando el servicio de datos REST se ha iniciado satisfactoriamente, se visualiza el mensaje siguiente en el archivo SystemOut.log para el perfil del servidor:

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

  7. Verifique que el servicio de datos REST funcione: El número de puerto se puede encontrar en el archivo SystemOut.log en el directorio de registros del perfil del servidor de aplicaciones mirando el primer puerto visualizado para el identificador de mensaje: SRVE0250I. El puerto predeterminado es 9080.

    Por ejemplo:http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/ Resultado: Se visualiza el documento del servicio AtomPub.

    Por ejemplo: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata. Aparecerá el documento de extensiones de datos del modelo de entidad (EDMX).

  8. Para detener los procesos de la cuadrícula de datos, utilice CTRL+C en la ventana de mandatos correspondiente.