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

De SIU
Saltar a: navegación, buscar

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