SIU-Guarani/version3.13.0/actualizacion/3w

Instalación de SIU-Guaraní 3w versión 3.13.x en entorno de Desarrollo o Producción

Es necesario tener instalada la versión 3.13.x de SIU-Guaraní Gestión para poder proceder con esta versión de SIU-Guaraní 3w y solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.

A lo largo de los pasos se deberá reemplazar:

• <path proyecto 3w>: por el path donde está instalado el proyecto
• <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
• En caso de estar instalando la versión en entorno de Desarrollo:
  • 3.13.x: por la versión que se va a instalar
• En caso de estar instalando la versión en entorno de Producción:
  • 3.13.x.y: por la versión propia que se va a instalar

Pasos para la instalación

1. Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:

   sudo mkdir /usr/local/proyectos/g3w3

   Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto 3w>.

2. Bajar el proyecto del SVN desde la URL correspondiente en Colab:
   • Si se está actualizando en entorno de Desarrollo:

   svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/trunk/3.13.x <path proyecto 3w>

   • Si se está actualizando en entorno de Producción:

   svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/versiones/3.13.x.y <path proyecto 3w>

3. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario Apache pueda escribir
   • <path proyecto 3w>/instalacion/log
   • <path proyecto 3w>/instalacion/cache
   • <path proyecto 3w>/instalacion/temp
   • <path proyecto 3w>/instalacion/operaciones_inactivas
   • <path proyecto 3w>/src/siu/www/js/escalas
   • <path proyecto 3w>/src/siu/www/temp
   • <path proyecto 3w>/src/siu/www/_comp (esta carpeta se crea al ejecutar ./guarani compilar_recursos en la configuración del entorno de Producción)
4. Editar los archivos de configuración

   Armar los archivos de configuración a partir de los templates. Dentro de la carpeta 'instalación' (<path proyecto 3w>/instalacion):

   cp alias_template.conf alias.conf
   cp config_template.php config.php
   cp login_template.php login.php

   Editar los archivos alias.conf y config.php (ver Configuración)

5. Instalar las dependencias del proyecto

   Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:

   composer install

   Luego de correr dicho comando se debe versionar el archivo composer.lock. Por otra parte, la carpeta vendor se encuentra ignorada y jamas se debe subir al repositorio.

   Para mas información ver en la Documentación de Composer

1. Configurar el servidor web

   Incluir el archivo instalacion/alias.conf en la configuración del servidor web. Ejecutar el siguiente comando como superusuario para realizar el link simbólico a la instalación:

   ln -s <path proyecto 3w>/instalacion/alias.conf /etc/apache2/sites-enabled/<nombre del alias>.conf

   Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: http://localhost/<nombre del alias>

2. Verificar la aplicación

   Realizar un test de conexión a la base de datos. Dentro de la carpeta 'bin' (<path proyecto 3w>/bin) ejecutar:

   ./guarani test_conexion <bloque de acceso>

   Donde <bloque de acceso> es el ID del bloque de acceso a testear la conexión

   Nota: si al correr el comando test_conexion o al ingresar a la aplicación muestra el mensaje "La extensión de php 'mcrypt' no está instalada." correr el siguiente comando sudo php5enmod mcrypt y luego reiniciar apache.

Configuración de cron o tarea programada para el envío de emails

Un cron o tarea programada es un programa que permite ejecutar automáticamente comandos o scripts (grupos de comandos) a una hora o fecha específica. Es usado normalmente para comandos de tareas administrativas, como respaldos, pero puede ser usado para ejecutar cualquier cosa. Es un demonio que ejecuta programas agendados.

• Con un sistema GNU/Linux:

1. En una consola ejecutar el comando:
    sudo crontab -e
2. Agregar la siguiente linea:
   */10 * * * * <path_to_g3w3>/bin/guarani enviar_emails
   (ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/
3. Guardar y salir del editor

• Con un sistema Windows:

1. Crear un archivo .bat (ej: C:\g3w3_enviar_emails_bat.bat) con el siguiente contenido:
   @echo off
   <path_to_g3w3>\bin\guarani enviar_emails
   exit
2. Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".
3. Ir a Acciones -> Crear tarea, en la solapa "General" poner un Nombre a la tarea (ej: g3w3_cron_enviar_emails), una descripción (opcional) y tildar la opción "Oculta".
4. En la solapa "Acciones" crear una nueva acción, donde dice "Programa o Script" seleccionar el path hasta el .bat (ej: C:\g3w3_enviar_emails_bat.bat).
5. En la solapa "Desencadenadores" crear un nuevo desencadenador, en inicio poner una hora posterior a la actual (ej: 10 minutos mas tarde) en Configuración avanzada poner Repetir cada 10 minutos repetir indefinidamente.
6. Aceptar para crear la tarea.

Terminar de configurar - sólo si se está instalando el entorno de Producción

1. Compilar los recursos en el servidor de producción:

   Dentro de la carpeta 'bin' (<path proyecto 3w>/bin)

   ./guarani compilar_recursos

   Este comando crea la carpeta <path proyecto 3w>/src_siu/www/_comp, se le deben dar los permisos arriba detallados.
   Esta carpeta no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor.

2. Activar el modo producción en el archivo de configuración (<path proyecto 3w>/instalacion/config.php).

   produccion: true

Si se estaba haciendo la actualización con personalizaciones, volver para terminar de configurar el entorno.

Ir al esquema de instalación y actualización de la versión