Actualizar de 1.2 a 1.3

Esta versión de Documentos, presenta nuevas funciones sobre la versión 1.2.

A continuación se describen los pasos para realizar la actualización de versión.

NO OLVIDE REALIZAR UNA COPIA DE SEGURIDAD DE LA APLICACIÓN Y LAS BASES DE DATOS ANTES DE CONTINUAR

Consideraciones iniciales

• Es necesario contar con una instalación de SIU-Araí: Documentos en la versión 1.2
• Se deberá realizar un despliegue con imágenes Docker
• En caso de utilizar S3, requiere los datos de conexión al mismo
• No incluye migracion de datos desde Nuxeo a otro Storage (Ejemplo S3)

La versión 1.2 mantiene los requerimientos mínimos respecto a la versión anterior:

• Orquestador para contenedores, con soporte a imágenes Docker
• PostgreSQL requerido en versión mínima 9.6 y máxima 12

Procedimiento

Para migrar de una instalación 1.2.X a una 1.3.X se deben seguir los siguientes pasos:

1. Preparar accesos y versiones
2. Resguardo de las bases de datos y assets
3. Actualizar Bases de datos
4. Desplegar contenedores

Preparar accesos y versiones

1. Definir la versión a utilizar

   export VERSION=1.3.0
   export VERSION_ANTERIOR=1.2.X
   

2. Autenticarse contra la registry de imágenes Docker del SIU (utiliza credenciales del HUB)

   docker login hub.siu.edu.ar:5005
   

   Donde opere con imágenes Docker del SIU, se requiere este paso

3. Descargar la imagen de la nueva versión de la aplicación. Asegurarse de tener la versión adecuada

   docker pull hub.siu.edu.ar:5005/siu-arai/docs-api:$VERSION
   

4. Preparar la configuración de conexión a las bases de datos

   Para poder realizar la migración, es necesario configurar unas variables de entorno para conectarse a PostgreSQL respectivamente. Ajustarlo a los parametros requeridos.

   echo \
   "#configurar ENV temporal
   # Variables obligatorias
   ARAI_DOCS_DB_HOST=localhost
   ARAI_DOCS_DB_PORT=5432
   ARAI_DOCS_DB_DBNAME=arai_documentos
   ARAI_DOCS_DB_USERNAME=postgres
   ARAI_DOCS_DB_PASSWORD=postgres
   # Variables no requeridas para actualizar db, pero deben estar
   ARAI_DOCS_DB_SCHEMA=public
   ARAI_DOCS_DB_ENCODING=utf8
   ARAI_DOCS_URL=localhost
   ARAI_DOCS_USER=documentos
   ARAI_DOCS_PASS=documentos
   ARAI_DOCS_LOG_HANDLER=errorlog
   ARAI_DOCS_LOG_LEVEL=ERROR
   ARAI_DOCS_TOKEN_LIFETIME=2000
   ARAI_REGISTRY_URL=http://registry/registry
   ARAI_REGISTRY_USER=registry
   ARAI_REGISTRY_PASS=registry
   " > migrar.env

Backup de las base de datos

1. Realizar el backup de PostgreSQL de manera preventiva

   pg_dump -b -O -x --clean --create --disable-triggers --if-exists -h ${DB_HOST} -p ${DB_PORT} -U ${DB_USERNAME} -d ${DB_DBNAME} -f dump_11.sql
   

Actualizar PostgreSQL

1. Con los datos de configuración actualizados, se migra la estructura de la base de datos en PostgreSQL

   docker run --rm -it  \
      --env-file=migrar.env \
      hub.siu.edu.ar:5005/siu-arai/docs-api:$VERSION \
      --db-update --no-interaction --no-progress
   

Nota: El proceso de actualización aún NO TERMINO. La siguiente sección es crucial para finalizar la actualización a la versión 1.2.

Actualizar configuración

Toda la configuración del proyecto se realiza por medio de variables de entorno. Cada módulo cuenta con un conjunto de variables que permiten su parametrización:

• el templates/arai-docs.env.dist

Tabla de equivalencias

En el cambio de la versión 1.2 a la 1.3 se renombraron algunas variables de entorno.

• Se eliminaron las siguientes variables de entorno:

Variable
ARAI_DOCS_REPO_CONECTOR
ARAI_DOCS_REPO_SISTEMA
ARAI_DOCS_REPO_INSTALACION
ARAI_DOCS_REPO_RDI_SERVICE
ARAI_DOCS_REPO_LOG_DIR
ARAI_DOCS_REPO_LOCAL_TMP_DIR

Nuxeo vs S3

No disponible migracion entre Nuxeo y S3

Nuxeo

Si continua utilizando Nuxeo renombrar las siguientes variables:

Variable anterior	Variable nueva
ARAI_DOCS_REPO_HOST	ARAI_DOCS_NUXEO_HOST
ARAI_DOCS_REPO_USUARIO	ARAI_DOCS_NUXEO_USUARIO
ARAI_DOCS_REPO_CLAVE	ARAI_DOCS_NUXEO_CLAVE

S3

Si utiliza S3 debe crear y modificar las siguientes variables:

1. Reemplazar ARAI_DOCS_REPO_TIPO

   Variable	Valor
   ARAI_DOCS_REPO_TIPO	S3

2. Compleltar las siguientes variables

   Variables S3
   ARAI_DOCS_S3_ENDPOINT
   ARAI_DOCS_S3_KEY
   ARAI_DOCS_S3_SECRET
   ARAI_DOCS_S3_REGION
   ARAI_DOCS_S3_VERSION
   ARAI_DOCS_S3_BUCKET