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

De SIU
Saltar a: navegación, buscar
 
(No se muestran 10 ediciones intermedias de 3 usuarios)
Línea 3: Línea 3:
 
= Instalación desde cero de SIU-Guaraní Gestión 3.15 en entorno de Desarrollo =
 
= Instalación desde cero de SIU-Guaraní Gestión 3.15 en entorno de Desarrollo =
  
{| border=1 class="simple"
+
{| class="simple" border="1"
 
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
 
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
 
|}
 
|}
Línea 11: Línea 11:
 
** 3.15.x: por la versión que se va a instalar
 
** 3.15.x: por la versión que se va a instalar
  
== Pasos para la actualización ==
+
== Pasos para la instalación ==
 +
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]
 
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:  
 
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:  
#:<source lang="bash" enclose="div">sudo mkdir /usr/local/proyectos/guarani</source>
+
#:<source lang="bash" enclose="div">mkdir /usr/local/proyectos/guarani</source>
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <tt><path proyecto Guaraní></tt>.
+
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.
 
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
 
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x <path proyecto Guaraní>
+
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x <path proyecto Guaraní>
 
</source>
 
</source>
 
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
 
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
sudo composer install
+
composer install
 
</source>
 
</source>
 
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:
 
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
 
export TOBA_INSTANCIA=desarrollo
 
export TOBA_INSTANCIA=desarrollo
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>
+
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion
sudo ./toba instalacion instalar
+
./toba instalacion instalar
 
</source>
 
</source>
 
#:y completar:
 
#:y completar:
Línea 49: Línea 50:
 
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www
 
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www
 
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp
 
#*<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:
+
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', posicionados en '''<path proyecto Guaraní>''' debería ejecutarse:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
sudo chown -R www-data:www-data <path proyecto Guaraní>/www
+
chown -R $(whoami):www-data www temp instalacion vendor/siu-toba/framework/www vendor/siu-toba/framework/temp
sudo chown -R www-data:www-data <path proyecto Guaraní>/temp
 
sudo chown -R www-data:www-data <path proyecto Guaraní>/instalacion
 
sudo chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www
 
sudo chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp
 
 
</source>
 
</source>
#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
+
#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:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
sudo ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
+
ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
sudo a2ensite gestion.conf
+
a2ensite gestion.conf
sudo service apache2 reload
+
service apache2 reload
 
</source>
 
</source>
#Agregar los parámetros en el archivo de inicialización de la instalación Toba (<tt><path proyecto Guaraní>/instalacion/instalacion.ini</tt>):
+
#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'''):
 
#:<source lang="ini" enclose="div">
 
#:<source lang="ini" enclose="div">
 
[xslfo]
 
[xslfo]
 
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
 
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
 
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
 
#:'''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 (<tt><path proyecto Guaraní)</tt>) ejecutar:
+
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
 
cp menu.ini.tmpl menu.ini
 
cp menu.ini.tmpl menu.ini
 
</source>
 
</source>
 
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]
 
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]
#Para cargar el proyecto, dentro de la carpeta 'bin'(<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
+
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">
sudo ./guarani cargar -d <path proyecto Guaraní>
+
./guarani cargar -d <path proyecto Guaraní>
 
</source>
 
</source>
 
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''.  
 
#:'''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' (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
+
#Reiniciar Apache:
#:<source lang="bash" enclose="div">sudo ./guarani instalar</source>
+
#:<source lang="bash" enclose="div">
 +
service apache2 restart
 +
</source>
 +
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
 +
#:<source lang="bash" enclose="div">./guarani instalar</source>
 
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
 
#:'''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' (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
+
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">sudo ./guarani crear_auditoria -f guarani</source>
+
#:<source lang="bash" enclose="div">./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="bash" enclose="div">java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
+
#:<source lang="bash" enclose="div">java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/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.15</source>
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.15</source>
 
#:El usuario-clave para el primer acceso es: '''toba''', '''toba'''. Se recomienda luego del primer acceso modificar la clave.
 
#: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:
 
#Para editar el proyecto, navegar hacia la URL definida en ''toba.conf'', por defecto:
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.7</source>
+
#:<source lang="php" enclose="div">http://localhost/toba_editor/3.0</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>.
  
Línea 95: Línea 96:
 
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.
 
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''':
 
*:Con un sistema '''GNU/Linux''':
#En una consola ejecutar el comando:<source lang="php" enclose="div> sudo crontab -e </source>
+
#En una consola ejecutar el comando:<source lang="php" enclose="div">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/
 
#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
 
#Guardar y salir del editor

Revisión actual del 13:40 8 oct 2018

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:

  • <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.15.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.15.x <path proyecto Guaraní>
  4. Instalar vía Composer las dependencias del proyecto. Posicionados en la raíz <path proyecto Guaraní>, ejecutar:
    composer install
  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_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>
  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, posicionados en <path proyecto Guaraní> debería ejecutarse:
    chown -R $(whoami):www-data 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. 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.
  13. Para activar el esquema de auditoría, dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./guarani crear_auditoria -f guarani
  14. Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
    java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081
  15. 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.
  16. Para editar el proyecto, navegar hacia la URL definida en toba.conf, por defecto:
    http://localhost/toba_editor/3.0
    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