SIU-Guarani/version3.14.0/instalacion desde cero/produccion/gestion/linux

De SIU
Saltar a: navegación, buscar

Instalación desde cero de SIU-Guaraní Gestión 3.14 en entorno de Producción

Requisitos previos

  1. Haber liberado una versión propia de cuatro dígitos (se hayan o no desarrollado personalizaciones).


A lo largo de los pasos se deberá reemplazar:

  • <siglas institución>: por las siglas correspondientes al nodo de Colab de la Institución que realiza la instalación.
  • 3.14.x.y: por la versión propia que se va a instalar.

Pasos para la instalació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/versiones/3.14.x.y <path proyecto Guaraní>
  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. 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 de 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
  5. Tal como se indica en la consola al instalar, se debe crear el link simbólico a 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
  6. 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.
  7. 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
  8. 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.
  9. Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
    sudo ./guarani instalar
  10. Activar el esquema de auditoría. Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
    sudo ./guarani crear_auditoria -f guarani
  11. 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í>/lib/toba/php/3ros/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


Configuraciones adicionales

Manejo de perfiles

En el archivo <path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini establecer:

 es_produccion = 1

Para facilitar la actualización de versiones y evitar cometer errores en el pasaje desde desarrollo, los perfiles se definen en el entorno de producción. Ver Manejo de perfiles Para ello, en el archivo <path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/instancia.ini, dentro de la sección destinada al proyecto (indicada por "[guarani]") configurar:

 [guarani]
 usar_perfiles_propios = 1

La combinación de estos dos flags permite que la exportación de perfiles se haga en la carpeta <path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/p__guarani/perfiles en lugar de la carpeta usual <path proyecto Guaraní>/metadatos/permisos. Cuando se actualiza el sistema a una nueva versión, se mantienen los perfiles definidos localmente.

Compilar metadatos

Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

./guarani compilar

Este comando crea la carpeta <path proyecto Guaraní>/metadatos_compilados, se le deben dar los permisos arriba detallados. Esta carpeta no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor. Por dicha razón es que compilamos en el servidor de producción, donde no se realizan svn commits. Editar el archivo 'aplicacion.php' (<path proyecto Guaraní>/www/aplicacion.php) y descomentar la siguiente línea:

define('apex_pa_metadatos_compilados', 1);

Nivel de log

Adicionalmente, en el mismo archivo 'aplicacion.php', se puede establecer el nivel de log máximo deseado:

define("apex_pa_log_archivo_nivel", 3); // 3: Error | 5: notice | 6: debug

Probar el acceso

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

http://localhost/guarani/3.14

El usuario para el primer acceso es toba, y la contraseña es la establecida durante la instalación. Dado que estamos en un ambiente de producción, se recomienda no utilizar un password débil para este superusuario.

Desinstalar proyectos de desarrollo

Dado que estamos en un ambiente de producción, recomendamos desinstalar los proyectos toba_editor y toba_referencia, que son instalados por defecto junto con el framework. En una consola posicionada en el bin de toba (<path proyecto Guaraní>/lib/toba/bin), ejecutar:

toba proyecto eliminar -p toba_editor -i desarrollo
toba proyecto eliminar -p toba_referencia -i desarrollo

toba proyecto despublicar -p toba_editor -i desarrollo
toba proyecto despublicar -p toba_referencia -i desarrollo

Finalmente, reiniciar Apache.


Ir al esquema de instalación y actualización de la versión