SIU-Guarani/version3.21.0/instalacion/3w

Instalación de SIU-Guaraní 3w versión 3.21.x en entorno de Desarrollo o Producción

Es necesario tener instalada la versión 3.21.x de SIU-Guaraní Gestión para poder proceder con esta versión de SIU-Guaraní 3w y 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 3w>: por el path donde está instalado el proyecto
• <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
• En caso de estar instalando la versión en entorno de Desarrollo:
  • 3.21.x: por la versión que se va a instalar
• En caso de estar instalando la versión en entorno de Producción:
  • 3.21.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/g3w3

   Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto 3w>.

2. Bajar el proyecto del SVN desde la URL correspondiente en Colab:
   • Si se está actualizando en entorno de Desarrollo:

   svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/trunk/3.21.x <path proyecto 3w>

   • Si se está actualizando en entorno de Producción:

   svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/versiones/3.21.x.y <path proyecto 3w>

3. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario Apache pueda escribir
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/instalacion/log
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/instalacion/cache
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/instalacion/temp
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/instalacion/operaciones_inactivas
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/src/siu/www/js/escalas
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/src/siu/www/temp
   • sudo chown $(whoami):www-data -R <path proyecto 3w>/src/siu/www/_comp (esta carpeta se crea al ejecutar ./guarani compilar_recursos en la configuración del entorno de Producción)

   Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es www-data, debería ejecutarse:

   chown -R $(whoami):www-data instalacion/log/ instalacion/cache/ instalacion/temp/ instalacion/operaciones_inactivas/ src/siu/www/js/escalas/ src/siu/www/temp/
   chmod 775 -R instalacion/log/ instalacion/cache/ instalacion/temp/ instalacion/operaciones_inactivas/ src/siu/www/js/escalas/ src/siu/www/temp/

4. Editar los archivos de configuración

   Armar los archivos de configuración a partir de los templates. Dentro de la carpeta 'instalación' (<path proyecto 3w>/instalacion):

   cp alias_template.conf alias.conf
   cp config_template.php config.php
   cp login_template.php login.php

   Editar los archivos alias.conf y config.php (ver Configuración)

5. Instalar las dependencias del proyecto

   Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:

   Si se trata de un ambiente de desarrollo:

   composer install

   Si se trata de un ambiente de producción:

   composer install --prefer-dist --no-dev --optimize-autoloader

   La carpeta vendor se encuentra ignorada y jamas se debe subir al repositorio.

   Para mas información ver en la Documentación de Composer

6. Correr Jasper Reports (solo si Autogestión ha sido instalado en un servidor separado al de Gestión)

   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 3w>/vendor/siu-toba/jasper/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.

7. Configurar el servidor web

   Incluir el archivo instalacion/alias.conf en la configuración del servidor web. Ejecutar el siguiente comando como superusuario para realizar el link simbólico a la instalación:

   ln -s <path proyecto 3w>/instalacion/alias.conf /etc/apache2/sites-enabled/<nombre del alias>.conf

   Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: http://localhost/<nombre del alias>

8. Verificar la aplicación

   Realizar un test de conexión a la base de datos. Dentro de la carpeta 'bin' (<path proyecto 3w>/bin) ejecutar:

   ./guarani test_conexion <bloque de acceso>

   Donde <bloque de acceso> es el ID del bloque de acceso a testear la conexión

   Nota: si al correr el comando test_conexion o al ingresar a la aplicación muestra el mensaje "La extensión de php 'mcrypt' no está instalada." correr el siguiente comando sudo php5enmod mcrypt y luego reiniciar apache.

9. Agregar la url de Autogestión, en la directiva url3w del archivo de configuración instalacion.ini de Gestión antes del bloque [xslfo]

   url3w = "https://<url de Autogestion>"

Terminar de configurar - sólo si se está instalando el entorno de Producción

1. Compilar los recursos en el servidor de producción:

   Dentro de la carpeta 'bin' (<path proyecto 3w>/bin)

   ./guarani compilar_recursos

   Este comando crea la carpeta <path proyecto 3w>/src_siu/www/_comp, 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.

2. Activar el modo producción en el archivo de configuración (<path proyecto 3w>/instalacion/config.php).

   produccion: true

Si se estaba haciendo la actualización con personalizaciones, volver para terminar de configurar el entorno.

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