Diferencia entre revisiones de «SIU-Guarani/version3.14.0/instalacion desde cero/instalacion/gestion/linux»

De SIU
Saltar a: navegación, buscar
 
 
(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 SERVLET:8081</source>
+
#:<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

  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.14.x <path proyecto Guaraní>
    Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.
  3. 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>
  4. 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"
  5. 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
  6. 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
  7. 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.
  8. 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
  9. 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.
  10. 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.
  11. 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
  12. 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
  13. 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.
  14. 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