How To Configurar Base de Datos para O3 Query

Cómo configurar JBoss para conectar O3Query a Diferentes Bases de Datos

Base de datos predefinidas

No es necesario configurar el módulo

PostgreSQL
MS-SQL
h2
Derby
DerbyClient
hsqldb

Bases de datos testeadas

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

PostgreSQL (solo es necesario ejecutar el procedimiento de cambio de base)
MS-SQL - ver apartado
MySQL - ver apartado
ORACLE - ver apartado

Para el caso de MS-SQL en versión anterior a 6.2

Ir al directorio <o3>/jboss/standalone/deployments/o3-server.ear/lib
Si no esta abierto el jar o3-o3ee-xxxx.jar convertirlo a o3-o3ee-xxxx.zip desempacarlo, borrar o mover el o3-o3ee.xxxx.jar y renombra la carpeta como o3-o3ee-xxxx.jar xxxx = número de versión del jar.
Ir al directorio <o3>/jboss/standalone/deployments/o3-server.ear/lib/o3-o3ee-xxxx.jar/META-INF/
Renombrar el archivo orm-sqlserver.xml como orm.xml
Realizar el procedimiento de cambio de base de datos arriba enumerado.

Para el caso de MySQL

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

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

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

Crear un archivo de nombre module.xml en <o3>/jboss/modules/com/mysql/main con el siguiente contenido:

<?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.22-bin.jar"/>
 </resources>
 <dependencies>
 <module name="javax.api"/>
 </dependencies>
</module>

Crear directorios /mysql/main en <o3>/jboss/modules/com/
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.22-bin.jar"/>

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

<driver name="mysql" module="com.mysql">
    <xa-datasource-class>
        com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
    </xa-datasource-class>
</driver>

Para el caso de DB2

Por temas de licenciamiento no se suministra el driver, por lo cual el usuario deberá ser suminstrado por el administrador de base de datos, el cual dispondra de de los archivos necesarios(generalmente un .jar con el driver y otro .jar conteniendo la licencia).

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 descrito hacer los siguiente paso:

Copiar los drivers de db2 en <o3>/classes/jdbc/(db2jcc.jar y db2jcc_license_cu.jar) Estos drivers son a modo de ejemplo, los drivers deben ser proporcionados por el adm. de base de datos de la empresa.

Crear un archivo de nombre module.xml en <o3>/jboss/modules/com/ibm/db2/main con el siguiente contenido(crear directorios: ibm/db2/main):

module.xml

<?xml version="1.0" encoding="UTF-8"?>
  <module xmlns="urn:jboss:module:1.1" name="com.ibm.db2">
      <resources>
        <resource-root path="db2jcc.jar"/>
        <resource-root path="db2jcc_license_cu.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
        <module name="sun.jdk"/>
    </dependencies>
  </module>

En el directorio <o3>/jboss/modules/com/ibm/db2/main/ creado anteriormente
Agregar los drivers de db2 (.jar) en <o3>/jboss/modules/com/ibm/db2/main con el nombre igual al declarado en
<resource-root path="db2jcc.jar"/> y <resource-root path="db2jcc_license_cu.jar"/>
Copiar los archivos db2jcc.jar.index y db2jcc_license.jar.index a la carpeta anteriormente mencionada
Editar el archivo <o3>/jboss/standalone/configuration/o3bi.xml, buscar la sección <drivers> y agregarle:
o3bi.xml
```
<driver name="db2" module="com.ibm.db2">
	<driver-class>com.ibm.db2.jcc.DB2Driver</driver-class>
</driver>
```

Para el caso de Oracle

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

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 descrito hacer los siguiente paso:

Copiar el driver de oracle en <o3>/classes/jdbc/

Crear un archivo de nombre module.xml en <o3>/jboss/modules/com/oracle/ojdbc6/main con el siguiente contenido:

<?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.oracle.ojdbc6">
  <resources>
    <resource-root path="ojdbc6.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
  </dependencies>
</module>

Crear directorios /oracle/ojdbc6/main en <o3>/jboss/modules/com/
Agregar el driver de oracle (.jar) en <o3>/jboss/modules/com/oracle/ojdbc6/main con el nombre igual al declarado en
<resource-root path="ojdbc6.jar"/>

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

<driver name="oracle" module="com.oracle.ojdbc6">
  <xa-datasource-class>
    oracle.jdbc.OracleDriver
  </xa-datasource-class>
</driver>