Saltar al contenido principal
Vantage 3.0 reemplaza este modelo de implementación. Vantage 2.7 y las versiones anteriores requerían la infraestructura especificada por ABBYY, creada mediante scripts de Ansible y Azure CLI proporcionados por ABBYY. Este modelo no es compatible con la versión 3.0: usted aprovisiona su propia infraestructura y ABBYY no proporciona scripts de aprovisionamiento ni ningún otro tipo de automatización de infraestructura. Esta página se aplica únicamente a Vantage 2.7. Consulte la descripción general de Vantage 3.0 y Migrar desde Vantage 2.7.
En esta sección se describe el proceso de actualización de ABBYY Vantage dentro de la serie de versiones 2.7.x. La actualización a 3.0 es una migración, no una actualización; consulte Migrar desde Vantage 2.7.
Antes de actualizar Vantage, asegúrese de que se cumplan todos los requisitos de la nueva versión indicados en la sección Requisitos del sistema.
El proceso de actualización consta de los siguientes pasos:
  1. Sincronizar las imágenes de contenedor.
  2. Hacer una copia de seguridad de los datos.
  3. Ejecutar los script de instalación de instalación.
  4. Desinstalar Vantage.
  5. Actualizar ABBYY Vantage.

Sincronizar imágenes de contenedor

Para sincronizar imágenes de contenedor, sigue los pasos que se indican en Descargar imágenes de contenedor.

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 tener una copia de seguridad de las bases de datos, de Consul y copias de los secretos de Kubernetes. Siga estos pasos para hacer correctamente una 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:
    • Bases de datos: 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 crea una copia de seguridad de Consul en almacenamiento RWX externo (como NFS) mediante un pod llamado [X].consul-backup. Puede obtener los archivos TGZ de copia de seguridad desde la carpeta del PVC llamada consul-backup.
  3. Inicie el clúster. Inicie todos los nodos del clúster.
  4. Haga una copia de seguridad de las copias de los secretos de Kubernetes. Para obtener las claves, ejecute los siguientes comandos:
Antes de crear copias de seguridad de los secretos de Kubernetes, asegúrese de que el clúster esté en ejecución.
Las copias de seguridad se hacen por precaución. Si la actualización se realiza correctamente, no tendrá que restaurar 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.
De manera predeterminada, la versión 2 de Technology Core 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 contenedor.
  3. Ejecute los scripts de instalación (pasos 1-3).

Desinstalar Vantage

Ejecute el siguiente playbook para desinstalar el producto:
Este playbook eliminará todos los services y dejará intacto el data store.

Actualizar ABBYY Vantage

Para actualizar ABBYY Vantage:
  1. Ejecute los siguientes playbooks para realizar una comprobación previa al despliegue y leer y aceptar los documentos legales de Vantage:
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.).
  • Solicitará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:
Los playbooks instalarán una nueva versión del producto. En promedio, el proceso tardará entre 20 y 30 minutos.
Después de actualizar ABBYY Vantage, deberá volver a autorizar. 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 siguiente sección: Recuperación.

Recuperación

Si el proceso de actualización no se completó correctamente, siga estos pasos:
  1. Compruebe que los pods del clúster funcionen correctamente y reinícielos si no es así.
  2. Analice los logs de los pods que no estén funcionando como deberían.
  3. Siga los pasos de solución de problemas indicados en los logs del pod.
  4. Si la actualización falla en cualquier paso de la instalación de una nueva versión de Vantage (por ejemplo, al esperar los trabajos de Vantage o las implementaciones de Vantage), corrija la causa del error y luego ejecute el playbook de instalación:

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

Si los pasos descritos anteriormente no funcionaron, 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 todos sus datos.
  2. Restaure los datos desde las copias de seguridad que creó anteriormente.
  3. Prepare el archivo env_specific con los datos necesarios para conectar las bases de datos y el almacenamiento externo restaurados desde las copias de seguridad.
  4. Instale Vantage siguiendo los pasos de Ejecución de los scripts de instalación en la sección Instalación. Para el paso 2 (ejecutar el instalador desde una imagen de Docker), use el siguiente comando:
  1. Sobrescribe los valores de las claves en los secrets secretstorage-encryptionkeys y tokenmanagement-encryptionkeys con los valores de los que hiciste copia de seguridad anteriormente: a. Ejecuta el comando:
    b. En el archivo que se abre, después de key-<guid>.xml, reemplaza la cadena en base64 por la cadena en base64 contenida en la clave de la que se hizo copia de seguridad previamente para el secret secretstorage-encryptionkeys. c. Guarda los cambios y cierra el editor. d. Haz lo mismo para el secret tokenmanagement-encryptionkeys con el comando:
  2. Después de sobrescribir las claves, reinicia los pods secretstorage y tokenmanagement:
  1. Reinicie las transacciones. En una máquina conectada al clúster, ejecute este comando para acceder al servicio de transacciones:
Ve a http://localhost:8080/index.html en tu navegador y ejecuta el siguiente método de API:
Si la dirección del host de Vantage ha cambiado después de la recuperación y hay invitaciones pendientes de aceptación en el sistema, deberá volver a enviarlas.