SIU-Kolla/Version 4.7.0/instalacion desde cero
Sumario
Instalación desde cero
Durante la etapa de pruebas del módulo se recomienda realizar dos instalaciones: Una para los usuarios y otra para el equipo informático. De esta forma se logra independizar las pruebas que se realizan.
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.
Verificar requerimientos mínimos
Para poder comenzar con la instalación deben tener instalado el servidor web Apache (http://httpd.apache.org) con capacidad de interpretar scripts PHP. Por dudas sobre la instalación y/o configuración de alguno de estos servicios, comunicarse con el soporte técnico del SIU en https://comunidad.siu.edu.ar.
Las versiones recomendadas son:
- Apache 2.4.x
- PHP 7.3.x o superior, menor a 8 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip)
- PostgresSQL 10.x a 13
- Yarn
- Composer 2.x.x
Instalación
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el Portal de Servicios de Comunidad. Se pueden consultar mas detalles de cómo acceder al instalador en la sección Acceso a última versión.
2. Una vez descargado el instalador junto con el archivo de checksum y si se desea corroborar la autenticidad y la integridad del mismo, se debe correr el siguiente comando:
sha512sum -c instalador_kolla_4_7_0.rar.sha512.txt
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.
4. Ingresar al directorio y ejecutar:
composer install --no-dev
5. Copiar el archivo instalador.env.dist y renombrar a instalador.env. En linux se puede utilizar el siguiente comando:
cp -a instalador.env.dist instalador.env
6. Configurar archivo instalador.env
Configurar el archivo instalador.env con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Kolla y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).
###### CONFIG DE TOBA ######
TOBA_URL_BASE="http://localhost"
TOBA_USUARIO="<usuario admin inicial>"
TOBA_PASSWORD="<contraseña para el usuario admin>"
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"
TOBA_ALIAS_NUCLEO="<alias para toba>"
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
chmod +x bin/instalador
8. Ejecutar el instalador de la siguiente manera:
./bin/instalador proyecto:instalar
9. Revisar el archivo instalador.log para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:
tail -f instalador.log
10. Seguir las instrucciones que brinda el instalador para:
- Acomodar permisos de archivos y direcotorios
sudo ./bin/instalador permisos:simple
- Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
- Quitar el modo mantenimiento del proyecto
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
11. Reiniciar el servidor web para que tome los nuevos cambios.
Para obtener mas ayuda sobre el comando de instalación ejecutar
./bin/instalador proyecto:instalar -h
Configuración adicional
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.
Habilitaciones públicas
Configurar el acceso a Habilitaciones Públicas (desde 4.2.0). Editar el archivo "../kolla/instalacion/toba.conf", dentro de los tags <Directory> </Directory> de la sección #Proyecto: kolla se debe agregar la siguiente linea:
RewriteRule ^responder(.*)$ publica.php$1 [L]
Reiniciar Apache para que esta modificación impacte correctamente.
Protocolo HTTPS y acceso con certificado de seguridad
Si el servidor está configurado para armar URLs seguras con protocolo HTTPS habrá que editar el archivo instancia.ini (ubicado en el directorio de instalación de SIU-Kolla/kolla/instalacion/i__produccion) y agregar la siguiente línea dentro de la sección [kolla]:
protocolo_url_post_form_externo = 'https'
Datos iniciales
Al instalar la aplicación por primera vez, el Instalador se encargará de crear la base de datos, y en ella parte de los datos básicos iniciales necesarios para comenzar a utilizar la aplicación.
Hay además algunos seteos que serán necesarios realizar antes de comenzar a usar SIU-Kolla, tales como la configuración del servidor de mail si no se hizo durante la instalación. Esta configuración es necesaria para poder habilitar el ingreso de los encuestados al sistema.
Por otro lado, entre el set de datos iniciales se incluye la definición completa una serie de encuestas pre-cargadas en SIU-Kolla, disponibles inicialmente para la Unidad de Gestión Predeterminada:
- Encuestas para el seguimiento de graduados
- Encuestas para el acompañamiento al estudio de desgranamiento universitario
- Formulario de solicitudes de becas
También se incluyen los conjuntos de datos de instituciones, tipos de instituciones, responsables académicas, tipos de responsables académicas y títulos de SIU-Araucano, así como también el módulo de Ubicación Geográfica (continentes, países, provincias, partidos y localidades).
Inicialmente el único usuario habilitado en la aplicación será el indicado durante el proceso de instalación, el cual tendrá el perfil de Administrador de la aplicación.
Gestionar el acceso de usuarios
La creación de los usuarios de SIU-Kolla se realiza desde el menú Usuarios, opción Administración. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.
El perfil de acceso permite establecer el conjunto de operaciones que estarán habilitadas para el ingreso y cómo se identificará al usuario en la aplicación. Existen cuatro perfiles: Administrador, Gestor, Encuesta y Anónimo:
- Administrador: permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.
- Gestor: permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.
- Encuesta: este perfil le corresponde a los encuestados que se identificarán en la aplicación para responder la(s) encuesta(s) que les hayan sido asignadas.
- Anónimo: es una especialización del tipo de usuario encuestado, en el cual no se registran datos. Es útil para realizar encuestas donde las respuestas deben ser anónimas.
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.
