Diferencia entre revisiones de «SIU-Guarani/version3.14.0/instalacion desde cero/instalacion/gestion/linux»
(No se muestran 3 ediciones intermedias de 2 usuarios) | |||
Línea 37: | Línea 37: | ||
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)> | 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> | Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción> | ||
+ | </source> | ||
+ | #A partir de la versión 3.13.0, es necesario 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í>/lib/toba/instalacion/bases.ini''', ''si no existe'' una entrada con el encabezado '''[desarrollo toba_usuarios toba_usuarios]''', agregarla, con idéndica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo: | ||
+ | #:<source lang="ini" enclose="div"> | ||
+ | [desarrollo toba_usuarios toba_usuarios] | ||
+ | motor = "postgres7" | ||
+ | profile = "localhost" | ||
+ | usuario = "postgres" | ||
+ | clave = "**********" | ||
+ | base = "guarani3" | ||
+ | puerto = "5432" | ||
+ | encoding = "LATIN1" | ||
+ | schema = "desarrollo" | ||
</source> | </source> | ||
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir: | #Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir: | ||
Línea 79: | Línea 91: | ||
#:<source lang="php" enclose="div">sudo ./guarani crear_auditoria -f guarani</source> | #:<source lang="php" enclose="div">sudo ./guarani crear_auditoria -f guarani</source> | ||
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando: | #Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando: | ||
− | #:<source lang="php" enclose="div">java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar | + | #:<source lang="php" enclose="div">java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081</source> |
#Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto: | #Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto: | ||
#:<source lang="php" enclose="div">http://localhost/guarani/3.14</source> | #:<source lang="php" enclose="div">http://localhost/guarani/3.14</source> | ||
Línea 86: | Línea 98: | ||
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.7</source> | #:<source lang="php" enclose="div">http://localhost/toba_editor/2.7</source> | ||
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>. | #: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:<source lang="php" enclose="div> sudo crontab -e </source> | ||
+ | #Agregar la siguiente linea:<source lang="php" enclose="div">*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador</source>(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/ | ||
+ | #Guardar y salir del editor | ||
+ | <br> | ||
+ | *:Con un sistema '''Windows''': | ||
+ | #Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:<source lang="php" enclose="div"> | ||
+ | @echo off | ||
+ | <path proyecto Guaraní>\bin\guarani enviar_emails_notificador | ||
+ | exit | ||
+ | </source> | ||
+ | #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 [[SIU-Guarani/Version3.14.0/notificador|notificador]]) | ||
[[SIU-Guarani/Version3.14.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]] | [[SIU-Guarani/Version3.14.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]] |
Revisión actual del 17:26 22 mar 2018
Instalación desde cero de SIU-Guaraní Gestión 3.14 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.14.x: por la versión que se va a instalar
Pasos para la actualización
- 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í>.
- 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.14.x <path proyecto Guaraní>
- Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.
- Instalar el proyecto, para ello, ejecutar:
- sudo <path proyecto Guaraní>/lib/toba/bin/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>
- A partir de la versión 3.13.0, es necesario 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í>/lib/toba/instalacion/bases.ini, si no existe una entrada con el encabezado [desarrollo toba_usuarios toba_usuarios], agregarla, con idéndica 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"
- 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í>/metadatos_compilados (esta carpeta se crea al ejecutar ./guarani compilar en la configuración del entorno de Producción)
- <path proyecto Guaraní>/lib/toba/www
- <path proyecto Guaraní>/lib/toba/instalacion
- <path proyecto Guaraní>/lib/toba/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í>/metadatos_compilados
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/www
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/instalacion
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/temp
- 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í>/lib/toba/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
sudo a2ensite gestion.conf
sudo service apache2 reload
- Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/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' de Guaraní (<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.
- Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<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.
- Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- sudo ./guarani crear_auditoria -f guarani
- 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_LOCAL:8081
- Para ejecutar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
- http://localhost/guarani/3.14
- 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/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:
- En una consola ejecutar el comando:sudo 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)