Page History

...

Configurando pools de bases de datos

Regresar a la sección superior

Crear una base de datos

Regresar a la sección superior

...

Para configurar pools de bases de datos, el portlet Database Pools (Pools de Bases de Datos) esta disponible al elegir Database Pools en el menú de la Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. El portlet Database Pools ilustrado en la figura siguiente, muestra todo pool de base de datos disponible y proporciona ayudantes para importar ó crear nuevos pools.

Image Added

Crear nuevos pools de base de datos

Puedes crear nuevos pools mediante clic en la liga Using the Geronimo database pool wizard (Usando al ayudante Geronimo de pool de base de datos) dentro del portlet Database Pools. Este ayudante te guiará a durante el procedimiento de 4 pasos sencillos.

Primero necesitas especificar el nombre del pool de base de datos, así como su tipo de base de datos.

Image Added

Posteriormente seleccionas los controladores JDBC, los cuales por defecto son pre-llenados, basándose en el tipo de base de datos que seleccionaste en el paso previo. También debes seleccionar al JAR del controlador desde el menú de selección y después especificar el nombre de la base de datos. Para este ejemplo, una base de datos test (prueba) fue creada previamente; se trata del proceso de creación con un solo paso, el cual es explicado en #Crear una base de datos.

Image Added

El siguiente paso te permite configurar algunos parámetros de conexión, como el tamaño del pool (mínimo y máximo) y tolerancias de tiempo. Al estar satisfecho con los parámetros, haz clic en Test Connection _(Probar Conexión)_.

Image Added

Al haber probado satisfactoriamente la conexión, haz clic en Deploy Tool _(Herramienta de Activación)_. Como alternativa, puedes hacer clic en Show Deployment Plan _(Muestra Plan de Activación)_ para este pool de base de datos y también te permite editarle. Instrucciones adicionales en el como activar manualmente un plan de BD, puede encontrarse en la sección Configurando al Datasource DB2.

Image Added

Al haber sido activado, Derby_Test (Prueba_Derby) debería ser listado junto con el resto de pools de bases de datos.

Regresar a la sección superior

Importar pools de bases de datos de JBoss 4

Este ayudante te asistirá en la importación de pools de bases de datos JBoss 4 existentes. Para este ejemplo particular, usaremos al hsqldb-ds.xml proporcionado por el servidor JBoss default, esto es <jboss_home>\server*default*\deploy\hsqldb-ds.xml junto con la base de datos Hypersonic.

Antes de continuar, deberás proporcionar a Geronimo al jar controlador para Hypersonic HSQL. Para hacerlo, deberás seguir pasos similares a los descritos en Configurando al Datasource DB2. A continuación se presenta un resumen de pasos para la declaración del jar controlador HSQL en Geronimo.

1. Crea un registro en el repositorio Geronimo para identificar a los controladores para Hipersonic. Para este ejemplo, creamos <geronimo_home>\repository\ org.hsqldb.Server\jars. Nota que creamos dos directorios.
2. Localiza al controlador jar HSQL hsqldb.jar. Este archivo se encuentra en el directorio <jboss_home>\server\default\lib. Haz una copia de dicho archivo y cambia su nombre a hsqldb-1.8.0.jar.
3. Copia al archivo renombrado hacia el registro del repositorio que creaste previamente, <geronimo_home>\repository\org.hsqldb.Server\jars. El omitir el cambio de nombre del archivo antes de copiarlo al repositorio, causará que Geronimo lance una excepción, ya que no puede leer al formato del nombre del archivo. El nombre del archivo del controlador debe ser versionado.

Regresa a la Consola de Administración Geronimo y haz clic en la liga Database Pools (Pools de Bases de Datos). Desde el portlet Database Pools haz clic en Import from JBoss 4 (Importar de JBoss 4). En el Step 1 (Paso 1) de Import Database Pools (Importar Pools de Bases de Datos) especifica la ubicación del archivo -ds.xml y haz clic en Next (Siguiente).

Image Added

Al finalizar la carga del datasource JBoss, Setp 2 (Paso 2) lista los pools de bases de datos que pudo reconocer el ayudante, gracias al archivo hsqldb-ds.xml. Haz clic en Confirm and Deploy (Confirmar y Activar).

Image Added

El siguiente paso te permite editar al pool de base de datos que fue reconocido. En este paso deberás especificar al jar controlador que declaraste cuando actualizaste al repositorio de Geronimo. Observa como se lista Driver JAR: (JAR Controlador en la siguiente figura.

Image Added

Haz clic en Test Connection _(Probar Conexión)_ para verificar que proporcionaste todos los datos necesarios y que Geronimo pueda establecer una conexión.

Image Added

Haz clic en Deploy (Activar), lo cual te llevará a la misma página de Step 2. Si deberías tener más pools definidos en el archivo, podrías repetir los pasos para importar los pools de bases de datos que elijas. Como en este ejemplo solo tenemos uno, tendrías que hacer clic en Finish (Finalizar) para completar el uso del ayudante de importación.

Image Added

Ahora deberías ver al pool de bases de datos importado, DefaultDS.

Image Added

Regresar a la sección superior

Importar pools de bases de datos de WebLogic 8.1

Este ayudante te ofrece dos alternativas para la importación de pools de bases de datos BEA Weblogic existentes. La primera es proporcionando un archivo de configuración (por ej. config.xml); si seleccionas esta opción, el ayudante convertirá a tantos campos que pueda, y te solicitará el ingresar manualmente aquellos que no pudo convertir. Por ejemplo, uno de los valores que deberás proporcionar, es la contraseña de la base de datos.

La segunda alternativa es factible si tienes tanto al servidor Apache Geronimo como al servidor BEA Weblogic instalados en la misma máquina; en esta alternativa puedes especificar directamente al path de instalación de Weblogic así como los directorios del dominio. Esta alternativa tiene la ventaja de ser capaz de leer directamente las contraseñas de bases de datos.

Independientemente de la altermativa que eligieses, necesitarás decir a Geronimo donde se encuentran los jars controladores de las bases de datos. A continuación se presenta el resumen de pasos para la declaración del jar controlador PointBase en Geronimo.

1. Crea un registro en el repositorio Geronimo para identificar los controladores para PointBase. Para este ejemplo hemos creado <geronimo_home>\repository\ com.pointbase\jars. Nota que creamos dos directorios.
2. Localiza al jar controlador de cliente PointBase, pbclient44.jar. El archivo se localiza en el directorio <bea_home>weblogic81\common\eval\pointbase\lib. Haz una copia de dicho archivo y cambia su nombre a pbclient-4.4.0.jar.
3. Copia al archivo renombrado en al registro del repositorio que creaste previamente, <geronimo_home>\repository\com.pointbase\jars. El omitir el cambio de nombre del archivo antes de copiarlo al repositorio, causará que Geronimo lance una excepción, ya que no puede leer al formato del nombre del archivo. El nombre del archivo del controlador debe ser versionado.

Regresa a la Consola de Administración Geronimo y haz clic en la liga Database Pools (Pools de Bases de Datos). Desde el portlet Database Pools haz clic en Import from WebLogic 8.1 (Importar de WebLogic 8.1). La siguiente figura ilustra al ayudante de importación.

Image Added

Para este ejemplo particular nos enfocaremos en la segunda alternativa. Un dominio example (ejemplo) por defecto fue creado en el servidor WebLogic con toda aplicación ejemplo también incluida por defecto. Este dominio se licaliza en el directorio <bea_home>\user_projects\domains\examples.

En la primer pantalla del ayudante de importación (ilustrado en la figura previa) proporciona al Domain directory path: (Path del directorio del cominio y haz clic en Next (Siguiente).

Domain directory path: <bea_home>\user_projects\domains\examples

weblogic81/server/lib path: <bea_home>\weblogic81\server\lib

El Step 2 (Paso 2) ilustrado en la siguiente figura, te muestra una lista de pools de bases de datos reconocidos del dominio WebLogic que especificaste y que pueden ser importados a Apache Geronimo.

Image Added

Nota que el dominio WebLogic del cual estas intentando importar al pool de bases de datos, debe estar activo si deseas probar exitosamente la conexión. Para este ejemplo haz clic en la segunda Confirm and Deploy (Confirma y Activa) de la lista, la cual corresponde a examples-dataSource-demoPool.

En el siguiente paso selecciona al Driver JAR: (JAR Controlador que creaste recientemente en el repositorio Geronimo.

Image Added

Nota que la contraseña de la base de datos ha sido reconocida. Haz clic en Test Connection _(Probar Conexión)_, con lo cual deberías ver una confirmación similar a la siguiente figura. Haz clic en Deploy (Activar).

Image Added

La siguiente página regresa al Step 2, en esta ocasión también desplegará los pools de bases de datos restantes y disponibles para su importación, y también mostrará el estado de importación del pool de base de datos recién importado. En este momento puedes hacer clic en Skip Remaining Pools (Omitir Pools Restantes) para dejar al ayudante de importación.

Image Added

Ahora deberías observar listado en el portlet de pool de base de datos, al pool de base de datos que acabas de importar.

Image Added

Eliminando pools de bases de datos

Para eliminar los pools de bases de datos, puedes usar la Herramienta de activación. Entre otras cosas, dicha herramienta te permite listar a los módulos disponibles, donde la pool que acabas de activar será listada como un módulo.

Para listar a todo módulo disponible, teclea el comando siguiente:

E:\geronimo\bin>deploy --user system --password manager list-modules | grep user/database

  + user/database-pool-Derby_Test/1/car

Una vez que tienes identificado el pool de base de datos (en este ejemplo user/database-pool-Derby_Test/1/car) podrías eliminarle mediante el tecleo del siguiente comando:

E:\geronimo\bin>deploy --user system --password manager undeploy user/database-pool-Derby_Test/1/car

    Module user/database-pool-DerbyTest/1/car unloaded.

    Module user/database-pool-DerbyTest/1/car uninstalled.

    Undeployed user/database-pool-DerbyTest/1/car

Como paso adicional para verificar la baja del pool de base de datos, puedes ejecutar al siguiente comando; no deberían listarse registros.

deploy --user system --password manager list-modules | grep Derby_Test

Regresar a la sección superior

Crear una base de datos

Para crear una nueva base de datos e integrarla a Geronimo, el portlet DB Manager (Administrador de BD) está disponible. Cerca de la porción inferior del menú de Console Navigation _(Navegación de Consola), navega en Misc -> Embedded DB -> DB Manager. Ese portlet invoca a los portlets DB Viewer _(Visor de BD) y Run SQL (Ejecuta SQL), ilustrados en las siguientes figuras.

Image Added
Image Added

El portlet DB Viewer despliega toda base de datos disponible, sus tablas (de aplicación y sistema) y despliega el contenido de las tablas.

El portlet Run SQL te permite ejecutar comandos SQL para crear o eliminar bases de datos, y también para modificar el contenido de sus tablas. Este portlet te proporciona menúes de selección para elegir la base de datos sobre la cual desees ejecutar al comando.

Para crear una base de datos de pruebas, especifica test (prueba) en el campo Create DB: (Crear BD y haz clic en Create (Crear). Después de pocos segundos, deberías ver un mensaje de confirmación cerca de la porción inferior del portlet Run SQL, indicando Database created: test (Base de datos creada: prueba). Ahora se debería ver el registro de la base de datos test en el portlet DB Viewer.

Si deseas ejecutar cualquier comando SQL en esa base de datos, asegúrate de elegir test del menú de selección Use DB: (Usa BD, para después ingresar el comando SQL y finalmente hacer clic al botón Run SQL. Los resultados del comando se deplegarán cerca de la porción inferior del portlet.

Regresar a la sección superior

Configurando JMS

Para configurar JMS, los portlets JMS Connection Factories _(Fábricas de Conexión JMS)_ y JMS Destination Manager (Administrador de Destino JMS) son elegibles mediante JMS en el menú de Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. El portlet JMS Connection Factories, ilustrado en la figura siguiente, despliega a todo conector JMS configurado en el servidor Geronimo y te permite agregar una nueva Fábrica de Conexión JMS.

Image Added

El portlet JMS Destination Manager presenta la lista de toda cola (queue) y tópico configuradas(os) en el servidor Geronimo.

Image Added

En Apache Geronimo v1.0 estos portlets no estan totalmente implementados y necesitarás crear planes de activación (deployment plans) y herramientas de línea de comandos para activar a estas configuraciones. Detalles adicionales para la configuración JMS y su integración se encuentran cubiertos en la sección Integrando un Proveedor JMS de terceros.

Regresar a la sección superior

...