Diferencia entre revisiones de «SIU-Tehuelche/version 4.5/actualizacion»

De SIU
Saltar a: navegación, buscar
 
(→‎Proceso de Actualización)
 
Línea 6: Línea 6:
  
  
−
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.5.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.5.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:
+
1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el [https://herramientas.comunidad.siu.edu.ar Portal de Servicios de Comunidad].
  
−
<source lang="php" enclose="div" style="font-style: italic;">
+
2. Luego, vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.5.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.5.0'''. Luego, debemos descomprimir el archivo descargado en el paso anterior y copiar el contenido dentro directorio creado recientemente donde se desea realizar la instalación.
−
git clone --branch 4.5.x https://hub.siu.edu.ar/siu/tehuelche.git .
 
−
</source>
 
  
−
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:
+
3. Realizaremos la instalación de dependencias mediante Composer:
  
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
Línea 18: Línea 16:
 
</source>
 
</source>
  
−
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.
+
4. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.
  
−
4. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando:  
+
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando:  
  
 
  cp -a instalador.env.dist instalador.env
 
  cp -a instalador.env.dist instalador.env
  
−
5. Configurar archivo '''instalador.env'''
+
6. Configurar archivo '''instalador.env'''
  
 
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:
 
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:
Línea 39: Línea 37:
 
En general para los alias de apache y bases de datos, se mantiene la misma configuración de la instalación anterior. Se puede consultar entonces el archivo instalador.env de la instalación anterior y configurar el instalador.env actual de la misma manera.
 
En general para los alias de apache y bases de datos, se mantiene la misma configuración de la instalación anterior. Se puede consultar entonces el archivo instalador.env de la instalación anterior y configurar el instalador.env actual de la misma manera.
  
−
6. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.
+
7. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.
  
 
  chmod +x vendor/siu-toba/framework/bin/toba
 
  chmod +x vendor/siu-toba/framework/bin/toba
  
−
7. Ejecutar el instalador de la siguiente manera:
+
8. Ejecutar el instalador de la siguiente manera:
  
 
  ./bin/instalador proyecto:actualizar
 
  ./bin/instalador proyecto:actualizar
  
−
8. Revisar '''instalador.log''' para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:
+
9. Revisar '''instalador.log''' para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:
  
 
  tail -f instalador.log
 
  tail -f instalador.log
  
−
9. Seguir las instrucciones que brinda el instalador para:
+
10. Seguir las instrucciones que brinda el instalador para:
  
 
* Acomodar permisos de archivos y direcotorios
 
* Acomodar permisos de archivos y direcotorios
Línea 62: Línea 60:
 
   ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
   ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
  
−
10. En caso de que la instalación se encuentre vinculada a ARAI-Usuarios, hay que migrar parte de la configuración manualmente.  
+
11. En caso de que la instalación se encuentre vinculada a ARAI-Usuarios, hay que migrar parte de la configuración manualmente.  
  
 
* En el nuevo archivo '''instalacion/instalacion.ini''' se deben agregar las campos:
 
* En el nuevo archivo '''instalacion/instalacion.ini''' se deben agregar las campos:
Línea 87: Línea 85:
 
</code>
 
</code>
  
−
11. Reiniciar el servidor web para que tome los nuevos cambios.
+
12. Reiniciar el servidor web para que tome los nuevos cambios.
  
 
[[SIU-Tehuelche/version_4.5 | < Volver]]
 
[[SIU-Tehuelche/version_4.5 | < Volver]]

Revisión actual del 10:42 5 ago 2024

Proceso de Actualización

El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.

  • Ejemplo: si el directorio de la versión base es /siu/tehuelche/4.0.1 nos situaremos en /siu/tehuelche para realizar el proceso de actualización.


1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el Portal de Servicios de Comunidad.

2. Luego, vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.5.0 creamos la carpeta para la nueva instalación dentro de la carpeta tehuelche, obteniendo de esta manera /siu/tehuelche/4.5.0. Luego, debemos descomprimir el archivo descargado en el paso anterior y copiar el contenido dentro directorio creado recientemente donde se desea realizar la instalación.

3. Realizaremos la instalación de dependencias mediante Composer:

composer install --no-dev

4. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.

5. Copiar el archivo instalador.env.dist y renombrar a instalador.env. En linux se puede utilizar el siguiente comando: 

cp -a instalador.env.dist instalador.env

6. Configurar archivo instalador.env

Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son: 

PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar

TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar

TOBA_URL_BASE="http://localhost" ---> URL base de acceso al servidor

TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo

TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo

TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo (este alias se adicionará a la URL base del servidor)

TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente

TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente

En general para los alias de apache y bases de datos, se mantiene la misma configuración de la instalación anterior. Se puede consultar entonces el archivo instalador.env de la instalación anterior y configurar el instalador.env actual de la misma manera.

7. Dar permisos de ejecución al archivo toba que se encuentra en el directorio bin del framework Toba. 

chmod +x vendor/siu-toba/framework/bin/toba

8. Ejecutar el instalador de la siguiente manera: 

./bin/instalador proyecto:actualizar

9. Revisar instalador.log para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar: 

tail -f instalador.log

10. Seguir las instrucciones que brinda el instalador para:

  • Acomodar permisos de archivos y direcotorios
sudo ./bin/instalador permisos:simple
  • Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
  • Quitar el modo mantenimiento del proyecto
 ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

11. En caso de que la instalación se encuentre vinculada a ARAI-Usuarios, hay que migrar parte de la configuración manualmente.

  • En el nuevo archivo instalacion/instalacion.ini se deben agregar las campos:

vincula_arai_usuarios = "1"

vincula_arai_appID = "...." donde el valor para vincula_arai_appID se obtiene del id que se puede ver en Arai-Usuarios / Aplicaciones.

  • En el archivo instalacion/i__produccion/p__toba_usuarios/rest/rest_arai_usuarios/cliente.ini se deben definir los siguientes valores.

[conexion]

to = "https://dominio-local/api-usuarios/v1/"

auth_tipo = "basic"

auth_usuario = "tehuelche"

auth_password = "password-tehuelche"

12. Reiniciar el servidor web para que tome los nuevos cambios.

< Volver

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.5/actualizacion&oldid=101410»