Diferencia entre revisiones de «SIU-Pilaga/version3.0.3/instalacion actualizacion»

De SIU
Saltar a: navegación, buscar
(Instalación desde cero con personalizaciones)
(Instalación desde cero sin personalizaciones)
Línea 84: Línea 84:
 
Una vez realizado lo explicado en el ítem de [[SIU-Pilaga/Version_3.0.3/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:
 
Una vez realizado lo explicado en el ítem de [[SIU-Pilaga/Version_3.0.3/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:
  
#Para instalar en entorno de producción con una base de datos creada ejecutar:
+
Para instalar en entorno de produccion con una base de datos existente vacía ejecutar:
#:<source lang="bash" enclose="div">
+
:<source lang="bash" enclose="div">
 
./bin/instalador proyecto:instalar
 
./bin/instalador proyecto:instalar
 
</source>
 
</source>
#Para instalar en entorno de producción con una base de datos que no existe ejecutar:
+
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
#:<source lang="bash" enclose="div">
+
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
+
--crear-db
 
</source>
 
</source>
#Para instalar en entorno de producción con una base de datos de negocio existente ejecutar:
+
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
#:<source lang="bash" enclose="div">
+
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente  
+
--db-negocio-existente  
 
</source>
 
</source>
  

Revisión del 15:18 12 jun 2017

Instalación/Actualización del sistema SIU-Pilagá

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan. Considere la instalación del navegador en cada estación de trabajo, el sistema SIU-Pilagá fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

Esquema

El siguiente esquema muestra en detalle los pasos para una instalación y actualización del sistema SIU-Pilagá, en este esquema se contempla el procedimiento según se necesite personalizar o no.

Esquema

Requerimientos

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://comunidad.siu.edu.ar.

Las versiones recomendadas son las siguientes:

Tabla de requerimientos

Instalación

La instalación del sistema SIU-Pilagá se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

Pasos previos a un proceso de instalación

  1. Descargar el sistema de SIU-Pilaga desde el sitio http://comunidad.siu.edu.ar/ cuyo nombre es 'SIU-Pilaga_3.X.X.zip'.
  2. Descomprimir el archivo y copiar el directorio SIU-Pilagá en la máquina destino en el directorio donde se desea instalar el sistema.
  3. Luego ingresar en la carpeta del proyecto y ejecutar:
    composer install
  4. Copiar el archivo instalador.env.dist y renombrar a instalador.env
    cp instalador.env.dist instalador.env
  5. Configurar el archivo instalador.env con los datos correspondientes al proyecto y a toba. Los datos que estan comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parametros del instalador podemos configurar por separado la base de datos de negocio de Pilagá y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto.
    ###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
    PROYECTO_DB_HOST="localhost"
    PROYECTO_DB_PORT="5432"
    PROYECTO_DB_DBNAME="pilaga_db"
    PROYECTO_DB_USERNAME="postgres"
    PROYECTO_DB_PASSWORD="postgres"
    PROYECTO_DB_SCHEMA="public"

    ###### CONFIG DE BASE DE DATOS DE TOBA ######
    #TOBA_DB_HOST="localhost"
    #TOBA_DB_PORT="5432"
    #TOBA_DB_DBNAME="toba_pilaga_db"
    #TOBA_DB_USERNAME="postgres"
    #TOBA_DB_PASSWORD="postgres"
    #TOBA_DB_SCHEMA="public"

    ###### CONFIG DE TOBA ######
    TOBA_URL_BASE="http://localhost"
    #TOBA_URL_PORT="80"
    TOBA_USUARIO="toba"
    TOBA_PASSWORD="toba123*-a"
    TOBA_ALIAS_PROYECTO="/siu/pilaga"
    TOBA_ALIAS_TOBA_USUARIOS="/pilaga_toba_usuarios"
    #TOBA_ALIAS_NUCLEO="/toba_pilaga"
    #TOBA_ALIAS_TOBA_EDITOR="/toba_editor/2.7"
    #TOBA_ID_DESARROLLADOR=0
    #TOBA_SESSION_NAME="TOBA_SESSID"

    ###### CONFIG DEL INSTALADR ######
    #INSTALADOR_TIMEOUT="360"
  6. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
    chmod +x bin/instalador

Instalación desde cero sin personalizaciones

Para realizar una instalación de cero sin personalizaciones, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de Pasos previos a un proceso de instalación, el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de produccion con una base de datos existente vacía ejecutar:

./bin/instalador proyecto:instalar

Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:

--crear-db

Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:

--db-negocio-existente

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado Post instalación

Instalación desde cero en entorno de desarrollo

Para realizar una instalación de cero con personalizaciones, es necesario iniciar una instalación en modo desarrollo ya que es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de Pasos previos a un proceso de instalación, el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de desarrollo con una base de datos existente vacia ejecutar:

./bin/instalador proyecto:instalar --dev

Como parámetros opcionales podemos instalar en entorno de desarrollo y crear desde el instalador una base de datos vacía agregando el parámetro:

--crear-db

Opcionalmente tambien podemos realizar una instalación usando una base de datos de negocio existente agregando el siguiente parámetro:

--db-negocio-existente

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado Post instalación

Actualización

Actualización de una instalación sin personalizaciones

Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.

Una vez realizado lo explicado en el ítem de Pasos previos a un proceso de instalación, el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para actualizar en entorno de producción se ejecuta el siguiente comando:

./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR

Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado Post actualización

Actualización de una instalación con personalizaciones

Post Instalación

Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.

Modificar permisos

Permite modificar los permisos, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. Ejecute el siguiente comando como superusuario:

./bin/instalador permisos:simple -U usuario

Configuración del servidor de aplicaciones

Independientemente de si se va a realizar la instalación del sistema SIU-Pilagá en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Pilagá en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre pilagá con el siguiente contenido:


<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    ServerName servidor.universidad.edu.ar

    ### INICIO INCLUSION CONTENIDO toba.conf ###

    Include /ruta_instalacion/pilaga/instalacion/toba.conf

    ### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>


Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Pilagá abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/pilaga.

Activar el sistema

Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:

./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

Personalizaciones

Activar esquema de personalizaciones

Desarrollar nuevas personalizaciones

Crear una versión propia con personalizaciones

Actualización del ambiente de producción con personalizaciones

Instalación de cero de un ambiente de producción con personalizaciones


<Volver