Configuración de un origen de datos con la consola administrativa

Los componentes de aplicación utilizan un origen de datos para acceder a las instancias de conexión con la base de datos.

Antes de empezar

El servidor de aplicaciones da soporte a dos versiones distintas de un origen de datos. Determine el origen de datos para el entorno de acuerdo con el enterprise bean y los niveles de especificación de servlet que forman la base de las aplicaciones:
  • Los orígenes de datos (WebSphere Application Server versión 4) se utilizan con la especificación Enterprise JavaBeans (EJB) 1.0 y la especificación Java™ Servlet 2.2.
  • Los orígenes de datos de la última versión estándar se utilizan con aplicaciones que implementan los releases más avanzados de estas especificaciones.

Acerca de esta tarea

Al crear un origen de datos, éste se asocia con un proveedor de JDBC (Java Database Connectivity) que se ha configurado para acceder a una base de datos de proveedor específica. El servidor de aplicaciones requiere que los dos objetos de la aplicación realicen llamadas a dicha base de datos concreta y reciban datos de la misma. El origen de datos proporciona funciones de gestión de conexiones que hacen posible físicamente estos intercambios entre las aplicaciones y la base de datos.
Recuerde: El servidor tiene que reiniciarse para que el origen de datos recién creado esté disponible para una JNDI (Java Naming and Directory Interface) desde la aplicación.

Procedimiento

  1. Abra la consola de administración.
  2. Acceda al panel de la consola necesario. Utilice una de las vías de acceso siguientes:
    • Pulse Recursos > JDBC > Orígenes de datos.
    • Pulse Recursos > JDBC > Orígenes de datos (WebSphere Application Server versión 4)
    • Pulse Recursos > JDBC > Proveedores de JDBC > proveedor_jdbc > Orígenes de datos.
    • Pulse Recursos > JDBC > Proveedores JDBC > proveedor_JDBC > Orígenes de datos (WebSphere Application Server versión 4).
  3. Seleccione el ámbito en el que las aplicaciones pueden utilizar el origen de datos. Puede elegir una célula, el nodo, el clúster o el servidor. Para obtener más información, consulte el tema sobre los valores de ámbito.
    Sólo versión 4: A partir de este punto, los pasos para crear orígenes de datos de WebSphere Application Server Versión 4 difieren de los pasos para crear orígenes de datos de la última versión estándar. Para configurar un origen de datos de versión 4:
    • Pulse Nuevo para continuar con el panel de la consola para definir propiedades necesarias.
    • En este panel de propiedades, especifique valores para los campos que se agrupan bajo la cabecera Configuración. El servidor de aplicaciones requiere estas propiedades para implementar las clases del controlador de JDBC.
    • Guarde la configuración pulsando Aceptar. En este momento ha acabado las tareas de configuración del origen de datos primario.
    • Defina otras propiedades que podría necesitar el proveedor de la base de datos, o que podría ofrecer como opciones, para su uso con el controlador de JDBC. El servidor de aplicaciones las llama propiedades personalizadas y es necesario que las defina en el origen de datos. Comience por pulsar el enlace Propiedades personalizadas que ahora aparece en el panel de la consola administrativa. Consulte la documentación de la base de datos para tener más información sobre estas propiedades obligatorias y opcionales.

      [z/OS]También puede obtener información sobre las propiedades de origen de datos en la publicación Application Programming Guide and Reference for Java para la versión de DB2 para z/OS, si utiliza el proveedor del controlador JDBC de DB2 Universal o DB2 con controlador JCC de IBM® para el proveedor de JDBC.

  4. Pulse Nuevo. Esta acción hace que el asistente Crear un origen de datos se inicie y visualice el panel Entre información básica de origen de datos. El primer paso es el campo de ámbito, que es de sólo lectura. Este campo muestra la selección de ámbito anterior.
  5. Escriba un nombre de origen de datos en el campo Nombre de origen de datos. Este nombre identifica el origen de datos sólo a efectos administrativos.
  6. Escriba un nombre JNDI (Java Naming and Directory Interface) en el campo Nombre JNDI. El servidor de aplicaciones utiliza el nombre JNDI para enlazar referencias a una aplicación a este origen de datos. Sigas estos requisitos cuando especifique nombres JNDI:
    • No asigne nombres JNDI duplicados entre diferentes tipos de recursos, como orígenes de datos versus fábricas de conexiones J2C o fábricas de conexiones JMS).
    • No asigne nombres JNDI duplicados para varios recursos del mismo tipo en el mismo ámbito.
    Para obtener más información sobre JNDI, consulte el tema sobre denominación.
  7. Pulse Siguiente para ver el panel Seleccionar un proveedor de JDBC. El panel Seleccionar un proveedor de JDBC se ignora si no se dispone de proveedores de JDBC que estén configurados en el ámbito actual.
  8. Seleccione un proveedor de JDBC existente o cree un proveedor nuevo.
    • Seleccione un proveedor de JDBC existente.
      1. Pulse Seleccionar un proveedor de JDBC existente.
      2. Seleccione un controlador JDBC en la lista.
      3. Pulse Siguiente. Ahora verá el panel Entre las propiedades específicas de la base de datos para el origen de datos.
    • Cree un proveedor de JDBC nuevo.
      1. Pulse Crear un nuevo proveedor de JDBC.
      2. Pulse Siguiente para ver el panel Crear un nuevo proveedor de JDBC.
      3. Utilice la primera lista desplegable para seleccionar el tipo de base de datos del proveedor de JDBC que necesita crear.
        La opción definida por el usuario: Seleccione Definido por el usuario para el tipo de base de datos en los siguientes casos:
        • No ve su tipo de base de datos.
        • No puede seleccionar el tipo de proveedor JDBC que necesita en el paso siguiente.
        Si se selecciona definido por el usuario se visualizará el panel del asistente que mostrará el tipo de proveedor como Proveedor de JDBC definido por el usuario y el tipo de implementación como Definido por el usuario. Consulte la documentación de la base de datos para ver los archivos de clase de controlador JDBC, las propiedades del origen de datos, etc. que se necesitan para el proveedor definido por el usuario. Debe proporcionar esta información en los siguientes dos paneles del asistente:
        • La información de la variable classpath de la base de datos
        • Las propiedades específicas de la base de datos
      4. Si el tipo de proveedor de JDBC se muestra en la segunda lista, seleccione el tipo de proveedor de JDBC. Seleccione Mostrar en desuso para que se muestren tanto los proveedores actuales como los en desuso. Si no puede encontrar el proveedor en esta lista ampliada, a continuación, seleccione Definido por el usuario en la lista anterior de tipos de bases de datos.
      5. En la tercera lista, seleccione el tipo de implementación que es necesaria para la aplicación. Si la aplicación no necesita que las conexiones den soporte a transacciones de confirmación de dos fases, seleccione Origen de datos de la agrupación de conexiones. No obstante, seleccione Origen de datos XA si la aplicación necesita conexiones que den soporte a transacciones de confirmación de dos fases. Las aplicaciones que utilizan esta configuración de origen de datos tienen la ventaja de la recuperación de transacciones gestionada por contenedor.

        Después de seleccionar un tipo de implementación, el asistente rellena los campos de nombre y descripción del proveedor de JDBC. Puede entrar distintos valores para estos campos; sólo sirven a efectos administrativos.

      6. Pulse Siguiente después de definir el tipo de base de datos, el tipo de proveedor y el tipo de implementación. Aparecerá el panel del asistente Entrar información de classpath de base de datos.
      7. En el campo Classpath, escriba la ubicación de vía de acceso completa de los archivos de clase de controlador JDBC de base de datos. La información de classpath pasa a ser el valor de la variable de entorno de WebSphere que se visualiza en esta página, en el formato ${DATABASE_JDBC_DRIVER_PATH}. El servidor de aplicaciones utiliza la variable para definir el proveedor de JDBC; gracias a ello, no es necesario especificar classpaths de JDBC estáticas para aplicaciones individuales. Recuerde que si no proporciona la variable classpath de controlador JDBC correcta y completa para la variable, el origen de datos en última instancia fallará. Si el campo ya muestra una classpath totalmente calificada, puede aceptar la definición de la variable completado el resto de este panel del asistente y pulsando Siguiente.
      8. Utilice el campo Vía de acceso de biblioteca nativa para especificar archivos de clase adicionales que el controlador de JDBC puede necesitar para funcionar correctamente en la plataforma del servidor de aplicaciones. Escriba el nombre de la vía de acceso de directorio completa de estos archivos de clase.
      9. Pulse Siguiente. Ahora verá el panel Entre las propiedades específicas de la base de datos para el origen de datos.
  9. Rellene todos los campos del panel Entrar las propiedades especificas de la base de datos para el origen de datos.
    • Pulse Utilice este origen de datos en la persistencia gestionada por contenedor (CMP) si los enterprise beans CMP (Container Managed Persistence) deben acceder a este origen de datos.
    • Cualquier otro campo de propiedades que se muestre en este panel del asistente es específico del tipo de base de datos. Consulte el tema sobre valores obligatorios mínimos de origen de datos, por proveedor, para obtener información sobre estos valores de propiedades. En el artículo se describen los proveedores de JDBC actuales y en desuso definidos previamente en el servidor de aplicaciones.
      Orígenes de datos definidos por el usuario: Este panel de asistente no muestra los campos de propiedad adicional para los orígenes de datos que se corresponden con los proveedores de JDBC definidos por el usuario. No obstante, en los archivos de clase del controlador JDBC que ha instalado, el servidor de aplicaciones puede extraer generalmente los nombres de propiedades de orígenes de datos necesarios. El servidor de aplicaciones los define como propiedades personalizadas del origen de datos y los muestra una página de la consola de propiedades personalizadas y les asigna valores predeterminados. Consulte la documentación de la base de datos relacionada con estas propiedades y cualquier otro requisito del origen de datos definido por el usuario. Después de crear el origen de datos, vaya hasta el panel correspondiente de colección de propiedades personalizadas en la consola administrativa pulsando Orígenes de datos > origen_datos > Propiedades personalizadas. Revise los valores predeterminados de las propiedades y modifíquelos si es necesario.

      El servidor de aplicaciones sólo puede extraer propiedades específicas del proveedor de los archivos de clases del controlador si instala los archivos en el nodo del gestor de despliegue y configura sus variables de WebSphere representativas correctamente. De lo contrario, el producto muestra un mensaje informativo (y no un mensaje de error) que le indica que defina manualmente las propiedades necesarias como propiedades personalizadas.

  10. Opcional: Configure los alias de seguridad para el origen de datos. Puede no elegir ninguno de los método de autenticación o elegir uno de los tipos siguientes:
    • Alias de autenticación gestionada por componentes: especifica un alias de autenticación que se debe utilizar cuando un valor res-auth de referencia de recursos de componente es Application. Para definir un nuevo alias, vaya a Elementos relacionados > Entradas de datos de autenticación J2C (J2EE Connector Architecture). Un alias gestionado por componentes representa una combinación de ID y contraseña que se especifica en una aplicación para la autenticación de origen de datos. Por lo tanto, el alias que se establece en el origen de datos debe ser idéntico al alias del código de aplicación.
      1. Utilice la lista desplegable para seleccionar un alias de autenticación gestionada por componente existente.
      2. Para crear un nuevo alias, pulse los enlaces que se proporcionan. Esta acción cierra el asistente de origen de datos y activa la consola administrativa para visualizar el panel de datos de autenticación J2C. Pulse Nuevo para definir un nuevo alias. Pulse Aceptar para guardar los valores y ver el nuevo alias en la el panel de datos de autenticación J2C. Reinicie el asistente de origen de datos regresando al panel de colección de orígenes de datos, seleccionando el ámbito adecuado y pulsando Nuevo.
      Para obtener más información sobre la seguridad de J2C (Java 2 Connector), consulte el tema sobre la gestión de entradas de datos de autenticación Java 2 Connector Architecture.
    • Alias de correlación-configuración: se utiliza sólo en ausencia de una configuración de inicio de sesión en la referencia de recursos de componente. La especificación de una configuración de inicio de sesión y de las propiedades asociadas de la referencia del recurso de componentes es el método preferido para definir la estrategia de autenticación cuando el valor de res-auth es Container. Si especifica la configuración de inicio de sesión DefaultPrincipalMapping, la propiedad asociadas es un alias de entrada de datos de autenticación JAAS - J2C.
    • Alias de autenticación gestionada por contenedor: se utiliza sólo en ausencia de una configuración de inicio de sesión en la referencia de recursos de componente. La especificación de una configuración de inicio de sesión y de las propiedades asociadas de la referencia del recurso de componentes determina la estrategia de autenticación gestionada por contenedor cuando el valor de res-auth se establece en Container.
    Nota: Si ha definido dominios de seguridad en el servidor de aplicaciones, puede pulsar Examinar... para seleccionar un alias de autenticación para el recurso que vaya a configurar. Los dominios de seguridad dan soporte al aislamiento de los alias de autenticación entre servidores. La vista de árbol es útil para determinar el dominio de seguridad al que pertenece un alias y la vista de árbol puede ayudar a determinar los servidores que pueden acceder a cada alias de autenticación. La vista de árbol se adapta a cada recurso, por lo que los dominios y los alias quedan ocultos cuando se pueden utilizar.
  11. Pulse Siguiente para ver el panel Resumen y revisar la información del origen de datos. Si algún dato de la información no es correcto, puede pulsar Anterior para volver y corregirlo.
  12. Pulse Finalizar para guardar la configuración y salir del asistente. Ahora verá el panel Orígenes de datos, que muestra la nueva configuración en una tabla junto con otros orígenes de datos configurados para el mismo ámbito.

Qué hacer a continuación

  • Puede alterar temporalmente los valores predeterminados de algunas propiedades de origen de datos.
  • Puede configurar propiedades adicionales que el proveedor de la base de datos podría necesitar u ofrecer como opciones. Consulte la documentación de la base de datos sobre estos valores.
  • [z/OS]Si utiliza el proveedor del controlador JDBC de DB2 Universal, o DB2 con controlador JCC de IBM,obtenga más información sobre las propiedades del origen de datos en Application Programming Guide and Reference for Java para la versión de DB2 para z/OS.
  • Puede añadir la propiedad personalizada commitOrRollbackOnCleanup a los valores de un origen de datos JDBC, si desea que se realice una acción específica con cualquier trabajo no comprometido, si el origen de datos JDBC se cierra inesperadamente. Los valores que se pueden especificar para esta propiedad son commit o rollback.

    Si el origen de datos JDBC soporta la detección de unidad de trabajo (UOW), esta propiedad sólo se aplica cuando se está trabajando en una unidad de trabajo diferenciada. Si el origen de datos JDBC no soporta la detección UOW, esta propiedad siempre se aplica.

    Si no añade esta propiedad a los valores de origen de datos JDBC, se retrotraen las transacciones implícitas detectadas y la aplicación debe tratar con las transacciones implícitas no detectadas.

    Para añadir esta propiedad personalizada a los valores de configuración de origen de datos JDBC:
    1. En la consola administrativa, pulse Proveedores JDBC > Proveedor_JDBC > Orígenes de datos > origen_datos > Propiedades personalizadas > Nuevo.
    2. Especifique commitOrRollbackOnCleanup en el campo Nombre, y commit o rollback en el campo Valor.
    3. Guarde los cambios.

Los artículos siguientes de este Information Center le describen cómo utilizar la consola de administración para asignar los valores de propiedad:


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_ccrtpds
File name: tdat_ccrtpds.html