Page Comparison

...

Paso 1: Configuración de la Base de Datos
Paso 2: Migración de los datos de la versión anterior
Paso 3: Habilitación Habilitación de la configuración de Datamarts en Base de Datos de Datamarts

Consideraciones previas a la migración

La migración asume el correcto funcionamiento de la instalación anterior
Revisar si hay espacio suficiente en el disco para la nueva instalación, así como para los datamarts que ella contendrá una vez migrados

Comienzo de la migración

La migración requiere la ejecución de los siguientes pasos previos:

Bajar el Servidor (jboss) y todos los módulos de O3 que estén en ejecución.
Es importante que no se vuelva a levantar niguno de los 2 jboss hasta que se indique
Renombrar la carpeta de instalación (ej: renombrar ...\O3 a ...\O3_old) y luego instalar en el mismo lugar (ej: es decir en <ruta a O3>\O3 )
Instalar las licencias y activarlas (ver Guía de instalación de Licencias)
Iniciar el O3 Server Administrator de la versión recién instalada.
Desde el menú Herramientas seleccionar la opción Wizard de Configuración y Migración...
Esta operación desplegará el Wizard para ejecutar los 3 pasos mencionados anteriormente

Paso 1. Configuración de la Base de Datos

Este paso permite configurar la base de datos del O3 Server.
En esta base de datos se almacenan los usuarios, los roles y los esquemas de seguridad, así como la referencia a los datamarts publicados en el servidor.

...

En el manejador de base de datos de nuestra preferencia crear una base de datos vacía y un usuario con permisos suficientes para crear tablas en ella.
Seleccionar la opción de Usar una base de datos distinta a la incluida en O3

Ingresar los datos específicos para la base de datos escogida.

Parámetro	Descripción
Motor	Identificador del Motor de Base de datos a utilizar. Debe seleccionarse un manejador de la lista desplegable. La selección de este campo carga el resto con valores por defecto que deberán modificarse
Manejador	Nombre del Driver JDBC que se utiliza para conectarse a la base de datos.
URL	URL de conexión a la base de datos. Típicamente identifica la IP o nombre del servidor, puerto y parámetros adicionales. Cada driver JDBC tendrá una URL propia que podrá consultarse en la documentación del driver
Usuario	Usuario de la base de datos con el que se conectará el Servidor de O3
Contraseña	Contraseña del usuario indicado en el campo anterior

Note

title	Atención

Como paso previo se debe de instalar el driver JDBC adecuado en la carpeta <o3>/classes/jdbc/ y en <o3>/jboss/server/default/lib para poder acceder a la base de datos.

Image Modified

Verificar la conexión con el botón Testear Conexión
Presionar el botón Siguiente
Confirmar el diálogo que pregunta si se deben crear las tablas necesarias

Paso 2. Migración de los datos de la versión anterior

Este paso permite indicar dónde se encuentra instalada la versión anterior (4.3) de O3 de la que se tomará la configuración, así como los datamarts que contenga.

Seleccionar la opción Migración desde versión 4.x.
Indicar la ruta a la instalación anterior de O3.
Esta ruta deberá apuntar a la carpeta de instalación.

Una vez indicada la ruta se despliega información acerca de la instalación, típicamente datos sobre la base de datos que la versión anterior utilizaba.

Note

title	Atención

Si no se despliega información acerca de la instalación anterior es posible que se haya ingresado una ruta incorrecta que no apunte a la raiz de instalación o que se trate de una versión incorrecta de O3 de la cual no se pueda migrar.

Image Modified

Verificar que se encuentran activos los checkbox que permiten copiar los recursos de la instalación anterior y la configuración de usuarios y roles
Presionar el botón Siguiente para que se realice la migración de los datos

Paso 3. Habilitación de la Configuración de Datamarts en Base de Datos

...

Este paso permite habilitar o no el uso de la base de datos como repositorio para la configuración de los datamarts publicados en el Servidor de O3.
...
Seleccionar la opción de Habilitar o no el uso de la base de datos
Image Modified
Opcionalmente se puede realizar sólo la migración de cubos habilitados, dejando aquellos deshabilitados sin copiar a la nueva versión
Presionar el botón Finalizar para confirmar la selección y finalizar la migración

Otras consideraciones

Las siguientes consideraciones podrán aplicarse o no dependiendo de cada instalación.

...

Revisar en la instalación anterior si hay cambio de puertos.
Para ello se debe verificar el archivo /jboss/server/default/conf/jboss-service.xml

Si dijera otro valor diferente a ports-default significa que los puertos han sido modificados.

Code Block

	xml
	xml

<mbean code="org.jboss.services.binding.ServiceBindingManager"
           name="jboss.system:service=ServiceBindingManager">
           <attribute name="ServerName">ports-default</attribute>
           <attribute name="StoreURL">${jboss.server.home.url}/port-bindings.xml</attribute>
           <attribute name="StoreFactoryClassName">org.jboss.services.binding.XMLServicesStoreFactory</attribute>
</mbean>

En tal caso deberá replicarse el mismo cambio en la nueva versión.
Revisar la guía de modificación de puertos de JBoss para obtener más detalles sobre este punto.
Revisar si se cambió el puerto del tomcat en la instalación vieja.
Revisar el archivo jboss/server/default/deploy/jbossweb-tomcat55.sar/server.xml
Buscar el código
Code Block
<Connector port="8080" address="${jboss.bind.address}">
El puerto por defecto es el 8080. Si hubiera otro definido se debe modificar también en la nueva instalación.
En la versión 5 este archivo cambio el path siende el nuevo path el siguiente
<o3>/jboss/server/default/deploy/jboss-web.deployer/server.xml

...

Revisar configuración del mail. Copiar el archivo jboss\server\default\deploy\mail-service.xml a la nueva instalación en el mismo lugar.
Información más detallada de este punto puede encontrarse en HowTo configurar el mailer de JBoss

Verificando la nueva instalación

...

Versions Compared

Old Version 16

New Version Current

Key