SIU-Guarani/version3.21.0/instalacion desde cero/instalacion/gestion/linux

Instalación desde cero de SIU-Guaraní Gestión 3.21 en entorno de Desarrollo

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 Guaraní>: por el path donde está instalado el proyecto
• <siglas institución>: por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación
  • 3.21.x: por la versión que se va a instalar

Pasos para la instalación

1. Verificar que se cumplan todos los requisitos técnicos de la versión
2. Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:

   mkdir /usr/local/proyectos/guarani

   Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.

3. Bajar el proyecto del SVN desde la URL correspondiente en Colab:

   svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.21.x <path proyecto Guaraní>

4. Instalar vía Composer las dependencias del proyecto. Posicionados en la raíz <path proyecto Guaraní>, ejecutar:

   composer install

   Nota: Si ha modificado algún archivo de la carpeta vendor y obtiene algún mensaje como este:

   Updating siu-arai/documentos-cli (v1.0.2 => v1.0.3):    
   The package has modified files:
   M tests/src/SIU/Queue/QueueTest.php
   Discard changes [y,n,v,d,s,?]? y

   Contestar y para descartar los cambios que se hayan realizado.

5. Instalar el framework SIU-Toba, para ello, posicionados en <path proyecto Guaraní>/bin ejecutar:

   export TOBA_INSTANCIA=desarrollo
   export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion
   ./toba instalacion instalar

   y completar:

   Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
   Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico>
   Se trata de una instalacion de producción? (Si o No) (s/n): n
   Nombre de la instalación (ej: Andromeda): <ej: guarani3>
   PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
   PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
   PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
   PostgreSQL - Clave  (ENTER para usar sin clave): <clave servidor Postgres>
   PostgreSQL - Base de datos (ENTER utilizará toba_3_3): <nombre de la base, sugerencia: guarani3>
   Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
   Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>

6. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario con el que se ejecuta Apache pueda escribir:
   • <path proyecto Guaraní>/www
   • <path proyecto Guaraní>/temp
   • <path proyecto Guaraní>/instalacion
   • <path proyecto Guaraní>/vendor/siu-toba/framework/www
   • <path proyecto Guaraní>/vendor/siu-toba/framework/temp

   Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es www-data, debería ejecutarse:

   chown -R $(whoami):www-data www temp instalacion vendor/siu-toba/framework/www vendor/siu-toba/framework/temp
   chmod 775 -R www temp instalacion vendor/siu-toba/framework/www vendor/siu-toba/framework/temp

7. Crear un link simbólico a toba.conf, e indicarle Apache que recargue los archivos de configuración. En lugar de hacerlo como indica la consola de instalación, sugerimos:

   ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
   a2ensite gestion.conf
   service apache2 reload

8. Agregar los parámetros de localización de fop al final del archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/instalacion/instalacion.ini):

   [xslfo]
   fop=<path proyecto Guaraní>/php/3ros/fop/fop

   Nota: verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.

9. Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto (<path proyecto Guaraní)) ejecutar:

   cp menu.ini.tmpl menu.ini

   Completar el archivo menu.ini

10. Para cargar el proyecto, dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:

    ./guarani cargar -d <path proyecto Guaraní>

    Nota: ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder s.

11. Reiniciar Apache:

    service apache2 restart

12. Configurar la API REST

    API SIU-Guaraní - Perfil Funcional

13. Para crear la base de datos de negocio, dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:

    ./guarani instalar

    Nota: en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador -j a la sentencia anterior.

14. Para activar el esquema de auditoría, dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:

    ./guarani crear_auditoria -f guarani

15. Programar una tarea que levante la utilidad PHP-Java Bridge, necesaria para el motor de reportes Jasper Reports. El comando para activarlo es:

    java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081

    Por ejemplo, en un ambiente Debian, se puede editar como superusuario el archivo /etc/rc.local, y agregar la sentencia anterior.

16. Para ejecutar el proyecto navegar hacia la URL definida en toba.conf, por defecto:

    http://localhost/guarani/3.21

    El usuario-clave para el primer acceso es: toba, toba. Se recomienda luego del primer acceso modificar la clave.

17. Para editar el proyecto, navegar hacia la URL definida en toba.conf, por defecto:

    http://localhost/toba_editor/3.3

    El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.

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:
   crontab -e
2. Agregar la siguiente linea:
   */10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador
   (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:\guarani_enviar_emails_bat.bat) con el siguiente contenido:
   @echo off
   <path proyecto Guaraní>\bin\guarani enviar_emails_notificador
   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: guarani_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:\guarani_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.

(Para más detalles del envío de emails consulte la documentación del notificador)

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