https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&user=Fmartinez&feedformat=atomSIU - Contribuciones del usuario [es]2024-03-28T17:58:32ZContribuciones del usuarioMediaWiki 1.30.0https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/instalacion_desde_cero/instalacion/gestion/linux&diff=41795SIU-Guarani/version3.15.0/instalacion desde cero/instalacion/gestion/linux2018-05-22T14:05:46Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
= Instalación desde cero de SIU-Guaraní Gestión 3.15 en entorno de Desarrollo =<br />
<br />
{| class="simple" border="1"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación<br />
** 3.15.x: por la versión que se va a instalar<br />
<br />
== Pasos para la instalación ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]<br />
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo: <br />
#:<source lang="bash" enclose="div">mkdir /usr/local/proyectos/guarani</source><br />
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.<br />
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:<br />
#:<source lang="bash" enclose="div"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x <path proyecto Guaraní><br />
</source><br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
export TOBA_INSTANCIA=desarrollo<br />
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion<br />
./toba instalacion instalar<br />
</source><br />
#:y completar:<br />
#:<source lang="bash" enclose="div"><br />
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3><br />
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico><br />
Se trata de una instalacion de producción? (Si o No) (s/n): n<br />
Nombre de la instalación (ej: Andromeda): <ej: guarani3><br />
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres><br />
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres><br />
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres><br />
PostgreSQL - Clave (ENTER para usar sin clave): <clave servidor Postgres><br />
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3><br />
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)><br />
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción><br />
</source><br />
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:<br />
#*<path proyecto Guaraní>/www<br />
#*<path proyecto Guaraní>/temp<br />
#*<path proyecto Guaraní>/instalacion<br />
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www<br />
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp<br />
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', debería ejecutarse:<br />
#:<source lang="bash" enclose="div"><br />
chown -R $(whoami):www-data <path proyecto Guaraní>/www<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/temp<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/instalacion<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp<br />
</source><br />
#Crear un link simbólico a toba.conf, e indicarle Apache que recargue los archivos de configuración. En lugar de hacerlo como indica la consola de instalación, sugerimos:<br />
#:<source lang="bash" enclose="div"><br />
ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf<br />
a2ensite gestion.conf<br />
service apache2 reload<br />
</source><br />
#Agregar los parámetros de localización de '''fop''' al final del archivo de inicialización de la instalación Toba ('''<path proyecto Guaraní>/instalacion/instalacion.ini'''):<br />
#:<source lang="ini" enclose="div"><br />
[xslfo]<br />
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source><br />
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.<br />
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani cargar -d <path proyecto Guaraní><br />
</source><br />
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''. <br />
#Reiniciar Apache:<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div">./guarani instalar</source><br />
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.<br />
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div">./guarani crear_auditoria -f guarani</source><br />
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:<br />
#:<source lang="bash" enclose="div">java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081</source><br />
#Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto:<br />
#:<source lang="php" enclose="div">http://localhost/guarani/3.15</source><br />
#:El usuario-clave para el primer acceso es: '''toba''', '''toba'''. Se recomienda luego del primer acceso modificar la clave.<br />
#Para editar el proyecto, navegar hacia la URL definida en ''toba.conf'', por defecto:<br />
#:<source lang="php" enclose="div">http://localhost/toba_editor/3.0</source><br />
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.<br />
<br />
== Configuración de cron o tarea programada para el envío de emails ==<br />
Un cron o tarea programada es un programa que permite ejecutar automáticamente comandos o scripts (grupos de comandos) a una hora o fecha específica. Es usado normalmente para comandos de tareas administrativas, como respaldos, pero puede ser usado para ejecutar cualquier cosa. Es un demonio que ejecuta programas agendados.<br />
*:Con un sistema '''GNU/Linux''':<br />
#En una consola ejecutar el comando:<source lang="php" enclose="div">crontab -e </source><br />
#Agregar la siguiente linea:<source lang="php" enclose="div">*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador</source>(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/<br />
#Guardar y salir del editor<br />
<br><br />
*:Con un sistema '''Windows''':<br />
#Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:<source lang="php" enclose="div"><br />
@echo off<br />
<path proyecto Guaraní>\bin\guarani enviar_emails_notificador<br />
exit<br />
</source><br />
#Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".<br />
#Ir a Acciones -> Crear tarea, en la solapa "General" poner un Nombre a la tarea (ej: guarani_cron_enviar_emails), una descripción (opcional) y tildar la opción "Oculta".<br />
#En la solapa "Acciones" crear una nueva acción, donde dice "Programa o Script" seleccionar el path hasta el .bat (ej: C:\guarani_enviar_emails_bat.bat).<br />
#En la solapa "Desencadenadores" crear un nuevo desencadenador, en inicio poner una hora posterior a la actual (ej: 10 minutos mas tarde) en Configuración avanzada poner Repetir cada 10 minutos repetir indefinidamente.<br />
#Aceptar para crear la tarea.<br />
<br />
(Para más detalles del '''envío de emails''' consulte la documentación del [[SIU-Guarani/Version3.15.0/notificador|notificador]])<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.16.0/instalacion_desde_cero/instalacion/gestion/linux&diff=44688SIU-Guarani/version3.16.0/instalacion desde cero/instalacion/gestion/linux2018-05-22T14:05:46Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
= Instalación desde cero de SIU-Guaraní Gestión 3.16 en entorno de Desarrollo =<br />
<br />
{| class="simple" border="1"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación<br />
** 3.16.x: por la versión que se va a instalar<br />
<br />
== Pasos para la instalación ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.16.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]<br />
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo: <br />
#:<source lang="bash" enclose="div">mkdir /usr/local/proyectos/guarani</source><br />
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.<br />
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:<br />
#:<source lang="bash" enclose="div"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.16.x <path proyecto Guaraní><br />
</source><br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
export TOBA_INSTANCIA=desarrollo<br />
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion<br />
./toba instalacion instalar<br />
</source><br />
#:y completar:<br />
#:<source lang="bash" enclose="div"><br />
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3><br />
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico><br />
Se trata de una instalacion de producción? (Si o No) (s/n): n<br />
Nombre de la instalación (ej: Andromeda): <ej: guarani3><br />
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres><br />
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres><br />
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres><br />
PostgreSQL - Clave (ENTER para usar sin clave): <clave servidor Postgres><br />
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3><br />
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)><br />
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción><br />
</source><br />
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:<br />
#*<path proyecto Guaraní>/www<br />
#*<path proyecto Guaraní>/temp<br />
#*<path proyecto Guaraní>/instalacion<br />
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www<br />
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp<br />
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', debería ejecutarse:<br />
#:<source lang="bash" enclose="div"><br />
chown -R $(whoami):www-data <path proyecto Guaraní>/www<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/temp<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/instalacion<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www<br />
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp<br />
</source><br />
#Crear un link simbólico a toba.conf, e indicarle Apache que recargue los archivos de configuración. En lugar de hacerlo como indica la consola de instalación, sugerimos:<br />
#:<source lang="bash" enclose="div"><br />
ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf<br />
a2ensite gestion.conf<br />
service apache2 reload<br />
</source><br />
#Agregar los parámetros de localización de '''fop''' al final del archivo de inicialización de la instalación Toba ('''<path proyecto Guaraní>/instalacion/instalacion.ini'''):<br />
#:<source lang="ini" enclose="div"><br />
[xslfo]<br />
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source><br />
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.<br />
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.16.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani cargar -d <path proyecto Guaraní><br />
</source><br />
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''. <br />
#Reiniciar Apache:<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div">./guarani instalar</source><br />
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.<br />
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div">./guarani crear_auditoria -f guarani</source><br />
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:<br />
#:<source lang="bash" enclose="div">java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081</source><br />
#Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto:<br />
#:<source lang="php" enclose="div">http://localhost/guarani/3.16</source><br />
#:El usuario-clave para el primer acceso es: '''toba''', '''toba'''. Se recomienda luego del primer acceso modificar la clave.<br />
#Para editar el proyecto, navegar hacia la URL definida en ''toba.conf'', por defecto:<br />
#:<source lang="php" enclose="div">http://localhost/toba_editor/3.0</source><br />
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.<br />
<br />
== Configuración de cron o tarea programada para el envío de emails ==<br />
Un cron o tarea programada es un programa que permite ejecutar automáticamente comandos o scripts (grupos de comandos) a una hora o fecha específica. Es usado normalmente para comandos de tareas administrativas, como respaldos, pero puede ser usado para ejecutar cualquier cosa. Es un demonio que ejecuta programas agendados.<br />
*:Con un sistema '''GNU/Linux''':<br />
#En una consola ejecutar el comando:<source lang="php" enclose="div">crontab -e </source><br />
#Agregar la siguiente linea:<source lang="php" enclose="div">*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador</source>(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/<br />
#Guardar y salir del editor<br />
<br><br />
*:Con un sistema '''Windows''':<br />
#Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:<source lang="php" enclose="div"><br />
@echo off<br />
<path proyecto Guaraní>\bin\guarani enviar_emails_notificador<br />
exit<br />
</source><br />
#Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".<br />
#Ir a Acciones -> Crear tarea, en la solapa "General" poner un Nombre a la tarea (ej: guarani_cron_enviar_emails), una descripción (opcional) y tildar la opción "Oculta".<br />
#En la solapa "Acciones" crear una nueva acción, donde dice "Programa o Script" seleccionar el path hasta el .bat (ej: C:\guarani_enviar_emails_bat.bat).<br />
#En la solapa "Desencadenadores" crear un nuevo desencadenador, en inicio poner una hora posterior a la actual (ej: 10 minutos mas tarde) en Configuración avanzada poner Repetir cada 10 minutos repetir indefinidamente.<br />
#Aceptar para crear la tarea.<br />
<br />
(Para más detalles del '''envío de emails''' consulte la documentación del [[SIU-Guarani/Version3.16.0/notificador|notificador]])<br />
<br />
[[SIU-Guarani/Version3.16.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.15.0/actualizacion_de_produccion/gestion&diff=41555SIU-Guarani/Version3.15.0/actualizacion de produccion/gestion2018-05-16T13:33:44Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x.y en entorno de producción ==<br />
=== Requisitos previos a la actualización ===<br />
* Haber creado la [[SIU-Guarani/version3.15.0/crear_version_propia/gestion|versión propia de SIU-Guaraní Gestión]]<br />
<br />
=== Configuraciones del servidor de producción ===<br />
Chequear que el servidor de producción esté configurado como se indica en esta [[SIU-Guarani/version3.15.0/instalacion_desde_cero/configuracion_produccion_gestion|documentación]].<br />
<br />
=== Actualización de la versión ===<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.15.x.y''': por la versión propia a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Realizar un backup integral de la base de datos.<br />
#Exportar datos locales. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Apuntar el servidor de producción a la nueva versión 3.15.x.y<br />
#:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y<br />
</source><br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="bash" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#'''Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.'''<br />
#:En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#:Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#:Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Importante:''': si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.<br />
#Compilar metadatos. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani compilar<br />
</source><br />
#:Al compilar los metadatos se generará la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', que no debe versionarse (''svn commit'') ya que se regenerará cada vez que se actualice la versión de producción.<br />
#Editar el archivo '''aplicacion.php''' ('''<path proyecto Guaraní>/www/aplicacion.php'''):<br />
##Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:<br />
##:<source lang="php" enclose="div"><br />
define('apex_pa_metadatos_compilados', 1);<br />
</source><br />
##Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:<br />
##:<source lang="php" enclose="div"><br />
define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice<br />
</source><br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.16.0/actualizacion_de_produccion/gestion&diff=44703SIU-Guarani/Version3.16.0/actualizacion de produccion/gestion2018-05-16T13:33:44Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Actualización del SIU-Guaraní Gestión a la versión 3.16.x.y en entorno de producción ==<br />
=== Requisitos previos a la actualización ===<br />
* Haber creado la [[SIU-Guarani/version3.16.0/crear_version_propia/gestion|versión propia de SIU-Guaraní Gestión]]<br />
<br />
=== Configuraciones del servidor de producción ===<br />
Chequear que el servidor de producción esté configurado como se indica en esta [[SIU-Guarani/version3.16.0/instalacion_desde_cero/configuracion_produccion_gestion|documentación]].<br />
<br />
=== Actualización de la versión ===<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.16.x.y''': por la versión propia a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.16.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Realizar un backup integral de la base de datos.<br />
#Exportar datos locales. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Apuntar el servidor de producción a la nueva versión 3.16.x.y<br />
#:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.16.x.y<br />
</source><br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.16.x.y --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="bash" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#'''Si se está actualizando a 3.16.1 desde 3.16.0, omitir este paso.'''<br />
#:En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#:Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#:Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Importante:''': si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.<br />
#Compilar metadatos. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani compilar<br />
</source><br />
#:Al compilar los metadatos se generará la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', que no debe versionarse (''svn commit'') ya que se regenerará cada vez que se actualice la versión de producción.<br />
#Editar el archivo '''aplicacion.php''' ('''<path proyecto Guaraní>/www/aplicacion.php'''):<br />
##Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:<br />
##:<source lang="php" enclose="div"><br />
define('apex_pa_metadatos_compilados', 1);<br />
</source><br />
##Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:<br />
##:<source lang="php" enclose="div"><br />
define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice<br />
</source><br />
<br />
[[SIU-Guarani/Version3.16.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=41554SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-05-16T13:33:01Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados. <br />
##Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando, desde la carpeta bin ('''<path proyecto Guaraní>/bin'''):<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
##'''Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.'''<br />
##:En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##:Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##:Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion/gestion&diff=41553SIU-Guarani/version3.15.0/actualizacion/gestion2018-05-16T13:31:28Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==<br />
{| class="simple" border="1"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
#:y verificar que no existan archivos con estado 'S'.<br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#'''Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.'''<br />
#:En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#:Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#:Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Desde '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.15.0/actualizacion_de_produccion/gestion&diff=40593SIU-Guarani/Version3.15.0/actualizacion de produccion/gestion2018-04-12T13:15:37Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x.y en entorno de producción ==<br />
=== Requisitos previos a la actualización ===<br />
* Haber creado la [[SIU-Guarani/version3.15.0/crear_version_propia/gestion|versión propia de SIU-Guaraní Gestión]]<br />
<br />
=== Configuraciones del servidor de producción ===<br />
Chequear que el servidor de producción esté configurado como se indica en esta [[SIU-Guarani/version3.15.0/instalacion_desde_cero/configuracion_produccion_gestion|documentación]].<br />
<br />
=== Actualización de la versión ===<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.15.x.y''': por la versión propia a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Realizar un backup integral de la base de datos.<br />
#Exportar datos locales. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Apuntar el servidor de producción a la nueva versión 3.15.x.y<br />
#:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y<br />
</source><br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="bash" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Importante:''': si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.<br />
#Compilar metadatos. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani compilar<br />
</source><br />
#:Al compilar los metadatos se generará la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', que no debe versionarse (''svn commit'') ya que se regenerará cada vez que se actualice la versión de producción.<br />
#Editar el archivo '''aplicacion.php''' ('''<path proyecto Guaraní>/www/aplicacion.php'''):<br />
##Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:<br />
##:<source lang="php" enclose="div"><br />
define('apex_pa_metadatos_compilados', 1);<br />
</source><br />
##Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:<br />
##:<source lang="php" enclose="div"><br />
define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice<br />
</source><br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=40592SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-04-12T13:15:16Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados. <br />
##Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando, desde la carpeta bin ('''<path proyecto Guaraní>/bin'''):<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
##En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion/gestion&diff=40591SIU-Guarani/version3.15.0/actualizacion/gestion2018-04-12T13:14:10Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==<br />
{| class="simple" border="1"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
#:y verificar que no existan archivos con estado 'S'.<br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Desde '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion/gestion&diff=40590SIU-Guarani/version3.15.0/actualizacion/gestion2018-04-12T13:13:01Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==<br />
{| class="simple" border="1"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
#:y verificar que no existan archivos con estado 'S'.<br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source> '''Verificar que el comando anterior finalice sin errores para continuar.'''<br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Desde '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.15.0/Novedades_tecnicas&diff=40589SIU-Guarani/Version3.15.0/Novedades tecnicas2018-04-12T13:06:14Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
= Principales novedades técnicas =<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;">[[SIU-Guarani/Version3.15.0 | Volver]]</p><br />
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.15.0</strong></p><br />
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>26/04/2017</strong></p><br />
</div><br />
<p style="clear: both;"></p><br />
== Base de Datos ==<br />
* [https://colab.siu.edu.ar/modelo/031500/Guarani_v3_14_0.html Modelo 3.15.0] (Se accede con credenciales de Colab)<br />
<br />
=== Diferencias con versiones anteriores ===<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.11.0&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.11.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.11.1&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.11.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.11.2&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.11.2]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.12.0&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.12.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.13.0&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.13.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.13.1&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.13.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.13.2&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.13.2]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.14.0&new=HEAD@/branches/base_diff/versiones/3.15.0 Con versión 3.14.0]<br />
<div class="mw-collapsible" style="width:100%"><br />
== Notas de versión ==<br />
<div class="mw-collapsible-content"><br />
== Gestión ==<br />
* '''Jasper '''<br />
<dd>Como Toba ahora se descarga por Composer, y cambia la ubicación de las librerías del framework dentro del sistema de archivos, se debe tener en cuenta que '''el comando para iniciar el servicio ha cambiado'''. Para mas información ver [[SIU-Guarani/Version3.15.0/jasper|el siguiente link]].</dd><br />
<br />
* '''Rest-Hooks '''<br />
<dd>Para las nuevas funcionalidades de '''Propuestas Cobrables''' se esta utilizando la tecnología '''Rest-Hooks'''. Para mas información ver [[SIU-Guarani/Version3.15.0/interfaces/rest-hooks|el siguiente link]].</dd><br />
<br />
== 3W ==<br />
<br />
* '''Modificaciones en el archivo de configuración''': <br />
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', <br />
<br />
1) Se agrega la directiva '''schema_toba''' dentro de la configuración de la DB, esto se usa para poder acceder a los mensajes de Toba.<br />
<br />
recrearlo a partir de '''instalacion/config_template.php'''. Para mas información ver [[SIU-Guarani/Version3.15.0/3w/configuracion|la siguiente referencia]].</dd><br />
<br />
* '''Conexión REST entre Gestión y 3W'''. Se utiliza para saber si un alumno cumple las condiciones para solicitar certificación en una propuesta determinada. Para más información ir [http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/interfaces/gestion-3w-rest aquí].<br />
</div></div></div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion&diff=40449SIU-Guarani/preinscripcion3.8.0/instalacion desde cero/instalacion2018-04-09T19:37:12Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Instalación desde cero ==<br />
<br />
=== Checkout === <br />
*Crear una carpeta en el sistema de archivos, por ejemplo:<br />
*:<source lang="php" enclose="div">/usr/local/proyectos/preinscripcion</source><br />
*:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <path proyecto Preinscripción>.<br />
*Efectuar un svn checkout de la URL de la versión 3.8.0 para el nodo correspondiente a su institución. Ejemplo:<br />
*:<source lang="php" enclose="div" style="width: 650px;"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/preinscripcion/trunk/3.8.0<br />
</source><br />
<br />
*En caso de no tener creado su nodo en Colab, solicitarlo al SIU mediante el Gestor de Solicitudes (GDS). Se asignarán también los respectivos usuarios.<br><br />
<br />
=== Permisos de carpetas ===<br />
<br />
En sistemas Linux, es necesario cambiar el propietario de las carpetas "temp", "log" y "cache" de la carpeta "instalacion" al usuario y grupo de Apache. Por ejemplo, para sistemas Ubuntu, donde el usuario y grupo Apache por defecto es "www-data", ejecutar:<br />
<br />
<source lang="bash" enclose="div"><br />
chown www-data:www-data -R instalacion/temp<br />
chown www-data:www-data -R instalacion/log<br />
chown www-data:www-data -R instalacion/cache<br />
</source><br />
<br />
También es necesario dar permisos de escritura a la carpeta navegable, condición necesaria para poder ejecutar la limpieza de caché APC desde el panel de administración:<br />
<br />
<source lang="bash" enclose="div"><br />
chown www-data:www-data -R src/siu/www<br />
</source><br />
<br />
=== Instalar las dependencias del proyecto ===<br />
<br />
Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:<br />
<source lang="php" enclose="div"><br />
composer install<br />
</source> <br />
La carpeta '''vendor''' tiene establecida la propiedad ''svn:ignore'' y '''jamas se debe subir al repositorio'''.<br />
Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer]<br />
<br />
=== Base de datos === <br />
<br />
Crear una base de datos en PostgreSQL con encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
CREATE DATABASE preinscripcion<br />
WITH ENCODING='LATIN1'<br />
OWNER=postgres<br />
TEMPLATE=template0<br />
LC_COLLATE='C'<br />
LC_CTYPE='C'<br />
CONNECTION LIMIT=-1<br />
TABLESPACE=pg_default;<br />
</source><br />
<br />
Usar el archivo ''"creacion_preinscripcion3_postgresql.sql"'', que se encuentra en la carpeta "BD/creacion", para crear la estructura de la base de datos. El script está en encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
psql -d preinscripcion -h localhost < creacion_preinscripcion3_postgresql.sql -U postgres<br />
</source><br />
<br />
=== Definición de alias de acceso ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"alias.conf"'' a partir de la plantilla ''"alias_template.conf"''. Seguir los pasos allí documentados para definir los puntos de acceso de los distintos perfiles funcionales (''Administrador'' y ''Alumno'').<br />
<br />
Se deberán definir apropiadamente los alias de los puntos de acceso en función de la ubicación de la carpeta de instalación. Opcionalmente, en la configuración del punto de acceso de administración (<Location ~ "/preinscripcion_admin/*"> … ) se podrían definir restricciones para que sólo se pueda ingresar desde una intranet, siguiendo las reglas de Apache. <br />
<br />
Si se desea utilizar una misma instalación de Preinscripción como front-end de varias Unidades Académicas, cada una con su propia base de datos y personalizaciones, se debe seguir el proceso autodocumentado en el archivo, del cual presentamos a continuación un ejemplo:<br />
<br />
<source lang="php" enclose="div"><br />
<br />
# Alias del punto de acceso de ALUMNOS del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Alias del punto de acceso ADMINISTRADOR del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion_admin/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion_admin/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Configuración del directorio navegable<br />
<Directory "/path/a/preinscripcion/src/siu/www/"><br />
Options FollowSymLinks<br />
DirectoryIndex index.php<br />
<IfModule !mod_authz_core.c><br />
Order allow,deny<br />
Allow from all<br />
</IfModule><br />
<IfModule mod_authz_core.c><br />
Require all granted<br />
</IfModule><br />
include /path/a/preinscripcion/instalacion/rewrite.conf<br />
</Directory><br />
<br />
#### CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
<Location ~ "/preinscripcion/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: alumnos de la instalación del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen varios puntos de acceso, no debe repetirse este valor<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL alumno<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion/[pto_acc]<br />
</Location><br />
<br />
<Location ~ "/preinscripcion_admin/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: admin del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen puntos de acceso, tener cuidado de no repetir este valor<br />
# Debe corresponderse con el ID_PTO_ACCESO del perfil 'alumno' que administra este panel de admin.<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL admin<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion_admin/[pto_acc]<br />
<br />
# Si se desea restringir las IP desde las cuales acceder al panel de <br />
# administración, hacerlo aquí.<br />
</Location><br />
<br />
#### FIN CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
</source><br />
<br />
Para configurar los puntos de acceso, se recomienda abrir el template en un editor de texto y ''seleccionar y reemplazar'' todos los [pto_acc] y [id_pto_acc] y así evitar posibles errores en la cofiguración de este archivo.<br />
<br />
En caso de que se deseen implementar varios puntos de acceso, basta con duplicar el modelo del template y configurar las variables [pto_acc] y [id_pto_acc] con los datos de los nuevos puntos de acceso.<br />
<br />
Esta configuración debe complementarse con la definición del respectivo bloque de acceso en el archivo [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_del_sistema| config.php]].<br />
<br />
Se debe configurar el servidor Apache para tomar las definiciones del ''"alias.conf"''. <br />
<br />
<u>Ejemplo 1</u>: se puede incluir en el archivo de configuración de Apache (httpd.conf) la siguiente directiva: <br />
<br />
<source lang="php" enclose="div"><br />
Include "<path proyecto Preinscripción>/instalacion/alias.conf"<br />
</source><br />
<br />
<u>Ejemplo 2</u>: En ambientes Linux basados en Debian, se puede definir un link simbólico:<br />
<br />
<source lang="php" enclose="div"><br />
sudo ln -s <path proyecto Preinscripción>/instalacion/alias.conf /etc/apache2/sites-available/preinscripcion.conf<br />
a2ensite preinscripcion.conf<br />
service apache2 reload<br />
</source><br />
<br />
Finalmente, reiniciar Apache para que los cambios surtan efecto.<br />
<br />
Los datos censales y personales no pueden configurarse por punto de acceso ya que los mismos son definidos por la Institución.<br />
<br />
=== Configuración de LOGIN ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"login.php"'' a partir de la plantilla ''"login_template.php"''. <br />
<br />
En Preinscripción se dispone de un módulo de login mediante '''Google''' y '''Facebook''', que no suplanta al mecanismo de acceso tradicional, con una casilla de e-mail como nombre de usuario, sino que lo extiende y vincula a un usuario del sistema con alguno de los servicios externos habilitados.<br />
<br />
La única sección que debería editarse en el archivo ''"login.php"'' es "cuentas_ext", en el caso de querer habilitar el módulo de servicios externos. <br />
<br />
Como primera medida, establecer "'activo' => true" en el primer nivel de configuración de la citada sección. <br />
<br />
*Para utilizar el login con Google, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> google. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_google| instructivo]] para generar una aplicación con la API de Google y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
*Para utilizar el login con Facebook, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> facebook. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_facebook| instructivo]] para generar una aplicación con la API de Facebook y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
=== Generación de Usuarios Administradores de Puntos de Acceso ===<br />
<br />
Para crear los usuarios administradores por cada punto de acceso definido en el archivo alias.conf y config.php, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:<br />
<br />
<source lang="php" enclose="div">./preinscripcion user_admin</source><br />
<br />
y completar<br />
<br />
<source lang="php" enclose="div"><br />
Ingrese el nombre del usuario administrador (ENTER asume "admin"): [username]<br />
Ingrese el PASSWORD del usuario administrador: [password]<br />
Ingrese el ID DE PUNTO DE ACCESO en el que operara del usuario administrador (ante la duda, verificar el valor de "SetEnv ID_PTO_ACCESO" en alias.conf): [ID_PTO_ACCESO]<br />
---------------------------------------------------------<br />
Se ha creado el siguiente usuario administrador:<br />
- username: username<br />
- password: password<br />
- ID_PTO_ACCESO: ID_PTO_ACCESO<br />
---------------------------------------------------------<br />
</source><br />
<br />
=== Configuración del sistema ===<br />
<br />
Para configurar la interfaz de Preinscripción, se deberán seguir los siguientes pasos:<br />
<br />
==== Configurar archivo config.php ====<br />
<br />
En la carpeta "instalacion", crear un archivo "config.php" a partir de la plantilla "config_template.php".<br />
<br />
Este archivo contiene toda la configuración del sistema, incluyendo el acceso a base de datos de Preinscripción y Gestión, servidor de correo y los parámetros propios del sistema y de la generación de comprobantes.<br />
<br />
Recomendamos efectuar la configuración siguiendo la documentación "inline" provista en dicho archivo. Tener cuidado de no establecer la variable 'produccion' en 'true' hasta haber completado los pasos de puesta en producción.<br />
<br />
==== Configurar datos a través de la interfaz de Gestión ====<br />
<br />
A través de la interfaz de Gestión, se deberán configurar los siguientes [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|parámetros]].<br />
<br />
Asimismo, a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]], se podrán crear los turnos para la presentación de documentación por parte de los aspirantes.<br />
<br />
==== Configuración Puntos de Acceso ====<br />
<br />
Finalmente, una vez creados los usuarios administradores para cada punto de acceso, se deberán configurar sus correspondientes perfiles de datos. Esto permitirá que los diferentes puntos de acceso puedan ser administrados de forma independiente. Asimismo, los formularios de datos censales y personales solicitados no podrán configurarse independientemente sin realizar primero una personalización. Cualquier cambio realizado en los formularios de Preinscripción, se impactarán en todos los puntos de acceso.<br />
<br />
Para conocer mas detalles sobre la configuración a través del Panel de Administración, acceda [[SIU-Guarani/preinscripcion3.8.0/administracion|aquí]].<br />
<br />
=== Personalizaciones ===<br />
<br />
Si desea implementar personalizaciones (y solicitó al SIU una URL de checkout preparada a tal efecto), puede seguir la [[SIU-Guarani/preinscripcion3.8.0/personalizacion| documentación]] pertinente.<br />
<br />
=== Puesta en producción ===<br />
<br />
Se hayan efectuado o no personalizaciones, por cuestiones de performance, antes de poner el sistema en producción se deben compilar los recursos mediante el comando "preinscripcion" de la carpeta "bin": <br />
<br />
<source lang="php" enclose="div"><br />
preinscripcion compilar_recursos<br />
</source><br />
<br />
Finalmente, establecer la variable "produccion" en "true" en el archivo "config.php".<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion&diff=45391SIU-Guarani/preinscripcion3.9.0/instalacion desde cero/instalacion2018-04-09T19:37:12Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Instalación desde cero ==<br />
<br />
=== Checkout === <br />
*Crear una carpeta en el sistema de archivos, por ejemplo:<br />
*:<source lang="php" enclose="div">/usr/local/proyectos/preinscripcion</source><br />
*:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <path proyecto Preinscripción>.<br />
*Efectuar un svn checkout de la URL de la versión 3.9.0 para el nodo correspondiente a su institución. Ejemplo:<br />
*:<source lang="php" enclose="div" style="width: 650px;"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/preinscripcion/trunk/3.9.0<br />
</source><br />
<br />
*En caso de no tener creado su nodo en Colab, solicitarlo al SIU mediante el Gestor de Solicitudes (GDS). Se asignarán también los respectivos usuarios.<br><br />
<br />
=== Permisos de carpetas ===<br />
<br />
En sistemas Linux, es necesario cambiar el propietario de las carpetas "temp", "log" y "cache" de la carpeta "instalacion" al usuario y grupo de Apache. Por ejemplo, para sistemas Ubuntu, donde el usuario y grupo Apache por defecto es "www-data", ejecutar:<br />
<br />
<source lang="bash" enclose="div"><br />
chown www-data:www-data -R instalacion/temp<br />
chown www-data:www-data -R instalacion/log<br />
chown www-data:www-data -R instalacion/cache<br />
</source><br />
<br />
También es necesario dar permisos de escritura a la carpeta navegable, condición necesaria para poder ejecutar la limpieza de caché APC desde el panel de administración:<br />
<br />
<source lang="bash" enclose="div"><br />
chown www-data:www-data -R src/siu/www<br />
</source><br />
<br />
=== Instalar las dependencias del proyecto ===<br />
<br />
Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:<br />
<source lang="php" enclose="div"><br />
composer install<br />
</source> <br />
La carpeta '''vendor''' tiene establecida la propiedad ''svn:ignore'' y '''jamas se debe subir al repositorio'''.<br />
Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer]<br />
<br />
=== Base de datos === <br />
<br />
Crear una base de datos en PostgreSQL con encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
CREATE DATABASE preinscripcion<br />
WITH ENCODING='LATIN1'<br />
OWNER=postgres<br />
TEMPLATE=template0<br />
LC_COLLATE='C'<br />
LC_CTYPE='C'<br />
CONNECTION LIMIT=-1<br />
TABLESPACE=pg_default;<br />
</source><br />
<br />
Usar el archivo ''"creacion_preinscripcion3_postgresql.sql"'', que se encuentra en la carpeta "BD/creacion", para crear la estructura de la base de datos. El script está en encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
psql -d preinscripcion -h localhost < creacion_preinscripcion3_postgresql.sql -U postgres<br />
</source><br />
<br />
=== Definición de alias de acceso ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"alias.conf"'' a partir de la plantilla ''"alias_template.conf"''. Seguir los pasos allí documentados para definir los puntos de acceso de los distintos perfiles funcionales (''Administrador'' y ''Alumno'').<br />
<br />
Se deberán definir apropiadamente los alias de los puntos de acceso en función de la ubicación de la carpeta de instalación. Opcionalmente, en la configuración del punto de acceso de administración (<Location ~ "/preinscripcion_admin/*"> … ) se podrían definir restricciones para que sólo se pueda ingresar desde una intranet, siguiendo las reglas de Apache. <br />
<br />
Si se desea utilizar una misma instalación de Preinscripción como front-end de varias Unidades Académicas, cada una con su propia base de datos y personalizaciones, se debe seguir el proceso autodocumentado en el archivo, del cual presentamos a continuación un ejemplo:<br />
<br />
<source lang="php" enclose="div"><br />
<br />
# Alias del punto de acceso de ALUMNOS del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Alias del punto de acceso ADMINISTRADOR del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion_admin/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion_admin/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Configuración del directorio navegable<br />
<Directory "/path/a/preinscripcion/src/siu/www/"><br />
Options FollowSymLinks<br />
DirectoryIndex index.php<br />
<IfModule !mod_authz_core.c><br />
Order allow,deny<br />
Allow from all<br />
</IfModule><br />
<IfModule mod_authz_core.c><br />
Require all granted<br />
</IfModule><br />
include /path/a/preinscripcion/instalacion/rewrite.conf<br />
</Directory><br />
<br />
#### CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
<Location ~ "/preinscripcion/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: alumnos de la instalación del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen varios puntos de acceso, no debe repetirse este valor<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL alumno<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion/[pto_acc]<br />
</Location><br />
<br />
<Location ~ "/preinscripcion_admin/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: admin del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen puntos de acceso, tener cuidado de no repetir este valor<br />
# Debe corresponderse con el ID_PTO_ACCESO del perfil 'alumno' que administra este panel de admin.<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL admin<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion_admin/[pto_acc]<br />
<br />
# Si se desea restringir las IP desde las cuales acceder al panel de <br />
# administración, hacerlo aquí.<br />
</Location><br />
<br />
#### FIN CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
</source><br />
<br />
Para configurar los puntos de acceso, se recomienda abrir el template en un editor de texto y ''seleccionar y reemplazar'' todos los [pto_acc] y [id_pto_acc] y así evitar posibles errores en la cofiguración de este archivo.<br />
<br />
En caso de que se deseen implementar varios puntos de acceso, basta con duplicar el modelo del template y configurar las variables [pto_acc] y [id_pto_acc] con los datos de los nuevos puntos de acceso.<br />
<br />
Esta configuración debe complementarse con la definición del respectivo bloque de acceso en el archivo [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_del_sistema| config.php]].<br />
<br />
Se debe configurar el servidor Apache para tomar las definiciones del ''"alias.conf"''. <br />
<br />
<u>Ejemplo 1</u>: se puede incluir en el archivo de configuración de Apache (httpd.conf) la siguiente directiva: <br />
<br />
<source lang="php" enclose="div"><br />
Include "<path proyecto Preinscripción>/instalacion/alias.conf"<br />
</source><br />
<br />
<u>Ejemplo 2</u>: En ambientes Linux basados en Debian, se puede definir un link simbólico:<br />
<br />
<source lang="php" enclose="div"><br />
sudo ln -s <path proyecto Preinscripción>/instalacion/alias.conf /etc/apache2/sites-available/preinscripcion.conf<br />
a2ensite preinscripcion.conf<br />
service apache2 reload<br />
</source><br />
<br />
Finalmente, reiniciar Apache para que los cambios surtan efecto.<br />
<br />
Los datos censales y personales no pueden configurarse por punto de acceso ya que los mismos son definidos por la Institución.<br />
<br />
=== Configuración de LOGIN ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"login.php"'' a partir de la plantilla ''"login_template.php"''. <br />
<br />
En Preinscripción se dispone de un módulo de login mediante '''Google''' y '''Facebook''', que no suplanta al mecanismo de acceso tradicional, con una casilla de e-mail como nombre de usuario, sino que lo extiende y vincula a un usuario del sistema con alguno de los servicios externos habilitados.<br />
<br />
La única sección que debería editarse en el archivo ''"login.php"'' es "cuentas_ext", en el caso de querer habilitar el módulo de servicios externos. <br />
<br />
Como primera medida, establecer "'activo' => true" en el primer nivel de configuración de la citada sección. <br />
<br />
*Para utilizar el login con Google, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> google. Seguir el siguiente [[SIU-Guarani/preinscripcion3.9.0/configuracion_google| instructivo]] para generar una aplicación con la API de Google y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
*Para utilizar el login con Facebook, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> facebook. Seguir el siguiente [[SIU-Guarani/preinscripcion3.9.0/configuracion_facebook| instructivo]] para generar una aplicación con la API de Facebook y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
=== Generación de Usuarios Administradores de Puntos de Acceso ===<br />
<br />
Para crear los usuarios administradores por cada punto de acceso definido en el archivo alias.conf y config.php, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:<br />
<br />
<source lang="php" enclose="div">./preinscripcion user_admin</source><br />
<br />
y completar<br />
<br />
<source lang="php" enclose="div"><br />
Ingrese el nombre del usuario administrador (ENTER asume "admin"): [username]<br />
Ingrese el PASSWORD del usuario administrador: [password]<br />
Ingrese el ID DE PUNTO DE ACCESO en el que operara del usuario administrador (ante la duda, verificar el valor de "SetEnv ID_PTO_ACCESO" en alias.conf): [ID_PTO_ACCESO]<br />
---------------------------------------------------------<br />
Se ha creado el siguiente usuario administrador:<br />
- username: username<br />
- password: password<br />
- ID_PTO_ACCESO: ID_PTO_ACCESO<br />
---------------------------------------------------------<br />
</source><br />
<br />
=== Configuración del sistema ===<br />
<br />
Para configurar la interfaz de Preinscripción, se deberán seguir los siguientes pasos:<br />
<br />
==== Configurar archivo config.php ====<br />
<br />
En la carpeta "instalacion", crear un archivo "config.php" a partir de la plantilla "config_template.php".<br />
<br />
Este archivo contiene toda la configuración del sistema, incluyendo el acceso a base de datos de Preinscripción y Gestión, servidor de correo y los parámetros propios del sistema y de la generación de comprobantes.<br />
<br />
Recomendamos efectuar la configuración siguiendo la documentación "inline" provista en dicho archivo. Tener cuidado de no establecer la variable 'produccion' en 'true' hasta haber completado los pasos de puesta en producción.<br />
<br />
==== Configurar datos a través de la interfaz de Gestión ====<br />
<br />
A través de la interfaz de Gestión, se deberán configurar los siguientes [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|parámetros]].<br />
<br />
Asimismo, a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]], se podrán crear los turnos para la presentación de documentación por parte de los aspirantes.<br />
<br />
==== Configuración Puntos de Acceso ====<br />
<br />
Finalmente, una vez creados los usuarios administradores para cada punto de acceso, se deberán configurar sus correspondientes perfiles de datos. Esto permitirá que los diferentes puntos de acceso puedan ser administrados de forma independiente. Asimismo, los formularios de datos censales y personales solicitados no podrán configurarse independientemente sin realizar primero una personalización. Cualquier cambio realizado en los formularios de Preinscripción, se impactarán en todos los puntos de acceso.<br />
<br />
Para conocer mas detalles sobre la configuración a través del Panel de Administración, acceda [[SIU-Guarani/preinscripcion3.9.0/administracion|aquí]].<br />
<br />
=== Personalizaciones ===<br />
<br />
Si desea implementar personalizaciones (y solicitó al SIU una URL de checkout preparada a tal efecto), puede seguir la [[SIU-Guarani/preinscripcion3.9.0/personalizacion| documentación]] pertinente.<br />
<br />
=== Puesta en producción ===<br />
<br />
Se hayan efectuado o no personalizaciones, por cuestiones de performance, antes de poner el sistema en producción se deben compilar los recursos mediante el comando "preinscripcion" de la carpeta "bin": <br />
<br />
<source lang="php" enclose="div"><br />
preinscripcion compilar_recursos<br />
</source><br />
<br />
Finalmente, establecer la variable "produccion" en "true" en el archivo "config.php".<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion&diff=40448SIU-Guarani/preinscripcion3.8.0/instalacion desde cero/instalacion2018-04-09T19:24:25Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Instalación desde cero ==<br />
<br />
=== Checkout === <br />
*Crear una carpeta en el sistema de archivos, por ejemplo:<br />
*:<source lang="php" enclose="div">/usr/local/proyectos/preinscripcion</source><br />
*:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <path proyecto Preinscripción>.<br />
*Efectuar un svn checkout de la URL de la versión 3.8.0 para el nodo correspondiente a su institución. Ejemplo:<br />
*:<source lang="php" enclose="div" style="width: 650px;"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/preinscripcion/trunk/3.8.0<br />
</source><br />
<br />
*En caso de no tener creado su nodo en Colab, solicitarlo al SIU mediante el Gestor de Solicitudes (GDS). Se asignarán también los respectivos usuarios.<br><br />
<br />
=== Permisos de carpetas ===<br />
<br />
En sistemas Linux, es necesario cambiar el propietario de las carpetas "temp", "log" y "cache" de la carpeta "instalacion" al usuario y grupo de Apache. Por ejemplo, para sistemas Ubuntu, donde el usuario y grupo Apache por defecto es "www-data", ejecutar:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown www-data:www-data -R instalacion/temp<br />
sudo chown www-data:www-data -R instalacion/log<br />
sudo chown www-data:www-data -R instalacion/cache<br />
</source><br />
<br />
También es necesario dar permisos de escritura a la carpeta navegable, condición necesaria para poder ejecutar la limpieza de caché APC desde el panel de administración:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown $(whoami):www-data -R src/siu/www<br />
</source><br />
<br />
=== Instalar las dependencias del proyecto ===<br />
<br />
Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:<br />
<source lang="php" enclose="div"><br />
composer install<br />
</source> <br />
La carpeta '''vendor''' tiene establecida la propiedad ''svn:ignore'' y '''jamas se debe subir al repositorio'''.<br />
Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer]<br />
<br />
=== Base de datos === <br />
<br />
Crear una base de datos en PostgreSQL con encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
CREATE DATABASE preinscripcion<br />
WITH ENCODING='LATIN1'<br />
OWNER=postgres<br />
TEMPLATE=template0<br />
LC_COLLATE='C'<br />
LC_CTYPE='C'<br />
CONNECTION LIMIT=-1<br />
TABLESPACE=pg_default;<br />
</source><br />
<br />
Usar el archivo ''"creacion_preinscripcion3_postgresql.sql"'', que se encuentra en la carpeta "BD/creacion", para crear la estructura de la base de datos. El script está en encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
psql -d preinscripcion -h localhost < creacion_preinscripcion3_postgresql.sql -U postgres<br />
</source><br />
<br />
=== Definición de alias de acceso ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"alias.conf"'' a partir de la plantilla ''"alias_template.conf"''. Seguir los pasos allí documentados para definir los puntos de acceso de los distintos perfiles funcionales (''Administrador'' y ''Alumno'').<br />
<br />
Se deberán definir apropiadamente los alias de los puntos de acceso en función de la ubicación de la carpeta de instalación. Opcionalmente, en la configuración del punto de acceso de administración (<Location ~ "/preinscripcion_admin/*"> … ) se podrían definir restricciones para que sólo se pueda ingresar desde una intranet, siguiendo las reglas de Apache. <br />
<br />
Si se desea utilizar una misma instalación de Preinscripción como front-end de varias Unidades Académicas, cada una con su propia base de datos y personalizaciones, se debe seguir el proceso autodocumentado en el archivo, del cual presentamos a continuación un ejemplo:<br />
<br />
<source lang="php" enclose="div"><br />
<br />
# Alias del punto de acceso de ALUMNOS del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Alias del punto de acceso ADMINISTRADOR del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion_admin/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion_admin/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Configuración del directorio navegable<br />
<Directory "/path/a/preinscripcion/src/siu/www/"><br />
Options FollowSymLinks<br />
DirectoryIndex index.php<br />
<IfModule !mod_authz_core.c><br />
Order allow,deny<br />
Allow from all<br />
</IfModule><br />
<IfModule mod_authz_core.c><br />
Require all granted<br />
</IfModule><br />
include /path/a/preinscripcion/instalacion/rewrite.conf<br />
</Directory><br />
<br />
#### CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
<Location ~ "/preinscripcion/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: alumnos de la instalación del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen varios puntos de acceso, no debe repetirse este valor<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL alumno<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion/[pto_acc]<br />
</Location><br />
<br />
<Location ~ "/preinscripcion_admin/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: admin del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen puntos de acceso, tener cuidado de no repetir este valor<br />
# Debe corresponderse con el ID_PTO_ACCESO del perfil 'alumno' que administra este panel de admin.<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL admin<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion_admin/[pto_acc]<br />
<br />
# Si se desea restringir las IP desde las cuales acceder al panel de <br />
# administración, hacerlo aquí.<br />
</Location><br />
<br />
#### FIN CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
</source><br />
<br />
Para configurar los puntos de acceso, se recomienda abrir el template en un editor de texto y ''seleccionar y reemplazar'' todos los [pto_acc] y [id_pto_acc] y así evitar posibles errores en la cofiguración de este archivo.<br />
<br />
En caso de que se deseen implementar varios puntos de acceso, basta con duplicar el modelo del template y configurar las variables [pto_acc] y [id_pto_acc] con los datos de los nuevos puntos de acceso.<br />
<br />
Esta configuración debe complementarse con la definición del respectivo bloque de acceso en el archivo [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_del_sistema| config.php]].<br />
<br />
Se debe configurar el servidor Apache para tomar las definiciones del ''"alias.conf"''. <br />
<br />
<u>Ejemplo 1</u>: se puede incluir en el archivo de configuración de Apache (httpd.conf) la siguiente directiva: <br />
<br />
<source lang="php" enclose="div"><br />
Include "<path proyecto Preinscripción>/instalacion/alias.conf"<br />
</source><br />
<br />
<u>Ejemplo 2</u>: En ambientes Linux basados en Debian, se puede definir un link simbólico:<br />
<br />
<source lang="php" enclose="div"><br />
sudo ln -s <path proyecto Preinscripción>/instalacion/alias.conf /etc/apache2/sites-available/preinscripcion.conf<br />
a2ensite preinscripcion.conf<br />
service apache2 reload<br />
</source><br />
<br />
Finalmente, reiniciar Apache para que los cambios surtan efecto.<br />
<br />
Los datos censales y personales no pueden configurarse por punto de acceso ya que los mismos son definidos por la Institución.<br />
<br />
=== Configuración de LOGIN ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"login.php"'' a partir de la plantilla ''"login_template.php"''. <br />
<br />
En Preinscripción se dispone de un módulo de login mediante '''Google''' y '''Facebook''', que no suplanta al mecanismo de acceso tradicional, con una casilla de e-mail como nombre de usuario, sino que lo extiende y vincula a un usuario del sistema con alguno de los servicios externos habilitados.<br />
<br />
La única sección que debería editarse en el archivo ''"login.php"'' es "cuentas_ext", en el caso de querer habilitar el módulo de servicios externos. <br />
<br />
Como primera medida, establecer "'activo' => true" en el primer nivel de configuración de la citada sección. <br />
<br />
*Para utilizar el login con Google, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> google. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_google| instructivo]] para generar una aplicación con la API de Google y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
*Para utilizar el login con Facebook, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> facebook. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_facebook| instructivo]] para generar una aplicación con la API de Facebook y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
=== Generación de Usuarios Administradores de Puntos de Acceso ===<br />
<br />
Para crear los usuarios administradores por cada punto de acceso definido en el archivo alias.conf y config.php, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:<br />
<br />
<source lang="php" enclose="div">./preinscripcion user_admin</source><br />
<br />
y completar<br />
<br />
<source lang="php" enclose="div"><br />
Ingrese el nombre del usuario administrador (ENTER asume "admin"): [username]<br />
Ingrese el PASSWORD del usuario administrador: [password]<br />
Ingrese el ID DE PUNTO DE ACCESO en el que operara del usuario administrador (ante la duda, verificar el valor de "SetEnv ID_PTO_ACCESO" en alias.conf): [ID_PTO_ACCESO]<br />
---------------------------------------------------------<br />
Se ha creado el siguiente usuario administrador:<br />
- username: username<br />
- password: password<br />
- ID_PTO_ACCESO: ID_PTO_ACCESO<br />
---------------------------------------------------------<br />
</source><br />
<br />
=== Configuración del sistema ===<br />
<br />
Para configurar la interfaz de Preinscripción, se deberán seguir los siguientes pasos:<br />
<br />
==== Configurar archivo config.php ====<br />
<br />
En la carpeta "instalacion", crear un archivo "config.php" a partir de la plantilla "config_template.php".<br />
<br />
Este archivo contiene toda la configuración del sistema, incluyendo el acceso a base de datos de Preinscripción y Gestión, servidor de correo y los parámetros propios del sistema y de la generación de comprobantes.<br />
<br />
Recomendamos efectuar la configuración siguiendo la documentación "inline" provista en dicho archivo. Tener cuidado de no establecer la variable 'produccion' en 'true' hasta haber completado los pasos de puesta en producción.<br />
<br />
==== Configurar datos a través de la interfaz de Gestión ====<br />
<br />
A través de la interfaz de Gestión, se deberán configurar los siguientes [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|parámetros]].<br />
<br />
Asimismo, a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]], se podrán crear los turnos para la presentación de documentación por parte de los aspirantes.<br />
<br />
==== Configuración Puntos de Acceso ====<br />
<br />
Finalmente, una vez creados los usuarios administradores para cada punto de acceso, se deberán configurar sus correspondientes perfiles de datos. Esto permitirá que los diferentes puntos de acceso puedan ser administrados de forma independiente. Asimismo, los formularios de datos censales y personales solicitados no podrán configurarse independientemente sin realizar primero una personalización. Cualquier cambio realizado en los formularios de Preinscripción, se impactarán en todos los puntos de acceso.<br />
<br />
Para conocer mas detalles sobre la configuración a través del Panel de Administración, acceda [[SIU-Guarani/preinscripcion3.8.0/administracion|aquí]].<br />
<br />
=== Personalizaciones ===<br />
<br />
Si desea implementar personalizaciones (y solicitó al SIU una URL de checkout preparada a tal efecto), puede seguir la [[SIU-Guarani/preinscripcion3.8.0/personalizacion| documentación]] pertinente.<br />
<br />
=== Puesta en producción ===<br />
<br />
Se hayan efectuado o no personalizaciones, por cuestiones de performance, antes de poner el sistema en producción se deben compilar los recursos mediante el comando "preinscripcion" de la carpeta "bin": <br />
<br />
<source lang="php" enclose="div"><br />
preinscripcion compilar_recursos<br />
</source><br />
<br />
Finalmente, establecer la variable "produccion" en "true" en el archivo "config.php".<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion&diff=40447SIU-Guarani/preinscripcion3.8.0/instalacion desde cero/instalacion2018-04-09T19:16:07Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Instalación desde cero ==<br />
<br />
=== Checkout === <br />
*Crear una carpeta en el sistema de archivos, por ejemplo:<br />
*:<source lang="php" enclose="div">/usr/local/proyectos/preinscripcion</source><br />
*:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <path proyecto Preinscripción>.<br />
*Efectuar un svn checkout de la URL de la versión 3.8.0 para el nodo correspondiente a su institución. Ejemplo:<br />
*:<source lang="php" enclose="div" style="width: 650px;"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/preinscripcion/trunk/3.8.0<br />
</source><br />
<br />
*En caso de no tener creado su nodo en Colab, solicitarlo al SIU mediante el Gestor de Solicitudes (GDS). Se asignarán también los respectivos usuarios.<br><br />
<br />
=== Permisos de carpetas ===<br />
<br />
En sistemas Linux, es necesario cambiar el propietario de las carpetas "temp", "log" y "cache" de la carpeta "instalacion" al usuario y grupo de Apache. Por ejemplo, para sistemas Ubuntu, donde el usuario y grupo Apache por defecto es "www-data", ejecutar:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown $(whoami):www-data -R instalacion/temp<br />
sudo chown $(whoami):www-data -R instalacion/log<br />
sudo chown $(whoami):www-data -R instalacion/cache<br />
</source><br />
<br />
También es necesario dar permisos de escritura a la carpeta navegable, condición necesaria para poder ejecutar la limpieza de caché APC desde el panel de administración:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown $(whoami):www-data -R src/siu/www<br />
</source><br />
<br />
=== Instalar las dependencias del proyecto ===<br />
<br />
Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:<br />
<source lang="php" enclose="div"><br />
composer install<br />
</source> <br />
La carpeta '''vendor''' tiene establecida la propiedad ''svn:ignore'' y '''jamas se debe subir al repositorio'''.<br />
Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer]<br />
<br />
=== Base de datos === <br />
<br />
Crear una base de datos en PostgreSQL con encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
CREATE DATABASE preinscripcion<br />
WITH ENCODING='LATIN1'<br />
OWNER=postgres<br />
TEMPLATE=template0<br />
LC_COLLATE='C'<br />
LC_CTYPE='C'<br />
CONNECTION LIMIT=-1<br />
TABLESPACE=pg_default;<br />
</source><br />
<br />
Usar el archivo ''"creacion_preinscripcion3_postgresql.sql"'', que se encuentra en la carpeta "BD/creacion", para crear la estructura de la base de datos. El script está en encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
psql -d preinscripcion -h localhost < creacion_preinscripcion3_postgresql.sql -U postgres<br />
</source><br />
<br />
=== Definición de alias de acceso ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"alias.conf"'' a partir de la plantilla ''"alias_template.conf"''. Seguir los pasos allí documentados para definir los puntos de acceso de los distintos perfiles funcionales (''Administrador'' y ''Alumno'').<br />
<br />
Se deberán definir apropiadamente los alias de los puntos de acceso en función de la ubicación de la carpeta de instalación. Opcionalmente, en la configuración del punto de acceso de administración (<Location ~ "/preinscripcion_admin/*"> … ) se podrían definir restricciones para que sólo se pueda ingresar desde una intranet, siguiendo las reglas de Apache. <br />
<br />
Si se desea utilizar una misma instalación de Preinscripción como front-end de varias Unidades Académicas, cada una con su propia base de datos y personalizaciones, se debe seguir el proceso autodocumentado en el archivo, del cual presentamos a continuación un ejemplo:<br />
<br />
<source lang="php" enclose="div"><br />
<br />
# Alias del punto de acceso de ALUMNOS del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Alias del punto de acceso ADMINISTRADOR del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion_admin/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion_admin/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Configuración del directorio navegable<br />
<Directory "/path/a/preinscripcion/src/siu/www/"><br />
Options FollowSymLinks<br />
DirectoryIndex index.php<br />
<IfModule !mod_authz_core.c><br />
Order allow,deny<br />
Allow from all<br />
</IfModule><br />
<IfModule mod_authz_core.c><br />
Require all granted<br />
</IfModule><br />
include /path/a/preinscripcion/instalacion/rewrite.conf<br />
</Directory><br />
<br />
#### CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
<Location ~ "/preinscripcion/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: alumnos de la instalación del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen varios puntos de acceso, no debe repetirse este valor<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL alumno<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion/[pto_acc]<br />
</Location><br />
<br />
<Location ~ "/preinscripcion_admin/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: admin del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen puntos de acceso, tener cuidado de no repetir este valor<br />
# Debe corresponderse con el ID_PTO_ACCESO del perfil 'alumno' que administra este panel de admin.<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL admin<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion_admin/[pto_acc]<br />
<br />
# Si se desea restringir las IP desde las cuales acceder al panel de <br />
# administración, hacerlo aquí.<br />
</Location><br />
<br />
#### FIN CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
</source><br />
<br />
Para configurar los puntos de acceso, se recomienda abrir el template en un editor de texto y ''seleccionar y reemplazar'' todos los [pto_acc] y [id_pto_acc] y así evitar posibles errores en la cofiguración de este archivo.<br />
<br />
En caso de que se deseen implementar varios puntos de acceso, basta con duplicar el modelo del template y configurar las variables [pto_acc] y [id_pto_acc] con los datos de los nuevos puntos de acceso.<br />
<br />
Esta configuración debe complementarse con la definición del respectivo bloque de acceso en el archivo [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_del_sistema| config.php]].<br />
<br />
Se debe configurar el servidor Apache para tomar las definiciones del ''"alias.conf"''. <br />
<br />
<u>Ejemplo 1</u>: se puede incluir en el archivo de configuración de Apache (httpd.conf) la siguiente directiva: <br />
<br />
<source lang="php" enclose="div"><br />
Include "<path proyecto Preinscripción>/instalacion/alias.conf"<br />
</source><br />
<br />
<u>Ejemplo 2</u>: En ambientes Linux basados en Debian, se puede definir un link simbólico:<br />
<br />
<source lang="php" enclose="div"><br />
sudo ln -s <path proyecto Preinscripción>/instalacion/alias.conf /etc/apache2/sites-available/preinscripcion.conf<br />
a2ensite preinscripcion.conf<br />
service apache2 reload<br />
</source><br />
<br />
Finalmente, reiniciar Apache para que los cambios surtan efecto.<br />
<br />
Los datos censales y personales no pueden configurarse por punto de acceso ya que los mismos son definidos por la Institución.<br />
<br />
=== Configuración de LOGIN ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"login.php"'' a partir de la plantilla ''"login_template.php"''. <br />
<br />
En Preinscripción se dispone de un módulo de login mediante '''Google''' y '''Facebook''', que no suplanta al mecanismo de acceso tradicional, con una casilla de e-mail como nombre de usuario, sino que lo extiende y vincula a un usuario del sistema con alguno de los servicios externos habilitados.<br />
<br />
La única sección que debería editarse en el archivo ''"login.php"'' es "cuentas_ext", en el caso de querer habilitar el módulo de servicios externos. <br />
<br />
Como primera medida, establecer "'activo' => true" en el primer nivel de configuración de la citada sección. <br />
<br />
*Para utilizar el login con Google, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> google. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_google| instructivo]] para generar una aplicación con la API de Google y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
*Para utilizar el login con Facebook, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> facebook. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_facebook| instructivo]] para generar una aplicación con la API de Facebook y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
=== Generación de Usuarios Administradores de Puntos de Acceso ===<br />
<br />
Para crear los usuarios administradores por cada punto de acceso definido en el archivo alias.conf y config.php, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:<br />
<br />
<source lang="php" enclose="div">./preinscripcion user_admin</source><br />
<br />
y completar<br />
<br />
<source lang="php" enclose="div"><br />
Ingrese el nombre del usuario administrador (ENTER asume "admin"): [username]<br />
Ingrese el PASSWORD del usuario administrador: [password]<br />
Ingrese el ID DE PUNTO DE ACCESO en el que operara del usuario administrador (ante la duda, verificar el valor de "SetEnv ID_PTO_ACCESO" en alias.conf): [ID_PTO_ACCESO]<br />
---------------------------------------------------------<br />
Se ha creado el siguiente usuario administrador:<br />
- username: username<br />
- password: password<br />
- ID_PTO_ACCESO: ID_PTO_ACCESO<br />
---------------------------------------------------------<br />
</source><br />
<br />
=== Configuración del sistema ===<br />
<br />
Para configurar la interfaz de Preinscripción, se deberán seguir los siguientes pasos:<br />
<br />
==== Configurar archivo config.php ====<br />
<br />
En la carpeta "instalacion", crear un archivo "config.php" a partir de la plantilla "config_template.php".<br />
<br />
Este archivo contiene toda la configuración del sistema, incluyendo el acceso a base de datos de Preinscripción y Gestión, servidor de correo y los parámetros propios del sistema y de la generación de comprobantes.<br />
<br />
Recomendamos efectuar la configuración siguiendo la documentación "inline" provista en dicho archivo. Tener cuidado de no establecer la variable 'produccion' en 'true' hasta haber completado los pasos de puesta en producción.<br />
<br />
==== Configurar datos a través de la interfaz de Gestión ====<br />
<br />
A través de la interfaz de Gestión, se deberán configurar los siguientes [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|parámetros]].<br />
<br />
Asimismo, a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]], se podrán crear los turnos para la presentación de documentación por parte de los aspirantes.<br />
<br />
==== Configuración Puntos de Acceso ====<br />
<br />
Finalmente, una vez creados los usuarios administradores para cada punto de acceso, se deberán configurar sus correspondientes perfiles de datos. Esto permitirá que los diferentes puntos de acceso puedan ser administrados de forma independiente. Asimismo, los formularios de datos censales y personales solicitados no podrán configurarse independientemente sin realizar primero una personalización. Cualquier cambio realizado en los formularios de Preinscripción, se impactarán en todos los puntos de acceso.<br />
<br />
Para conocer mas detalles sobre la configuración a través del Panel de Administración, acceda [[SIU-Guarani/preinscripcion3.8.0/administracion|aquí]].<br />
<br />
=== Personalizaciones ===<br />
<br />
Si desea implementar personalizaciones (y solicitó al SIU una URL de checkout preparada a tal efecto), puede seguir la [[SIU-Guarani/preinscripcion3.8.0/personalizacion| documentación]] pertinente.<br />
<br />
=== Puesta en producción ===<br />
<br />
Se hayan efectuado o no personalizaciones, por cuestiones de performance, antes de poner el sistema en producción se deben compilar los recursos mediante el comando "preinscripcion" de la carpeta "bin": <br />
<br />
<source lang="php" enclose="div"><br />
preinscripcion compilar_recursos<br />
</source><br />
<br />
Finalmente, establecer la variable "produccion" en "true" en el archivo "config.php".<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/actualizacion&diff=40428SIU-Guarani/preinscripcion3.8.0/actualizacion2018-04-09T15:12:01Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores.'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.8.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.8.0 <institución>: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un backup de la base de datos de producción.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.1<br />
</source><br />
#Sobre la base de producción, correr el script '''mig_v3.7_a_v3.8.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.<br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' y completarlo, usando como referencia el archivo guardado en el paso 1, y definiendo las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/actualizacion&diff=45392SIU-Guarani/preinscripcion3.9.0/actualizacion2018-04-09T15:12:01Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores.'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.9.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.9.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.9.0 <institución>: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.9.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.9.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.9.0.x<br />
-m "<siglas institución> Creación de la version 3.9.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un backup de la base de datos de producción.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.9.0.1<br />
</source><br />
#Sobre la base de producción, correr el script '''mig_v3.7_a_v3.9.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.<br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' y completarlo, usando como referencia el archivo guardado en el paso 1, y definiendo las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/actualizacion&diff=40426SIU-Guarani/preinscripcion3.8.0/actualizacion2018-04-09T14:56:51Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores.'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.8.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.8.0 <institución>: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un backup de la base de datos de producción.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.1<br />
</source><br />
#Sobre la base de producción, correr el script '''mig_v3.7_a_v3.8.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.<br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' de la presente versión, y completarlo, usando como base el archivo guardado en el paso 1, y completando las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion&diff=40424SIU-Guarani/preinscripcion3.8.0/instalacion desde cero/instalacion2018-04-09T14:35:48Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Instalación desde cero ==<br />
<br />
=== Checkout === <br />
*Crear una carpeta en el sistema de archivos, por ejemplo:<br />
*:<source lang="php" enclose="div">/usr/local/proyectos/preinscripcion</source><br />
*:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <path proyecto Preinscripción>.<br />
*Efectuar un svn checkout de la URL de la versión 3.8.0 para el nodo correspondiente a su institución. Ejemplo:<br />
*:<source lang="php" enclose="div" style="width: 650px;"><br />
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/preinscripcion/trunk/3.8.0<br />
</source><br />
<br />
*En caso de no tener creado su nodo en Colab, solicitarlo al SIU mediante el Gestor de Solicitudes (GDS). Se asignarán también los respectivos usuarios.<br><br />
<br />
=== Permisos de carpetas ===<br />
<br />
En sistemas Linux, es necesario cambiar el propietario de las carpetas "temp", "log" y "cache" de la carpeta "instalacion" al usuario y grupo de Apache. Por ejemplo, para sistemas Ubuntu, donde el usuario y grupo Apache por defecto es "www-data", ejecutar:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown $(whoami):www-data -R instalacion/temp<br />
sudo chown $(whoami):www-data -R instalacion/log<br />
sudo chown $(whoami):www-data -R instalacion/cache<br />
</source><br />
<br />
También es necesario dar permisos de escritura a la carpeta navegable, condición necesaria para poder ejecutar la limpieza de caché APC desde el panel de administración:<br />
<br />
<source lang="php" enclose="div"><br />
sudo chown $(whoami):www-data -R src/siu/www<br />
</source><br />
<br />
=== Instalar las dependencias del proyecto ===<br />
<br />
Parados sobre el directorio raíz de nuestro proyecto ejecutar el siguiente comando para descargar las dependencias del mismo:<br />
<source lang="php" enclose="div"><br />
composer install<br />
</source> <br />
La carpeta '''vendor''' tiene establecida la propiedad ''svn:ignore'' y '''jamas se debe subir al repositorio'''.<br />
Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer]<br />
<br />
=== Base de datos === <br />
<br />
Crear una base de datos en PostgreSQL con encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
CREATE DATABASE preinscripcion<br />
WITH ENCODING='LATIN1'<br />
OWNER=postgres<br />
TEMPLATE=template0<br />
LC_COLLATE='C'<br />
LC_CTYPE='C'<br />
CONNECTION LIMIT=-1<br />
TABLESPACE=pg_default;<br />
</source><br />
<br />
Usar el archivo ''"creacion_preinscripcion3_postgresql.sql"'', que se encuentra en la carpeta "BD/creacion", para crear la estructura de la base de datos. El script está en encoding LATIN1. Ejemplo: <br />
<br />
<source lang="php" enclose="div"><br />
psql -d preinscripcion -h localhost < creacion_preinscripcion3_postgresql.sql -U postgres<br />
</source><br />
<br />
=== Definición de alias de acceso ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"alias.conf"'' a partir de la plantilla ''"alias_template.conf"''. Seguir los pasos allí documentados para definir los puntos de acceso de los distintos perfiles funcionales (''Administrador'' y ''Alumno'').<br />
<br />
Se deberán definir apropiadamente los alias de los puntos de acceso en función de la ubicación de la carpeta de instalación. Opcionalmente, en la configuración del punto de acceso de administración (<Location ~ "/preinscripcion_admin/*"> … ) se podrían definir restricciones para que sólo se pueda ingresar desde una intranet, siguiendo las reglas de Apache. <br />
<br />
Si se desea utilizar una misma instalación de Preinscripción como front-end de varias Unidades Académicas, cada una con su propia base de datos y personalizaciones, se debe seguir el proceso autodocumentado en el archivo, del cual presentamos a continuación un ejemplo:<br />
<br />
<source lang="php" enclose="div"><br />
<br />
# Alias del punto de acceso de ALUMNOS del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Alias del punto de acceso ADMINISTRADOR del punto de acceso [pto_acc] <br />
# Ejemplo: /preinscripcion_admin/ingenieria<br />
# Reemplazarlo según corresponda<br />
Alias /preinscripcion_admin/[pto_acc] "/path/a/preinscripcion/src/siu/www/"<br />
<br />
# Configuración del directorio navegable<br />
<Directory "/path/a/preinscripcion/src/siu/www/"><br />
Options FollowSymLinks<br />
DirectoryIndex index.php<br />
<IfModule !mod_authz_core.c><br />
Order allow,deny<br />
Allow from all<br />
</IfModule><br />
<IfModule mod_authz_core.c><br />
Require all granted<br />
</IfModule><br />
include /path/a/preinscripcion/instalacion/rewrite.conf<br />
</Directory><br />
<br />
#### CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
<Location ~ "/preinscripcion/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: alumnos de la instalación del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen varios puntos de acceso, no debe repetirse este valor<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL alumno<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion/[pto_acc]<br />
</Location><br />
<br />
<Location ~ "/preinscripcion_admin/[pto_acc]/*"><br />
# --------------------------------------------------------------------------<br />
# PUNTO DE ACCESO: admin del punto de acceso [pto_acc]<br />
# --------------------------------------------------------------------------<br />
<br />
# Nombre o ID del Punto de Acceso. No utilizar espacios.<br />
# Si se definen puntos de acceso, tener cuidado de no repetir este valor<br />
# Debe corresponderse con el ID_PTO_ACCESO del perfil 'alumno' que administra este panel de admin.<br />
SetEnv ID_PTO_ACCESO [id_pto_acc]<br />
<br />
# Setea el perfil funcional de quienes acceden por este punto de acceso.<br />
# NO MODIFICAR ESTE VALOR<br />
SetEnv PERFIL admin<br />
<br />
# se setea de esta manera para que esta variable sea accesible desde mod_rewrite<br />
# ATENCIÓN: el alias debe empezar con '/'<br />
SetEnvIf always_match ^ ACC_ALIAS=/preinscripcion_admin/[pto_acc]<br />
<br />
# Si se desea restringir las IP desde las cuales acceder al panel de <br />
# administración, hacerlo aquí.<br />
</Location><br />
<br />
#### FIN CONFIGURACION DE ACCESO [pto_acc]<br />
<br />
</source><br />
<br />
Para configurar los puntos de acceso, se recomienda abrir el template en un editor de texto y ''seleccionar y reemplazar'' todos los [pto_acc] y [id_pto_acc] y así evitar posibles errores en la cofiguración de este archivo.<br />
<br />
En caso de que se deseen implementar varios puntos de acceso, basta con duplicar el modelo del template y configurar las variables [pto_acc] y [id_pto_acc] con los datos de los nuevos puntos de acceso.<br />
<br />
Esta configuración debe complementarse con la definición del respectivo bloque de acceso en el archivo [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_del_sistema| config.php]].<br />
<br />
Se debe configurar el servidor Apache para tomar las definiciones del ''"alias.conf"''. <br />
<br />
<u>Ejemplo 1</u>: se puede incluir en el archivo de configuración de Apache (httpd.conf) la siguiente directiva: <br />
<br />
<source lang="php" enclose="div"><br />
Include "<path proyecto Preinscripción>/instalacion/alias.conf"<br />
</source><br />
<br />
<u>Ejemplo 2</u>: En ambientes Linux basados en Debian, se puede definir un link simbólico:<br />
<br />
<source lang="php" enclose="div"><br />
sudo ln -s <path proyecto Preinscripción>/instalacion/alias.conf /etc/apache2/sites-enabled/preinscripcion.conf<br />
</source><br />
<br />
Finalmente, reiniciar Apache para que los cambios surtan efecto.<br />
<br />
Los datos censales y personales no pueden configurarse por punto de acceso ya que los mismos son definidos por la Institución.<br />
<br />
=== Configuración de LOGIN ===<br />
<br />
En la carpeta "instalacion", crear un archivo ''"login.php"'' a partir de la plantilla ''"login_template.php"''. <br />
<br />
En Preinscripción se dispone de un módulo de login mediante '''Google''' y '''Facebook''', que no suplanta al mecanismo de acceso tradicional, con una casilla de e-mail como nombre de usuario, sino que lo extiende y vincula a un usuario del sistema con alguno de los servicios externos habilitados.<br />
<br />
La única sección que debería editarse en el archivo ''"login.php"'' es "cuentas_ext", en el caso de querer habilitar el módulo de servicios externos. <br />
<br />
Como primera medida, establecer "'activo' => true" en el primer nivel de configuración de la citada sección. <br />
<br />
*Para utilizar el login con Google, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> google. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_google| instructivo]] para generar una aplicación con la API de Google y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
*Para utilizar el login con Facebook, establecer 'activo' => true dentro de cuentas_ext -> parametros -> proveedores -> facebook. Seguir el siguiente [[SIU-Guarani/preinscripcion3.8.0/configuracion_facebook| instructivo]] para generar una aplicación con la API de Facebook y obtener los valores para completar los parámetros "app_key" y "app_secret" de la sección de configuración de login.<br />
<br />
=== Generación de Usuarios Administradores de Puntos de Acceso ===<br />
<br />
Para crear los usuarios administradores por cada punto de acceso definido en el archivo alias.conf y config.php, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:<br />
<br />
<source lang="php" enclose="div">./preinscripcion user_admin</source><br />
<br />
y completar<br />
<br />
<source lang="php" enclose="div"><br />
Ingrese el nombre del usuario administrador (ENTER asume "admin"): [username]<br />
Ingrese el PASSWORD del usuario administrador: [password]<br />
Ingrese el ID DE PUNTO DE ACCESO en el que operara del usuario administrador (ante la duda, verificar el valor de "SetEnv ID_PTO_ACCESO" en alias.conf): [ID_PTO_ACCESO]<br />
---------------------------------------------------------<br />
Se ha creado el siguiente usuario administrador:<br />
- username: username<br />
- password: password<br />
- ID_PTO_ACCESO: ID_PTO_ACCESO<br />
---------------------------------------------------------<br />
</source><br />
<br />
=== Configuración del sistema ===<br />
<br />
Para configurar la interfaz de Preinscripción, se deberán seguir los siguientes pasos:<br />
<br />
==== Configurar archivo config.php ====<br />
<br />
En la carpeta "instalacion", crear un archivo "config.php" a partir de la plantilla "config_template.php".<br />
<br />
Este archivo contiene toda la configuración del sistema, incluyendo el acceso a base de datos de Preinscripción y Gestión, servidor de correo y los parámetros propios del sistema y de la generación de comprobantes.<br />
<br />
Recomendamos efectuar la configuración siguiendo la documentación "inline" provista en dicho archivo. Tener cuidado de no establecer la variable 'produccion' en 'true' hasta haber completado los pasos de puesta en producción.<br />
<br />
==== Configurar datos a través de la interfaz de Gestión ====<br />
<br />
A través de la interfaz de Gestión, se deberán configurar los siguientes [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|parámetros]].<br />
<br />
Asimismo, a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]], se podrán crear los turnos para la presentación de documentación por parte de los aspirantes.<br />
<br />
==== Configuración Puntos de Acceso ====<br />
<br />
Finalmente, una vez creados los usuarios administradores para cada punto de acceso, se deberán configurar sus correspondientes perfiles de datos. Esto permitirá que los diferentes puntos de acceso puedan ser administrados de forma independiente. Asimismo, los formularios de datos censales y personales solicitados no podrán configurarse independientemente sin realizar primero una personalización. Cualquier cambio realizado en los formularios de Preinscripción, se impactarán en todos los puntos de acceso.<br />
<br />
Para conocer mas detalles sobre la configuración a través del Panel de Administración, acceda [[SIU-Guarani/preinscripcion3.8.0/administracion|aquí]].<br />
<br />
=== Personalizaciones ===<br />
<br />
Si desea implementar personalizaciones (y solicitó al SIU una URL de checkout preparada a tal efecto), puede seguir la [[SIU-Guarani/preinscripcion3.8.0/personalizacion| documentación]] pertinente.<br />
<br />
=== Puesta en producción ===<br />
<br />
Se hayan efectuado o no personalizaciones, por cuestiones de performance, antes de poner el sistema en producción se deben compilar los recursos mediante el comando "preinscripcion" de la carpeta "bin": <br />
<br />
<source lang="php" enclose="div"><br />
preinscripcion compilar_recursos<br />
</source><br />
<br />
Finalmente, establecer la variable "produccion" en "true" en el archivo "config.php".<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0&diff=40423SIU-Guarani/preinscripcion3.8.02018-04-09T14:26:16Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Preinscripción 3.8.0 ==<br />
<br />
Preinscripción es una de las tres interfaces del proyecto SIU-Guaraní 3. La misma funciona como un módulo "satélite", destinado a registrar las preinscripciones de Aspirantes a las Propuestas Formativas ofrecidas por la Institución dentro de los periodos de definidos a tal efecto, colectando en ese proceso autogestionado una serie de datos personales y censales que luego serán mantenidos por el Módulo de Gestión Académica.<br />
<br />
Esta interfaz cuenta con una base de datos propia, en la cual se recolecta la información de los aspirantes. Asimismo, posee una conexión directa con la interfaz de Gestión, para obtener datos de manera en línea (por ejemplo, Propuestas disponibles, Ubicaciones, Períodos, etcétera).<br />
<br />
'''Desde la versión 3.7.0 en adelante, Preinscripción presenta un gran cambio estructural respecto de versiones anteriores, porque se abandona el concepto de "base descartable", de un uso, a la que se le exportan datos desde Gestión y trabaja de manera desconectada. En este nuevo escenario, Preinscripción consume directamente la información que necesita de Guaraní (apoyandose en una caché de corto plazo para evitar cuellos de botella), y mantiene en su base propia la información autogestionada por los aspirantes, hasta que son incorporados efectivamente en Gestión.''' '''Para más información, revisar la documentación de la versión [[SIU-Guarani/preinscripcion3.7.0|3.7.0]] de Preinscripción.'''<br />
<br />
Preinscripción puede ser implementado tanto de forma centralizada como distribuida, mediante varios puntos de accesos, aunque siempre vinculada a una misma interfaz de Gestión. Se recomienda fuertemente mantener un mismo criterio a la hora de implementar Preinscripción y Gestión: ambos centralizados o ambos descentralizados, pero siempre manteniendo una relación uno a uno. En caso de implementar de manera centralizada, a través de los puntos de acceso se puede gestionar de una forma flexible los aspirantes de la Institución por Responsables Académicas, Tipos de Propuestas, Ubicaciones, Propuestas Formativas, o cualquier combinación de ellas.<br />
<br />
===Compatibilidad con SIU-Guaraní Gestión ===<br />
<br />
La presente versión de Preinscripción es compatible con la versión 3.15.0, o posterior, de SIU-Guaraní Gestión. <br />
<br />
=== Novedades de la versión ===<br />
<br />
# Se incorpora la carga de [[SIU-Guarani/preinscripcion3.8.0/alumno#Documentaci.C3.B3n_digital|documentos digitales]] para los requisitos de ingreso de las propuestas elegidas por el aspirante.<br />
# Ajustes en la búsqueda de códigos postales en popup de búsqueda avanzada de localidades.<br />
# Normalización a minúsculas del mail del aspirante (usado como nombre de usuario al momento del login).<br />
<br />
=== Documentación ===<br />
<br />
*[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|Documentación técnica]]<br />
*[[SIU-Guarani/preinscripcion3.8.0/documentacion_funcional|Documentación funcional]]<br />
<br />
[[SIU-Guarani|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0&diff=45383SIU-Guarani/preinscripcion3.9.02018-04-09T14:26:16Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Preinscripción 3.9.0 ==<br />
<br />
Preinscripción es una de las tres interfaces del proyecto SIU-Guaraní 3. La misma funciona como un módulo "satélite", destinado a registrar las preinscripciones de Aspirantes a las Propuestas Formativas ofrecidas por la Institución dentro de los periodos de definidos a tal efecto, colectando en ese proceso autogestionado una serie de datos personales y censales que luego serán mantenidos por el Módulo de Gestión Académica.<br />
<br />
Esta interfaz cuenta con una base de datos propia, en la cual se recolecta la información de los aspirantes. Asimismo, posee una conexión directa con la interfaz de Gestión, para obtener datos de manera en línea (por ejemplo, Propuestas disponibles, Ubicaciones, Períodos, etcétera).<br />
<br />
'''Desde la versión 3.7.0 en adelante, Preinscripción presenta un gran cambio estructural respecto de versiones anteriores, porque se abandona el concepto de "base descartable", de un uso, a la que se le exportan datos desde Gestión y trabaja de manera desconectada. En este nuevo escenario, Preinscripción consume directamente la información que necesita de Guaraní (apoyandose en una caché de corto plazo para evitar cuellos de botella), y mantiene en su base propia la información autogestionada por los aspirantes, hasta que son incorporados efectivamente en Gestión.''' '''Para más información, revisar la documentación de la versión [[SIU-Guarani/preinscripcion3.7.0|3.7.0]] de Preinscripción.'''<br />
<br />
Preinscripción puede ser implementado tanto de forma centralizada como distribuida, mediante varios puntos de accesos, aunque siempre vinculada a una misma interfaz de Gestión. Se recomienda fuertemente mantener un mismo criterio a la hora de implementar Preinscripción y Gestión: ambos centralizados o ambos descentralizados, pero siempre manteniendo una relación uno a uno. En caso de implementar de manera centralizada, a través de los puntos de acceso se puede gestionar de una forma flexible los aspirantes de la Institución por Responsables Académicas, Tipos de Propuestas, Ubicaciones, Propuestas Formativas, o cualquier combinación de ellas.<br />
<br />
===Compatibilidad con SIU-Guaraní Gestión ===<br />
<br />
La presente versión de Preinscripción es compatible con la versión 3.15.0, o posterior, de SIU-Guaraní Gestión. <br />
<br />
=== Novedades de la versión ===<br />
<br />
# Se incorpora la carga de [[SIU-Guarani/preinscripcion3.9.0/alumno#Documentaci.C3.B3n_digital|documentos digitales]] para los requisitos de ingreso de las propuestas elegidas por el aspirante.<br />
# Ajustes en la búsqueda de códigos postales en popup de búsqueda avanzada de localidades.<br />
# Normalización a minúsculas del mail del aspirante (usado como nombre de usuario al momento del login).<br />
<br />
=== Documentación ===<br />
<br />
*[[SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica|Documentación técnica]]<br />
*[[SIU-Guarani/preinscripcion3.9.0/documentacion_funcional|Documentación funcional]]<br />
<br />
[[SIU-Guarani|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/apc&diff=40358SIU-Guarani/preinscripcion3.8.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/apc&diff=45390SIU-Guarani/preinscripcion3.9.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.10.0/instalacion_desde_cero/apc&diff=57633SIU-Guarani/preinscripcion3.10.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.10.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.11.0/instalacion_desde_cero/apc&diff=65862SIU-Guarani/preinscripcion3.11.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.11.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.12.0/instalacion_desde_cero/apc&diff=72535SIU-Guarani/preinscripcion3.12.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.12.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.13.0/instalacion_desde_cero/apc&diff=76773SIU-Guarani/preinscripcion3.13.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.13.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.21.0/instalacion_desde_cero/apc&diff=87111SIU-Guarani/preinscripcion3.21.0/instalacion desde cero/apc2018-04-06T15:26:16Z<p>Fmartinez: </p>
<hr />
<div>== Consideraciones sobre la caché APC ==<br />
<br />
Como una medida de eficiencia para optimizar los tiempos de respuesta, el sistema utiliza una herramienta de caché para almacenar datos obtenidos de la base propia y a través de la interfaz con Gestión. El mecanismo utilizado es APC, también conocido como "caché alternativo de PHP" (por las siglas en inglés de Alternative PHP Cache). Es un código de operación de caché libre y abierto para PHP. <br />
<br />
Los datos obtenidos desde Gestión se almacenan en caché por un período que oscila entre los 5 segundos y los 5 minutos, dependiendo de qué tan factible sea que se produzca alguna modificación. Dichos valores pueden ser personalizados.<br />
<br />
Si en algún momento se necesita refrescar toda la caché, se dispone de una operación en el panel de Administración de Preinscripción provista a tal efecto.<br />
<br />
[[SIU-Guarani/preinscripcion3.21.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/actualizacion&diff=40352SIU-Guarani/preinscripcion3.8.0/actualizacion2018-04-06T14:07:53Z<p>Fmartinez: </p>
<hr />
<div>== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.8.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.8.0 UNX: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un backup de la base de datos de producción.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.1<br />
</source><br />
#Sobre la base de producción, correr el script '''mig_v3.7_a_v3.8.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.<br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' de la presente versión, y completarlo, usando como base el archivo guardado en el paso 1, y completando las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/actualizacion&diff=40351SIU-Guarani/preinscripcion3.8.0/actualizacion2018-04-06T14:07:24Z<p>Fmartinez: </p>
<hr />
<div>== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.8.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.8.0 UNX: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un backup de la base de datos de producción.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.1<br />
</source><br />
#Sobre la base de producción, correr el script '''mig_v3.7_a_v3.8.sql''', distribuido con la versión en la carpeta '''BD/Conversion'''.<br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' de la presente versión, y completarlo, usando como base el archivo guardado en el paso 1, y completando las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/actualizacion&diff=40350SIU-Guarani/preinscripcion3.8.0/actualizacion2018-04-06T13:53:05Z<p>Fmartinez: </p>
<hr />
<div>== Actualización desde versión 3.7.0 ==<br />
<br />
'''<u>IMPORTANTE</u>: Recordar que la versión 3.7.0 representa un cambio importante en cuanto a modelo y arquitectura, por lo que no es posible migrar automáticamente las personalizaciones de versiones anteriores'''<br />
<br />
Si se dispone de una instalación en producción de la versión 3.7.0 de Preinscripción y se desea actualizar a 3.8.0, recomendamos seguir los siguientes pasos:<br />
<br />
=== Copia de personalizaciones ===<br />
<br />
Si se han desarrollado personalizaciones en la versión 3.7.0, seguir los siguientes pasos en un '''servidor de desarrollo''':<br />
<br />
'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.7.0, todas las personalizaciones <br />
<br />
Realizar una copia de las personalizaciones anteriores a la nueva versión. <br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.7.0/src/pers/nombre_carpeta_pers<br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0/src/pers/nombre_carpeta_pers<br />
-m "Personalizaciones Preinscripción 3.8.0 UNX: se copian las personalizaciones de la versión 3.7.0"<br />
</source><br />
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.<br />
<br />
=== Versión de cuatro dígitos ===<br />
<br />
Realizar una instalación de desarrollo para probar la compatibilidad de personalizaciones. Una vez testeadas, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.<br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
=== Instalación en producción ===<br />
<br />
Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:<br />
<br />
#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.<br />
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:<br />
#:<source lang="bash" enclose="div"><br />
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.1<br />
</source><br />
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' de la presente versión, y completarlo, usando como base el archivo guardado en el paso 1, y completando las nuevas configuraciones de la presente versión.<br />
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/crear_version_propia&diff=40349SIU-Guarani/preinscripcion3.8.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.8.0.1, 3.8.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.8.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.8.0.x<br />
-m "<siglas institución> Creación de la version 3.8.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/crear_version_propia&diff=45395SIU-Guarani/preinscripcion3.9.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.9.0.1, 3.9.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.9.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.9.0.x<br />
-m "<siglas institución> Creación de la version 3.9.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.10.0/crear_version_propia&diff=57638SIU-Guarani/preinscripcion3.10.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.10.0.1, 3.10.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.10.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.10.0.x<br />
-m "<siglas institución> Creación de la version 3.10.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.10.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.10.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.11.0/crear_version_propia&diff=65867SIU-Guarani/preinscripcion3.11.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.11.0.1, 3.11.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.11.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.11.0.x<br />
-m "<siglas institución> Creación de la version 3.11.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.11.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.11.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.12.0/crear_version_propia&diff=72540SIU-Guarani/preinscripcion3.12.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.12.0.1, 3.12.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.12.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.12.0.x<br />
-m "<siglas institución> Creación de la version 3.12.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.12.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.12.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.13.0/crear_version_propia&diff=76778SIU-Guarani/preinscripcion3.13.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.13.0.1, 3.13.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.13.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.13.0.x<br />
-m "<siglas institución> Creación de la version 3.13.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.13.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.13.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.21.0/crear_version_propia&diff=87116SIU-Guarani/preinscripcion3.21.0/crear version propia2018-04-06T13:43:14Z<p>Fmartinez: </p>
<hr />
<div>== Creación de una nueva versión propia del sistema (versión de cuatro dígitos) ==<br />
<br />
Se recomienda liberar una versión propia del sistema, a partir de la nueva versión proporcionada por el SIU sumando las personalizaciones realizadas. La idea es que a medida que se van desarrollando y testeando personalizaciones, se proceda con la creación de una nueva versión propia incluyendo un cuarto dígito para pasar estos cambios a producción (Ej.: 3.21.0.1, 3.21.0.2, etc.). <br />
<br />
El servidor de producción, a diferencia del de desarrollo, debe siempre apuntar a versiones propias (de 4 dígitos) incluidas en la carpeta '''https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/'''. Esto práctica es alentada para evitar errores y tener un mejor control de los cambios y personalizaciones aplicadas.<br />
<br />
Para liberar versiones propias, una vez realizadas las personalizaciones, habiendo verificado su correcto funcionamiento en el ambiente de desarrollo y commiteadas en la rama del SVN correspondiente, se debe proceder con la creación de la rama de SVN de la versión propia, que contendrá los archivos que componen la misma. <br />
<br />
<source lang="bash" enclose="div"><br />
svn cp <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.21.0 <br />
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.21.0.x<br />
-m "<siglas institución> Creación de la version 3.21.0.x de Preinscripción"<br />
</source><br />
<br />
Finalmente, usar esa rama creada para realizar la instalación en el servidor de producción como se explica en la [[SIU-Guarani/preinscripcion3.21.0/instalacion_desde_cero/instalacion| guía de instalación]].<br />
<br />
[[SIU-Guarani/preinscripcion3.21.0/documentacion_tecnica|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica&diff=40348SIU-Guarani/preinscripcion3.8.0/documentacion tecnica2018-04-06T13:09:59Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Documentación Técnica ==<br />
<br />
=== Instalación desde cero ===<br />
<br />
* [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/requisitos|Requisitos]]<br />
* [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/apc|Consideraciones sobre la caché APC]]<br />
* [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion|Pasos para la instalación]]<br />
<br />
=== [[SIU-Guarani/preinscripcion3.8.0/actualizacion|Actualizar desde versión 3.7.0]] ===<br />
<br />
=== [[SIU-Guarani/preinscripcion3.8.0/crear_version_propia|Crear versión propia]] ===<br />
<br />
=== [[SIU-Guarani/preinscripcion3.8.0/personalizacion|¿Cómo personalizo el sistema?]] ===<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/documentacion_tecnica&diff=45388SIU-Guarani/preinscripcion3.9.0/documentacion tecnica2018-04-06T13:09:59Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Documentación Técnica ==<br />
<br />
=== Instalación desde cero ===<br />
<br />
* [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/requisitos|Requisitos]]<br />
* [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/apc|Consideraciones sobre la caché APC]]<br />
* [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion|Pasos para la instalación]]<br />
<br />
=== [[SIU-Guarani/preinscripcion3.9.0/actualizacion|Actualizar desde versión 3.7.0]] ===<br />
<br />
=== [[SIU-Guarani/preinscripcion3.9.0/crear_version_propia|Crear versión propia]] ===<br />
<br />
=== [[SIU-Guarani/preinscripcion3.9.0/personalizacion|¿Cómo personalizo el sistema?]] ===<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0&diff=40305SIU-Guarani/preinscripcion3.8.02018-04-04T15:20:06Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Preinscripción 3.8.0 ==<br />
<br />
Preinscripción es una de las tres interfaces del proyecto SIU-Guaraní 3. La misma funciona como un sistema "satélite" destinado a registrar las preinscripciones de Aspirantes a las Propuestas Formativas ofrecidas por la Institución dentro de los periodos de "preinscripción" definidos, colectando en ese proceso de "autogestión", una serie de datos personales y censales que luego serán mantenidos por el Sistema de Gestión Académica.<br />
<br />
Esta interfaz cuenta con una base de datos propia, en la cual se recolecta la información de los aspirantes. Asimismo, posee una conexión directa con la interfaz de Gestión mediante la cual intercambia datos, entre ellos los registros de aspirantes, de forma online.<br />
<br />
A diferencia de la interfaz de Gestión, Preinscripción puede ser implementada y administrada, tanto de forma centralizada como distribuida mediante varios puntos de accesos, aunque siempre integrada a una misma interfaz de Gestión. Esta característica permite gestionar de una forma flexible los aspirantes de la Institución según los Tipos de Propuestas, Responsables Académicas, Ubicaciones y/o Propuestas Formativas y, a través de múltiples administradores y perfiles de datos, asegura la confidencialidad de los datos registrados.<br />
<br />
De todas maneras, se recomienda fuertemente mantener un mismo criterio a la hora de implementar Preinscripción y Gestión: ambos centralizados o ambos descentralizados, pero siempre manteniendo una relación uno a uno.<br />
<br />
Desde la versión 3.7.0 en adelante, Preinscripción presenta un gran cambio estructural respecto de versiones anteriores, porque se abandona el concepto de "base descartable", de un uso, a la que se le exportan datos desde Gestión y trabaja de manera desconectada. En este nuevo escenario, Preinscripción consume directamente la información que necesita de Guaraní (apoyandose en una caché de corto plazo para evitar cuellos de botella), y mantiene en su base propia la información autogestionada por los aspirantes, hasta que son incorporados efectivamente en Gestión.<br />
<br />
Para más información, revisar la documentación de la versión [[SIU-Guarani/preinscripcion3.7.0|3.7.0]] de Preinscripción.<br />
<br />
=== Compatibilidad con SIU-Guaraní Gestión ===<br />
<br />
La presente versión de Preinscripción es compatible con la versión 3.15.0, o posterior, de SIU-Guaraní Gestión. <br />
<br />
=== Novedades de la versión ===<br />
<br />
# Se incorpora la carga de [[SIU-Guarani/preinscripcion3.8.0/alumno#Documentaci.C3.B3n_digital|documentos digitales]] para los requisitos de ingreso de las propuestas elegidas por el aspirante.<br />
# Ajustes en la búsqueda de códigos postales en popup de búsqueda avanzada de localidades.<br />
# Normalización a minúsculas del mail del aspirante (usado como nombre de usuario al momento del login).<br />
<br />
=== Documentación ===<br />
<br />
*[[SIU-Guarani/preinscripcion3.8.0/documentacion_tecnica|Documentación técnica]]<br />
*[[SIU-Guarani/preinscripcion3.8.0/documentacion_funcional|Documentación funcional]]<br />
<br />
[[SIU-Guarani|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.8.0/alumno&diff=40304SIU-Guarani/preinscripcion3.8.0/alumno2018-04-04T14:50:47Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Front-end de preinscripción (perfil "alumno") ==<br />
<br />
Se accede a esta interfaz mediante la URL definida en los puntos de acceso con perfil 'alumnos' en el archivo "alias.conf".<br />
<br />
=== Pantalla de login ===<br />
<br />
La pantalla de inicio ofrece la posibilidad de:<br />
<br />
*[[SIU-Guarani/preinscripcion3.8.0/alumno#Alta_de_usuario| Dar de alta un usuario]]<br />
*[[SIU-Guarani/preinscripcion3.8.0/alumno#Login| Loguearse en el sistema]] (si ya se dispone de un usuario registrado)<br />
*[[SIU-Guarani/preinscripcion3.8.0/alumno#Recuperaci.C3.B3n_de_clave| Recuperar la clave de usuario]]<br />
*[[SIU-Guarani/preinscripcion3.8.0/alumno#Autenticaci.C3.B3n_mediante_Facebook_y_Google| Loguearse mediante Facebook y Google]] (si se encuentra [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]]). <br />
<br />
[[File:GUA_Pre_1.png|1000px]]<br><br />
<br />
==== Alta de usuario ====<br />
<br />
Antes de comenzar el proceso, es necesario contar con una dirección de correo electrónico válida y que funcione correctamente. A través de la misma se confirmará la cuenta y será posible recuperar la clave en caso que sea necesario.<br />
<br />
Para registrar un nuevo usuario se debe clickear el botón "Registrate". Si no hay períodos de inscripción activos, no se podrá completar la acción, mostrándose una pantalla de error: <br />
<br />
[[File:GUA_Pre_2.png|1000px]]<br />
<br />
En caso contrario se verá la siguiente pantalla de alta de usuario:<br />
<br />
[[File:GUA_Pre_3.png|1000px]]<br />
<br />
Con respecto a la clave, se presentan las siguientes consideraciones:<br />
<br />
* La clave debe tener una longitud mínima, definida mediante el parámetro del sistema "clave_long_minima" (por defecto 6 caracteres).<br />
* La clave no puede ser igual al nombre de usuario.<br />
* Las claves se almacenan cifradas con sha1, utilizando un valor de "salt" definido en el archivo de configuración. <br />
<br />
Tras completar este formulario, arribará un e-mail a la casilla especificada, con un contenido de esta forma: <br />
<br />
[[File:G3_preinscripcion13.png]]<br />
<br />
El alta no estará completa hasta que la casilla de e-mail haya sido validada tras clickear el link enviado. <br />
<br />
Una vez activada la cuenta mediante este procedimiento, el usuario será redirigido a la operación de inicio, y ya estará en condiciones de efectuar su preinscripción.<br />
<br />
==== Login ====<br />
<br />
Si el usuario falla al identificarse, se muestra un mensaje de error. Si están activados los captchas en el sistema (en el archivo de configuración, sección "captcha"), se puede definir la cantidad máxima de intentos de logueo erróneos permitidos ("intentos_login") antes de exigir adicionalmente que se complete un captcha.<br />
<br />
[[File:GUA_Pre_4.png]]<br />
<br />
==== Recuperación de clave ====<br />
<br />
Si el usuario necesita recuperar su clave, puede acceder a la funcionalidad provista por el sistema mediante el link "¿Olvidaste tu clave?" o eventualmente "solicitar una nueva" del mensaje de error. <br />
<br />
[[File:GUA_Pre_5.png]]<br />
<br />
Luego de esta acción, arribará un mail a la casilla especificada, con un contenido de estas características:<br />
<br />
[[File:G3_preinscripcion16.png]]<br />
<br />
Vale la pena aclarar que realizar esa solicitud <u>no invalida la clave anterior</u>, sólo habilita el mecanismo de recuperación. De esta manera, si no fue el propio usuario quien solicitó el reseteo de clave, puede seguir ingresando con su contraseña original. <br><br />
<br />
Para completar el proceso, siguiendo el link recibido en el correo electrónico, se redirige a una operación para introducir la nueva clave:<br />
<br />
[[File:G3_preinscripcion17.png]]<br />
<br />
La nueva clave debe cumplir las mismas condiciones especificadas anteriormente. Al completar el proceso de restauración, se loguea automáticamente al usuario y se lo redirige a la operación de preinscripción.<br />
<br />
==== Autenticación mediante Facebook y Google ====<br />
<br />
Preinscripción permite el acceso mediante Facebook o Google (GMail), como complemento del login tradicional mediante una casilla de e-mail.<br />
<br />
Cuando el mecanismo se encuentra [[SIU-Guarani/preinscripcion3.8.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]], en la pantalla de acceso, debajo del login estándar, aparecen los servicios disponibles. <br />
<br />
[[File:G3_preinscripcion_loginSE-292.png]]<br />
<br />
La primera vez que se elige alguna de las opciones mediante el ícono correspondiente, se redirige a la pantalla de login del servicio. Si el usuario se identifica correctamente, vuelve a Preinscripción. Pueden suceder dos situaciones:<br />
<br />
#El e-mail con el que se logueó en el servicio externo no está registrado en Preinscripción. Entonces se redirige a la pantalla de alta (si es que existen períodos de inscripción habilitados), y se vincula al nuevo usuario con la cuenta externa. Se mantiene la obligación de validar la cuenta mediante el proceso tradicional, clickeando el link enviado por mail.<br />
#El e-mail ya está asociado a un usuario de Preinscripción. Entonces se redirige a una pantalla donde se solicita la clave de Preinscripción del usuario asociado a ese e-mail. Si supera la validación, se asocia el servicio externo a la cuenta existente.<br />
<br />
Completados cualquiera de estos pasos, de ahí en adelante el usuario podrá entrar al sistema mediante el login tradicional o el servicio externo asociado.<br />
<br />
=== Operación: Preinscripción ===<br />
<br />
[[File:GUA_Pre_6.png|1000px]]<br />
<br />
Como primer paso, se deberá elegir una carrera. Para ello, haciendo click en el botón "Elegir Carrera" se desplegará un popup con las opciones disponibles en el período de inscripción corriente: <br />
<br />
[[File:GUA_Pre_7.png|1000px]]<br><br><br />
<br />
Luego de elegir la primera carrera, si el sistema lo permite, se podrán elegir otras siguiendo el mismo procedimiento. Esto depende del parámetro del sistema [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|pre_cant_max_propuestas_preinsc ]] que define la cantidad máxima de preinscripciones que puede realizar un aspirante (el valor "0" implica sin límite). También se pueden eliminar las elecciones de carreras anteriores, siempre y cuando el período de preinscripción de las mismas estén vigentes y no se hayan procesado las inscripciones en Gestión. <br />
<br />
==== Datos censales ====<br />
<br />
Una vez elegida al menos una carrera, aparecerá un menú a la izquierda de la operación para cargar una serie de datos censales. <br />
<br />
Los campos marcados con (*) son obligatorios. Eso depende de la configuración dada en la operación "Configuración de campos de formulario" del perfil Administrador para el tipo de carrera seleccionado. No es necesario cargar todos los campos obligatorios en una sola sesión, pero sí será requerido y controlado al momento de imprimir el comprobante, lo que constituye el paso final del proceso. <br />
<br />
[[File:GUA_Pre_8.png|1000px]]<br />
<br />
La operación está provista de un mecanismo de '''control de cambios y autoguardado'''. El mismo se ejecuta al intentar cambiar de solapa (en el menú de la izquierda). Si se han detectado cambios y no se presionó el botón guardar, los mismos son salvados automáticamente. Vale la pena aclarar que este mecanismo no aplica a las secciones de carga de múltiples registros.<br />
<br />
En cada pantalla, los datos están organizados en agrupados. Cada uno de esos agrupados puede ser colapsado y descolapsado a gusto, para mantener una visión ordenada del formulario. <br />
<br />
[[File:GUA_Pre_24.png|1000px]]<br />
<br />
Si algún agrupado tiene todos sus campos definidos como no visibles, el mismo se ocultará. A su vez, si todos los agrupados de una solapa tienen todos sus campos ocultos, la solapa entera no será incluida en el menú.<br />
<br />
==== Documentación digital ====<br />
<br />
Si el parámetro de SIU-Guaraní Gestión '''usa_repositorio_digital''' está establecido en '''[S] Se almacenan los documentos en el repositorio digital''', se habilita la solapa '''"Documentación"''', donde el aspirante podrá cargar documentos digitales para los requisitos de ingreso documentales, que luego serán validados en ventanilla al momento de hacer efectiva la inscripción.<br />
<br />
Se listan para la carga todos los requisitos de ingreso de tipo Documental de las propuestas que haya elegido el aspirante. En caso de que se haya optado por varias propuestas y un requisito sea común a ellas, se solicita una sola vez.<br />
<br />
Por cada requisito se puede subir un archivo. Para los ya cargados, en caso de ser imágenes, se muestra una previsualización. En caso de no ser imágenes, se indica que el documento ha sido cargado, pero que no hay vista previa disponible. Los documentos cargados pueden modificarse, eliminarse o descargarse.<br />
<br />
[[File:GUA_Pre_Doc_RDI.png|1000px]]<br />
<br />
==== Turno de presentación ====<br />
<br />
Si se encuentra habilitado el módulo de turnos a través del archivo config.php, será necesario seleccionar uno para concurrir a presentar la documentación requerida por la institución. Los turnos serán administrados a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]] de Gestión, tal como se muestra a continuación<br />
<br />
[[File:GUA_Pre_21.png|1000px]]<br />
<br />
A tal efecto, se habilitará una nueva solapa, donde el aspirante deberá elegir una fecha y una banda horaria para concurrir y el sistema le asignará automáticamente un horario y ventanilla según la disponibilidad.<br />
<br />
[[File:GUA_Pre_22.png|1000px]]<br />
<br />
Una vez asignado, se mostrarán los detalles del turno, pudiendo ser modificado en caso de ser necesario.<br />
<br />
[[File:GUA_Pre_23.png|1000px]]<br />
<br />
'''IMPORTANTE''': el turno figurará impreso en el comprobante emitido para presentar en ventanilla. Por esta razón, si se cambia el turno luego de la impresión será necesario generar un nuevo comprobante, ya que el anterior quedará invalidado en el sistema.<br />
<br />
==== Impresión del comprobante ====<br />
<br />
El paso final para completar la preinscripción consiste en la impresión de un comprobante, para ser entregado en la dependencia que corresponda.<br />
<br />
El mismo se obtiene presionando el botón "Imprimir", que se encuentra en el extremo superior derecho de la operación.<br />
<br />
Previamente a la generación del PDF, se realiza un control para asegurar que todos los campos configurados como obligatorios hayan sido cargados. En caso de detectarse omisiones, se habilitará en la misma operación una ayuda contextual, que consiste en: <br />
<br />
* Un mensaje de notificación ("Para imprimir es necesario que completes todos los campos obligatorios") y la posibilidad de desactivar esa ayuda contextual ("Ocultar") en el extremo superior de la operación.<br />
* Resaltado en color rojo de las solapas del menú que presentan campos obligatorios incompletos. Si la pestaña activa es una de ellas, el color rojo es más intenso.<br />
* Resaltado en rojo de los campos no completados, con la leyenda "Para imprimir es necesario que completes todos los campos obligatorios".<br />
<br />
[[File:GUA_Pre_19.png]]<br />
<br />
Completados todos los campos, se obtendrá el comprobante en formato PDF. En el mismo se puede distinguir: <br />
<br />
* El encabezado. El nombre de institución que se muestra es definido en el archivo config.php ("rep_nombre_institucion"). <br />
* Una primera sección, consistente de: <br />
** Número de ficha, compuesto de un ID interno y número de versión impresa.<br />
** La fecha de última modificación.<br />
** Apellido y nombres del aspirante.<br />
** Un espacio para completar el número de libreta.<br />
** El código QR del número de ficha.<br />
** Un espacio para la foto.<br />
<br />
* Una segunda sección donde se listan las carreras elegidas.<br />
* Si el parámetro "rep_imprime_CBC" del archivo de configuración es seteado en "1", se genera a continuación una tabla para completar manualmente los resultados del CBC.<br />
* Los datos censales configurados como imprimibles. Se muestran agrupados de la misma manera que en pantalla. Si todos los campos de un grupo son configurados como no imprimibles, se oculta también su encabezado; de la misma manera se procede con las secciones. <br />
<br />
[[File:GUA_Pre_20.png]]<br />
<br />
Luego de los datos censales agrupados en secciones, se puede observar: <br />
<br />
* Una serie de notificaciones numeradas. Cada una de ellas se encuentra definida como una componente del arreglo "rep_avisos" en el archivo de configuración. Si no desean mostrarse avisos, se recomienda dejar definido el parámetro como un arreglo vacío: "rep_avisos" => array(),<br />
* La localidad y fecha de impresión. La localidad es configurable mediante el parámetro "rep_localidad". Si no se desea mostrar la misma, dejar definido el parámetro como string vacío: "rep_localidad" = "", <br />
* Espacio para la firma del alumno.<br />
* Credencial provisoria. Se genera siempre en el pie de la última página. Si el espacio restante en la última página no alcanza, se habilita una nueva página y se genera al pie. Se puede optar por no generar la misma, mediante el parámetro "rep_imprime_credencial_provisoria".<br />
<br />
[[File:GUA_Pre_25.png|1000px]]<br />
<br />
En caso de realizarse modificaciones luego de la impresión, '''será necesario generar nuevamente el comprobante'''. De no hacerlo, no será posible completar la inscripción con Guaraní. Un mensaje de alerta quedará fijo en pantalla hasta que se imprima un nuevo comprobante.<br />
<br />
[[File:GUA_Pre_26.png|1000px]]<br />
<br />
[[SIU-Guarani/preinscripcion3.8.0/documentacion_funcional|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.9.0/alumno&diff=45387SIU-Guarani/preinscripcion3.9.0/alumno2018-04-04T14:50:47Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Front-end de preinscripción (perfil "alumno") ==<br />
<br />
Se accede a esta interfaz mediante la URL definida en los puntos de acceso con perfil 'alumnos' en el archivo "alias.conf".<br />
<br />
=== Pantalla de login ===<br />
<br />
La pantalla de inicio ofrece la posibilidad de:<br />
<br />
*[[SIU-Guarani/preinscripcion3.9.0/alumno#Alta_de_usuario| Dar de alta un usuario]]<br />
*[[SIU-Guarani/preinscripcion3.9.0/alumno#Login| Loguearse en el sistema]] (si ya se dispone de un usuario registrado)<br />
*[[SIU-Guarani/preinscripcion3.9.0/alumno#Recuperaci.C3.B3n_de_clave| Recuperar la clave de usuario]]<br />
*[[SIU-Guarani/preinscripcion3.9.0/alumno#Autenticaci.C3.B3n_mediante_Facebook_y_Google| Loguearse mediante Facebook y Google]] (si se encuentra [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]]). <br />
<br />
[[File:GUA_Pre_1.png|1000px]]<br><br />
<br />
==== Alta de usuario ====<br />
<br />
Antes de comenzar el proceso, es necesario contar con una dirección de correo electrónico válida y que funcione correctamente. A través de la misma se confirmará la cuenta y será posible recuperar la clave en caso que sea necesario.<br />
<br />
Para registrar un nuevo usuario se debe clickear el botón "Registrate". Si no hay períodos de inscripción activos, no se podrá completar la acción, mostrándose una pantalla de error: <br />
<br />
[[File:GUA_Pre_2.png|1000px]]<br />
<br />
En caso contrario se verá la siguiente pantalla de alta de usuario:<br />
<br />
[[File:GUA_Pre_3.png|1000px]]<br />
<br />
Con respecto a la clave, se presentan las siguientes consideraciones:<br />
<br />
* La clave debe tener una longitud mínima, definida mediante el parámetro del sistema "clave_long_minima" (por defecto 6 caracteres).<br />
* La clave no puede ser igual al nombre de usuario.<br />
* Las claves se almacenan cifradas con sha1, utilizando un valor de "salt" definido en el archivo de configuración. <br />
<br />
Tras completar este formulario, arribará un e-mail a la casilla especificada, con un contenido de esta forma: <br />
<br />
[[File:G3_preinscripcion13.png]]<br />
<br />
El alta no estará completa hasta que la casilla de e-mail haya sido validada tras clickear el link enviado. <br />
<br />
Una vez activada la cuenta mediante este procedimiento, el usuario será redirigido a la operación de inicio, y ya estará en condiciones de efectuar su preinscripción.<br />
<br />
==== Login ====<br />
<br />
Si el usuario falla al identificarse, se muestra un mensaje de error. Si están activados los captchas en el sistema (en el archivo de configuración, sección "captcha"), se puede definir la cantidad máxima de intentos de logueo erróneos permitidos ("intentos_login") antes de exigir adicionalmente que se complete un captcha.<br />
<br />
[[File:GUA_Pre_4.png]]<br />
<br />
==== Recuperación de clave ====<br />
<br />
Si el usuario necesita recuperar su clave, puede acceder a la funcionalidad provista por el sistema mediante el link "¿Olvidaste tu clave?" o eventualmente "solicitar una nueva" del mensaje de error. <br />
<br />
[[File:GUA_Pre_5.png]]<br />
<br />
Luego de esta acción, arribará un mail a la casilla especificada, con un contenido de estas características:<br />
<br />
[[File:G3_preinscripcion16.png]]<br />
<br />
Vale la pena aclarar que realizar esa solicitud <u>no invalida la clave anterior</u>, sólo habilita el mecanismo de recuperación. De esta manera, si no fue el propio usuario quien solicitó el reseteo de clave, puede seguir ingresando con su contraseña original. <br><br />
<br />
Para completar el proceso, siguiendo el link recibido en el correo electrónico, se redirige a una operación para introducir la nueva clave:<br />
<br />
[[File:G3_preinscripcion17.png]]<br />
<br />
La nueva clave debe cumplir las mismas condiciones especificadas anteriormente. Al completar el proceso de restauración, se loguea automáticamente al usuario y se lo redirige a la operación de preinscripción.<br />
<br />
==== Autenticación mediante Facebook y Google ====<br />
<br />
Preinscripción permite el acceso mediante Facebook o Google (GMail), como complemento del login tradicional mediante una casilla de e-mail.<br />
<br />
Cuando el mecanismo se encuentra [[SIU-Guarani/preinscripcion3.9.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]], en la pantalla de acceso, debajo del login estándar, aparecen los servicios disponibles. <br />
<br />
[[File:G3_preinscripcion_loginSE-292.png]]<br />
<br />
La primera vez que se elige alguna de las opciones mediante el ícono correspondiente, se redirige a la pantalla de login del servicio. Si el usuario se identifica correctamente, vuelve a Preinscripción. Pueden suceder dos situaciones:<br />
<br />
#El e-mail con el que se logueó en el servicio externo no está registrado en Preinscripción. Entonces se redirige a la pantalla de alta (si es que existen períodos de inscripción habilitados), y se vincula al nuevo usuario con la cuenta externa. Se mantiene la obligación de validar la cuenta mediante el proceso tradicional, clickeando el link enviado por mail.<br />
#El e-mail ya está asociado a un usuario de Preinscripción. Entonces se redirige a una pantalla donde se solicita la clave de Preinscripción del usuario asociado a ese e-mail. Si supera la validación, se asocia el servicio externo a la cuenta existente.<br />
<br />
Completados cualquiera de estos pasos, de ahí en adelante el usuario podrá entrar al sistema mediante el login tradicional o el servicio externo asociado.<br />
<br />
=== Operación: Preinscripción ===<br />
<br />
[[File:GUA_Pre_6.png|1000px]]<br />
<br />
Como primer paso, se deberá elegir una carrera. Para ello, haciendo click en el botón "Elegir Carrera" se desplegará un popup con las opciones disponibles en el período de inscripción corriente: <br />
<br />
[[File:GUA_Pre_7.png|1000px]]<br><br><br />
<br />
Luego de elegir la primera carrera, si el sistema lo permite, se podrán elegir otras siguiendo el mismo procedimiento. Esto depende del parámetro del sistema [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|pre_cant_max_propuestas_preinsc ]] que define la cantidad máxima de preinscripciones que puede realizar un aspirante (el valor "0" implica sin límite). También se pueden eliminar las elecciones de carreras anteriores, siempre y cuando el período de preinscripción de las mismas estén vigentes y no se hayan procesado las inscripciones en Gestión. <br />
<br />
==== Datos censales ====<br />
<br />
Una vez elegida al menos una carrera, aparecerá un menú a la izquierda de la operación para cargar una serie de datos censales. <br />
<br />
Los campos marcados con (*) son obligatorios. Eso depende de la configuración dada en la operación "Configuración de campos de formulario" del perfil Administrador para el tipo de carrera seleccionado. No es necesario cargar todos los campos obligatorios en una sola sesión, pero sí será requerido y controlado al momento de imprimir el comprobante, lo que constituye el paso final del proceso. <br />
<br />
[[File:GUA_Pre_8.png|1000px]]<br />
<br />
La operación está provista de un mecanismo de '''control de cambios y autoguardado'''. El mismo se ejecuta al intentar cambiar de solapa (en el menú de la izquierda). Si se han detectado cambios y no se presionó el botón guardar, los mismos son salvados automáticamente. Vale la pena aclarar que este mecanismo no aplica a las secciones de carga de múltiples registros.<br />
<br />
En cada pantalla, los datos están organizados en agrupados. Cada uno de esos agrupados puede ser colapsado y descolapsado a gusto, para mantener una visión ordenada del formulario. <br />
<br />
[[File:GUA_Pre_24.png|1000px]]<br />
<br />
Si algún agrupado tiene todos sus campos definidos como no visibles, el mismo se ocultará. A su vez, si todos los agrupados de una solapa tienen todos sus campos ocultos, la solapa entera no será incluida en el menú.<br />
<br />
==== Documentación digital ====<br />
<br />
Si el parámetro de SIU-Guaraní Gestión '''usa_repositorio_digital''' está establecido en '''[S] Se almacenan los documentos en el repositorio digital''', se habilita la solapa '''"Documentación"''', donde el aspirante podrá cargar documentos digitales para los requisitos de ingreso documentales, que luego serán validados en ventanilla al momento de hacer efectiva la inscripción.<br />
<br />
Se listan para la carga todos los requisitos de ingreso de tipo Documental de las propuestas que haya elegido el aspirante. En caso de que se haya optado por varias propuestas y un requisito sea común a ellas, se solicita una sola vez.<br />
<br />
Por cada requisito se puede subir un archivo. Para los ya cargados, en caso de ser imágenes, se muestra una previsualización. En caso de no ser imágenes, se indica que el documento ha sido cargado, pero que no hay vista previa disponible. Los documentos cargados pueden modificarse, eliminarse o descargarse.<br />
<br />
[[File:GUA_Pre_Doc_RDI.png|1000px]]<br />
<br />
==== Turno de presentación ====<br />
<br />
Si se encuentra habilitado el módulo de turnos a través del archivo config.php, será necesario seleccionar uno para concurrir a presentar la documentación requerida por la institución. Los turnos serán administrados a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]] de Gestión, tal como se muestra a continuación<br />
<br />
[[File:GUA_Pre_21.png|1000px]]<br />
<br />
A tal efecto, se habilitará una nueva solapa, donde el aspirante deberá elegir una fecha y una banda horaria para concurrir y el sistema le asignará automáticamente un horario y ventanilla según la disponibilidad.<br />
<br />
[[File:GUA_Pre_22.png|1000px]]<br />
<br />
Una vez asignado, se mostrarán los detalles del turno, pudiendo ser modificado en caso de ser necesario.<br />
<br />
[[File:GUA_Pre_23.png|1000px]]<br />
<br />
'''IMPORTANTE''': el turno figurará impreso en el comprobante emitido para presentar en ventanilla. Por esta razón, si se cambia el turno luego de la impresión será necesario generar un nuevo comprobante, ya que el anterior quedará invalidado en el sistema.<br />
<br />
==== Impresión del comprobante ====<br />
<br />
El paso final para completar la preinscripción consiste en la impresión de un comprobante, para ser entregado en la dependencia que corresponda.<br />
<br />
El mismo se obtiene presionando el botón "Imprimir", que se encuentra en el extremo superior derecho de la operación.<br />
<br />
Previamente a la generación del PDF, se realiza un control para asegurar que todos los campos configurados como obligatorios hayan sido cargados. En caso de detectarse omisiones, se habilitará en la misma operación una ayuda contextual, que consiste en: <br />
<br />
* Un mensaje de notificación ("Para imprimir es necesario que completes todos los campos obligatorios") y la posibilidad de desactivar esa ayuda contextual ("Ocultar") en el extremo superior de la operación.<br />
* Resaltado en color rojo de las solapas del menú que presentan campos obligatorios incompletos. Si la pestaña activa es una de ellas, el color rojo es más intenso.<br />
* Resaltado en rojo de los campos no completados, con la leyenda "Para imprimir es necesario que completes todos los campos obligatorios".<br />
<br />
[[File:GUA_Pre_19.png]]<br />
<br />
Completados todos los campos, se obtendrá el comprobante en formato PDF. En el mismo se puede distinguir: <br />
<br />
* El encabezado. El nombre de institución que se muestra es definido en el archivo config.php ("rep_nombre_institucion"). <br />
* Una primera sección, consistente de: <br />
** Número de ficha, compuesto de un ID interno y número de versión impresa.<br />
** La fecha de última modificación.<br />
** Apellido y nombres del aspirante.<br />
** Un espacio para completar el número de libreta.<br />
** El código QR del número de ficha.<br />
** Un espacio para la foto.<br />
<br />
* Una segunda sección donde se listan las carreras elegidas.<br />
* Si el parámetro "rep_imprime_CBC" del archivo de configuración es seteado en "1", se genera a continuación una tabla para completar manualmente los resultados del CBC.<br />
* Los datos censales configurados como imprimibles. Se muestran agrupados de la misma manera que en pantalla. Si todos los campos de un grupo son configurados como no imprimibles, se oculta también su encabezado; de la misma manera se procede con las secciones. <br />
<br />
[[File:GUA_Pre_20.png]]<br />
<br />
Luego de los datos censales agrupados en secciones, se puede observar: <br />
<br />
* Una serie de notificaciones numeradas. Cada una de ellas se encuentra definida como una componente del arreglo "rep_avisos" en el archivo de configuración. Si no desean mostrarse avisos, se recomienda dejar definido el parámetro como un arreglo vacío: "rep_avisos" => array(),<br />
* La localidad y fecha de impresión. La localidad es configurable mediante el parámetro "rep_localidad". Si no se desea mostrar la misma, dejar definido el parámetro como string vacío: "rep_localidad" = "", <br />
* Espacio para la firma del alumno.<br />
* Credencial provisoria. Se genera siempre en el pie de la última página. Si el espacio restante en la última página no alcanza, se habilita una nueva página y se genera al pie. Se puede optar por no generar la misma, mediante el parámetro "rep_imprime_credencial_provisoria".<br />
<br />
[[File:GUA_Pre_25.png|1000px]]<br />
<br />
En caso de realizarse modificaciones luego de la impresión, '''será necesario generar nuevamente el comprobante'''. De no hacerlo, no será posible completar la inscripción con Guaraní. Un mensaje de alerta quedará fijo en pantalla hasta que se imprima un nuevo comprobante.<br />
<br />
[[File:GUA_Pre_26.png|1000px]]<br />
<br />
[[SIU-Guarani/preinscripcion3.9.0/documentacion_funcional|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/preinscripcion3.10.0/alumno&diff=57630SIU-Guarani/preinscripcion3.10.0/alumno2018-04-04T14:50:47Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
<br />
== Front-end de preinscripción (perfil "alumno") ==<br />
<br />
Se accede a esta interfaz mediante la URL definida en los puntos de acceso con perfil 'alumnos' en el archivo "alias.conf".<br />
<br />
=== Pantalla de login ===<br />
<br />
La pantalla de inicio ofrece la posibilidad de:<br />
<br />
*[[SIU-Guarani/preinscripcion3.10.0/alumno#Alta_de_usuario| Dar de alta un usuario]]<br />
*[[SIU-Guarani/preinscripcion3.10.0/alumno#Login| Loguearse en el sistema]] (si ya se dispone de un usuario registrado)<br />
*[[SIU-Guarani/preinscripcion3.10.0/alumno#Recuperaci.C3.B3n_de_clave| Recuperar la clave de usuario]]<br />
*[[SIU-Guarani/preinscripcion3.10.0/alumno#Autenticaci.C3.B3n_mediante_Facebook_y_Google| Loguearse mediante Facebook y Google]] (si se encuentra [[SIU-Guarani/preinscripcion3.10.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]]). <br />
<br />
[[File:GUA_Pre_1.png|1000px]]<br><br />
<br />
==== Alta de usuario ====<br />
<br />
Antes de comenzar el proceso, es necesario contar con una dirección de correo electrónico válida y que funcione correctamente. A través de la misma se confirmará la cuenta y será posible recuperar la clave en caso que sea necesario.<br />
<br />
Para registrar un nuevo usuario se debe clickear el botón "Registrate". Si no hay períodos de inscripción activos, no se podrá completar la acción, mostrándose una pantalla de error: <br />
<br />
[[File:GUA_Pre_2.png|1000px]]<br />
<br />
En caso contrario se verá la siguiente pantalla de alta de usuario:<br />
<br />
[[File:GUA_Pre_3.png|1000px]]<br />
<br />
Con respecto a la clave, se presentan las siguientes consideraciones:<br />
<br />
* La clave debe tener una longitud mínima, definida mediante el parámetro del sistema "clave_long_minima" (por defecto 6 caracteres).<br />
* La clave no puede ser igual al nombre de usuario.<br />
* Las claves se almacenan cifradas con sha1, utilizando un valor de "salt" definido en el archivo de configuración. <br />
<br />
Tras completar este formulario, arribará un e-mail a la casilla especificada, con un contenido de esta forma: <br />
<br />
[[File:G3_preinscripcion13.png]]<br />
<br />
El alta no estará completa hasta que la casilla de e-mail haya sido validada tras clickear el link enviado. <br />
<br />
Una vez activada la cuenta mediante este procedimiento, el usuario será redirigido a la operación de inicio, y ya estará en condiciones de efectuar su preinscripción.<br />
<br />
==== Login ====<br />
<br />
Si el usuario falla al identificarse, se muestra un mensaje de error. Si están activados los captchas en el sistema (en el archivo de configuración, sección "captcha"), se puede definir la cantidad máxima de intentos de logueo erróneos permitidos ("intentos_login") antes de exigir adicionalmente que se complete un captcha.<br />
<br />
[[File:GUA_Pre_4.png]]<br />
<br />
==== Recuperación de clave ====<br />
<br />
Si el usuario necesita recuperar su clave, puede acceder a la funcionalidad provista por el sistema mediante el link "¿Olvidaste tu clave?" o eventualmente "solicitar una nueva" del mensaje de error. <br />
<br />
[[File:GUA_Pre_5.png]]<br />
<br />
Luego de esta acción, arribará un mail a la casilla especificada, con un contenido de estas características:<br />
<br />
[[File:G3_preinscripcion16.png]]<br />
<br />
Vale la pena aclarar que realizar esa solicitud <u>no invalida la clave anterior</u>, sólo habilita el mecanismo de recuperación. De esta manera, si no fue el propio usuario quien solicitó el reseteo de clave, puede seguir ingresando con su contraseña original. <br><br />
<br />
Para completar el proceso, siguiendo el link recibido en el correo electrónico, se redirige a una operación para introducir la nueva clave:<br />
<br />
[[File:G3_preinscripcion17.png]]<br />
<br />
La nueva clave debe cumplir las mismas condiciones especificadas anteriormente. Al completar el proceso de restauración, se loguea automáticamente al usuario y se lo redirige a la operación de preinscripción.<br />
<br />
==== Autenticación mediante Facebook y Google ====<br />
<br />
Preinscripción permite el acceso mediante Facebook o Google (GMail), como complemento del login tradicional mediante una casilla de e-mail.<br />
<br />
Cuando el mecanismo se encuentra [[SIU-Guarani/preinscripcion3.10.0/instalacion_desde_cero/instalacion#Configuraci.C3.B3n_de_LOGIN| habilitado]], en la pantalla de acceso, debajo del login estándar, aparecen los servicios disponibles. <br />
<br />
[[File:G3_preinscripcion_loginSE-292.png]]<br />
<br />
La primera vez que se elige alguna de las opciones mediante el ícono correspondiente, se redirige a la pantalla de login del servicio. Si el usuario se identifica correctamente, vuelve a Preinscripción. Pueden suceder dos situaciones:<br />
<br />
#El e-mail con el que se logueó en el servicio externo no está registrado en Preinscripción. Entonces se redirige a la pantalla de alta (si es que existen períodos de inscripción habilitados), y se vincula al nuevo usuario con la cuenta externa. Se mantiene la obligación de validar la cuenta mediante el proceso tradicional, clickeando el link enviado por mail.<br />
#El e-mail ya está asociado a un usuario de Preinscripción. Entonces se redirige a una pantalla donde se solicita la clave de Preinscripción del usuario asociado a ese e-mail. Si supera la validación, se asocia el servicio externo a la cuenta existente.<br />
<br />
Completados cualquiera de estos pasos, de ahí en adelante el usuario podrá entrar al sistema mediante el login tradicional o el servicio externo asociado.<br />
<br />
=== Operación: Preinscripción ===<br />
<br />
[[File:GUA_Pre_6.png|1000px]]<br />
<br />
Como primer paso, se deberá elegir una carrera. Para ello, haciendo click en el botón "Elegir Carrera" se desplegará un popup con las opciones disponibles en el período de inscripción corriente: <br />
<br />
[[File:GUA_Pre_7.png|1000px]]<br><br><br />
<br />
Luego de elegir la primera carrera, si el sistema lo permite, se podrán elegir otras siguiendo el mismo procedimiento. Esto depende del parámetro del sistema [[SIU-Guarani/Version3.14.0/configuracion_del_sistema/parametros#Pre_Inscripci.C3.B3n|pre_cant_max_propuestas_preinsc ]] que define la cantidad máxima de preinscripciones que puede realizar un aspirante (el valor "0" implica sin límite). También se pueden eliminar las elecciones de carreras anteriores, siempre y cuando el período de preinscripción de las mismas estén vigentes y no se hayan procesado las inscripciones en Gestión. <br />
<br />
==== Datos censales ====<br />
<br />
Una vez elegida al menos una carrera, aparecerá un menú a la izquierda de la operación para cargar una serie de datos censales. <br />
<br />
Los campos marcados con (*) son obligatorios. Eso depende de la configuración dada en la operación "Configuración de campos de formulario" del perfil Administrador para el tipo de carrera seleccionado. No es necesario cargar todos los campos obligatorios en una sola sesión, pero sí será requerido y controlado al momento de imprimir el comprobante, lo que constituye el paso final del proceso. <br />
<br />
[[File:GUA_Pre_8.png|1000px]]<br />
<br />
La operación está provista de un mecanismo de '''control de cambios y autoguardado'''. El mismo se ejecuta al intentar cambiar de solapa (en el menú de la izquierda). Si se han detectado cambios y no se presionó el botón guardar, los mismos son salvados automáticamente. Vale la pena aclarar que este mecanismo no aplica a las secciones de carga de múltiples registros.<br />
<br />
En cada pantalla, los datos están organizados en agrupados. Cada uno de esos agrupados puede ser colapsado y descolapsado a gusto, para mantener una visión ordenada del formulario. <br />
<br />
[[File:GUA_Pre_24.png|1000px]]<br />
<br />
Si algún agrupado tiene todos sus campos definidos como no visibles, el mismo se ocultará. A su vez, si todos los agrupados de una solapa tienen todos sus campos ocultos, la solapa entera no será incluida en el menú.<br />
<br />
==== Documentación digital ====<br />
<br />
Si el parámetro de SIU-Guaraní Gestión '''usa_repositorio_digital''' está establecido en '''[S] Se almacenan los documentos en el repositorio digital''', se habilita la solapa '''"Documentación"''', donde el aspirante podrá cargar documentos digitales para los requisitos de ingreso documentales, que luego serán validados en ventanilla al momento de hacer efectiva la inscripción.<br />
<br />
Se listan para la carga todos los requisitos de ingreso de tipo Documental de las propuestas que haya elegido el aspirante. En caso de que se haya optado por varias propuestas y un requisito sea común a ellas, se solicita una sola vez.<br />
<br />
Por cada requisito se puede subir un archivo. Para los ya cargados, en caso de ser imágenes, se muestra una previsualización. En caso de no ser imágenes, se indica que el documento ha sido cargado, pero que no hay vista previa disponible. Los documentos cargados pueden modificarse, eliminarse o descargarse.<br />
<br />
[[File:GUA_Pre_Doc_RDI.png|1000px]]<br />
<br />
==== Turno de presentación ====<br />
<br />
Si se encuentra habilitado el módulo de turnos a través del archivo config.php, será necesario seleccionar uno para concurrir a presentar la documentación requerida por la institución. Los turnos serán administrados a través de la operación [[SIU-Guarani/Version3.14.0/Documentacion_de_las_operaciones/Matrícula/administrar_turnos_presentacion_documentacion|Administrar turnos de presentación de documentación]] de Gestión, tal como se muestra a continuación<br />
<br />
[[File:GUA_Pre_21.png|1000px]]<br />
<br />
A tal efecto, se habilitará una nueva solapa, donde el aspirante deberá elegir una fecha y una banda horaria para concurrir y el sistema le asignará automáticamente un horario y ventanilla según la disponibilidad.<br />
<br />
[[File:GUA_Pre_22.png|1000px]]<br />
<br />
Una vez asignado, se mostrarán los detalles del turno, pudiendo ser modificado en caso de ser necesario.<br />
<br />
[[File:GUA_Pre_23.png|1000px]]<br />
<br />
'''IMPORTANTE''': el turno figurará impreso en el comprobante emitido para presentar en ventanilla. Por esta razón, si se cambia el turno luego de la impresión será necesario generar un nuevo comprobante, ya que el anterior quedará invalidado en el sistema.<br />
<br />
==== Impresión del comprobante ====<br />
<br />
El paso final para completar la preinscripción consiste en la impresión de un comprobante, para ser entregado en la dependencia que corresponda.<br />
<br />
El mismo se obtiene presionando el botón "Imprimir", que se encuentra en el extremo superior derecho de la operación.<br />
<br />
Previamente a la generación del PDF, se realiza un control para asegurar que todos los campos configurados como obligatorios hayan sido cargados. En caso de detectarse omisiones, se habilitará en la misma operación una ayuda contextual, que consiste en: <br />
<br />
* Un mensaje de notificación ("Para imprimir es necesario que completes todos los campos obligatorios") y la posibilidad de desactivar esa ayuda contextual ("Ocultar") en el extremo superior de la operación.<br />
* Resaltado en color rojo de las solapas del menú que presentan campos obligatorios incompletos. Si la pestaña activa es una de ellas, el color rojo es más intenso.<br />
* Resaltado en rojo de los campos no completados, con la leyenda "Para imprimir es necesario que completes todos los campos obligatorios".<br />
<br />
[[File:GUA_Pre_19.png]]<br />
<br />
Completados todos los campos, se obtendrá el comprobante en formato PDF. En el mismo se puede distinguir: <br />
<br />
* El encabezado. El nombre de institución que se muestra es definido en el archivo config.php ("rep_nombre_institucion"). <br />
* Una primera sección, consistente de: <br />
** Número de ficha, compuesto de un ID interno y número de versión impresa.<br />
** La fecha de última modificación.<br />
** Apellido y nombres del aspirante.<br />
** Un espacio para completar el número de libreta.<br />
** El código QR del número de ficha.<br />
** Un espacio para la foto.<br />
<br />
* Una segunda sección donde se listan las carreras elegidas.<br />
* Si el parámetro "rep_imprime_CBC" del archivo de configuración es seteado en "1", se genera a continuación una tabla para completar manualmente los resultados del CBC.<br />
* Los datos censales configurados como imprimibles. Se muestran agrupados de la misma manera que en pantalla. Si todos los campos de un grupo son configurados como no imprimibles, se oculta también su encabezado; de la misma manera se procede con las secciones. <br />
<br />
[[File:GUA_Pre_20.png]]<br />
<br />
Luego de los datos censales agrupados en secciones, se puede observar: <br />
<br />
* Una serie de notificaciones numeradas. Cada una de ellas se encuentra definida como una componente del arreglo "rep_avisos" en el archivo de configuración. Si no desean mostrarse avisos, se recomienda dejar definido el parámetro como un arreglo vacío: "rep_avisos" => array(),<br />
* La localidad y fecha de impresión. La localidad es configurable mediante el parámetro "rep_localidad". Si no se desea mostrar la misma, dejar definido el parámetro como string vacío: "rep_localidad" = "", <br />
* Espacio para la firma del alumno.<br />
* Credencial provisoria. Se genera siempre en el pie de la última página. Si el espacio restante en la última página no alcanza, se habilita una nueva página y se genera al pie. Se puede optar por no generar la misma, mediante el parámetro "rep_imprime_credencial_provisoria".<br />
<br />
[[File:GUA_Pre_25.png|1000px]]<br />
<br />
En caso de realizarse modificaciones luego de la impresión, '''será necesario generar nuevamente el comprobante'''. De no hacerlo, no será posible completar la inscripción con Guaraní. Un mensaje de alerta quedará fijo en pantalla hasta que se imprima un nuevo comprobante.<br />
<br />
[[File:GUA_Pre_26.png|1000px]]<br />
<br />
[[SIU-Guarani/preinscripcion3.10.0/documentacion_funcional|< Volver]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=40186SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-03-27T12:54:17Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados. <br />
##Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando, desde la carpeta bin ('''<path proyecto Guaraní>/bin'''):<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=40185SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-03-27T12:53:42Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados. Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando, desde la carpeta bin ('''<path proyecto Guaraní>/bin'''):<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.15.0/actualizacion_de_produccion/gestion&diff=40154SIU-Guarani/Version3.15.0/actualizacion de produccion/gestion2018-03-23T18:52:17Z<p>Fmartinez: </p>
<hr />
<div>__NOTOC__<br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x.y en entorno de producción ==<br />
=== Requisitos previos a la actualización ===<br />
* Haber creado la [[SIU-Guarani/version3.15.0/crear_version_propia/gestion|versión propia de SIU-Guaraní Gestión]]<br />
<br />
=== Configuraciones del servidor de producción ===<br />
Chequear que el servidor de producción esté configurado como se indica en esta [[SIU-Guarani/version3.15.0/instalacion_desde_cero/configuracion_produccion_gestion|documentación]].<br />
<br />
=== Actualización de la versión ===<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.15.x.y''': por la versión propia a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Realizar un backup integral de la base de datos.<br />
#Exportar datos locales. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Apuntar el servidor de producción a la nueva versión 3.15.x.y<br />
#:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y<br />
</source><br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="bash" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Importante:''': si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.<br />
#Compilar metadatos. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani compilar<br />
</source><br />
#:Al compilar los metadatos se generará la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', que no debe versionarse (''svn commit'') ya que se regenerará cada vez que se actualice la versión de producción.<br />
#Editar el archivo '''aplicacion.php''' ('''<path proyecto Guaraní>/www/aplicacion.php'''):<br />
##Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:<br />
##:<source lang="php" enclose="div"><br />
define('apex_pa_metadatos_compilados', 1);<br />
</source><br />
##Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:<br />
##:<source lang="php" enclose="div"><br />
define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice<br />
</source><br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=40152SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-03-23T18:50:02Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados<br />
##Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion&diff=40149SIU-Guarani/version3.15.0/actualizacion con personalizaciones/gestion2018-03-23T18:48:12Z<p>Fmartinez: </p>
<hr />
<div><br />
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización de SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo con personalizaciones ==<br />
<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
=== Requisitos previos ===<br />
* Que no queden desarrollos parciales de ningún miembro del equipo sin subir al repositorio SVN.<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.15.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br />
<br />
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
== Pasos a realizar por el Concentrador ==<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Versionar los diferenciales de metadatos personalizados<br />
##Calcular los diferenciales de metadatos, en formato XML que facilitará su incorporación en la próxima versión, ejecutando:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers exportar<br />
</source><br />
##:El resultado de dicha acción quedará en la carpeta '''<path proyecto Guaraní>/personalizacion/metadatos'''<br />
##:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. <br />
##Desactivar el esquema de personalizaciones para evitar conflictos de SVN al cambiar de versión. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers desactivar<br />
</source><br />
##Verificar si hay cambios para subir al repositorio, ejecutando dentro de la carpeta de Guaraní ('''<path proyecto Guaraní>''')<br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para agregar a SVN:<br />
##:<source lang = "bash" enclose="div"><br />
svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)><br />
</source><br />
##Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "Se versionan las personalizaciones para cambio de versión"<br />
</source><br />
#Actualizar el entorno de desarrollo a la nueva versión<br />
##Cambiar la versión del código <br />
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
##:En versiones nuevas de svn puede salir un error:<br />
##:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
##:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
##:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
##:y verificar que no existan archivos con estado 'S'.<br />
##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta '''<path proyecto Guaraní>/personalizacion'''.<br />
##Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
##:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
##Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
##En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
##:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
##:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
##Reiniciar Apache.<br />
##:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
##Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
##Migrar la base de datos de negocio. Dentro de la carpeta 'bin'('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
##:'''Importante:''': si como parte de las personalizaciones tienen el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden tener errores en la migración. En ese escenario, lo recomendado es borrarlas, migrar y luego volver a crearlas.<br />
##En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
##:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
#Migrar las personalizaciones <br />
#:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br><br />
##Mergear la carpeta '''personalizacion''' a la nueva versión <br />
##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/<br />
</source><br />
##Activar el esquema de personalizaciones <br />
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers iniciar <br />
</source><br />
##Chequear conflictos de las personalizaciones con la nueva versión <br />
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers conflictos<br />
</source><br />
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.<br />
##Importar las personalizaciones <br />
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani esquema_pers importar<br />
</source><br />
##Agregar al repositorio las personalizaciones importadas<br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
##Exportar las personalizaciones <br />
##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
./guarani exportar<br />
</source><br />
##Versionar las personalizaciones <br />
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:<br />
##:<source lang="bash" enclose="div"><br />
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" <br />
</source><br />
<br />
== Pasos a realizar por el resto del equipo ==<br />
'''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto.<br />
<br />
'''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos:<br />
#Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani instancia_exp_local<br />
</source><br />
#Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:En versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en este caso ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregue la carpeta al path y vuelva a intentarlo.<br />
<br><br><br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinezhttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.15.0/actualizacion/gestion&diff=40139SIU-Guarani/version3.15.0/actualizacion/gestion2018-03-23T18:16:15Z<p>Fmartinez: </p>
<hr />
<div><span style="float: right; margin: 0 0 15px 15px;">__TOC__</span><br />
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==<br />
{| border=1 class="simple"<br />
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.<br />
|}<br />
<br />
=== Pasos para la actualización ===<br />
Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten '''todos los pasos detallados'''. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).<br />
<br />
'''A lo largo de los pasos se deberá reemplazar:'''<br />
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto<br />
* '''<siglas institución>''': por las siglas correspondientes a la institución que realiza la instalación<br />
* '''3.y.z''': por la versión actual del sistema<br />
* '''3.15.x''': por la versión a la que se quiere actualizar<br />
<br />
'''Los pasos a realizar son:'''<br />
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].<br />
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x<br />
</source><br />
#:Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
svn status<br />
</source><br />
#:y verificar que no existan archivos con estado 'S'.<br />
#:'''Importante''': en versiones nuevas de svn puede salir un error:<br />
#:<source lang="bash" enclose="div"><br />
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check.<br />
</source><br />
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:<br />
#:<source lang="bash" enclose="div"><br />
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry<br />
</source><br />
#Antes de ejecutar el siguiente paso, es fundamental asegurar tener '''composer''' y '''bower''' instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:<br />
#:<source lang="ini" enclose="div"><br />
composer --version<br />
bower --version<br />
</source><br />
#Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''. <br />
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
composer install<br />
</source><br />
#En una consola en '''<path_proyecto>/bin''' ejecutar: <br />
#:<source lang="bash" enclose="div"><br />
./reestructurar<br />
</source><br />
#:Es un comando que se corre por única vez para reubicar la carpeta '''instalacion''', que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.<br />
#Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.<br />
#Reiniciar Apache.<br />
#:<source lang="bash" enclose="div"><br />
service apache2 restart<br />
</source><br />
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./toba instancia regenerar -i desarrollo<br />
</source><br />
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.<br />
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
./guarani migrar_base<br />
</source><br />
#En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:<br />
#:Desde '''<path proyecto Guaraní>''' ejecutar:<br />
#:<source lang="bash" enclose="div"><br />
cp menu.ini.tmpl menu.ini<br />
</source><br />
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]<br />
<br />
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]</div>Fmartinez