Versions Compared

Old Version 1

changes.mady.by.user sgarrido (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Diego Cabrera

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Excerpt

...

Ayudas y explicaciones de cómo realizar instalaciones de O3 con base de datos.

title

Cómo configurar JBoss para persistir O3 sobre Diferentes Bases de Datos

Panel
O3enBD: Hints y casos de interésO3enBD: Hints y casos de interés
Child pages (Children Display)
sort

Entorno

Es recomendable para ambientes en producción sustituir la base Derby que trae O3 por defecto por algún manejador de base de datos.

Bases de datos Testeadas

Hemos testeado el funcionamiento correcto de O3 con las siguiente bases de datos:

  • PostgreSQL
  • MySQL - ver apartado
  • MS-SQL
  • ORACLE
Note

Nota: Es posible funcionar con otras bases de datos, O3 provee creación de tablas para las Bases arriba mencionadas

Como cambiar a Base de Datos

Para las bases testeadas desde la aplicación admserver(.exe/.bat/.sh) es posible usar un wizard que se encarga de este proceso.

Proceso:

  1. Bajar o asegurarse que el JBoss este bajo.
  2. Abrir el admserver
  3. Ir a Herramientas -> Wizard de Configuración y Migración
  4. Elegir opción: Usar una base de datos distinta a la incluida con O3
  5. Elegir en Motor la base correspondiente
  6. Completar datos acorde y usar el botón de probar conexión.
  7. Si el testeo de conexión es exitoso, apretar el botón siguiente.
  8. Saltear el paso 2 a menos que se este además migrando de version.
  9. Apretar el botón siguiente e ir al pasa 3.
  10. En el paso 3 elegir Habilitar el uso de la base de datos.
  11. Levantar el JBoss desde el JBoss.bat o jboss.sh y ver que levanta sin exepciones.

Para el caso de MySQL

Por temas de licenciamiento no se suministra el driver, por lo cual el usario deberá bajarlo de internet

Los drivers de mysql hasta la versión 5.1.23 inclusive no se pueden poner en el deploy para que JBoss se encargue de configurarse automáticamente por lo cual hay que realizar un procedimiento manual.

Warning

Atención: es conveniente tener la última versión del driver ya que este contiene códigos para funcionar con JBoss 7

 

Antes de realizar el procedimiento anteriormente descripto hacer los siguiente paso:

  1. Copiar el driver de mysql en <o3>/classes/jdbc/

  2. Crear el module dentro del jboss en <o3>/jboss/modules/com/mysql
    Se adjunta el module.xml y el archivo ".index" para la versión "5.1.23" (debido a un error en la generación automática de este por el jboss).
    Aquí se demuestra como debe quedar la estructura de este módulo:

    1. "module.xml" en <o3>/jboss/modules/com/mysql/main con el siguiente contenido:

      Code Block
      <?xml version="1.0" encoding="UTF-8"?>
 
<!--
 ~ JBoss, Home of Professional Open Source.
 ~ Copyright 2010, Red Hat, Inc., and individual contributors
 ~ as indicated by the @author tags. See the copyright.txt file in the
 ~ distribution for a full listing of individual contributors.
 ~
 ~ This is free software; you can redistribute it and/or modify it
 ~ under the terms of the GNU Lesser General Public License as
 ~ published by the Free Software Foundation; either version 2.1 of
 ~ the License, or (at your option) any later version.
 ~
 ~ This software is distributed in the hope that it will be useful,
 ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
 ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 ~ Lesser General Public License for more details.
 ~
 ~ You should have received a copy of the GNU Lesser General Public
 ~ License along with this software; if not, write to the Free
 ~ Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 ~ 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 -->
 
<module xmlns="urn:jboss:module:1.0" name="com.mysql">
 <resources>
 <resource-root path="mysql-connector-java-5.1.23-bin.jar"/>
 </resources>
 <dependencies>
 <module name="javax.api"/>
 </dependencies>
</module>
    2. Agregar el driver de mysql (.jar) en <o3>/jboss/modules/com/mysql/main con el nombre igual al declarado en

      <resource-root path="mysql-connector-java-5.1.23-bin.jar"/>

    La estructura final tiene que quedar así:
    <o3>/jboss/modules/com/mysql/main
         - module.xml
         - mysql-connector-java-5.1.23-bin.jar
         - mysql-connector-java-5.1.23-bin.jar.index

  3. Editar el archivo <o3>/jboss/standalone/configuration/o3bi.xml, buscar la sección <drivers> y agregarle

    Code Block
    <driver name="mysql" module="com.mysql">
    <xa-datasource-class>
        com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
    </xa-datasource-class>
</driver>
  4. Realizar el procedimiento de cambio de base de datos arriba enumerado