SIU-Guarani/version3.20.0/instalacion/3w
Instalación de SIU-Guaraní 3w versión 3.20.x en entorno de Desarrollo o Producción
Es necesario tener instalada la versión 3.20.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.20.x: por la versión que se va a instalar
- En caso de estar instalando la versión en entorno de Producción:
- 3.20.x.y: por la versión propia que se va a instalar
Pasos para la instalación
- 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>.
- 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.20.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.20.x.y <path proyecto 3w>
- 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/
- 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)
- 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
- 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.
- 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>
- 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.
- 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
- Compilar los recursos en el servidor de producción:
- Dentro de la carpeta 'bin' (<path proyecto 3w>/bin)
- Este comando crea la carpeta <path proyecto 3w>/src_siu/www/_comp, se le deben dar los permisos arriba detallados../guarani compilar_recursos
Esta carpeta no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor.
- 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