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

Instalación desde cero de SIU-Guaraní Gestión 3.13 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.13.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/trunk/3.13.x.y <path proyecto Guaraní>

3. Instalar el proyecto, para ello, ejecutar:

   sudo <path proyecto Guaraní>/lib/toba/bin/instalar

   y completar

   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
   PostgreSQL - Ubicación (ENTER utilizará localhost): localhost
   PostgreSQL - Puerto (ENTER utilizará: 5432): 5432 (ejemplo)
   PostgreSQL - Usuario (ENTER utilizará postgres): postgres (ejemplo)
   PostgreSQL - Clave  (ENTER para usar sin clave): xxxxxxxxxx
   PostgreSQL - Base de datos (ENTER utilizará toba_2_7): toba_2_7
   Toba - Clave (usuario "toba"): toba (ejemplo)

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
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:8081

    Por ejemplo, en un ambiente Debian, se puede editar como superusuario el archivo /etc/rc.local, y agregar:

    java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
    exit 0

Configuraciones adicionales

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.

1. Compilar metadatos
   1. 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.

   2. Editar el archivo 'aplicacion.php' (<path proyecto Guaraní>/www/aplicacion.php) y descomentar la siguiente línea:

      define('apex_pa_metadatos_compilados', 1);

   3. Adicionalmente, en ese mismo archivo se puede establecer el nivel de log máximo deseado:

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

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

1. http://localhost/guarani/3.13

   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.

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