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

De SIU
Saltar a: navegación, buscar
 
 
(No se muestran 3 ediciones intermedias del mismo usuario)
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.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:
+
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta '''tehuelche''', obteniendo de esta manera '''/siu/tehuelche/4.3.0'''. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:
−
<br />
+
 
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
 
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .
 
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .
 
</source>
 
</source>
  
 +
2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:
  
−
'''2)''' Ingresaremos al directorio creado y realizaremos la instalación de dependencias mediante Composer:
 
−
<br />
 
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
−
composer install
+
composer install --no-dev
 
</source>
 
</source>
−
<br />
 
  
−
'''3)''' Realizar siempre un backup de la base de datos de la instalación.
+
3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.
−
<br />
 
−
<br />
 
  
−
'''4)''' Configurar el archivo de actualización. Dentro de la carpeta de instalación se encuentra el archivo ''instalador.env.dist''. Debemos copiar este y renombrarlo como ''instalador.env''. Una vez hecho esto, podemos editar este nuevo archivo de configuración, ingresando los valores que deseamos utilizar en la actualización.
+
4. 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
 +
 +
5. 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:
  
−
* '''PROYECTO_DB_DBNAME='''"xxx" ---> nombre de la base de datos de la versión que deseamos actualizar
+
PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
−
* '''TOBA_DB_DBNAME='''"xxx" ---> nombre de la base de datos de la versión que deseamos actualizar
+
TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar<br />
−
* '''TOBA_URL_BASE='''"<nowiki>http://url</nowiki>" ---> URL base de acceso al servidor
+
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>" ---> URL base de acceso al servidor<br />
−
* '''TOBA_USUARIO='''"usuario" ---> usuario para primer acceso a la nueva versión del módulo
+
TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo<br />
−
* '''TOBA_PASSWORD='''"contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo
+
TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo<br />
−
* '''TOBA_PROYECTO_DIR='''"./siu/tehuelche/4.3.x/" ---> directorio del proyecto (paso 1)
+
TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''<br />
−
* '''TOBA_INSTALACION_DIR='''"./siu/tehuelche/4.3.x/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)
+
TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente<br />
−
* '''TOBA_ALIAS_PROYECTO='''"/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''
+
TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente<br />
−
* '''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.
  
−
'''5)''' Verificar que en la instalación a actualizar el archivo /siu/tehuelche/4.0.1/instalacion/i__produccion/'''instancia.ini''' (si tomamos el ejemplo mencionado anteriormente) tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto tehuelche.
+
6. 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
  
−
'''6)''' Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:
+
7. Ejecutar el instalador de la siguiente manera:
−
<br />
+
 
−
<source lang="php" enclose="div" style="font-style: italic;">
+
./bin/instalador proyecto:actualizar
−
bin/instalador proyecto:actualizar
 
−
</source>
 
−
''Observación'': Durante la actualización, al finalizar el paso 8 (Actualizar proyecto) puede suceder que arroje el siguiente mensaje de error:
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
[ERROR] No se pudo generar el autoload porque existen clases repetidas.
 
−
</source>
 
−
El mismo, no representa un error en sí mismo y es posible seguir adelante sin ningún problema.
 
−
<br />
 
  
 +
8. Revisar '''instalador.log''' para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:
  
−
'''7)''' Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
+
tail -f instalador.log
−
* Es muy probable que haya configuraciones del archivo ''/etc/php/<versión PHP>/cli/php.ini'' que nos informe el instalador que debemos modificar.
 
−
<br />
 
  
−
'''8)''' Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):
+
9. Seguir las instrucciones que brinda el instalador para:
−
<br />
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png
 
−
</source>
 
−
<br />
 
  
−
'''9)''' Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
+
* Acomodar permisos de archivos y direcotorios
−
<br />
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
sudo bin/instalador permisos:simple
 
−
</source>
 
−
<br />
 
  
−
'''10)''' Correr el comando para incorporar el link simbólico. El instalador indicará en pantalla un comando similar al siguiente, que deberemos ejecutar (notar que '''ruta_a_la_instalación''' dependerá de la instalación puntual realizada):
+
sudo ./bin/instalador permisos:simple
−
<br />
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf
 
−
</source>
 
−
<br />
 
  
−
'''11)''' Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
+
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
−
<br />
+
* Quitar el modo mantenimiento del proyecto
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
sudo service apache2 reload
 
−
</source>
 
−
<br />
 
  
−
'''12)''' Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:
+
  ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
−
* Es posible editar el archivo ''proyecto.ini'' y asignar cero a la variable '''modo_mantenimiento'''.
 
−
* Otra opción es utilizar el siguiente comando del instalador:
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
−
</source>
 
−
<br />
 
  
−
'''12)''' Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
+
10. Reiniciar el servidor web para que tome los nuevos cambios.
  
−
<br>
 
 
[[SIU-Tehuelche/version_4.3 | < Volver]]
 
[[SIU-Tehuelche/version_4.3 | < Volver]]

Revisión actual del 12:30 4 ene 2022

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. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta tehuelche, obteniendo de esta manera /siu/tehuelche/4.3.0. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:

git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .

2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:

composer install --no-dev

3. 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: 

cp -a instalador.env.dist instalador.env

5. 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.

6. 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

7. Ejecutar el instalador de la siguiente manera: 

./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: 

tail -f instalador.log

9. 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

10. 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.3/actualizacion&oldid=78125»