https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&user=Rmiranda&feedformat=atomSIU - Contribuciones del usuario [es]2024-03-28T14:15:53ZContribuciones del usuarioMediaWiki 1.30.0https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/version4.7.0&diff=93317SIU-Kolla/version4.7.02023-07-17T12:39:34Z<p>Rmiranda: </p>
<hr />
<div> __NOTOC__<br />
[[Archivo:siu-kolla.png|derecha|link=SIU-Kolla]]<br />
<br />
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;"><br />
<p style="margin: 0; padding: 0;">Número de última versión: <strong>4.7.3</strong></p><br />
<p style="margin: 0; padding: 0;">Fecha de publicación: '''11/07/2023'''</p><br />
<p style="margin: 0; padding: 0;"> '''<big>[[SIU-Kolla/version4.7.0/Principales mejoras|★ Principales novedades y mejoras]]</big>''' </p><br />
</div><br />
<p style="clear: both;"></p><br />
{|<br />
|-<br />
! <p style="text-align: left; font-size: 18px; font-weight: bold; color: #297a9b;">http://portal.comunidad.siu.edu.ar/images/iconos/boton_funcional_2.png<br><br>Documentación Funcional</p> !! &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; !! <p style="text-align: left; font-size: 18px; font-weight: bold; color: #297a9b;">http://portal.comunidad.siu.edu.ar/images/iconos/boton_tecnico_2.png<br><br>Documentación Técnica</p><br />
|-<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Glosario_de_conceptos|Glosario de conceptos]] ||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; || [[SIU-Kolla/Version 4.7.0/instalacion_desde_cero|Instalación del paquete desde cero]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Primeros_pasos|Primeros pasos]] || &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; || [[SIU-Kolla/Version 4.7.0/actualizacion|Actualizar desde una versión anterior]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Encuestas_precargadas|Encuestas precargadas]] <br />
||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ||[[SIU-Kolla/correspondencia entre versiones|Correspondencia entre versiones]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Aspectos_generales_de_las_operaciones|Aspectos generales de las operaciones]] <br />
||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; || [[SIU-Kolla/Version 4.7.0/interfaces|Conexión con otros módulos]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Documentacion_de_las_operaciones|Documentación de las operaciones]] <br />
||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ||[[SIU-Kolla/Version 4.7.0/anonimizador|Anonimizador de base de datos]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/Principales_circuitos_funcionales|Principales circuitos funcionales]] ||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ||[[SIU-Kolla/Version 4.7.0/preguntas.frecuentes|Preguntas frecuentes]]<br />
|-<br />
| [[SIU-Kolla/Version 4.7.0/preguntas_frecuentes|Preguntas frecuentes]] ||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ||[[SIU-Kolla/Version 4.7.0/Contacto|Contactanos]]<br />
|-<br />
|[[SIU-Kolla/Version 4.7.0/Contactanos|Contactanos]] || &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; || <br />
|- }<br />
|}</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces&diff=90183SIU-Kolla/Version 4.8.0/interfaces2023-03-22T13:05:26Z<p>Rmiranda: </p>
<hr />
<div>__TOC__<br />
[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.8.0]]<br />
<br />
== Introducción ==<br />
<br />
Para lograr una comunicación con otros módulos SIU-Kolla ofrece diferentes servicios web a través de su API para la manipulación de entidades básicas. En algunos casos, lo servicios sólo involucran la recuperación de datos y, en otros, ofrecen un CRUD (Create-Retrieve-Update-Delete).<br />
<br />
== Configuración para SIU-Guaraní y otros ==<br />
<br />
Para poder utilizar los Servicios Web se debe dar de alta el usuarios como Sistema Externo y, posteriormente, configurar dicho usuario en la configuración REST del proyecto:<br />
<br />
=== Creación de usuario como Sistema Externo ===<br />
<br />
''Para registrar un Sistema Externo visite la siguiente [[SIU-Kolla/Version 4.8.0/Documentacion de las operaciones/menu usuarios sistemas externos|página]].''<br />
<br />
=== Creación de usuario REST ===<br />
<br />
Editar el archivo <tt><path_kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor.ini</tt> para la definición de las rutas de las versiones de la API REST:<br />
<source lang="php" enclose="div"><br />
;servidor.ini<br />
autenticacion = basic <br />
<br />
; Configuración de paths para las versiones de la api<br />
[v1]<br />
path_api=<path_kolla>/php/rest/v1<br />
</source><br />
<br />
y <tt><path_kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor_usuarios.ini</tt><source lang="php" enclose="div"><br />
;servidor_usuarios.ini<br />
[<nombre de usuario>]<br />
password = sP6lgHwQopaqepOzgIWw ;cambiar!<br />
</source><br />
Se debe reemplazar:<br />
* <path_kolla>: por el path donde se encuentra instalado el proyecto SIU-Kolla<br />
* <instancia>: por el nombre de la instancia<br />
<br />
Para más información, consultar la explicación de [https://documentacion.siu.edu.ar/toba/docs/referencia-rest/ REST de Toba].<br />
<br />
== Configuración para SIU-Araí ==<br />
A continuación se detallan los puntos a tener en cuenta para configurar la conexión de SIU-Kolla con SIU-Araí.<br />
<br />
Una vez completados estos puntos se deberá proceder a realizar la configuración restante desde SIU-Araí (ver [[SIU-Arai/Modulos|'''documentación''']]).<br />
<br />
=== Crear datos de usuario rest para Araí Usuarios ===<br />
Editar el archivo <tt><path_kolla>/instalacion/i__<instancia>/p__kolla/rest/rest_arai_usuarios/cliente.ini</tt><br />
<br />
<source lang="php" enclose="div"><br />
[conexion]<br />
auth_usuario = nombre_usuario<br />
auth_password = password_usuario<br />
</source><br />
<br />
=== Editar archivo de instancia ===<br />
Asegurarse que en el archivo '''instancia.ini''' este incorporado la variable '''full_url''' con la dirección completa de Kolla.<br />
<br />
<source lang="php" enclose="div"><br />
[kolla]<br />
full_url = "http://direccion_completa_a_kolla"<br />
</source><br />
<br />
=== Editar archivo de proyecto ===<br />
Asegurarse que en el archivo '''proyecto.ini''' este incorporado la variable '''app_launcher''' activa'''.'''<br />
<source lang="php" enclose="div"><br />
[proyecto]<br />
app_launcher = 1<br />
</source><br />
<br />
=== Editar archivo de configuración para Araí ===<br />
Verificar que los datos provistos en el archivo <tt><path_kolla>/arai.json</tt>.<br />
<br />
A continuación detallamos un ejemplo básico para presentar una instalación de Kolla.<br />
<br />
Si desea obtener más detalles de cómo conformar este archivo, por favor visite en la [[SIU-Arai/usuarios/integracion-inicial-toba|'''documentación''']] el apartado ''Integrar a Arai-Registry la aplicación''.<br />
<source lang="php" enclose="div"><br />
{<br />
"name": "siu/kolla",<br />
"description": "SIU-Kolla, aplicación",<br />
"scripts": {<br />
"hooks": "SIU\\kolla\\AraiRegistryHooks"<br />
},<br />
"provide": [<br />
{<br />
"name": "app:siu/kolla",<br />
"alias": "Kolla",<br />
"description": "sistema de encuestas",<br />
"version": "4.8.0",<br />
"icon": "./www/img/logo-kolla-iso.png"<br />
}<br />
],<br />
"consume": [<br />
{<br />
"name": "service:siu/sso-saml-idp",<br />
"version": ">=0.1.0"<br />
},<br />
{<br />
"name": "api:siu/arai-usuarios",<br />
"version": ">=0.1.0",<br />
"options": {<br />
"toba-rest": [<br />
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }<br />
]<br />
}<br />
}<br />
]<br />
}<br />
</source><br />
<br />
=== Generar clave ===<br />
Para la vinculación será necesario contar con la clave de encriptación. Para generarla, será necesario correr el siguiente comando:<br />
<br />
<source lang="php" enclose="div"><br />
bin/arai-cli arai:generar-key --destino=<ruta_a_la_llave_de_encriptacion>arai-sync.key<br />
</source><br />
<br />
Luego dirigirse al archivo <code><path_kolla>/instalacion/instalacion.ini</code> y agregar la siguiente entrada con la ruta a la llave:<br />
<br />
<source lang="php" enclose="div"><br />
arai_sync_key_file= "<ruta_a_la_llave_de_encriptacion>/arai-sync.key"<br />
</source><br />
<br />
=== Registrar SIU-Kolla en SIU-Araí ===<br />
El administrador de SIU-Araí deberá registrar el módulo mediante el comando:<source lang="php" enclose="div"><br />
bin/arai-cli registry:add --maintainer nombre-encargado-admin --maintainer-email email-encargado-admin@uni.edu.ar http://url-arai-registry/arai-registry<br />
<br />
./bin/arai-cli registry:sync --aceptar-pedidos-acceso<br />
</source><blockquote>''<u>Nota</u>: recordar tener ingresadas las variables de entorno correspondientes al usuario y password de registry''</blockquote><blockquote>'''''export ARAI_REGISTRY_USER=usuario_registry''''' </blockquote><blockquote>'''''export ARAI_REGISTRY_PASS=password_registry'''''</blockquote><br />
<br />
=== Sincronizar SIU-Kolla en SIU-Araí ===<br />
Finalmente desde SIU-Araí deberá sincronizarse SIU-Kolla para que efectivamente sea incorporada la nueva vinculación:<source lang="php" enclose="div"><br />
bin/arai-cli registry:sync<br />
</source><br />
<br />
=== Importar Cuentas ===<br />
Para que las cuentas existentes en SIU-Kolla puedan utilizarse vinculadas será necesario realizar la exportación de dichas cuentas desde Kolla y luego importarlas desde Araí Usuarios. Para exportarlas se deberá ejecutar el siguiente comando:<source lang="php" enclose="div"><br />
toba proyecto exportar_usuarios_arai<br />
</source><br />
<br />
El comando anterior generará un archivo json que, luego, deberá utilizarse como entrada del siguiente comando en Araí Usuarios:<source lang="php" enclose="div"><br />
toba proyecto importar_usuarios_arai -f <ruta_al_archivo_generado> -m comparador<br />
</source><br />
<br />
Notar que al momento de importar, las cuentas deben ser identificadas por el Tipo y Nro. de Documento (el argumento de -m debe ser 1). Si alguna cuenta no es vinculada correctamente, el administrador de la plataforma Araí puede resolver manualmente los casos con conflictos.<br />
<br />
Para mayor información sobre la importación de cuentas dirigirse al siguiente [[SIU-Arai/Administrar#Importar cuentas desde una aplicaci.C3.B3n vinculada|enlace]], sección '''Importar cuentas desde una aplicación vinculada'''.<br />
<br />
== Posibles errores en las peticiones ==<br />
<br />
* '''480''': Errores de validación. Uno o más atributos de la entidad que se quiere guardar no paso la validación. El servicio retorna un arreglo con la descripción de cada uno de los errores.<br />
* '''424''': Usualmente ocurre cuando el recurso que se intenta manipular o recuperar no existe. Podrá sera cualquiera de las entidades involucradas (Por ejemplo, la [[SIU-Kolla/Version 4.8.0/Glosario de conceptos#U|Unidad de Gestión]] no existe).<br />
* '''500''': Error interno en el servidor, deberá revisarse el mensaje enviado al cliente.<br />
<br />
<br><br />
[[SIU-Kolla/version4.8.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces&diff=90182SIU-Kolla/Version 4.8.0/interfaces2023-03-22T13:03:51Z<p>Rmiranda: </p>
<hr />
<div>__TOC__<br />
[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.8.0]]<br />
<br />
== Introducción ==<br />
<br />
Para lograr una comunicación con otros módulos SIU-Kolla ofrece diferentes servicios web a través de su API para la manipulación de entidades básicas. En algunos casos, lo servicios sólo involucran la recuperación de datos y, en otros, ofrecen un CRUD (Create-Retrieve-Update-Delete).<br />
<br />
== Configuración para SIU-Guaraní y otros ==<br />
<br />
Para poder utilizar los Servicios Web se debe dar de alta el usuarios como Sistema Externo y, posteriormente, configurar dicho usuario en la configuración REST del proyecto:<br />
<br />
=== Creación de usuario como Sistema Externo ===<br />
<br />
''Para registrar un Sistema Externo visite la siguiente [[SIU-Kolla/Version 4.8.0/Documentacion de las operaciones/menu usuarios sistemas externos|página]].''<br />
<br />
=== Creación de usuario REST ===<br />
<br />
Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor.ini</tt> para la definición de las rutas de las versiones de la API REST:<br />
<source lang="php" enclose="div"><br />
;servidor.ini<br />
autenticacion = basic <br />
<br />
; Configuración de paths para las versiones de la api<br />
[v1]<br />
path_api=<path_kolla>/php/rest/v1<br />
</source><br />
<br />
y <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor_usuarios.ini</tt><source lang="php" enclose="div"><br />
;servidor_usuarios.ini<br />
[<nombre de usuario>]<br />
password = sP6lgHwQopaqepOzgIWw ;cambiar!<br />
</source><br />
Se debe reemplazar:<br />
* <path proyecto Kolla>: por el path donde se encuentra instalado el proyecto SIU-Kolla<br />
* <instancia>: por el nombre de la instancia<br />
<br />
Para más información, consultar la explicación de [https://documentacion.siu.edu.ar/toba/docs/referencia-rest/ REST de Toba].<br />
<br />
== Configuración para SIU-Araí ==<br />
A continuación se detallan los puntos a tener en cuenta para configurar la conexión de SIU-Kolla con SIU-Araí.<br />
<br />
Una vez completados estos puntos se deberá proceder a realizar la configuración restante desde SIU-Araí (ver [[SIU-Arai/Modulos|'''documentación''']]).<br />
<br />
=== Crear datos de usuario rest para Araí Usuarios ===<br />
Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/rest_arai_usuarios/cliente.ini</tt><br />
<br />
<source lang="php" enclose="div"><br />
[conexion]<br />
auth_usuario = nombre_usuario<br />
auth_password = password_usuario<br />
</source><br />
<br />
=== Editar archivo de instancia ===<br />
Asegurarse que en el archivo '''instancia.ini''' este incorporado la variable '''full_url''' con la dirección completa de Kolla.<br />
<br />
<source lang="php" enclose="div"><br />
[kolla]<br />
full_url = "http://direccion_completa_a_kolla"<br />
</source><br />
<br />
=== Editar archivo de proyecto ===<br />
Asegurarse que en el archivo '''proyecto.ini''' este incorporado la variable '''app_launcher''' activa'''.'''<br />
<source lang="php" enclose="div"><br />
[proyecto]<br />
app_launcher = 1<br />
</source><br />
<br />
=== Editar archivo de configuración para Araí ===<br />
Verificar que los datos provistos en el archivo <tt><path proyecto Kolla>/arai.json</tt>.<br />
<br />
A continuación detallamos un ejemplo básico para presentar una instalación de Kolla.<br />
<br />
Si desea obtener más detalles de cómo conformar este archivo, por favor visite en la [[SIU-Arai/usuarios/integracion-inicial-toba|'''documentación''']] el apartado ''Integrar a Arai-Registry la aplicación''.<br />
<source lang="php" enclose="div"><br />
{<br />
"name": "siu/kolla",<br />
"description": "SIU-Kolla, aplicación",<br />
"scripts": {<br />
"hooks": "SIU\\kolla\\AraiRegistryHooks"<br />
},<br />
"provide": [<br />
{<br />
"name": "app:siu/kolla",<br />
"alias": "Kolla",<br />
"description": "sistema de encuestas",<br />
"version": "4.8.0",<br />
"icon": "./www/img/logo-kolla-iso.png"<br />
}<br />
],<br />
"consume": [<br />
{<br />
"name": "service:siu/sso-saml-idp",<br />
"version": ">=0.1.0"<br />
},<br />
{<br />
"name": "api:siu/arai-usuarios",<br />
"version": ">=0.1.0",<br />
"options": {<br />
"toba-rest": [<br />
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }<br />
]<br />
}<br />
}<br />
]<br />
}<br />
</source><br />
<br />
=== Generar clave ===<br />
Para la vinculación será necesario contar con la clave de encriptación. Para generarla, será necesario correr el siguiente comando:<br />
<br />
<source lang="php" enclose="div"><br />
bin/arai-cli arai:generar-key --destino=<ruta_a_la_llave_de_encriptacion>arai-sync.key<br />
</source><br />
<br />
Luego dirigirse al archivo <code><ruta_al_proyecto>/instalacion/instalacion.ini</code> y agregar la siguiente entrada con la ruta a la llave:<br />
<br />
<source lang="php" enclose="div"><br />
arai_sync_key_file= "<ruta_a_la_llave_de_encriptacion>/arai-sync.key"<br />
</source><br />
<br />
=== Registrar SIU-Kolla en SIU-Araí ===<br />
El administrador de SIU-Araí deberá registrar el módulo mediante el comando:<source lang="php" enclose="div"><br />
bin/arai-cli registry:add --maintainer nombre-encargado-admin --maintainer-email email-encargado-admin@uni.edu.ar http://url-arai-registry/arai-registry<br />
<br />
./bin/arai-cli registry:sync --aceptar-pedidos-acceso<br />
</source><blockquote>''<u>Nota</u>: recordar tener ingresadas las variables de entorno correspondientes al usuario y password de registry''</blockquote><blockquote>'''''export ARAI_REGISTRY_USER=usuario_registry''''' </blockquote><blockquote>'''''export ARAI_REGISTRY_PASS=password_registry'''''</blockquote><br />
<br />
=== Sincronizar SIU-Kolla en SIU-Araí ===<br />
Finalmente desde SIU-Araí deberá sincronizarse SIU-Kolla para que efectivamente sea incorporada la nueva vinculación:<source lang="php" enclose="div"><br />
bin/arai-cli registry:sync<br />
</source><br />
<br />
=== Importar Cuentas ===<br />
Para que las cuentas existentes en SIU-Kolla puedan utilizarse vinculadas será necesario realizar la exportación de dichas cuentas desde Kolla y luego importarlas desde Araí Usuarios. Para exportarlas se deberá ejecutar el siguiente comando:<source lang="php" enclose="div"><br />
toba proyecto exportar_usuarios_arai<br />
</source><br />
<br />
El comando anterior generará un archivo json que, luego, deberá utilizarse como entrada del siguiente comando en Araí Usuarios:<source lang="php" enclose="div"><br />
toba proyecto importar_usuarios_arai -f <ruta_al_archivo_generado> -m comparador<br />
</source><br />
<br />
Notar que al momento de importar, las cuentas deben ser identificadas por el Tipo y Nro. de Documento (el argumento de -m debe ser 1). Si alguna cuenta no es vinculada correctamente, el administrador de la plataforma Araí puede resolver manualmente los casos con conflictos.<br />
<br />
Para mayor información sobre la importación de cuentas dirigirse al siguiente [[SIU-Arai/Administrar#Importar cuentas desde una aplicaci.C3.B3n vinculada|enlace]], sección '''Importar cuentas desde una aplicación vinculada'''.<br />
<br />
== Posibles errores en las peticiones ==<br />
<br />
* '''480''': Errores de validación. Uno o más atributos de la entidad que se quiere guardar no paso la validación. El servicio retorna un arreglo con la descripción de cada uno de los errores.<br />
* '''424''': Usualmente ocurre cuando el recurso que se intenta manipular o recuperar no existe. Podrá sera cualquiera de las entidades involucradas (Por ejemplo, la [[SIU-Kolla/Version 4.8.0/Glosario de conceptos#U|Unidad de Gestión]] no existe).<br />
* '''500''': Error interno en el servidor, deberá revisarse el mensaje enviado al cliente.<br />
<br />
<br><br />
[[SIU-Kolla/version4.8.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces&diff=90181SIU-Kolla/Version 4.8.0/interfaces2023-03-22T13:02:28Z<p>Rmiranda: </p>
<hr />
<div>__TOC__<br />
[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.8.0]]<br />
<br />
== Introducción ==<br />
<br />
Para lograr una comunicación con otros módulos SIU-Kolla ofrece diferentes servicios web a través de su API para la manipulación de entidades básicas. En algunos casos, lo servicios sólo involucran la recuperación de datos y, en otros, ofrecen un CRUD (Create-Retrieve-Update-Delete).<br />
<br />
== Configuración para SIU-Guaraní y otros ==<br />
<br />
Para poder utilizar los Servicios Web se debe dar de alta el usuarios como Sistema Externo y, posteriormente, configurar dicho usuario en la configuración REST del proyecto:<br />
<br />
=== Creación de usuario como Sistema Externo ===<br />
<br />
''Para registrar un Sistema Externo visite la siguiente [[SIU-Kolla/Version 4.8.0/Documentacion de las operaciones/menu usuarios sistemas externos|página]].''<br />
<br />
=== Creación de usuario REST ===<br />
<br />
* Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor.ini</tt><br />
<source lang="php" enclose="div"><br />
;servidor.ini<br />
autenticacion = basic <br />
<br />
; Configuración de paths para las versiones de la api<br />
[v1]<br />
path_api=<path_kolla>/php/rest/v1<br />
</source><br />
<br />
y <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor_usuarios.ini</tt><source lang="php" enclose="div"><br />
;servidor_usuarios.ini<br />
[<nombre de usuario>]<br />
password = sP6lgHwQopaqepOzgIWw ;cambiar!<br />
</source><br />
* Se debe reemplazar:<br />
** <path proyecto Kolla>: por el path donde se encuentra instalado el proyecto SIU-Kolla<br />
** <instancia>: por el nombre de la instancia<br />
<br />
Para más información, consultar la explicación de [https://documentacion.siu.edu.ar/toba/docs/referencia-rest/ REST de Toba].<br />
<br />
== Configuración para SIU-Araí ==<br />
A continuación se detallan los puntos a tener en cuenta para configurar la conexión de SIU-Kolla con SIU-Araí.<br />
<br />
Una vez completados estos puntos se deberá proceder a realizar la configuración restante desde SIU-Araí (ver [[SIU-Arai/Modulos|'''documentación''']]).<br />
<br />
=== Crear datos de usuario rest para Araí Usuarios ===<br />
Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/rest_arai_usuarios/cliente.ini</tt><br />
<br />
<source lang="php" enclose="div"><br />
[conexion]<br />
auth_usuario = nombre_usuario<br />
auth_password = password_usuario<br />
</source><br />
<br />
=== Editar archivo de instancia ===<br />
Asegurarse que en el archivo '''instancia.ini''' este incorporado la variable '''full_url''' con la dirección completa de Kolla.<br />
<br />
<source lang="php" enclose="div"><br />
[kolla]<br />
full_url = "http://direccion_completa_a_kolla"<br />
</source><br />
<br />
=== Editar archivo de proyecto ===<br />
Asegurarse que en el archivo '''proyecto.ini''' este incorporado la variable '''app_launcher''' activa'''.'''<br />
<source lang="php" enclose="div"><br />
[proyecto]<br />
app_launcher = 1<br />
</source><br />
<br />
=== Editar archivo de configuración para Araí ===<br />
Verificar que los datos provistos en el archivo <tt><path proyecto Kolla>/arai.json</tt>.<br />
<br />
A continuación detallamos un ejemplo básico para presentar una instalación de Kolla.<br />
<br />
Si desea obtener más detalles de cómo conformar este archivo, por favor visite en la [[SIU-Arai/usuarios/integracion-inicial-toba|'''documentación''']] el apartado ''Integrar a Arai-Registry la aplicación''.<br />
<source lang="php" enclose="div"><br />
{<br />
"name": "siu/kolla",<br />
"description": "SIU-Kolla, aplicación",<br />
"scripts": {<br />
"hooks": "SIU\\kolla\\AraiRegistryHooks"<br />
},<br />
"provide": [<br />
{<br />
"name": "app:siu/kolla",<br />
"alias": "Kolla",<br />
"description": "sistema de encuestas",<br />
"version": "4.8.0",<br />
"icon": "./www/img/logo-kolla-iso.png"<br />
}<br />
],<br />
"consume": [<br />
{<br />
"name": "service:siu/sso-saml-idp",<br />
"version": ">=0.1.0"<br />
},<br />
{<br />
"name": "api:siu/arai-usuarios",<br />
"version": ">=0.1.0",<br />
"options": {<br />
"toba-rest": [<br />
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }<br />
]<br />
}<br />
}<br />
]<br />
}<br />
</source><br />
<br />
=== Generar clave ===<br />
Para la vinculación será necesario contar con la clave de encriptación. Para generarla, será necesario correr el siguiente comando:<br />
<br />
<source lang="php" enclose="div"><br />
bin/arai-cli arai:generar-key --destino=<ruta_a_la_llave_de_encriptacion>arai-sync.key<br />
</source><br />
<br />
Luego dirigirse al archivo <code><ruta_al_proyecto>/instalacion/instalacion.ini</code> y agregar la siguiente entrada con la ruta a la llave:<br />
<br />
<source lang="php" enclose="div"><br />
arai_sync_key_file= "<ruta_a_la_llave_de_encriptacion>/arai-sync.key"<br />
</source><br />
<br />
=== Registrar SIU-Kolla en SIU-Araí ===<br />
El administrador de SIU-Araí deberá registrar el módulo mediante el comando:<source lang="php" enclose="div"><br />
bin/arai-cli registry:add --maintainer nombre-encargado-admin --maintainer-email email-encargado-admin@uni.edu.ar http://url-arai-registry/arai-registry<br />
<br />
./bin/arai-cli registry:sync --aceptar-pedidos-acceso<br />
</source><blockquote>''<u>Nota</u>: recordar tener ingresadas las variables de entorno correspondientes al usuario y password de registry''</blockquote><blockquote>'''''export ARAI_REGISTRY_USER=usuario_registry''''' </blockquote><blockquote>'''''export ARAI_REGISTRY_PASS=password_registry'''''</blockquote><br />
<br />
=== Sincronizar SIU-Kolla en SIU-Araí ===<br />
Finalmente desde SIU-Araí deberá sincronizarse SIU-Kolla para que efectivamente sea incorporada la nueva vinculación:<source lang="php" enclose="div"><br />
bin/arai-cli registry:sync<br />
</source><br />
<br />
=== Importar Cuentas ===<br />
Para que las cuentas existentes en SIU-Kolla puedan utilizarse vinculadas será necesario realizar la exportación de dichas cuentas desde Kolla y luego importarlas desde Araí Usuarios. Para exportarlas se deberá ejecutar el siguiente comando:<source lang="php" enclose="div"><br />
toba proyecto exportar_usuarios_arai<br />
</source><br />
<br />
El comando anterior generará un archivo json que, luego, deberá utilizarse como entrada del siguiente comando en Araí Usuarios:<source lang="php" enclose="div"><br />
toba proyecto importar_usuarios_arai -f <ruta_al_archivo_generado> -m comparador<br />
</source><br />
<br />
Notar que al momento de importar, las cuentas deben ser identificadas por el Tipo y Nro. de Documento (el argumento de -m debe ser 1). Si alguna cuenta no es vinculada correctamente, el administrador de la plataforma Araí puede resolver manualmente los casos con conflictos.<br />
<br />
Para mayor información sobre la importación de cuentas dirigirse al siguiente [[SIU-Arai/Administrar#Importar cuentas desde una aplicaci.C3.B3n vinculada|enlace]], sección '''Importar cuentas desde una aplicación vinculada'''.<br />
<br />
== Posibles errores en las peticiones ==<br />
<br />
* '''480''': Errores de validación. Uno o más atributos de la entidad que se quiere guardar no paso la validación. El servicio retorna un arreglo con la descripción de cada uno de los errores.<br />
* '''424''': Usualmente ocurre cuando el recurso que se intenta manipular o recuperar no existe. Podrá sera cualquiera de las entidades involucradas (Por ejemplo, la [[SIU-Kolla/Version 4.8.0/Glosario de conceptos#U|Unidad de Gestión]] no existe).<br />
* '''500''': Error interno en el servidor, deberá revisarse el mensaje enviado al cliente.<br />
<br />
<br><br />
[[SIU-Kolla/version4.8.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces&diff=90180SIU-Kolla/Version 4.8.0/interfaces2023-03-22T12:56:36Z<p>Rmiranda: </p>
<hr />
<div>__TOC__<br />
[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.8.0]]<br />
<br />
== Introducción ==<br />
<br />
Para lograr una comunicación con otros módulos SIU-Kolla ofrece diferentes servicios web a través de su API para la manipulación de entidades básicas. En algunos casos, lo servicios sólo involucran la recuperación de datos y, en otros, ofrecen un CRUD (Create-Retrieve-Update-Delete).<br />
<br />
== Configuración para SIU-Guaraní y otros ==<br />
<br />
Para poder utilizar los Servicios Web se debe dar de alta el usuarios como Sistema Externo y, posteriormente, configurar dicho usuario en la configuración REST del proyecto:<br />
<br />
=== Creación de usuario como Sistema Externo ===<br />
<br />
''Para registrar un Sistema Externo visite la siguiente [[SIU-Kolla/Version 4.8.0/Documentacion de las operaciones/menu usuarios sistemas externos|página]].''<br />
=== Creación de usuario REST ===<br />
* Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor.ini</tt><br />
<source lang="php" enclose="div"><br />
;servidor.ini<br />
autenticacion = basic <br />
</source><br />
<br />
y <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor_usuarios.ini</tt><source lang="php" enclose="div"><br />
;servidor_usuarios.ini<br />
[<nombre de usuario>]<br />
password = sP6lgHwQopaqepOzgIWw ;cambiar!<br />
</source><br />
* Se debe reemplazar:<br />
** <path proyecto Kolla>: por el path donde se encuentra instalado el proyecto SIU-Kolla<br />
** <instancia>: por el nombre de la instancia<br />
<br />
Para más información, consultar la explicación de [https://documentacion.siu.edu.ar/toba/docs/referencia-rest/ REST de Toba].<br />
<br />
== Configuración para SIU-Araí ==<br />
A continuación se detallan los puntos a tener en cuenta para configurar la conexión de SIU-Kolla con SIU-Araí.<br />
<br />
Una vez completados estos puntos se deberá proceder a realizar la configuración restante desde SIU-Araí (ver [[SIU-Arai/Modulos|'''documentación''']]).<br />
<br />
=== Crear datos de usuario rest para Araí Usuarios ===<br />
Editar el archivo <tt><path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/rest_arai_usuarios/cliente.ini</tt><br />
<br />
<source lang="php" enclose="div"><br />
[conexion]<br />
auth_usuario = nombre_usuario<br />
auth_password = password_usuario<br />
</source><br />
<br />
=== Editar archivo de instancia ===<br />
Asegurarse que en el archivo '''instancia.ini''' este incorporado la variable '''full_url''' con la dirección completa de Kolla.<br />
<br />
<source lang="php" enclose="div"><br />
[kolla]<br />
full_url = "http://direccion_completa_a_kolla"<br />
</source><br />
<br />
=== Editar archivo de proyecto ===<br />
Asegurarse que en el archivo '''proyecto.ini''' este incorporado la variable '''app_launcher''' activa'''.'''<br />
<source lang="php" enclose="div"><br />
[proyecto]<br />
app_launcher = 1<br />
</source><br />
<br />
=== Editar archivo de configuración para Araí ===<br />
Verificar que los datos provistos en el archivo <tt><path proyecto Kolla>/arai.json</tt>.<br />
<br />
A continuación detallamos un ejemplo básico para presentar una instalación de Kolla.<br />
<br />
Si desea obtener más detalles de cómo conformar este archivo, por favor visite en la [[SIU-Arai/usuarios/integracion-inicial-toba|'''documentación''']] el apartado ''Integrar a Arai-Registry la aplicación''.<br />
<source lang="php" enclose="div"><br />
{<br />
"name": "siu/kolla",<br />
"description": "SIU-Kolla, aplicación",<br />
"scripts": {<br />
"hooks": "SIU\\kolla\\AraiRegistryHooks"<br />
},<br />
"provide": [<br />
{<br />
"name": "app:siu/kolla",<br />
"alias": "Kolla",<br />
"description": "sistema de encuestas",<br />
"version": "4.8.0",<br />
"icon": "./www/img/logo-kolla-iso.png"<br />
}<br />
],<br />
"consume": [<br />
{<br />
"name": "service:siu/sso-saml-idp",<br />
"version": ">=0.1.0"<br />
},<br />
{<br />
"name": "api:siu/arai-usuarios",<br />
"version": ">=0.1.0",<br />
"options": {<br />
"toba-rest": [<br />
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }<br />
]<br />
}<br />
}<br />
]<br />
}<br />
</source><br />
<br />
=== Generar clave ===<br />
Para la vinculación será necesario contar con la clave de encriptación. Para generarla, será necesario correr el siguiente comando:<br />
<br />
<source lang="php" enclose="div"><br />
bin/arai-cli arai:generar-key --destino=<ruta_a_la_llave_de_encriptacion>arai-sync.key<br />
</source><br />
<br />
Luego dirigirse al archivo <code><ruta_al_proyecto>/instalacion/instalacion.ini</code> y agregar la siguiente entrada con la ruta a la llave:<br />
<br />
<source lang="php" enclose="div"><br />
arai_sync_key_file= "<ruta_a_la_llave_de_encriptacion>/arai-sync.key"<br />
</source><br />
<br />
=== Registrar SIU-Kolla en SIU-Araí ===<br />
El administrador de SIU-Araí deberá registrar el módulo mediante el comando:<source lang="php" enclose="div"><br />
bin/arai-cli registry:add --maintainer nombre-encargado-admin --maintainer-email email-encargado-admin@uni.edu.ar http://url-arai-registry/arai-registry<br />
<br />
./bin/arai-cli registry:sync --aceptar-pedidos-acceso<br />
</source><blockquote>''<u>Nota</u>: recordar tener ingresadas las variables de entorno correspondientes al usuario y password de registry''</blockquote><blockquote>'''''export ARAI_REGISTRY_USER=usuario_registry''''' </blockquote><blockquote>'''''export ARAI_REGISTRY_PASS=password_registry'''''</blockquote><br />
<br />
=== Sincronizar SIU-Kolla en SIU-Araí ===<br />
Finalmente desde SIU-Araí deberá sincronizarse SIU-Kolla para que efectivamente sea incorporada la nueva vinculación:<source lang="php" enclose="div"><br />
bin/arai-cli registry:sync<br />
</source><br />
<br />
=== Importar Cuentas ===<br />
Para que las cuentas existentes en SIU-Kolla puedan utilizarse vinculadas será necesario realizar la exportación de dichas cuentas desde Kolla y luego importarlas desde Araí Usuarios. Para exportarlas se deberá ejecutar el siguiente comando:<source lang="php" enclose="div"><br />
toba proyecto exportar_usuarios_arai<br />
</source><br />
<br />
El comando anterior generará un archivo json que, luego, deberá utilizarse como entrada del siguiente comando en Araí Usuarios:<source lang="php" enclose="div"><br />
toba proyecto importar_usuarios_arai -f <ruta_al_archivo_generado> -m comparador<br />
</source><br />
<br />
Notar que al momento de importar, las cuentas deben ser identificadas por el Tipo y Nro. de Documento (el argumento de -m debe ser 1). Si alguna cuenta no es vinculada correctamente, el administrador de la plataforma Araí puede resolver manualmente los casos con conflictos.<br />
<br />
Para mayor información sobre la importación de cuentas dirigirse al siguiente [[SIU-Arai/Administrar#Importar cuentas desde una aplicaci.C3.B3n vinculada|enlace]], sección '''Importar cuentas desde una aplicación vinculada'''.<br />
<br />
== Posibles errores en las peticiones ==<br />
<br />
* '''480''': Errores de validación. Uno o más atributos de la entidad que se quiere guardar no paso la validación. El servicio retorna un arreglo con la descripción de cada uno de los errores.<br />
* '''424''': Usualmente ocurre cuando el recurso que se intenta manipular o recuperar no existe. Podrá sera cualquiera de las entidades involucradas (Por ejemplo, la [[SIU-Kolla/Version 4.8.0/Glosario de conceptos#U|Unidad de Gestión]] no existe).<br />
* '''500''': Error interno en el servidor, deberá revisarse el mensaje enviado al cliente.<br />
<br />
<br><br />
[[SIU-Kolla/version4.8.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces/verificar_usuarios&diff=89797SIU-Kolla/Version 4.8.0/interfaces/verificar usuarios2023-02-23T16:46:57Z<p>Rmiranda: </p>
<hr />
<div><br />
== Verificar y Corregir Identificadores de Usuarios ==<br />
<br />
Arai Usuarios sólo acepta identificadores de cuenta de usuario que respetan la siguiente expresión regular (a-z)(A-Z)(1-9)(.-), es decir sólo letras, números, el punto y la coma.<br />
<br />
Se detectó un error en versiones de Kolla posteriores a 4.8.x que permitían generar cuentas de usuarios con identificadores no válidos. Luego no era posible importar estas cuentas en Arai Usuarios utilizando el proceso de importación de cuentas.<br />
<br />
Para resolver este problema, a partir de la versión 4.8 de Kolla, se agrega la posibilidad de validar los identificadores de cuentas de usuarios de una instalación de Kolla y corregir identificadores si es necesario.<br />
<br />
Ejecutar el proceso de validación y corrección<br />
<br />
./bin/instalador proyecto:verificar-usuarios-arai<br />
<br />
Este proceso realiza la verificación de identificadores de usuarios utilizados en las tablas de Kolla (sge_encuestado) y Toba (apex_usuario). Se verifica que los usuarios cumplan con la siguiente expresión regular:<br />
<br />
'/^[a-z\d_.-]{1,60}$/i'<br />
<br />
Si el proceso encuentra algún identificador no válido, solicita al usuario que ingrese una lista de reemplazos separados por un espacio con la siguiente estructura:<br />
<br />
ciSEPcv<br />
<br />
Donde:<br />
<br />
ci = caracter inválido<br />
SEP = palabra clave para poder separar caracteres. Se opta por una palabra para evitar falsos positivos.<br />
cv = caracter válido<br />
<br />
El proceso toma esa lista de reemplazos y actualiza las siguientes tablas según el caso.<br />
<br />
Toba: <br />
<br />
* apex_usuario_pregunta_secreta<br />
* apex_usuario_pwd_reset<br />
* apex_usuario_pwd_usados<br />
* apex_usuario_proyecto_perfil_datos<br />
* apex_usuario_proyecto<br />
<br />
Kolla:<br />
<br />
* sge_encuestado.usuario<br />
<br />
Si ocurre algún error en el proceso revisar el archivo:<br />
<br />
instalador.log</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces/verificar_usuarios&diff=89796SIU-Kolla/Version 4.8.0/interfaces/verificar usuarios2023-02-23T16:46:03Z<p>Rmiranda: </p>
<hr />
<div><br />
== Verificar Usuarios ==<br />
<br />
Arai Usuarios sólo acepta identificadores de cuenta de usuario que respetan la siguiente expresión regular (a-z)(A-Z)(1-9)(.-), es decir sólo letras, números, el punto y la coma.<br />
<br />
Se detectó un error en versiones de Kolla posteriores a 4.8.x que permitían generar cuentas de usuarios con identificadores no válidos. Luego no era posible importar estas cuentas en Arai Usuarios.<br />
<br />
Para resolver este problema, a partir de la versión 4.8 de Kolla, se agrega la posibilidad de validar los identificadores de cuentas de usuarios de una instalación de Kolla y corregir identificadores si es necesario.<br />
<br />
Ejecutar el proceso de validación y corrección<br />
<br />
./bin/instalador proyecto:verificar-usuarios-arai<br />
<br />
Este proceso realiza la verificación de identificadores de usuarios utilizados en las tablas de Kolla (sge_encuestado) y Toba (apex_usuario). Se verifica que los usuarios cumplan con la siguiente expresión regular:<br />
<br />
'/^[a-z\d_.-]{1,60}$/i'<br />
<br />
Si el proceso encuentra algún identificador no válido, solicita al usuario que ingrese una lista de reemplazos separados por un espacio con la siguiente estructura:<br />
<br />
ciSEPcv<br />
<br />
Donde:<br />
<br />
ci = caracter inválido<br />
SEP = palabra clave para poder separar caracteres. Se opta por una palabra para evitar falsos positivos.<br />
cv = caracter válido<br />
<br />
El proceso toma esa lista de reemplazos y actualiza las siguientes tablas según el caso.<br />
<br />
Toba: <br />
<br />
* apex_usuario_pregunta_secreta<br />
* apex_usuario_pwd_reset<br />
* apex_usuario_pwd_usados<br />
* apex_usuario_proyecto_perfil_datos<br />
* apex_usuario_proyecto<br />
<br />
Kolla:<br />
<br />
* sge_encuestado.usuario<br />
<br />
Si ocurre algún error en el proceso revisar el archivo:<br />
<br />
instalador.log</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces/verificar_usuarios&diff=89795SIU-Kolla/Version 4.8.0/interfaces/verificar usuarios2023-02-23T16:44:58Z<p>Rmiranda: </p>
<hr />
<div><br />
== Verificar Usuarios ==<br />
<br />
Arai Usuarios sólo acepta identificadores de cuenta de usuario que respetan la siguiente expresión regular (a-z)(A-Z)(1-9)(.-), es decir sólo letras, números, el punto y la coma.<br />
<br />
Se detectó un error en versiones de Kolla posteriores a 4.8.x que permitían generar cuentas de usuarios con identificadores no válidos. Luego no era posible importar estas cuentas en Arai Usuarios.<br />
<br />
Para resolver este problema, a partir de la versión 4.8 de Kolla, se agrega la posibilidad de validar los identificadores de cuentas de usuarios de una instalación de Kolla y corregir identificadores si es necesario.<br />
<br />
Ejecutar el proceso de validación y corrección<br />
<br />
./bin/instalador proyecto:verificar-usuarios-arai<br />
<br />
Este proceso realiza la verificación de identificadores de usuarios utilizados en las tablas de Kolla (sge_encuestado) y Toba (apex_usuario). Se verifica que los usuarios cumplan con la siguiente expresión regular:<br />
<br />
'/^[a-z\d_.-]{1,60}$/i'<br />
<br />
Si el proceso encuentra algún identificador no válido, solicita al usuario que ingrese una lista de reemplazos separados por un espacio con la siguiente estructura:<br />
<br />
ciSEPcv<br />
<br />
Donde:<br />
<br />
ci = caracter inválido<br />
SEP = palabra clave para poder separar caracteres. Se opta por una palabra para evitar falsos positivos.<br />
cv = caracter válido<br />
<br />
El proceso toma esa lista de reemplazos y actualiza las siguientes tablas según el caso.<br />
<br />
Toba: <br />
<br />
* apex_usuario_pregunta_secreta<br />
* apex_usuario_pwd_reset<br />
* apex_usuario_pwd_usados<br />
* apex_usuario_proyecto_perfil_datos<br />
* apex_usuario_proyecto<br />
<br />
Kolla:<br />
<br />
* sge_encuestado.usuario</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/interfaces/verificar_usuarios&diff=89794SIU-Kolla/Version 4.8.0/interfaces/verificar usuarios2023-02-23T16:42:20Z<p>Rmiranda: </p>
<hr />
<div>Verificar Usuarios<br />
<br />
Arai Usuarios sólo acepta identificadores de cuenta de usuario que respetan la siguiente expresión regular (a-z)(A-Z)(1-9)(.-), es decir sólo letras, números, el punto y la coma.<br />
<br />
Se detectó un error en versiones de Kolla posteriores a 4.8.x que permitían generar cuentas de usuarios con identificadores no válidos. Luego no era posible importar estas cuentas en Arai Usuarios.<br />
<br />
Para resolver este problema, a partir de la versión 4.8 de Kolla, se agrega la posibilidad de validar los identificadores de cuentas de usuarios de una instalación de Kolla y corregir identificadores si es necesario.<br />
<br />
Ejecutar el proceso de validación y corrección<br />
<br />
./bin/instalador proyecto:verificar-usuarios-arai<br />
<br />
Este proceso realiza la verificación de identificadores de usuarios utilizados en las tablas de Kolla (sge_encuestado) y Toba (apex_usuario). Se verifica que los usuarios cumplan con la siguiente expresión regular:<br />
<br />
'/^[a-z\d_.-]{1,60}$/i'<br />
<br />
Si el proceso encuentra algún identificador no válido, solicita al usuario que ingrese una lista de reemplazos separados por un espacio con la siguiente estructura:<br />
<br />
ciSEPcv<br />
<br />
Donde:<br />
<br />
ci = caracter inválido<br />
SEP = palabra clave para poder separar caracteres. Se opta por una palabra para evitar falsos positivos.<br />
cv = caracter válido<br />
<br />
El proceso toma esa lista de reemplazos y actualiza las siguientes tablas según el caso.<br />
<br />
Toba: <br />
<br />
apex_usuario_pregunta_secreta<br />
apex_usuario_pwd_reset<br />
apex_usuario_pwd_usados<br />
apex_usuario_proyecto_perfil_datos<br />
apex_usuario_proyecto<br />
<br />
Kolla:<br />
<br />
sge_encuestado.usuario</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.7.0/Documentacion_de_las_operaciones/menu_configuracion_configuracion_mails&diff=81886SIU-Kolla/Version 4.7.0/Documentacion de las operaciones/menu configuracion configuracion mails2022-06-15T12:47:36Z<p>Rmiranda: </p>
<hr />
<div>__NOTOC__<br />
== Menú Configuración ==<br />
<br />
=== Configuración de Mails ===<br />
<br />
En esta opción se permite definir la '''configuración de servidores de mail''' que pueden ser utilizados en SIU-Kolla. Durante el proceso de instalación es posible realizar la configuración inicial. Se recomienda no omitir este paso para poder contar con la opción de recuperación de clave.<br />
<br />
En el listado inicial se puede visualizar la conexión definida durante la instalación del sistema. La misma puede editarse o bien se pueden definir otras alternativas para ser usadas en las operaciones que requieren envío de emails desde SIU-Kolla.<br />
<br />
[[Archivo:KOL_K4_ConfigMail1.png]]<br />
<br />
Al editar o agregar una nueva conexión se solicitan los datos que se muestran a continuación:<br />
<br />
[[Archivo:KOL_K4_ConfigMail2.png]]<br />
<br />
Para controlar la disponibilidad del servicio o que los datos indicados sean correctos el sistema ofrece la opción '''Probar conexión''' que intentará realizar el envío de email a la cuenta indicada dando aviso del resultado obtenido.<br />
<br />
Las operaciones que requieren disponer de un servidor de mail son:<br />
* '''Responder por encuestado:''' debido a que se envía un email de manera automática al encuestado real.<br />
* '''Responder:''' en el caso de no contar con un servidor de email correctamente configurado no se podrán completar los envíos de comprobantes o de encuestas respondidas.<br />
* '''Restablecer contraseña:''' Debido a que el proceso de regeneración de contraseña se completa a través de envíos de emails a los usuarios.<br />
* '''Envío de E-Mails'''<br />
<br />
=== Consideraciones para Gmail ===<br />
<br />
Lo primero que hay que hacer es generar una clave de aplicación https://support.google.com/accounts/answer/185833. Luego agregar la configuración SMTP en Kolla y en el campo clave utilizar la clave de aplicación. El resto de los campos es igual salvo que:<br />
<br />
Servidor = smtp.gmail.com<br><br />
Puerto = 587<br><br />
Seguridad = TLS<br><br />
<br />
[[SIU-Kolla/Version_4.7.0/Documentacion_de_las_operaciones#Configuración | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/Documentacion_de_las_operaciones/menu_configuracion_configuracion_mails&diff=88538SIU-Kolla/Version 4.8.0/Documentacion de las operaciones/menu configuracion configuracion mails2022-06-15T12:47:36Z<p>Rmiranda: </p>
<hr />
<div>__NOTOC__<br />
== Menú Configuración ==<br />
<br />
=== Configuración de Mails ===<br />
<br />
En esta opción se permite definir la '''configuración de servidores de mail''' que pueden ser utilizados en SIU-Kolla. Durante el proceso de instalación es posible realizar la configuración inicial. Se recomienda no omitir este paso para poder contar con la opción de recuperación de clave.<br />
<br />
En el listado inicial se puede visualizar la conexión definida durante la instalación del sistema. La misma puede editarse o bien se pueden definir otras alternativas para ser usadas en las operaciones que requieren envío de emails desde SIU-Kolla.<br />
<br />
[[Archivo:KOL_K4_ConfigMail1.png]]<br />
<br />
Al editar o agregar una nueva conexión se solicitan los datos que se muestran a continuación:<br />
<br />
[[Archivo:KOL_K4_ConfigMail2.png]]<br />
<br />
Para controlar la disponibilidad del servicio o que los datos indicados sean correctos el sistema ofrece la opción '''Probar conexión''' que intentará realizar el envío de email a la cuenta indicada dando aviso del resultado obtenido.<br />
<br />
Las operaciones que requieren disponer de un servidor de mail son:<br />
* '''Responder por encuestado:''' debido a que se envía un email de manera automática al encuestado real.<br />
* '''Responder:''' en el caso de no contar con un servidor de email correctamente configurado no se podrán completar los envíos de comprobantes o de encuestas respondidas.<br />
* '''Restablecer contraseña:''' Debido a que el proceso de regeneración de contraseña se completa a través de envíos de emails a los usuarios.<br />
* '''Envío de E-Mails'''<br />
<br />
=== Consideraciones para Gmail ===<br />
<br />
Lo primero que hay que hacer es generar una clave de aplicación https://support.google.com/accounts/answer/185833. Luego agregar la configuración SMTP en Kolla y en el campo clave utilizar la clave de aplicación. El resto de los campos es igual salvo que:<br />
<br />
Servidor = smtp.gmail.com<br><br />
Puerto = 587<br><br />
Seguridad = TLS<br><br />
<br />
[[SIU-Kolla/Version_4.8.0/Documentacion_de_las_operaciones#Configuración | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/documentacion_operaciones/administracion_configuracion_SMTP&diff=81885SIU-Tehuelche/version 4.3/documentacion operaciones/administracion configuracion SMTP2022-06-15T12:46:48Z<p>Rmiranda: </p>
<hr />
<div><br />
== Configuración de SMTP==<br />
Esta operación permite configurar cuentas de e-mail para utilizar como medio de comunicación entre el módulo y sus usuarios.<br />
<br />
Es posible configurar tantas cuentas como sea necesario, y establecer cuál de ellas será la predeterminada para el uso diario.<br />
[[Archivo:TEH admin listado config mail.png]]<br />
<br />
=== Detalle de Configuración de E-mails===<br />
<br />
Para vincular una cuenta a SIU-Tehuelche bastará con completar los datos requeridos en el formulario.<br />
<br />
Ante cualquier duda al respecto a estos datos el proveedor de servicios de e-mail suele contar con documentación referida al uso de la cuenta en modo SMTP para envíos masivos y/o externos.<br />
<br />
Una vez completados los datos de conexión será posible realizar una Prueba de Conexión para asegurar el correcto funcionamiento de la cuenta.<br />
[[Archivo:TEH admin config mail.png]]<br />
<br />
=== Consideraciones para Gmail ===<br />
<br />
Lo primero que hay que hacer es generar una clave de aplicación https://support.google.com/accounts/answer/185833. Luego agregar la configuración SMTP en Kolla y en el campo clave utilizar la clave de aplicación. El resto de los campos es igual salvo que:<br />
<br />
Servidor = smtp.gmail.com<br><br />
Puerto = 587<br><br />
Seguridad = TLS<br><br />
<br />
[[SIU-Tehuelche/version 4.3/documentacion operaciones#Administraci.C3.B3n|< Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.4/documentacion_operaciones/administracion_configuracion_SMTP&diff=83299SIU-Tehuelche/version 4.4/documentacion operaciones/administracion configuracion SMTP2022-06-15T12:46:48Z<p>Rmiranda: </p>
<hr />
<div><br />
== Configuración de SMTP==<br />
Esta operación permite configurar cuentas de e-mail para utilizar como medio de comunicación entre el módulo y sus usuarios.<br />
<br />
Es posible configurar tantas cuentas como sea necesario, y establecer cuál de ellas será la predeterminada para el uso diario.<br />
[[Archivo:TEH admin listado config mail.png]]<br />
<br />
=== Detalle de Configuración de E-mails===<br />
<br />
Para vincular una cuenta a SIU-Tehuelche bastará con completar los datos requeridos en el formulario.<br />
<br />
Ante cualquier duda al respecto a estos datos el proveedor de servicios de e-mail suele contar con documentación referida al uso de la cuenta en modo SMTP para envíos masivos y/o externos.<br />
<br />
Una vez completados los datos de conexión será posible realizar una Prueba de Conexión para asegurar el correcto funcionamiento de la cuenta.<br />
[[Archivo:TEH admin config mail.png]]<br />
<br />
=== Consideraciones para Gmail ===<br />
<br />
Lo primero que hay que hacer es generar una clave de aplicación https://support.google.com/accounts/answer/185833. Luego agregar la configuración SMTP en Kolla y en el campo clave utilizar la clave de aplicación. El resto de los campos es igual salvo que:<br />
<br />
Servidor = smtp.gmail.com<br><br />
Puerto = 587<br><br />
Seguridad = TLS<br><br />
<br />
[[SIU-Tehuelche/version 4.4/documentacion operaciones#Administraci.C3.B3n|< Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/documentacion_operaciones/administracion_configuracion_SMTP&diff=81884SIU-Tehuelche/version 4.3/documentacion operaciones/administracion configuracion SMTP2022-06-15T12:46:20Z<p>Rmiranda: </p>
<hr />
<div><br />
== Configuración de SMTP==<br />
Esta operación permite configurar cuentas de e-mail para utilizar como medio de comunicación entre el módulo y sus usuarios.<br />
<br />
Es posible configurar tantas cuentas como sea necesario, y establecer cuál de ellas será la predeterminada para el uso diario.<br />
[[Archivo:TEH admin listado config mail.png]]<br />
<br />
=== Detalle de Configuración de E-mails===<br />
<br />
Para vincular una cuenta a SIU-Tehuelche bastará con completar los datos requeridos en el formulario.<br />
<br />
Ante cualquier duda al respecto a estos datos el proveedor de servicios de e-mail suele contar con documentación referida al uso de la cuenta en modo SMTP para envíos masivos y/o externos.<br />
<br />
Una vez completados los datos de conexión será posible realizar una Prueba de Conexión para asegurar el correcto funcionamiento de la cuenta.<br />
[[Archivo:TEH admin config mail.png]]<br />
<br />
=== Consideraciones para Gmail ===<br />
<br />
Lo primero que hay que hacer es generar una clave de aplicación https://support.google.com/accounts/answer/185833. Luego agregar la configuración SMTP en Kolla y en el campo clave utilizar la clave de aplicación. El resto de los campos es igual salvo que:<br />
<br />
Servidor = smtp.gmail.com<br />
Puerto = 587<br />
Seguridad = TLS<br />
<br />
[[SIU-Tehuelche/version 4.3/documentacion operaciones#Administraci.C3.B3n|< Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.7.0/actualizacion&diff=78756SIU-Kolla/Version 4.7.0/actualizacion2022-02-16T15:58:16Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.7.0]]<br />
<br />
= Actualización de versión =<br />
<br />
== Esquema de migración hasta la versión 4.7.X ==<br />
<br />
La actualización a la versión 4.7 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.7 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.7.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.7.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.4.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 2.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_7_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.7.X exitosamente.<br />
<br />
== Recomendaciones == <br />
<br />
Si se realizó la actualización de una instalación originalmente versión hasta 4.6 se recomienda utilizar el comando para cambiar los permisos de la base de negocio. Este comando genera un script sql que corrige los privilegios de acceso y el owner de todos los objetos de la base y esquema de negocio con el fin de evitar el uso del superusuario postgres. <br />
<br />
Antes de utilizar este comando se recomienda consultar con la persona responsable de la administración de las bases de datos de la institución para validar el rol a utilizar y la existencia de políticas propias de gestión de las bases de datos.<br />
<br />
El comando puede utilizarse de dos maneras. En ambos casos el proceso solicitará que se indique el '''superusuario''' con el que se correrá el script y el usuario administrador para la base de negocio del módulo. En el primer paso se listarán todos los superusuarios disponibles para ayudar a seleccionar el que se usará, en el segundo paso se listarán todos los que no son superusuarios entre los que se podrá elegir el administrador.<br />
<br />
Las alternativas son:<br />
<br />
* Correrlo para generar un archivo <br />
<br />
toba proyecto cambiar_permisos_base -p kolla<br />
<br />
Como resultado se generará un script en la carpeta temp del proyecto. Se debeberá tomar este script y utilizarlo para realizar los ajustes mencionados sobre la base de datos.<br />
<br />
* Correrlo con el parámetro "--ejecutar"<br />
<br />
toba proyecto cambiar_permisos_base -p kolla --ejecutar<br />
<br />
Como resultado el script se generará y se ejecutará sobre la base de datos antes de terminar. Esto evita tener que ejecutar el script manualmente sobre la base.<br />
<br />
Al finalizar se deberá editar el archivo '''bases.ini''' actualizando en todas las fuentes de datos el '''usuario''' y '''clave''' del nuevo usuario con acceso de administrador de la base.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.7.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.7.0/instalacion_desde_cero&diff=78755SIU-Kolla/Version 4.7.0/instalacion desde cero2022-02-16T15:57:20Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.7.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.4.x o superior, menor a 8 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 2.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_7_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.7.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.7.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.8.0/instalacion_desde_cero&diff=88579SIU-Kolla/Version 4.8.0/instalacion desde cero2022-02-16T15:57:20Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.8.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.4.x o superior, menor a 8 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 2.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_7_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.8.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.8.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/actualizacion&diff=78125SIU-Tehuelche/version 4.3/actualizacion2022-01-04T15:30:28Z<p>Rmiranda: </p>
<hr />
<div>== Proceso de Actualización ==<br />
<br />
El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.<br />
<br />
* Ejemplo: si el directorio de la versión base es '''/siu/tehuelche/4.0.1''' nos situaremos en '''/siu/tehuelche''' para realizar el proceso de actualización.<br />
<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.<br />
<br />
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
5. Configurar archivo '''instalador.env'''<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
<br />
PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>" ---> URL base de acceso al servidor<br /><br />
TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br /><br />
TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br /><br />
<br />
En general para los alias de apache y bases de datos, se mantiene la misma configuración de la instalación anterior. Se puede consultar entonces el archivo instalador.env de la instalación anterior y configurar el instalador.env actual de la misma manera.<br />
<br />
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
7. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
8. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
9. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
10. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.4/actualizacion&diff=83287SIU-Tehuelche/version 4.4/actualizacion2022-01-04T15:30:28Z<p>Rmiranda: </p>
<hr />
<div>== Proceso de Actualización ==<br />
<br />
El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.<br />
<br />
* Ejemplo: si el directorio de la versión base es '''/siu/tehuelche/4.0.1''' nos situaremos en '''/siu/tehuelche''' para realizar el proceso de actualización.<br />
<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.4.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.4.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.4.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.<br />
<br />
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
5. Configurar archivo '''instalador.env'''<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
<br />
PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>" ---> URL base de acceso al servidor<br /><br />
TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br /><br />
TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br /><br />
<br />
En general para los alias de apache y bases de datos, se mantiene la misma configuración de la instalación anterior. Se puede consultar entonces el archivo instalador.env de la instalación anterior y configurar el instalador.env actual de la misma manera.<br />
<br />
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
7. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
8. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
9. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
10. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
[[SIU-Tehuelche/version_4.4 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/actualizacion&diff=78124SIU-Tehuelche/version 4.3/actualizacion2022-01-04T15:19:27Z<p>Rmiranda: </p>
<hr />
<div>== Proceso de Actualización ==<br />
<br />
El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.<br />
<br />
* Ejemplo: si el directorio de la versión base es '''/siu/tehuelche/4.0.1''' nos situaremos en '''/siu/tehuelche''' para realizar el proceso de actualización.<br />
<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.<br />
<br />
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
5. Configurar archivo '''instalador.env'''<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
<br />
PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>" ---> URL base de acceso al servidor<br /><br />
TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br /><br />
TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br /><br />
TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br /><br />
<br />
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
7. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
8. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
9. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
10. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/actualizacion&diff=78123SIU-Tehuelche/version 4.3/actualizacion2022-01-04T15:19:00Z<p>Rmiranda: </p>
<hr />
<div>== Proceso de Actualización ==<br />
<br />
El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.<br />
<br />
* Ejemplo: si el directorio de la versión base es '''/siu/tehuelche/4.0.1''' nos situaremos en '''/siu/tehuelche''' para realizar el proceso de actualización.<br />
<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.<br />
<br />
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
5. Configurar archivo '''instalador.env'''<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
<br />
PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>" ---> URL base de acceso al servidor<br />
TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo<br />
TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br />
TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br />
TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br />
TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br />
<br />
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
7. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
8. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
9. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
10. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/actualizacion&diff=78122SIU-Tehuelche/version 4.3/actualizacion2022-01-04T15:15:39Z<p>Rmiranda: </p>
<hr />
<div>== Proceso de Actualización ==<br />
<br />
El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.<br />
<br />
* Ejemplo: si el directorio de la versión base es '''/siu/tehuelche/4.0.1''' nos situaremos en '''/siu/tehuelche''' para realizar el proceso de actualización.<br />
<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.<br />
<br />
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
5. Configurar archivo '''instalador.env'''<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
<br />
* '''PROYECTO_DB_DBNAME='''"xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
* '''TOBA_DB_DBNAME='''"xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
* '''TOBA_URL_BASE='''"<nowiki>http://url</nowiki>" ---> URL base de acceso al servidor<br />
* '''TOBA_USUARIO='''"usuario" ---> usuario para primer acceso a la nueva versión del módulo<br />
* '''TOBA_PASSWORD='''"contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br />
* '''TOBA_PROYECTO_DIR='''"./siu/tehuelche/4.3.x/" ---> directorio del proyecto (paso 1)<br />
* '''TOBA_INSTALACION_DIR='''"./siu/tehuelche/4.3.x/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)<br />
* '''TOBA_ALIAS_PROYECTO='''"/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br />
* '''TOBA_ALIAS_NUCLEO='''"/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br />
* '''TOBA_ALIAS_TOBA_USUARIOS='''"/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br />
<br />
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
7. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
8. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
9. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
10. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/instalacion&diff=78121SIU-Tehuelche/version 4.3/instalacion2022-01-04T14:31:31Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache 2.4<br />
* PHP >= 7.3 y < 8<br />
* PostgreSQL 13<br />
* Yarn<br />
* Composer<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
4. Configurar archivo '''instalador.env'''<br />
<br />
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 Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br />
<br />
'''Sólo a modo de ejemplo:'''<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="toba"<br /><br />
TOBA_PASSWORD="toba1234"<br /><br />
TOBA_ALIAS_PROYECTO="/siu/tehuelche"<br /><br />
TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"<br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
<br />
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.4/instalacion&diff=83275SIU-Tehuelche/version 4.4/instalacion2022-01-04T14:31:31Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache 2.4<br />
* PHP >= 7.3 y < 8<br />
* PostgreSQL 13<br />
* Yarn<br />
* Composer<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.4.0'''. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.4.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
4. Configurar archivo '''instalador.env'''<br />
<br />
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 Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br />
<br />
'''Sólo a modo de ejemplo:'''<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="toba"<br /><br />
TOBA_PASSWORD="toba1234"<br /><br />
TOBA_ALIAS_PROYECTO="/siu/tehuelche"<br /><br />
TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"<br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
<br />
# [[SIU-Tehuelche/version_4.4/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.4 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/instalacion&diff=78120SIU-Tehuelche/version 4.3/instalacion2022-01-04T14:30:59Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache 2.4<br />
* PHP >= 7.3 y < 8<br />
* PostgreSQL 13<br />
* Yarn<br />
* Composer<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
4. Configurar archivo '''instalador.env'''<br />
<br />
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 Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br />
<br />
A modo de ejemplo:<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="toba"<br /><br />
TOBA_PASSWORD="toba1234"<br /><br />
TOBA_ALIAS_PROYECTO="/siu/tehuelche"<br /><br />
TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"<br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
<br />
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/instalacion&diff=78119SIU-Tehuelche/version 4.3/instalacion2022-01-04T14:02:11Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache<br />
* PHP >= 7.3 y < 8<br />
* Postgres 13<br />
* Yarn<br />
* Composer 1.x.x<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br />
2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br />
3. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
4. Configurar archivo '''instalador.env'''<br />
<br />
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 Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br />
<br />
A modo de ejemplo:<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="toba"<br /><br />
TOBA_PASSWORD="toba1234"<br /><br />
TOBA_ALIAS_PROYECTO="/siu/tehuelche"<br /><br />
TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"<br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
<br />
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/instalacion&diff=78118SIU-Tehuelche/version 4.3/instalacion2022-01-04T13:54:50Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache<br />
* PHP >= 7.3 y < 8<br />
* Postgres 13<br />
* Yarn<br />
* Composer 1.x.x<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1) Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''.<br />
Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br /><br />
<br />
2) Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br /><br />
<br />
3) Configurar el archivo de instalación. Dentro de la carpeta de instalación se encuentra el archivo ''instalador.env.dist''. Debemos copiar este y renombrarlo como ''instalador.env''. Una vez hecho esto, podemos editar este nuevo archivo de configuración, ingresando los valores que deseamos utilizar en la instalación.<br />
<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
* Configurar la variable '''PROYECTO_DB_DBNAME,''' indicará el nombre de la base de datos de negocio.<br />
* Configurar la variable '''TOBA_DB_DBNAME,''' indicará el nombre de la base de datos de toba.<br />
* Configurar la variable '''TOBA_ALIAS_PROYECTO'''.<br />
* Configurar el usuario '''TOBA_USUARIO''' y su respectiva contraseña mediante '''TOBA_PASSWORD'''. Con estos datos ingresaremos al sistema por primera vez.<br />
* Es importante que en la variable '''PROYECTO_DB_SCHEMA''' este configurada con el valor ''tehuelche''. Caso contrario fallará la carga inicial de datos en la instalación.<br />
<br /><br />
<br />
4) Correr el instalador del proyecto. Para esto ejecutamos el siguiente comando:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
bin/instalador proyecto:instalar<br />
</source><br />
<br /><br />
<br />
5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos<br />
* Es muy probable que haya configuraciones del archivo ''/etc/php/<versión PHP>/cli/php.ini'' que nos informe el instalador que debemos modificar.<br />
<br /><br />
<br />
6) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo bin/instalador permisos:simple<br />
</source><br />
<br /><br />
<br />
7) Correr el comando para incorporar el link simbólico. El instalador indicará en pantalla un comando similar al siguiente, que deberemos ejecutar (notar que '''ruta_a_la_instalación''' dependerá de la instalación puntual realizada):<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf<br />
</source><br />
<br /><br />
<br />
8) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo service apache2 reload<br />
</source><br />
<br /><br />
<br />
9) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:<br />
* Es posible editar el archivo ''proyecto.ini'' y asignar cero a la variable '''modo_mantenimiento'''.<br />
* Otra opción es utilizar el siguiente comando del instalador:<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
</source><br />
<br />
<br />10) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.<br />
<br />
<br><br />
11) Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.3/instalacion&diff=78117SIU-Tehuelche/version 4.3/instalacion2022-01-04T13:53:35Z<p>Rmiranda: </p>
<hr />
<div>== Pre-requisitos para instalar ==<br />
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:<br />
* Apache<br />
* PHP mayor o igual a 7.3<br />
* Postgres 13<br />
* Yarn<br />
* Composer 1.x.x<br />
* Git<br />
<br />
== Pasos de instalación ==<br />
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.<br />
<br />
1) Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''.<br />
Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:<br />
<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .<br />
</source><br />
<br /><br />
<br />
2) Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
composer install --no-dev<br />
</source><br />
<br /><br />
<br />
3) Configurar el archivo de instalación. Dentro de la carpeta de instalación se encuentra el archivo ''instalador.env.dist''. Debemos copiar este y renombrarlo como ''instalador.env''. Una vez hecho esto, podemos editar este nuevo archivo de configuración, ingresando los valores que deseamos utilizar en la instalación.<br />
<br />
<br />
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:<br />
* Configurar la variable '''PROYECTO_DB_DBNAME,''' indicará el nombre de la base de datos de negocio.<br />
* Configurar la variable '''TOBA_DB_DBNAME,''' indicará el nombre de la base de datos de toba.<br />
* Configurar la variable '''TOBA_ALIAS_PROYECTO'''.<br />
* Configurar el usuario '''TOBA_USUARIO''' y su respectiva contraseña mediante '''TOBA_PASSWORD'''. Con estos datos ingresaremos al sistema por primera vez.<br />
* Es importante que en la variable '''PROYECTO_DB_SCHEMA''' este configurada con el valor ''tehuelche''. Caso contrario fallará la carga inicial de datos en la instalación.<br />
<br /><br />
<br />
4) Correr el instalador del proyecto. Para esto ejecutamos el siguiente comando:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
bin/instalador proyecto:instalar<br />
</source><br />
<br /><br />
<br />
5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos<br />
* Es muy probable que haya configuraciones del archivo ''/etc/php/<versión PHP>/cli/php.ini'' que nos informe el instalador que debemos modificar.<br />
<br /><br />
<br />
6) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo bin/instalador permisos:simple<br />
</source><br />
<br /><br />
<br />
7) Correr el comando para incorporar el link simbólico. El instalador indicará en pantalla un comando similar al siguiente, que deberemos ejecutar (notar que '''ruta_a_la_instalación''' dependerá de la instalación puntual realizada):<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf<br />
</source><br />
<br /><br />
<br />
8) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:<br />
<br /><br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
sudo service apache2 reload<br />
</source><br />
<br /><br />
<br />
9) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:<br />
* Es posible editar el archivo ''proyecto.ini'' y asignar cero a la variable '''modo_mantenimiento'''.<br />
* Otra opción es utilizar el siguiente comando del instalador:<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
</source><br />
<br />
<br />10) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.<br />
<br />
<br><br />
11) Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:<br />
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]<br />
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.<br />
<br />
<br><br />
[[SIU-Tehuelche/version_4.3 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75816SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T18:27:21Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.7.0/instalacion_desde_cero&diff=78377SIU-Kolla/Version 4.7.0/instalacion desde cero2021-10-06T18:27:21Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.7.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.7.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.7.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.7.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75815SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T18:27:08Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.7.0/actualizacion&diff=78358SIU-Kolla/Version 4.7.0/actualizacion2021-10-06T18:27:08Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.7.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.7.X ==<br />
<br />
La actualización a la versión 4.7 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.7 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.7.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.7.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.7.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.7.X exitosamente.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.7.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75814SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T17:55:01Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75813SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:54:54Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75812SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:54:41Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo-pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75811SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T17:54:31Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php_gd, php_pdo, php_pdo-pgsql, php_curl, php_xsl, php_zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75810SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:38:59Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75809SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:38:45Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
== Personalizaciones ==<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75808SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:38:04Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Actualizar a una versión posterior =<br />
<br />
== Esquema de migración hasta la versión 4.6.X ==<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
== Librerías y módulos adicionales ==<br />
<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Pasos para la Actualización ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75807SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:37:02Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75806SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:35:57Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
=== Configuración adicional ===<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75805SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:34:48Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
=== Configuración adicional ===<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75804SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:33:01Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
chmod +x vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
=== Configuración adicional ===<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
1. Configurar el acceso a Habilitaciones Públicas (desde 4.6.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
2. Una vez finalizada al actualización de la aplicación, se debe tener presente que la misma queda en '''Modo Mantenimiento''', para permitirle a quien esté llevando adelante estas tareas, concluir con los detalles de configuración, evitando que a la vez cualquier usuario del módulo acceda al mismo en esos momentos.<br />
<br />
[[Archivo:KOL_mantenimiento_V1.png]]<br />
<br />
<br />
Para sacar la aplicación del Modo Mantenimiento, se debe acceder al archivo '''proyecto.ini''', identificar la entrada '''modo_mantenimiento''', y setear el valor a ''' 0 '''.<br /><br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75803SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:32:14Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
<...>/vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
=== Configuración adicional ===<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
1. Configurar el acceso a Habilitaciones Públicas (desde 4.6.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
2. Una vez finalizada al actualización de la aplicación, se debe tener presente que la misma queda en '''Modo Mantenimiento''', para permitirle a quien esté llevando adelante estas tareas, concluir con los detalles de configuración, evitando que a la vez cualquier usuario del módulo acceda al mismo en esos momentos.<br />
<br />
[[Archivo:KOL_mantenimiento_V1.png]]<br />
<br />
<br />
Para sacar la aplicación del Modo Mantenimiento, se debe acceder al archivo '''proyecto.ini''', identificar la entrada '''modo_mantenimiento''', y setear el valor a ''' 0 '''.<br /><br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75802SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:31:59Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
=== Pasos para la Actualización ===<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_5_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Antes de comenzar con el proceso de actualización es de suma importancia realizar un dump/backup de la base de datos y del directorio completo de la instalación actual del proyecto.<br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
8. Verificar que, en la instalación a actualizar, el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<br />
<...>/vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''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:<br />
<br />
tail -f instalador.log<br />
<br />
12. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
13. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
=== Configuración adicional ===<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
1. Configurar el acceso a Habilitaciones Públicas (desde 4.6.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
2. Una vez finalizada al actualización de la aplicación, se debe tener presente que la misma queda en '''Modo Mantenimiento''', para permitirle a quien esté llevando adelante estas tareas, concluir con los detalles de configuración, evitando que a la vez cualquier usuario del módulo acceda al mismo en esos momentos.<br />
<br />
[[Archivo:KOL_mantenimiento_V1.png]]<br />
<br />
<br />
Para sacar la aplicación del Modo Mantenimiento, se debe acceder al archivo '''proyecto.ini''', identificar la entrada '''modo_mantenimiento''', y setear el valor a ''' 0 '''.<br /><br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/actualizacion&diff=75801SIU-Kolla/Version 4.6.0/actualizacion2021-10-06T17:25:59Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
== Actualizar a una versión posterior ==<br />
<br />
=== Esquema de migración hasta la versión 4.6.X ===<br />
<br />
La actualización a la versión 4.6 requiere contar con una instalación de SIU-Kolla 4.1.0 o posterior.<br />
<br />
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:<br />
<br />
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0<br />
* Actualizar desde 4.1.0 a la versión 4.6 de SIU-Kolla<br />
<br />
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.<br />
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.6.x.<br />
<br />
Este proceso se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración '''no incluye''' desarrollos, o personalizaciones que se hayan realizado en el módulo de encuestas. <br />
<br />
El esquema '''toba_kolla''' conservará los datos del framework de Toba, mientras que el esquema '''kolla''' será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.<br />
<br />
=== Librerías y módulos adicionales ===<br />
Al actualizar a la versión 4.6.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
==== Pasos para la Actualización ====<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]). Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso ultima version|Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_5_0.rar.sha512.txt<br />
<br />
A través de ejecutar esta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
composer install<br />
<br />
5. Hacer dump/backup de la base de datos de la instalación. <br />
<br />
6. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp instalador.env.dist instalador.env<br />
<br />
7. Configurar archivo '''instalador.env'''<br />
* Datos de la base de negocio y de Toba tal como están en el archivo '''bases.ini''' de la instalación a actualizar<br />
* Datos para Toba<br />
<small>TOBA_PROYECTO_DIR="<path a la carpeta en la que está el Kolla nuevo>"<br /><br />
TOBA_INSTALACION_DIR="<path del paso anterior/instalacion>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias de acceso a Kolla>_toba_usuarios"</small><br /><br />
*Datos para el smtp de mail<br />
8. Verificar que en la instalación a actualizar el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.<br />
<br />
9. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.<br />
<...>/vendor/siu-toba/framework/bin/toba<br />
<br />
10. Ejecutar el instalador de esta manera:<br />
./bin/instalador proyecto:actualizar<br />
<br />
11. Revisar '''instalador.log''' para verificar que el proceso haya culminado con éxito.<br />
<br />
12. Seguir las instrucciones que brinda el instalador para acomodar permisos crear o actualizar el link simbólico al '''toba.conf''' creado.<br />
<br />
13. Quitar el modo mantenimiento de la nueva instalación del proyecto.<br />
==== Configuración adicional ====<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
1. Configurar el acceso a Habilitaciones Públicas (desde 4.6.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
2. Una vez finalizada al actualización de la aplicación, se debe tener presente que la misma queda en '''Modo Mantenimiento''', para permitirle a quien esté llevando adelante estas tareas, concluir con los detalles de configuración, evitando que a la vez cualquier usuario del módulo acceda al mismo en esos momentos.<br />
<br />
[[Archivo:KOL_mantenimiento_V1.png]]<br />
<br />
<br />
Para sacar la aplicación del Modo Mantenimiento, se debe acceder al archivo '''proyecto.ini''', identificar la entrada '''modo_mantenimiento''', y setear el valor a ''' 0 '''.<br /><br />
<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.6.X exitosamente.<br />
<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
------<br />
<br />
=== Personalizaciones ===<br />
<br />
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.<br />
<br />
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión. <br />
<br />
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.<br />
<br />
<small>[[#Actualizar a una versión posterior|Subir]]</small><br />
<br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75800SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T16:34:15Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
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:<br />
<br />
tail -f instalador.log<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75799SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T16:26:12Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
9. Revisar el archivo '''instalador.log''' para verificar que el proceso haya culminado con éxito<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
== Gestionar el acceso de usuarios ==<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75798SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T16:25:53Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
9. Revisar el archivo '''instalador.log''' para verificar que el proceso haya culminado con éxito<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
=== Gestionar el acceso de usuarios ===<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmirandahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Kolla/Version_4.6.0/instalacion_desde_cero&diff=75797SIU-Kolla/Version 4.6.0/instalacion desde cero2021-10-06T16:24:37Z<p>Rmiranda: </p>
<hr />
<div>[[Archivo:siu-kolla_iso.png|derecha|link=SIU-Kolla/version4.6.0]]<br />
<br />
= Instalación desde cero =<br />
<br />
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. <br />
<br />
A continuación se mencionan los pasos necesarios para instalar SIU-Kolla.<br />
<br />
== Verificar requerimientos mínimos ==<br />
<br />
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.<br />
<br />
Las versiones recomendadas son:<br />
<br />
* Apache 2.4.x<br />
* PHP 7.3.x (con las extensiones: php-gd, php-pdo, php-pdo-pgsql, php-curl, php-xsl, php-zip) <br />
* PostgresSQL 10.x a 13<br />
* Yarn<br />
* Composer 1.x.x<br />
<br />
<small>[[#Instalación desde cero|Subir]]</small><br />
------<br />
<br />
== Instalación ==<br />
<br />
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad]. Se pueden consultar mas detalles de cómo acceder al instalador en la sección [[SIU-Kolla/acceso_ultima_version | Acceso a última versión]].<br />
<br />
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:<br />
<br />
sha512sum -c instalador_kolla_4_6_0.rar.sha512.txt<br />
<br />
Al ejecutar ésta sentencia podemos detectar posibles cambios accidentales que hayan ocurrido al descargar el archivo de instalación.<br />
<br />
3. Descomprimir el archivo y copiar el contenido al directorio donde se desea realizar la instalación.<br />
<br />
4. Ingresar al directorio y ejecutar:<br />
<br />
composer install --no-dev<br />
<br />
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando: <br />
<br />
cp -a instalador.env.dist instalador.env<br />
<br />
6. Configurar archivo '''instalador.env'''<br />
<br />
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).<br />
<br />
###### CONFIG DE TOBA ######<br /><br /><br />
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br /><br />
TOBA_USUARIO="<usuario admin inicial>"<br /><br />
TOBA_PASSWORD="<contraseña para el usuario admin>"<br /><br />
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br /><br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br /><br />
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"<br /><br />
<br />
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: <br />
<br />
chmod +x bin/instalador<br />
<br />
8. Ejecutar el instalador de la siguiente manera:<br />
<br />
./bin/instalador proyecto:instalar<br />
<br />
9. Revisar el archivo '''instalador.log''' para verificar que el proceso haya culminado con éxito<br />
<br />
10. Seguir las instrucciones que brinda el instalador para:<br />
<br />
* Acomodar permisos de archivos y direcotorios<br />
<br />
sudo ./bin/instalador permisos:simple<br />
<br />
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)<br />
* Quitar el modo mantenimiento del proyecto<br />
<br />
/bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento<br />
<br />
11. Reiniciar el servidor web para que tome los nuevos cambios.<br />
<br />
Para obtener mas ayuda sobre el comando de instalación ejecutar<br />
<br />
./bin/instalador proyecto:instalar -h<br />
<br />
== Configuración adicional ==<br />
<br />
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.<br />
<br />
=== Habilitaciones públicas ===<br />
<br />
Configurar el acceso a Habilitaciones Públicas (desde 4.6.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:<br />
<br />
RewriteRule ^responder(.*)$ publica.php$1 [L]<br />
<br />
'''Reiniciar Apache''' para que esta modificación impacte correctamente.<br />
<br />
=== Protocolo HTTPS y acceso con certificado de seguridad ===<br />
<br />
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]''':<br />
<br />
protocolo_url_post_form_externo = 'https'<br />
<br />
<small>[[#Instalación desde cero|Subir]]</small><br />
------<br />
<br />
== Datos iniciales ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
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:<br />
<br />
* Encuestas para el seguimiento de graduados<br />
* Encuestas para el acompañamiento al estudio de desgranamiento universitario<br />
* Formulario de solicitudes de becas<br />
<br />
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).<br />
<br />
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.<br />
<br />
<small>[[#Instalación desde cero|Subir]]</small><br />
------<br />
<br />
=== Gestionar el acceso de usuarios ===<br />
<br />
La creación de los usuarios de SIU-Kolla se realiza desde el menú '''Usuarios''', opción[[SIU-Kolla/Version_4.6.0/Documentacion_de_las_operaciones/menu_usuarios_administracion| '''Administración''']]. Para conocer el detalle de cómo gestionar usuarios en SIU-Kolla ingresar a la documentación de la operación mencionada.<br />
<br />
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'':<br />
<br />
* '''Administrador''': permite al usuario configurar y administrar íntegramente la aplicación, con acceso a todas las operaciones y configuraciones.<br />
* '''Gestor''': permite al usuario gestionar las encuestas y todos los datos en general de la aplicación.<br />
* '''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.<br />
* '''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.<br />
<br />
Posteriormente cada usuario verá el menú principal de acuerdo al perfil de usuario que tenga asociado.<br />
<br />
<source lang="php" enclose="div" style="font-style: italic;"><br />
La instalación inicial de la aplicación crea la Unidad de Gestión Predeterminada. Genera también un usuario de tipo Administrador, con permisos para completar la configuración inicial del sistema, definir Unidades de Gestión y los usuarios de tipo Gestor para comenzar a operar en SIU-Kolla.<br />
</source><br />
<br />
<small>[[#Instalación desde cero|Subir]]</small><br />
<br />
<br><br />
[[SIU-Kolla/version4.6.0 | < Volver]]</div>Rmiranda