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

De SIU
Saltar a: navegación, buscar
(Página creada con «= Instalación desde cero de SIU-Guaraní Gestión 3.13 en entorno de Producción = === Requisitos previos === #Haber liberado una SIU-Guarani/version3.13.0/crear_versio...»)
 
Línea 3: Línea 3:
 
=== Requisitos previos ===
 
=== Requisitos previos ===
 
#Haber liberado una [[SIU-Guarani/version3.13.0/crear_version_propia/gestion|versión propia]] de cuatro dígitos (se hayan o no desarrollado personalizaciones).
 
#Haber liberado una [[SIU-Guarani/version3.13.0/crear_version_propia/gestion|versión propia]] de cuatro dígitos (se hayan o no desarrollado personalizaciones).
 
+
<br>
 
'''A lo largo de los pasos se deberá reemplazar:'''
 
'''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.
* <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.
** 3.13.x.y: por la versión propia que se va a instalar
 
  
 
=== Pasos para la instalación ===
 
=== Pasos para la instalación ===
Línea 63: Línea 62:
 
#Activar el esquema de auditoría. Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
#Activar el esquema de auditoría. Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
#:<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:
+
#Programar una tarea que levante la utilidad PHP-Java Bridge, necesaria para el motor de reportes Jasper Reports. El comando para activarlo es:
 
#:<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:8081</source>
#:'''Nota:''' sería recomendable programar una tarea con el comando anterior al iniciar el servidor.  
+
#:Por ejemplo, en un ambiente Debian, se puede editar como superusuario el archivo /etc/rc.local, y agregar:
 +
#:<source lang="php" enclose="div">
 +
java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
 +
exit 0
 +
</source>
 +
=== Configuraciones adicionales ===
 +
 
 +
En el archivo <tt><path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini</tt> establecer:
 +
<source lang="php" enclose="div">
 +
es_produccion = 1
 +
</source>
 +
 
 +
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 [[SIU-Guarani/Version3.13.0/personalizaciones/manejo_de_perfiles | Manejo de perfiles]]
 +
Para ello, en el archivo <tt><path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/instancia.ini</tt>, dentro de la sección destinada al proyecto (indicada por "[guarani]") configurar:
 +
<source lang="php" enclose="div">
 +
[guarani]
 +
usar_perfiles_propios = 1
 +
</source>
 +
La combinación de estos dos flags permite que la exportación de perfiles se haga en la carpeta <tt><path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/p__guarani/perfiles</tt> en lugar de la carpeta usual <tt><path proyecto Guaraní>/metadatos/permisos</tt>. Cuando se actualiza el sistema a una nueva versión, se mantienen los perfiles definidos localmente.
  
=== Configuraciones adicionales ===
 
# Seguir los pasos de: [[SIU-Guarani/version3.13.0/instalacion_desde_cero/configuracion_produccion_gestion|Configuración del servidor de producción]]
 
 
#Compilar metadatos
 
#Compilar metadatos
 
##Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
##Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
Línea 79: Línea 94:
 
##:<source lang="php" enclose="div">
 
##:<source lang="php" enclose="div">
 
define('apex_pa_metadatos_compilados', 1);
 
define('apex_pa_metadatos_compilados', 1);
 +
</source>
 +
##Adicionalmente, en ese mismo archivo se puede establecer el nivel de log máximo deseado:
 +
##:<source lang="php" enclose="div">
 +
define("apex_pa_log_archivo_nivel", 3); // 3: Error | 5: notice | 6: debug
 
</source>
 
</source>
  

Revisión del 12:42 28 abr 2017

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