Saltar al contenido principal

​
Lista de verificación de requisitos previos

Prepare y configure los siguientes componentes externos antes de instalar Vantage:
  • Una máquina con Docker y acceso a internet (desde la que se instala Vantage)
  • Máquinas virtuales (con acceso a internet durante la instalación) que se usarán como nodos de Kubernetes
  • Un registro de contenedores para almacenar imágenes de Docker
  • Sistemas de administración de bases de datos relacionales (RDBMS) para el funcionamiento de Vantage
  • Un servidor SMTP para enviar mensajes de correo electrónico a los usuarios de Vantage
  • Un certificado TLS para establecer comunicaciones cifradas
  • 2 direcciones IP estáticas: una para la configuración/administración de Kubernetes y otra para el acceso a Vantage
  • Un registro DNS para el acceso a Vantage
  • Almacenamiento externo (opcional para la configuración sin alta disponibilidad)

​
Requisitos de la máquina de instalación

La máquina desde la que se va a instalar Vantage requiere lo siguiente:
  • Sistema operativo Linux o Subsistema de Windows para Linux (WSL)
  • Docker versión 19.03 o posterior
  • Acceso de red a abyvtgonprm27.azurecr.io
  • Archivos locales que contengan una clave SSH privada (sin passphrase) para la cuenta de usuario ansible
Todas las máquinas virtuales deben tener la misma clave SSH.

​
Requisitos de infraestructura

Todas las máquinas virtuales pueden ejecutarse en VMware o Hyper-V y deben tener:
  • Una dirección IP estática
  • Una cuenta de usuario llamada ansible con:
    • Acceso mediante una clave SSH compartida
    • Acceso sudo con la opción NOPASSWD
  • Un disco/lvm_volume dedicado y ampliable montado en /opt/local-path-provisioner en cada nodo de trabajo
  • Acceso a Internet durante la instalación al registro de contenedores y a los repositorios de paquetes:
    • Registro de contenedores con las imágenes sincronizadas preparadas como requisito previo para la instalación de Vantage. Para obtener más información, consulte Downloading Container Images.
    • Repositorio de paquetes: Ubuntu (archive.ubuntu.com), RHEL (cdn.redhat.com). Como alternativa al acceso a los repositorios de paquetes, también puede configurar acceso a su propio repositorio, que debe contener todos los paquetes necesarios enumerados a continuación.
Común (todas las distribuciones):
Paquetes específicos del SO:

​
Acceso de red posterior a la instalación

Después de instalar el clúster, las máquinas virtuales necesitan acceso a:
  • https://licensing-us.abbyy.com
  • El servidor de correo, cuya configuración SMTP se especifica en el archivo env_specific.yml (para enviar invitaciones por correo electrónico, recuperar contraseñas, etc.).
  • Todos los servidores de correo desde los que va a importar sus correos electrónicos en las Habilidades de proceso de Vantage.

​
Configuración de alta disponibilidad

Se indica el número mínimo necesario de máquinas virtuales. Según el rendimiento requerido, puede ser necesario un número diferente de máquinas virtuales.

​
Configuración sin alta disponibilidad

La versión 1.33.3 de Kubernetes se instalará durante la instalación de Vantage.

​
Registro de contenedores

Puede usar cualquier registro de contenedores.

​
Requisitos de la base de datos

Se requiere una base de datos Microsoft SQL Server o PostgreSQL con la siguiente configuración:Opción 1: Microsoft SQL ServerOpción 2: PostgreSQLDebe configurarse un servidor de base de datos externo, y debe contar con las credenciales adecuadas para crear y administrar la nueva base de datos.El instalador requiere la dirección IP del servidor SQL, así como un nombre de usuario y una contraseña para conectarse a la base de datos.

​
SMTP Server

El servidor debe operar mediante el protocolo SMTP. El instalador requiere la dirección IP o el nombre DNS, el puerto del servidor SMTP y la contraseña para conectarse al servidor (si el servidor requiere autenticación). El servidor SMTP debe tener permiso para enviar correos electrónicos a los usuarios de Vantage. Configure SMTP con o sin autenticación en env_specific.yml.
Recomendamos usar la opción con autenticación (with nombre de usuario y contraseña).
Con autenticación (recomendado) Con nombre de usuario y contraseña. En este caso, la sección smtp del archivo env_specific.yml debe definirse de la siguiente manera:
Sin autenticación Sin login ni contraseña. En este caso, la sección smtp del archivo env_specific.yml debe definirse así:
No olvide añadir el parámetro mailFrom al nodo raíz.
Recomendamos usar la opción con autenticación (con login y contraseña).

​
Certificado TLS

Necesitará un certificado comodín o un certificado para un dominio específico. Si su instalación de Vantage se conectará a servicios externos mediante la actividad personalizada o exportará a sistemas externos, el certificado debe haber sido emitido por una autoridad de certificación pública, por ejemplo, https://letsencrypt.org/.

​
Direcciones IP estáticas

1. Acceso a la API de Kubernetes. Una dirección IP estática que se usará como IP virtual para acceder al endpoint del servidor de la API de Kubernetes a fin de configurar y administrar el clúster. La dirección IP debe definirse en el archivo env_specific.yml de la siguiente manera. Para obtener más información, consulte Configuración de los archivos de configuración:
2. Acceso a los servicios de Vantage. Una dirección IP estática que se usará para acceder a los servicios de Vantage a través de HTTPS. Debe crearse previamente un registro DNS A adecuado. La dirección IP debe definirse en el archivo env_specific.yml de la siguiente manera. Para obtener más información, consulte Instalación:

​
Registro DNS para acceder a Vantage

No hay requisitos específicos. El instalador requiere un dominio principal y un nombre DNS que se usarán para acceder a Vantage. El registro DNS debe apuntar a la dirección IP dedicada para acceder a Vantage.

​
Requisitos de almacenamiento

El almacenamiento externo es un requisito opcional solo para la configuración Sin alta disponibilidad. Los requisitos de tamaño de disco para la configuración de alta disponibilidad se describen en la Guía de rendimiento.ABBYY Vantage implementa almacenamiento local en los discos duros de las máquinas virtuales proporcionadas, lo que acelera la instalación del producto. Sin embargo, esta opción puede seguir viéndose afectada por reinicios inesperados y fallos de las máquinas virtuales. Como esto puede provocar la pérdida de los datos almacenados, se recomienda usar almacenamiento externo durante la instalación.ABBYY Vantage le permite definir el uso de tipos de almacenamiento específicos de las maneras que se indican a continuación.

​
Uso de almacenamiento local

En este caso, se aprovisionarán localmente volúmenes con acceso ReadWriteOnce compatible con POSIX en el directorio /opt/local_path_provisioner de cada nodo de Kubernetes. Para los tipos de volumen ReadWriteMany, Vantage implementará un nfs-kernel-server en el clúster en el primer nodo abbyy_services (la IP de este nodo es la primera del bloque correspondiente en el archivo inventory). Los datos del servidor NFS se almacenarán en el directorio /opt/local_path_provisioner, así que asegúrese de tener un volumen o disco dedicado para esta ruta en el primer nodo abbyy_services (el primer nodo de este grupo se define en el archivo inventory) de al menos 500 GB.Para la configuración de alta disponibilidad, el primer nodo abbyy_services también alojará almacenamiento local de volúmenes persistentes. Requerirá capacidad adicional de disco duro en función de la carga de procesamiento. Para obtener detalles sobre la capacidad necesaria, consulte la Guía de rendimiento.
Si el almacenamiento local de volúmenes persistentes se queda sin espacio, Vantage puede dejar de funcionar y provocar la pérdida de algunos datos. Le recomendamos que supervise el espacio libre en su entorno y configure alertas cuando el espacio esté por agotarse, para que pueda añadir más almacenamiento a tiempo y evitar la pérdida de datos.

​
Uso de almacenamiento NFS externo

El instalador de Vantage le permite configurar automáticamente un almacenamiento NFS para usarlo como almacenamiento de Vantage para servicios específicos, como la importación y exportación a una carpeta compartida, y el almacenamiento de los datos recopilados por la supervisión.La sección del archivo env_specific.yml tendrá el siguiente aspecto:
Para que Vantage funcione correctamente, recomendamos que el directorio raíz del servidor NFS (por ejemplo, /opt/nfs) tenga los siguientes permisos y el siguiente propietario:
A continuación se muestra un ejemplo de configuración de directorio en el archivo /etc/exports si se utiliza una máquina Linux como servidor NFS:
En caso de que necesites conectar otro tipo de almacenamiento, consulta la sección Definir tus propias clases de almacenamiento más abajo.

​
Definir tus propias clases de almacenamiento

Si quieres usar almacenamiento externo que no sea NFS, sigue estos pasos:
  1. Durante el proceso de instalación, después de crear el clúster de Kubernetes (paso 4 en Ejecutar los scripts de instalación), despliega los controladores CSI (Container Storage Interface) adecuados y crea clases de almacenamiento para ellos.
  2. Completa la sección k8s del archivo env_specific.yml con el siguiente código:
  1. Continúe con la instalación.
Si el almacenamiento persistente del volumen local se queda sin espacio, Vantage puede dejar de funcionar y provocar pérdida de datos. Supervise el espacio libre y configure alertas.

​
Clúster de Redis (solo para Azure AKS)

Un clúster de Redis es obligatorio solo para la configuración de alta disponibilidad de Azure AKS. No se requiere para implementaciones en máquinas virtuales ni para implementaciones de Azure sin alta disponibilidad.
Para implementaciones de Azure AKS de alta disponibilidad, se requiere un clúster de Redis externo con la siguiente configuración: Se deben establecer las siguientes opciones en redis.conf:
El valor de maxmemory debe configurarse con la mitad de la memoria disponible en cada nodo de Redis. Sustituya <password> por la contraseña de su clúster.
Actualmente, Azure Cache for Redis no es compatible. Debe implementar Redis en máquinas virtuales fuera del clúster de AKS. La compatibilidad con Azure Cache for Redis está prevista para una futura versión.