Ejecución de los scripts de configuración y verificación de pureQuery Runtime para WebSphere Application Server

El directorio de instalación de pureQuery contiene scripts que configuran WebSphere Application Server para ejecutar aplicaciones habilitadas para pureQuery. El directorio también contiene una aplicación de servlet de WebSphere que verifica si se ha configurado correctamente WebSphere Application Server.

Antes de empezar

El usuario que ejecuta los scripts debe tener los privilegios siguientes:

Acerca de esta tarea

Los scripts están en el directorio PureQuery_Websphere_Config_Scripts del directorio de instalación de pureQuery Runtime.

Puede ejecutar los scripts sin especificar los parámetros para visualizar los parámetros necesarios y opcionales para el script.

Procedimiento

Para ejecutar los scripts configure WebSphere Application Server de modo que funcione con pureQuery Runtime y para verificar la configuración, ejecute los scripts en este orden:

  1. Ejecute el script InstallPQJars para actualizar una vía de acceso de proveedor de JDBC con la información de pureQuery Runtime.
  2. Ejecute el script SetupDSProp para crear una propiedad de origen de datos personalizado que especifique las propiedades de pureQuery Runtime.
  3. Ejecute el script InstallPQValidator para verificar la configuración de pureQuery Runtime.

Ejecución del script InstallPQJars para añadir los archivos JAR de pureQuery Runtime JAR a una vía de acceso de clases de proveedor de JDBC

Cuando se ejecuta el script InstallPQJars, se especifica el ámbito del proveedor JDBC de WebSphere que se ha de actualizar y la vía de acceso de los archivos JAR de pureQuery Runtime. Seleccione el proveedor JDBC de la lista de proveedores que muestra el script. El script actualiza la vía de acceso de clases del proveedor JDBC que especifique. Cuando el script ha configurado la vía de acceso de clases del proveedor, muestra información acerca del proveedor JDBC de WebSphere, pureQuery Runtime y el entorno Java.

Procedimiento

Para ejecutar el script añada los archivos JAR de pureQuery Runtime a una vía de acceso de clases de proveedor JDBC:

  1. Abra una ventana de mandatos y ejecute el script InstallPQJars. Por ejemplo, este mandato especifica que el nodo de WebSphere devNode01 y la vía de acceso de los archivos JAR de pureQuery Runtime es C:/PureQueryRuntime. :
     InstallPQJars -node devNode01 -pqPath C:/PureQueryRuntime

    El mandato de ejemplo presupone que los proveedores JDBC de WebSphere se definen en el nivel de nodo y que la instalación de WebSphere Application Server es una instalación autónoma y simple.

  2. Siga las instrucciones del script para configurar la vía de acceso de clases del proveedor JDBC.

    Si el script detecta los archivos JAR de pureQuery Runtime en la vía de acceso de clases, puede optar por actualizar la vía de acceso de clases o mantener la vía de acceso de clases actual.

    Cuando se completa el script, muestra la información de configuración de WebSphere, pureQuery y Java.

Qué hacer a continuación

En la consola administrativa, puede ver la vía de acceso de clases de proveedor JDBC con la información de pureQuery Runtime.

A continuación, ejecute el script SetupDSProp para configurar un origen de datos de proveedor JDBC con propiedades de pureQuery Runtime.

Ejecución del script SetupDSProp para añadir propiedades de pureQuery Runtime a un origen de datos

Cuando se ejecuta el script SetupDSProp, se especifican los valores de las propiedades de pureQuery Runtime y un servidor WebSphere. El script SetupDSProp crea la propiedad personalizada pdqProperties para el origen de datos especificado. El valor de la propiedad es la lista de los valores de propiedades de pureQuery Runtime especificados.

Procedimiento

Para ejecutar el script configure un origen de datos:

  1. Abra una ventana de mandatos y ejecute el script SetupDSProp. Por ejemplo, este mandato especifica el servidor WebSphere server1 y especifica el valor de la propiedad captureMode de pureQuery Runtime como ON y el valor de la propiedad pureQueryXml como C:\temp\capture.pdqxml.
    SetupDSProp -server server1 -props "captureMode(ON), pureQueryXml(C:\temp\capture.pdqxml)"
    Nota: El script no valida los valores de las propiedades de pureQuery Runtime que especifique. Crea la propiedad personalizada pdqProperties con la serie como el valor de la propiedad.
  2. Siga las instrucciones del script para configurar el origen de datos.

    Después de seleccionar el origen de datos para configurarlo, el script crea la propiedad personalizada. A continuación, el script muestra información acerca del origen de datos y de la propiedad personalizada.

Resultados

En la consola administrativa, puede verificar que la propiedad personalizada pdqProperties esté establecida. La propiedad se lista como una propiedad personalizada para el origen de datos.

Qué hacer a continuación

A continuación, ejecute el script InstallPQValidator para verificar que la configuración de pureQuery Runtime sea correcta ejecutando el script InstallPQValidator.

Ejecución del script InstallPQValidator para verificar la configuración de pureQuery Runtime

El script InstallPQValidator instala e inicia el servlet de WebSphere RunPQDataVersionEAR.ear. El servlet valida la configuración de pureQuery y los requisitos previos de pureQuery Runtime para el origen de datos. El servlet muestra el contenido, los cargadores de clases de aplicación, las propiedades globales de pureQuery y la información de versión de pureQuery Runtime.

Procedimiento

Para ejecutar el script verifique la instalación de pureQuery Runtime:

  1. Abra una ventana de mandatos y ejecute el script InstallPQValidator. Por ejemplo, este mandato especifica el servidor WebSphere server1, nodo devNode01.
    InstallPQValidator -server server1 -node devNode01
    El script instala e inicia el servlet

    El servlet se lista como una aplicación en la consola administrativa.

  2. Ejecute el servlet desde un navegador. Inicie un navegador y especifique el URL para ejecutar el servlet.
    Por ejemplo, este URL presupone que WebSphere se está ejecutando, que el servlet está en su sistema y que el puerto de WebSphere Application Server es 9081:
    http://localhost:9081/RunPQValidate/
    Se abre la página del servlet.
  3. En la página del servlet, escriba el nombre JNDI del origen de datos de DB2 y pulse Enviar.

    El servlet realiza la conexión con el origen de datos y luego muestra la información de configuración en la ventana del navegador.

Qué hacer a continuación

Se ha configurado el origen de datos de WebSphere Application Server para pureQuery Runtime. Las aplicaciones habilitadas para pureQuery pueden utilizar el origen de datos para acceder a una base de datos DB2.

Comentarios