Diferencia entre revisiones de «SIU-Guarani/version3.15.0/instalacion paralela/gestion/linux»

De SIU
Saltar a: navegación, buscar
(Se agrega página para versión paralela)
 
 
(No se muestran 2 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
  
= Instalación desde cero de SIU-Guaraní Gestión 3.15 en entorno de Desarrollo=
+
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
 +
== Mantener mi versión actual e instalar la nueva versión en entorno de desarrollo con personalizaciones ==
 +
 
 
{| class="simple" border="1"
 
{| class="simple" border="1"
!Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
+
! <u>Importante</u>: Antes de comenzar el proceso de actualización, verificar las <u>[[SIU-Guarani/Version3.15.0/Novedades tecnicas|novedades técnicas]]</u> de la versión.
|}'''A lo largo de los pasos se deberá reemplazar:'''
+
|}
*'''<path proyecto Guaraní>''': por el path donde está instalado el proyecto
+
 
*'''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación
+
=== Requisitos previos ===
**3.15.x: por la versión que se va a instalar
+
* Previamente se deberán tener exportadas las personalizaciones de la versión anterior. Pasos del concentrador del 1 al 2.http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion
== Pasos para la instalación==
+
 
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]
+
 
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
+
=== Pasos para la instalación ===
#:<source lang="bash" enclose="div">mkdir /usr/local/proyectos/guarani</source>
+
* Seguir los pasos para la instalación del siguiente link. http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/instalacion_desde_cero/instalacion/gestion/linux
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.
+
 
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
+
#Migrar las personalizaciones
#:<source lang="bash" enclose="div">
+
#: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>
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x <path proyecto Guaraní>
+
##Mergear la carpeta '''personalizacion''' a la nueva versión
</source>
+
##: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:
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
+
##:<source lang="bash" enclose="div">
#:<source lang="bash" enclose="div">
+
svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/
composer install
 
</source>
 
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:
 
#:<source lang="bash" enclose="div">
 
export TOBA_INSTANCIA=desarrollo
 
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion
 
./toba instalacion instalar
 
</source>
 
#:y completar:
 
#:<source lang="bash" enclose="div">
 
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
 
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico>
 
Se trata de una instalacion de producción? (Si o No) (s/n): n
 
Nombre de la instalación (ej: Andromeda): <ej: guarani3>
 
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
 
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
 
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
 
PostgreSQL - Clave  (ENTER para usar sin clave): <clave servidor Postgres>
 
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3>
 
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
 
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
 
 
</source>
 
</source>
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:
+
##Activar el esquema de personalizaciones
#*<path proyecto Guaraní>/www
+
##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:
#*<path proyecto Guaraní>/temp
+
##:<source lang="bash" enclose="div">
#*<path proyecto Guaraní>/instalacion
+
./guarani esquema_pers iniciar
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www
 
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp
 
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', debería ejecutarse:
 
#:<source lang="bash" enclose="div">
 
chown -R $(whoami):www-data <path proyecto Guaraní>/www
 
chown -R $(whoami):www-data <path proyecto Guaraní>/temp
 
chown -R $(whoami):www-data <path proyecto Guaraní>/instalacion
 
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www
 
chown -R $(whoami):www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp
 
 
</source>
 
</source>
#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:
+
##Chequear conflictos de las personalizaciones con la nueva versión
#:<source lang="bash" enclose="div">
+
##: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:
ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
+
##:<source lang="bash" enclose="div">
a2ensite gestion.conf
+
./guarani esquema_pers conflictos
service apache2 reload
 
 
</source>
 
</source>
#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'''):
+
##:'''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.
#:<source lang="ini" enclose="div">
+
##Importar las personalizaciones
[xslfo]
+
##: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:
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
+
##:<source lang="bash" enclose="div">
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
+
./guarani esquema_pers importar
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:
 
#:<source lang="bash" enclose="div">
 
cp menu.ini.tmpl menu.ini
 
 
</source>
 
</source>
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]
+
##Agregar al repositorio las personalizaciones importadas
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
+
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:
#:<source lang="bash" enclose="div">
+
##:<source lang="bash" enclose="div">
./guarani cargar -d <path proyecto Guaraní>
+
svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores"
 
</source>
 
</source>
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''.
+
##Exportar las personalizaciones
#Reiniciar Apache:
+
##: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:
#:<source lang="bash" enclose="div">
+
##:<source lang="bash" enclose="div">
service apache2 restart
+
./guarani exportar
 
</source>
 
</source>
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
+
##Versionar las personalizaciones
#:<source lang="bash" enclose="div">./guarani instalar</source>
+
##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
+
##:<source lang="bash" enclose="div">
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
+
svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores"  
#:<source lang="bash" enclose="div">./guarani crear_auditoria -f guarani</source>
 
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
 
#:<source lang="bash" enclose="div">java -jar <path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081</source>
 
#Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto:
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.15</source>
 
#:El usuario-clave para el primer acceso es: '''toba''', '''toba'''. Se recomienda luego del primer acceso modificar la clave.
 
#Para editar el proyecto, navegar hacia la URL definida en ''toba.conf'', por defecto:
 
#:<source lang="php" enclose="div">http://localhost/toba_editor/3.0</source>
 
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
 
== Configuración de cron o tarea programada para el envío de emails==
 
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.
 
*:Con un sistema '''GNU/Linux''':
 
#En una consola ejecutar el comando:<source lang="php" enclose="div">crontab -e </source>
 
#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/
 
#Guardar y salir del editor
 
*:Con un sistema '''Windows''':
 
#Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:<source lang="php" enclose="div">
 
@echo off
 
<path proyecto Guaraní>\bin\guarani enviar_emails_notificador
 
exit
 
 
</source>
 
</source>
#Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".
 
#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".
 
#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).
 
#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.
 
#Aceptar para crear la tarea.
 
(Para más detalles del '''envío de emails''' consulte la documentación del [[SIU-Guarani/Version3.15.0/notificador|notificador]])
 
  
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]
+
== Pasos a realizar por el resto del equipo ==
 +
Una vez subida las personalizaciones en el colab en la versión 3.15.0 el resto del equipo, si quiere mantener en paralelo la versión anterior e tener también está versión, solo deberá hacer una instalación desde 0.

Revisión actual del 15:58 29 jun 2018

Mantener mi versión actual e instalar la nueva versión en entorno de desarrollo con personalizaciones

Importante: Antes de comenzar el proceso de actualización, verificar las novedades técnicas de la versión.

Requisitos previos


Pasos para la instalación

  1. Migrar las personalizaciones
    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.
    1. Mergear la carpeta personalizacion a la nueva versión
      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:
      svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/
    2. Activar el esquema de personalizaciones
      Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
      ./guarani esquema_pers iniciar
    3. Chequear conflictos de las personalizaciones con la nueva versión
      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:
      ./guarani esquema_pers conflictos
      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.
    4. Importar las personalizaciones
      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:
      ./guarani esquema_pers importar
    5. Agregar al repositorio las personalizaciones importadas
      Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
      svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores"
    6. Exportar las personalizaciones
      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:
      ./guarani exportar
    7. Versionar las personalizaciones
      Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
      svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores"

Pasos a realizar por el resto del equipo

Una vez subida las personalizaciones en el colab en la versión 3.15.0 el resto del equipo, si quiere mantener en paralelo la versión anterior e tener también está versión, solo deberá hacer una instalación desde 0.