SIU-Guarani/version3.19.0/instalacion desde cero/instalacion/gestion/linux
Instalación desde cero de SIU-Guaraní Gestión 3.19 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.19.x: por la versión que se va a instalar
Pasos para la instalación
- Verificar que se cumplan todos los requisitos técnicos de la versión
- 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í>.
- 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.19.x <path proyecto Guaraní>
- 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.
- 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>
- 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
- 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
- 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.
- 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
- 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.
- Reiniciar Apache:
- service apache2 restart
- Configurar la API REST
- 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.
- Para activar el esquema de auditoría, dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani crear_auditoria -f guarani
- 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.
- Para ejecutar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
- http://localhost/guarani/3.19
- El usuario-clave para el primer acceso es: toba, toba. Se recomienda luego del primer acceso modificar la clave.
- 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:
- En una consola ejecutar el comando:crontab -e
- Agregar la siguiente linea:(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador
- Guardar y salir del editor
- Con un sistema Windows:
- 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 - Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".
- 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".
- 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).
- 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.
- Aceptar para crear la tarea.
(Para más detalles del envío de emails consulte la documentación del notificador)