Saltar al contenido principal
Esta sección describe el proceso para actualizar ABBYY Vantage a la última versión disponible.
Antes de actualizar Vantage, asegúrese de que se cumplan todos los requisitos de la nueva versión que se enumeran en la sección Requisitos del sistema.
El proceso de actualización consta de los siguientes pasos:
  1. Sincronizar imágenes de contenedores.
  2. Realizar una copia de seguridad de los datos.
  3. Ejecutar los scripts de instalación.
  4. Desinstalar Vantage.
  5. Actualizar ABBYY Vantage.

​
Sincronizar imágenes de contenedor

Para sincronizar las imágenes de contenedor, siga los pasos de Descarga de imágenes de contenedor.

​
Realizar copia de seguridad de los datos

Para restaurar Vantage a la versión que estaba en ejecución en el momento de la actualización, debe disponer de una copia de seguridad de las bases de datos, de Consul y de copias de los secretos de Kubernetes. Siga los pasos que se indican a continuación para realizar correctamente la copia de seguridad de estos componentes:
  1. Antes de crear una copia de seguridad de las bases de datos y de Consul, debe detener el clúster. Apague todos los nodos del clúster.
  2. Cree una copia de seguridad de:
    • Databases: La lista de bases de datos es: apigatewayregistry, auth, auth-identity, catalogstorage, cron, documentset, folderimport, interactive-jobs, mail, mailimport, permissions, publicapi, reporting, secretstorage, security-audit, skillinfo, skillmonitor, storage, subscriptions, tokenmanagement, transactions, workflows, workspace.
    • Consul: El CronJob de Kubernetes realiza copias de seguridad de Consul en un almacenamiento RWX externo (como NFS) mediante un pod con el nombre [X].consul-backup. Puede obtener los archivos TGZ de la copia de seguridad desde la carpeta PVC llamada consul-backup.
  3. Inicie el clúster. Inicie todos los nodos del clúster.
  4. Realice una copia de seguridad de las copias de los secretos de Kubernetes. Para obtener las claves, ejecute los siguientes comandos:
kubectl get secret -n abbyy-vantage secretstorage-encryptionkeys -o yaml
kubectl get secret -n abbyy-vantage tokenmanagement-encryptionkeys -o yaml
Antes de crear una copia de seguridad de los secretos de Kubernetes, asegúrese de que el clúster esté en ejecución.
Las copias de seguridad se realizan solo por precaución. Si la actualización se completa correctamente, no será necesario restaurar a partir de la copia de seguridad.

​
Ejecutar los scripts de instalación

Antes de actualizar ABBYY Vantage, siga los pasos de Instalación. Para ejecutar los scripts de instalación:
  1. Configure los archivos de configuración.
Por defecto, la versión 2 del núcleo tecnológico se elimina al actualizar Vantage. Para conservarla, agregue el parámetro techcore.keep_previous_version al archivo env_specific.yml y establezca su valor en true.
  1. Prepare los certificados.
  2. Descargue las imágenes de contenedores.
  3. Ejecute los scripts de instalación (pasos 1 a 3).

​
Desinstalar Vantage

Ejecute el siguiente playbook para desinstalar el producto: 
ansible-playbook -i inventories/k8s -v playbooks/uninstall-vantage.yml
Este playbook eliminará todos los servicios, pero dejará intacto el almacén de datos.

​
Actualizar ABBYY Vantage

Para actualizar ABBYY Vantage:
  1. Ejecute los siguientes playbooks para realizar una comprobación previa al despliegue y para leer y aceptar los documentos legales de Vantage:
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
Los playbooks harán lo siguiente:
  • Realizarán una comprobación preliminar de los recursos cuyos parámetros se especifican en el archivo env_specific.yml del playbook (base de datos, conexión SMTP, etc.).
  • Pedirán al administrador del sistema que acepte los términos del EULA y la Política de Privacidad de ABBYY.
  1. Ejecute el siguiente playbook para actualizar Vantage:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
Los playbooks instalarán una nueva versión del producto. En promedio, el proceso tardará entre 20 y 30 minutos.
Después de que se actualice ABBYY Vantage, tendrá que volver a autenticarse. Los tokens de autorización obtenidos antes de la actualización ya no funcionarán.
Para trabajar con Advanced Designer y Scanning Station, debe descargar sus nuevas versiones e instalarlas en sus equipos:
  • https://<your-vantage-host>/ad/latest - para descargar Advanced Designer
  • https://<your-vantage-host>/ss/latest - para descargar Scanning Station
Si el proceso de actualización falla, consulte la sección siguiente, Recovery.

​
Recuperación

Si el proceso de actualización no se completó correctamente, siga estos pasos:
  1. Compruebe que los pods del clúster estén funcionando correctamente y reinícielos si no lo están.
  2. Analice los registros de los pods que no están funcionando según lo previsto.
  3. Siga los pasos de resolución de problemas indicados en los registros de los pods.
  4. Si la actualización falla en cualquier paso de la instalación de una nueva versión de Vantage (por ejemplo, esperando a que se completen trabajos de Vantage, esperando a que se realicen despliegues de Vantage), corrija la causa del error y luego ejecute el playbook de instalación:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml

​
Instalación de Vantage con recuperación de datos en un clúster nuevo

Si los pasos descritos anteriormente no dieron resultado, puede instalar Vantage con recuperación de datos en un clúster nuevo siguiendo estos pasos:
  1. Asegúrese de tener las copias de seguridad más recientes de sus datos.
  2. Restaure los datos a partir de las copias de seguridad que creó anteriormente.
  3. Prepare el archivo env_specific que contenga la información de conexión para las bases de datos y el almacenamiento externo restaurados desde las copias de seguridad.
  4. Instale Vantage siguiendo los pasos de Running the installation scripts en la sección Installation. Para el paso 2 (ejecutar el instalador desde una imagen de Docker), use el siguiente comando:
docker run -it --net=host \
-v $PWD/kube:/root/.kube \
-v $PWD/inventory:/ansible/inventories/k8s/inventory \
-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
--privileged \
registry.local/vantage/vantage-k8s:2.7.1
  1. Sobrescriba los valores de las claves en los secretos secretstorage-encryptionkeys y tokenmanagement-encryptionkeys con los valores de los que hizo copia de seguridad anteriormente: a. Ejecute el comando: 
    kubectl edit secrets -n abbyy-vantage secretstorage-encryptionkeys
    b. En el archivo que se abre, después de key-<guid>.xml, sustituya la cadena en base64 por la cadena en base64 contenida en la clave de la que se hizo copia de seguridad previamente para el secreto secretstorage-encryptionkeys. c. Guarde los cambios y cierre el editor. d. Haga lo mismo para el secreto tokenmanagement-encryptionkeys usando el comando: 
    kubectl edit secrets -n abbyy-vantage tokenmanagement-encryptionkeys
  2. Después de sobrescribir las claves, reinicie los pods secretstorage y tokenmanagement: 
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=secretstorage -o name)

kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
  1. Vuelva a iniciar las transacciones. En un equipo conectado al clúster, ejecute el siguiente comando para acceder al servicio de transacciones:
kubectl port-forward -n abbyy-vantage deployments/abbyy-vantage-transactions 8080:8080
En su navegador, vaya a http://localhost:8080/index.html y ejecute el siguiente método de la API: 
/api/recovery/transactions/restart
Si la dirección del servidor de Vantage ha cambiado después de la recuperación y hay invitaciones no aceptadas en el sistema, deberá reenviar esas invitaciones.