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
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:

   • Si es una instalación nueva:

   composer install

   • Si es una actualización de versión:

   composer update

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

6. 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>

7. 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

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