Guía de Instalación de O3 v5

Este documento explica cómo realizar una instalación de O3 incluyendo cuál distribución utilizar para cada Sistema Operativo y los pasos a ejecutar en cada caso.

Dependiendo de la plataforma sobre la que se desee instalar el producto se deberá elegir entre los diferentes mecanismos de instalación.

Para plataformas Windows y Linux existen instaladores específicos, mientras que para otras plataformas se debe utilizar el instalador multiplataforma. Sin embargo este instalador multiplataforma también puede usarse para Windows o Linux.

Los pasos para la ejecución en Windows y Linux se detallan a continuación, una vez iniciado el instalador la secuencia de pasos es similar para todas las plataformas.

En el caso de efectuar una migración es importante leer la información presentada en Migración entre Versiones de O3

Importante

Es necesario realizar la instalación de O3 utilizando la cuenta de Administrador (en Windows) o root ( en Linux) en la máquina

 

Iniciando el instalador en plataformas Windows

El nombre del instalador para plataformas Windows es O3Setup.exe.

  1. Insertar el CD con la distribución de O3 en la lectora de CD-ROM y el proceso iniciará automáticamente.
    De no iniciar en forma automática deberá ejecurarse el archivo
    \Disk1\InstData\Windows\VM\O3Setup.exe
  2. De lo contrario simplemente ejecutar el archivo O3Setup.exe descargado del sitio de Ideasoft

Iniciando el instalador en plataformas Linux

El nombre del instalador para plataformas Linux es O3Setup.bin.

  1. Ejecutar el archivo \Disk1\InstData\Linux\VM\O3Setup.bin del CD de instalación.
  2. De lo contrario simplemente ejecutar el archivo O3Setup.bindescargado del sitio de Ideasoft

    Nota

    Para otros detalles sobre la instalación sobre Linux referirse a Solución de problemas en Linux

Iniciando el instalador multiplataforma

Para utilizar este procedimiento de instalación es necesario disponer de una Máquina Virtual Java instalada en el sistema (ya sea Java Development Kit - JDK o Java Runtime Environment - JRE, versión 1.5 o superior).

Para verificar la versión de java instalada en el sistema ejecutar en una línea de comandos

java \-version

Esto despliega algo similar a la información siguiente:

java version "1.5.0_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode, sharing)

La version debe de ser mayor o igual a 1.5

Visitar el sitio de SUN para [bajar la JVM|http://java.com/es/download/linux_manual.jsp]

Una vez instalada la Máquina Virtual Java, se deben seguir los siguientes pasos para instalar la versión de Ideasoft O3:

  1. Abrir una consola de línea de comando
  2. Ejecutar lo siguiente:
    java -jar <CDROM>/Disk1/InstData/Java/O3Setup.jar
    donde <CDROM> es la ruta a la lectora de CD

    Nota

    En el caso de no disponer de ambiente gráfico o que la invocación anterior presentara algún error, se deberá agregar la opción "-i console" a la invocación, lo cual iniciará el instalador sin consola gráfica.
    Ej: java -jar <path>/O3Setup.jar -i console

Luego de finalizado el proceso de instalación, deberá realizarse los siguientes ajustes de configuración

  1. Editar el archivo <O3>/sh/settings.sh que se encuentra en el directorio sh de la instalación.
  2. Localizar las siguientes líneas

    JVMPATH=$INSTALL_DIR/jre
    JVM=$JVMPATH/bin/java
    
  3. Realizar los siguientes cambios de modo de comentar estas líneas y agregar la nueva ruta

    #JVMPATH=$INSTALL_DIR/jre
    #JVM=$JVMPATH/bin/java
    JVM=<path_a_jvm>/java
    
  4. Editar el archivo <O3>/sh/jboss.sh o <O3>/bat/jboss.bat
  5. Localizar las siguientes líneas

    CLASSPATH=.
    # Uncomment this line and change the location of the JDK
    JAVA_HOME="$INSTDIR/../jre"
    
  6. Substituirlas por

    JAVA_HOME=<path_al_directorio_de _jvm>
    

    En general este path debe de ser hasta llegar al directorio donde estan entre otras carpetas bin del jvm

  7. Finalmente buscar <O3>/jre/lib/Tool.jar y copiarlo en
    <path_al_directorio_de_jvm>/lib, si no existe crearlo

El proceso de instalación

El proceso de instalación será el mismo tanto para plataformas Windows, Linux o para el caso del instalador multiplataforma.

  1. El proceso de instalación dará comienzo, mostrando una pantalla con el logo de Ideasoft O3, mientras el instalador arma el ambiente necesario.
  2. A continuación se despliega el mensaje de bienvenida. Luego de elegir el idioma a utilizar en el proceso de instalación, se debe presionar el botón OK para seguir adelante con la instalación.
  3. Para continuar con la instalación se debe presionar el botón Siguiente.
    Pantallas similares a la que se describe en este punto se mostrarán durante todo el proceso de instalación.
    En ellas se indicará en el panel de la izquierda la fase de instalación que se esté ejecutando, y en el panel de la derecha las instrucciones a seguir u opciones que deberán ser seleccionadas.
  4. En la siguiente fase se desplegará el acuerdo de licencia, Debe leerse detenidamente y en caso de estar de acuerdo, luego de seleccionar la opción "Acepto los términos del acuerdo de licencia", se debe presionar el botón Siguiente.
  5. Una vez aceptados los términos de la licencia de uso se solicita especificar la ruta de instalación del producto.
    En este paso de la instalación se sugiere una ruta por defecto "C:\Ideasoft\O3" para el caso de Windows, y /<usuario>/Ideasoft/O3 para el caso de Linux.
    La misma puede ser modificada en caso de preferir otra ubicación para la instalación del producto.
    Se recomienda no utilizar rutas que contengan caracteres en blanco (espacios).
    Presione el botón Siguiente para pasar a la siguiente fase de la instalación.
  6. En la siguiente fase se deben seleccionar los componentes de Ideasoft O3 que se desean instalar.
    Para facilitar el proceso de instalación, se puede seleccionar alguno de los conjuntos de módulos predefinidos que el instalador ofrece. De lo contrario, se deben seleccionar de a uno, todos los módulos que se desean instalar mediante la opción Personalizada
    Las opciones para instalar un conjunto de módulos predefinidos son:
    • Puesto de Trabajo
    • Diseñador
    • Servidor
    • Personalizada
      Para realizar una instalación Personalizada, se deberán elegir los componentes deseados, uno a uno.
  7. En la siguiente fase, se establece la ubicación del acceso directo a la aplicación. Automáticamente el instalador selecciona un lugar por defecto.
    Luego de seleccionar la opción deseada, se debe presionar el botón Siguiente.
  8. La siguiente fase, se refiere a la instalación de Servicios, debiéndose indicar si se desea que el servidor de aplicaciones JBoss sea instalado como servicio del sistema operativo.
    Esta opción aparece sólo si se seleccionó el JBoss entre la lista de componentes a instalar
    Si se elige instalar el servicio JBoss, es posible indicar la configuración deseada de para el inicio del servicio: Automática o Manual, así como el nombre del mismo.

    Nota

    No se recomienda cambiar el nombre del servicio de JBoss a menos que se sepa que conflictúa con otro servicio

  9. Como último paso de la configuración de la instalación se muestran las opciones seleccionadas, pudiendo volver atrás para hacer las modificaciones correspondientes.
  10. Se debe presionar el botón Instalar para iniciar el proceso de instalación.
    Al finalizar, un mensaje informará sobre la instalación exitosa del producto, debiendo presionar el botón Terminadopara cerrar el diálogo del proceso de instalación.

    Instalación y Activación de Licencias

    El paso siguiente a la instalación es el de instalación y activación de licencias. Más información sobre este paso puede encontrarse aquí