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

De SIU
Saltar a: navegación, buscar
 
 
(No se muestran 9 ediciones intermedias del mismo usuario)
Línea 3: Línea 3:
 
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.
 
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.1.0''' nos situaremos en '''./siu/tehuelche''' para realizar el proceso de actualización.
+
* 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.
  
  
Línea 9: Línea 9:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
git clone --branch 4.1.1 https://hub.siu.edu.ar/siu/tehuelche.git 4.1.1
+
git clone --branch 4.1.x https://hub.siu.edu.ar/siu/tehuelche.git 4.1.x
 
</source>
 
</source>
  
''Notaremos que este primer paso del proceso de actualización (la copia del código fuente desde el repositorio) creará un nuevo directorio "4.1.1" que convivirá junto al directorio de la versión base. Dentro del mismo se encontrarán todos los archivos necesarios para la actualización del módulo.''
+
''Notaremos que este primer paso del proceso de actualización (la copia del código fuente desde el repositorio) creará un nuevo directorio "4.1.x" que convivirá junto al directorio de la versión base. Dentro del mismo se encontrarán todos los archivos necesarios para la actualización del módulo.''
  
  
Línea 22: Línea 22:
 
<br />
 
<br />
  
'''3)''' Configurar el archivo de instalación/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.
+
'''3)''' Realizar siempre un backup de la base de datos de la instalación.
 +
<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.
 
<br />
 
<br />
 
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 31: Línea 35:
 
* '''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
 
* '''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
* '''TOBA_PROYECTO_DIR='''"./siu/tehuelche/4.1.1/" ---> directorio del proyecto (paso 1)
+
* '''TOBA_PROYECTO_DIR='''"./siu/tehuelche/4.1.x/" ---> directorio del proyecto (paso 1)
* '''TOBA_INSTALACION_DIR='''"./siu/tehuelche/4.1.1/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)
+
* '''TOBA_INSTALACION_DIR='''"./siu/tehuelche/4.1.x/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)
 
* '''TOBA_ALIAS_PROYECTO='''"/xxx" ---> alias de acceso al módulo ''(este alias se adicionará a la URL base del servidor)''
 
* '''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_NUCLEO='''"/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente
 
* '''TOBA_ALIAS_TOBA_USUARIOS='''"/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente
 
* '''TOBA_ALIAS_TOBA_USUARIOS='''"/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente
* Es importante que las variables '''PROYECTO_DB_SCHEMA''' y '''TOBA_DB_SCHEMA'''  este configurada con el valor '''tehuelche'''. Caso contrario fallará el proceso de actualización.
 
  
  
 +
'''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.
  
'''4)''' Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:
+
 
 +
'''6)''' Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
 
bin/instalador proyecto:actualizar
 
bin/instalador proyecto:actualizar
 
</source>
 
</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 />
 
<br />
  
'''5)''' Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
+
 
 +
'''7)''' Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
 
* Es muy probable que haya configuraciones del archivo ''/etc/php/7.1/cli/php.ini'' que nos informe el instalador que debemos modificar.
 
* Es muy probable que haya configuraciones del archivo ''/etc/php/7.1/cli/php.ini'' que nos informe el instalador que debemos modificar.
 
<br />
 
<br />
  
'''6)''' 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):
+
'''8)''' Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<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
+
cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png
 
</source>
 
</source>
 
<br />
 
<br />
  
'''7)''' Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):
+
'''9)''' Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png
+
sudo bin/instalador permisos:simple
 
</source>
 
</source>
 
<br />
 
<br />
  
'''8)''' Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
+
'''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):
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
sudo bin/instalador permisos:simple
+
sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf
 
</source>
 
</source>
 
<br />
 
<br />
  
'''9)''' Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
+
'''11)''' Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
Línea 79: Línea 90:
 
<br />
 
<br />
  
'''10)''' Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:
+
'''12)''' Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:
 
* Es posible editar el archivo ''proyecto.ini'' y asignar cero a la variable '''modo_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:
 
* Otra opción es utilizar el siguiente comando del instalador:
Línea 87: Línea 98:
 
<br />
 
<br />
  
'''11)''' Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
+
'''12)''' Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
  
 
<br>
 
<br>
 
[[SIU-Tehuelche/version_4.1 | < Volver]]
 
[[SIU-Tehuelche/version_4.1 | < Volver]]

Revisión actual del 16:45 18 mar 2021

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) Copiar el código fuente de la nueva versión desde el repositorio. Para esto utilizamos el comando clone de Git de las siguiente manera:

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

Notaremos que este primer paso del proceso de actualización (la copia del código fuente desde el repositorio) creará un nuevo directorio "4.1.x" que convivirá junto al directorio de la versión base. Dentro del mismo se encontrarán todos los archivos necesarios para la actualización del módulo.


2) Ingresaremos al directorio creado y realizaremos la instalación de dependencias mediante Composer:

composer install


3) Realizar siempre un backup de la base de datos de la instalación.

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.
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://url" ---> 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_PROYECTO_DIR="./siu/tehuelche/4.1.x/" ---> directorio del proyecto (paso 1)
  • TOBA_INSTALACION_DIR="./siu/tehuelche/4.1.x/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)
  • 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


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) Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:

bin/instalador proyecto:actualizar

Observación: Durante la actualización, al finalizar el paso 8 (Actualizar proyecto) puede suceder que arroje el siguiente mensaje de error:

[ERROR] No se pudo generar el autoload porque existen clases repetidas.

El mismo, no representa un error en sí mismo y es posible seguir adelante sin ningún problema.


7) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos

  • Es muy probable que haya configuraciones del archivo /etc/php/7.1/cli/php.ini que nos informe el instalador que debemos modificar.


8) Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):

cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png


9) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:

sudo bin/instalador permisos:simple


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 ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf


11) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:

sudo service apache2 reload


12) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:

  • 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:
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento


12) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación instalador.env.


< Volver