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

Instalación desde cero de SIU-Guaraní Gestión 3.15 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:

•  : 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.15.x: por la versión que se va a instalar

Pasos para la actualización

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

   sudo mkdir /usr/local/proyectos/guarani

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

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

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

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

   composer install

   Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.

4. 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í>
   ./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_2_7): <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>

5. Registrar manualmente la fuente de datos del proyecto toba_usuarios, usado para el manejo de perfiles y auditoría. Para ello, en el archivo <path proyecto Guaraní>/instalacion/bases.ini, agregar al final una entrada con el encabezado [desarrollo toba_usuarios toba_usuarios], con idéntica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo:

   [desarrollo toba_usuarios toba_usuarios]
   motor = "postgres7"
   profile = "localhost"
   usuario = "postgres"
   clave = "**********"
   base = "guarani3"
   puerto = "5432"
   encoding = "LATIN1"
   schema = "desarrollo"

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í>/metadatos_compilados (esta carpeta se crea al ejecutar ./guarani compilar en la configuración del entorno de Producción)
   • <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 www-data:www-data <path proyecto Guaraní>/www
   chown -R www-data:www-data <path proyecto Guaraní>/temp
   chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/instalacion
   chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
   chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www
   chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp

7. Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf e indicarle Apache que recargue los archivos de configuración

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

8. Agregar los parámetros en el 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:

    sudo ./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. Para crear la base de datos de negocio, dentro de la carpeta 'bin'(<path proyecto Guaraní>/bin) ejecutar:

    sudo ./guarani instalar

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

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

    sudo ./guarani crear_auditoria -f guarani

13. Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:

    java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081

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

    http://localhost/guarani/3.15

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

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

    http://localhost/toba_editor/2.7

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