...
- 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)Copiar la carpeta entera
<O3>\jboss\server\default\ideasoft-o3\server sobre la nueva instalación en el mismo lugar - 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 modificarseManejador
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.
- 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.
- 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
- 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
El puerto por defecto es el 8080. Si hubiera otro definido se debe modificar también en la nueva instalación.Code Block <Connector port="8080" address="${jboss.bind.address}">
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
...