Diferencia entre revisiones de «SIU-Tehuelche/version 4.1/actualizacion»
| (No se muestran 6 ediciones intermedias del mismo usuario) | |||
| 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. | + | 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. | + | ''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 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. | + | * '''TOBA_PROYECTO_DIR='''"./siu/tehuelche/4.1.x/" ---> directorio del proyecto (paso 1) |
| − | * '''TOBA_INSTALACION_DIR='''"./siu/tehuelche/4.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_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 | ||
| Línea 38: | Línea 42: | ||
| − | '''4)''' Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando: | + | '''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: | ||
<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 /> | ||
| − | ''' | + | |
| + | '''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 /> | ||
| − | ''' | + | '''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;"> | ||
| − | + | cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png | |
</source> | </source> | ||
<br /> | <br /> | ||
| − | ''' | + | '''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;"> | ||
| − | + | sudo bin/instalador permisos:simple | |
</source> | </source> | ||
<br /> | <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): |
<br /> | <br /> | ||
<source lang="php" enclose="div" style="font-style: italic;"> | <source lang="php" enclose="div" style="font-style: italic;"> | ||
| − | sudo | + | sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf |
</source> | </source> | ||
<br /> | <br /> | ||
| − | ''' | + | '''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 77: | Línea 90: | ||
<br /> | <br /> | ||
| − | ''' | + | '''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 85: | Línea 98: | ||
<br /> | <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'''. |
<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:
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:
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:
Observación: Durante la actualización, al finalizar el paso 8 (Actualizar proyecto) puede suceder que arroje el siguiente mensaje de error:
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):
9) 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):
11) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
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:
12) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación instalador.env.
