...
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.
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.
Info |
---|
Consulta Configurando al Datasource DB2 para un ejemplo funcional adicional en datasources con archivos jar (controlador+licencia) múltiples. |
Primero necesitas especificar el nombre del pool de base de datos, asà como su tipo de base de datos.
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.
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)_.
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.
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.
- 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.
- 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 ahsqldb-1.8.0.jar
. - 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).
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).
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.
Haz clic en Test Connection _(Probar Conexión)_ para verificar que proporcionaste todos los datos necesarios y que Geronimo pueda establecer una conexión.
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.
Ahora deberÃas ver al pool de bases de datos importado, DefaultDS.
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.
- 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.
- 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 apbclient-4.4.0.jar
. - 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.
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.
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.
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).
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.
Ahora deberÃas observar listado en el portlet de pool de base de datos, al pool de base de datos que acabas de importar.
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:
No Format bgColor #000000 borderStyle solid
E:\geronimo\bin>deploy --user system --password manager list-modules | grep user/database
+ user/database-pool-Derby_Test/1/car
Note |
---|
Para este comando ejemplo, |
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:
No Format bgColor #000000 borderStyle solid
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.
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.
El portlet JMS Destination Manager presenta la lista de toda cola (queue) y tópico configuradas(os) en el servidor Geronimo.
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
...