Instalación de O3 Planner

Estas instrucciones asumen que se cuenta con la exportación de una simulación. Para más detalles sobre cómo obtener dicha exportación se puede consultar la página Guia de Exportacion de un Simulador

Una vez ejecutada la instalación básica de Ideasoft O3, se deben ejecutar los siguientes pasos:

1. Importar la simulación deseada
   Nota: se puede utilizar el usuario predefinido en el sistema: user (password: user)
   1. Abrir el O3 Browser
   2. Verificar que las opciones de conexión son las correctas (servidor y puerto)
   3. Importar el modelo de simulación presionando el botón de importar
   4. Elegir el archivo (.zip) que contiene la simulación a importar
2. Modificar los parámetros de conexión a la base de datos del proyecto EDF
   1. Editar el proyecto EDF correspondiente a la simulación que se está importando
      Desde el menú Herramientas/Componentes/EDF/Editar Proyecto EDF
   2. Modificar la conexión por defecto de dicho proyecto para que la base de datos deseada
      Ejemplo para HSQLDB

      Motor	HSqlDb
      Driver	org.hsqldb.jdbcDriver
      URL	jdbc:hsqldb:hsql://localhost:1701
      Nombre	sa

   3. Salvar el proyecto EDF
3. (Si corresponde) Crear las tablas de la aplicación
   1. Elegir como proyecto EDF actual el que se modificó en el paso anterior
   2. Editar la metadata de la aplicación
   3. Crear las tablas desde el Editor de Metadata usando la acción de la toolbar
4. Publicar simulador
   Desde el O3 Browser / Editor de modelos de simulación efectuar un Deploy del simulador que se acaba de importar.
5. (Si corresponde) Verificar la correcta referencia a los objetos de análisis desde los dashboards
6. (Si corresponde) Verificar en los scorecards:
   1. la correcta referencia a las vistas,
   2. el usuario/password en sus respectivos archivos ".properties"
7. Recordar que los reportes realizados con jsp específicas pueden no estár incluídos en el zip del modelo de simulación. Por más información sobre los archivos incluídos y no incluídos en dicho zip se puede consultar la página Guia de Exportacion de un Simulador. En el caso de que existan reportes con esta característica:
   1. Copiar las jsp específicas (en general, bajo el directorio <O3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/jsp).
   2. Vincular los reportes generados por las jsp a los componentes y/o nodo Analizar correspondientes. Para ello se debe acceder a la aplicación web (desde el explorador de internet conectarse al O3Portal).
8. (Si corresponde) Definir los grupos de tablas versionables
   Mediante la aplicación web, verificar que los grupos deseados que contendrán las tablas versionables están definidos o en su defecto, definir dichos grupos.
9. (Si corresponde) Asignar las tablas versionables a los grupos correspondientes
   Si corresponde.
10. (Si corresponde) Modificar los parámetros de conexión a la base de datos del constructor de cubos
    1. Editar el archivo <O3>/jboss/server/default/ideasoft-o3/server/istore/simulation/<Nombre Simulador>/<Nombre Simulador>.cfg
    2. Agregar los siguientes parámetros para cada esquema que se deba acceder al contruir los cubos
       Ejemplo para Sql Server (<EsquemaMetadataAplicacion> es el nombre de uno de los esquemas. Se requiere que sea escrito en mayúsculas)

       CONN_PROTOCOL_<EsquemaMetadataAplicacion>=<e.g. sqlserver>
       CONN_DRIVER_<EsquemaMetadataAplicacion>=<nombre clase del driver>
       CONN_PARAMETERS_<EsquemaMetadataAplicacion>=<database url>
       CONN_LOGIN_<EsquemaMetadataAplicacion>=<nombre usuario bd>
       CONN_PASS_<EsquemaMetadataAplicacion>.pwd=<password encriptada del usuario bd> 
       
       CONN_PROTOCOL_SIMULATION=<e.g. sqlserver>
       CONN_DRIVER_SIMULATION=<nombre clase del driver>
       CONN_PARAMETERS_SIMULATION=<database url>
       CONN_LOGIN_SIMULATION=<nombre usuario bd>
       CONN_PASS_SIMULATION.pwd=<password encriptada del usuario bd>
       
       CONN_PROTOCOL_<EsquemaMetadataResultadoSimulacion>=<e.g. sqlserver>
       CONN_DRIVER_<EsquemaMetadataResultadoSimulacion>=<nombre clase del driver>
       CONN_PARAMETERS_<EsquemaMetadataResultadoSimulacion>=<database url>
       CONN_LOGIN_<EsquemaMetadataResultadoSimulacion>=<nombre usuario bd>
       CONN_PASS_<EsquemaMetadataResultadoSimulacion>.pwd=<password encriptada del usuario bd> 
       

       Encriptación de passwords

       Para la encriptación de passwords, el comando builder provee la opción -encrypt. El comando builder se provee como parte de la instalaciónde O3. Por ejemplo, en una instalación windows, si la password es "asdf123", la ejecución del siguiente comando, proveerá en la última línea de su resultado la password encriptada,

       $ <directorio de instalación de O3>\bat\builder -encrypt asdf123
       

       En una instalación linux,

       $ <directorio de instalación de O3>/sh/builder -encrypt asdf123
       

11. (Si corresponde) Ajuste de parámetros del constructor de cubos usado por el Planner.
    En caso que se utilicen puertos distintos a aquellos por defecto y/o se cambie el usuario/password usado para construir los cubos, modificar las propiedades que se encuentran en el archivo:

    <O3>/jboss/server/default/ideasoft-o3/config/publish/templates/cubesrv.vm

12. (Opcional según el método de exportación e importación de datos) Importar los datos en la base de datos utilizando la herramienta JDBCImport
    Para más información sobre cómo realizar importaciones de datos JDBC está disponible la página Exportando e Importando datos JDBC, donde entre otras cosas se describe cómo generar el archivo import.xml y cómo modificarlo.
    1. Copiar el archivo import.xml en una carpeta temporal (Ej: C:\tmp\Planner)
    2. Extraer el contenido del archivo DatabaseData.zip en la misma carpeta temporal (Ej: C:\tmp\Planner)
    3. Ejecutar la siguiente línea desde una consola de Línea de Comando para importar los datos desde la carpeta temporal

       jdbcimporter.bat import.xml
       

       Esto importa los datos existentes en los archvos .csv de acuerdo con las indicaciones del archivo import.xml

       Nota

       De ser necesario se puede modificar el archivo import.xml para indicar una base de datos diferente (más info)

13. Test de humo de la instalación
    Mediante la aplicación web definir un escenario y calcularlo. Por defecto se dispone de 2 usuarios admin/admin y user/user.
14. Gestionar la seguridad del simulador