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 cual 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 gestió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 configuraciones sin alta disponibilidad)

​
Requisitos de la máquina de instalación

La máquina desde la que se va a instalar Vantage requiere:
  • 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 frase de contraseña) para la cuenta de usuario ansible
Todas las máquinas virtuales deben tener la misma clave SSH.

​
Requisitos de la máquina virtual

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 o volumen LVM 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 Descarga de imágenes de contenedor.
    • Repositorio de paquetes: Ubuntu (archive.ubuntu.com), RHEL (cdn.redhat.com). En lugar de acceder a los repositorios de paquetes, también puede configurar acceso a su propio repositorio, que debe contener todos los paquetes requeridos que se enumeran a continuación.
Común a todas las distribuciones: 
curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar
Específico del sistema operativo: 
python3-apt, apt-transport-https, software-properties-common,
conntrack, libseccomp2

​
Acceso a la red después de la instalación

Después de la instalación del clúster, las máquinas virtuales necesitan acceso a:
  • https://licensing-us.abbyy.com
  • El servidor de correo, para el cual la 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 vaya a importar correos electrónicos en las Habilidades de proceso de Vantage. Estos deben ser los servidores de correo en los que estén registradas las direcciones de correo electrónico que se van a importar.

​
Configuración de alta disponibilidad

Se especifica el número mínimo requerido de máquinas virtuales. Distintos requisitos de rendimiento pueden requerir un número diferente de máquinas virtuales.
Tipo de nodo de KubernetesNodos maestrosNodos de trabajo (Servicios)Nodos de trabajo (Workers)
Sistema operativoUbuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8
Número de máquinas virtuales (VM)341
Núcleos de CPU (por cada VM)21212
RAM, GB (por cada VM)44848
Almacenamiento en disco para Kubernetes, GB (por cada VM)508080
Disco/volumen para el punto de montaje /opt/local-path-provisioner, GBNo se requiereMínimo 40Mínimo 40
Ancho de banda de red, Gbps (por cada VM)111

​
Sin configuración de alta disponibilidad

Tipo de nodo de KubernetesNodos maestrosNodos de trabajo (Servicios)Nodos de trabajo (Workers)
Sistema operativoUbuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8
Número de máquinas virtuales (VM)111
Núcleos de CPU (por cada VM)21212
RAM, GB (por cada VM)44848
Almacenamiento en disco para Kubernetes, GB (por cada VM)508080
Disco/volumen para el punto de montaje /opt/local-path-provisioner, GBNo es necesarioMínimo 40Mínimo 40
Ancho de banda de red, Gbps (por cada VM)111
La versión 1.28.4 de Kubernetes se instalará durante la instalación de Vantage.

​
Registro de contenedores

Puede utilizar cualquier registro de contenedores.

​
Requisitos de la base de datos

Se requiere una base de datos Microsoft SQL Server con la siguiente configuración:
VersiónSONúcleos de CPURAM, GBAlmacenamiento en disco, GBBúsqueda de texto completo
Enterprise 2022Linux44Recomendado: 400, mín.: 200Habilitada
Es necesario configurar un servidor de base de datos SQL externo y contar con las credenciales adecuadas para crear y administrar la nueva base de datos. El instalador requiere la dirección IP de SQL Server, así como un nombre de usuario y una contraseña para conectarse a la base de datos.

​
Servidor SMTP

El servidor debe funcionar mediante el protocolo SMTP. El instalador requiere la dirección IP/nombre DNS, el puerto del servidor SMTP y una 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 utilizar la opción con autenticación (con nombre de usuario y contraseña).
Con autenticación (recomendado) Con nombre de usuario y contraseña. En este caso, la sección smtp en el archivo env_specific.yml debe definirse de la siguiente manera: 
smtp:
  host: X.X.X.X
  login: email
  password: password
  port: 587
  useSSL: false
  secureSocketOptions: null
Sin autenticación Sin nombre de usuario ni contraseña. En este caso, la sección smtp en el archivo env_specific.yml debe definirse de la siguiente manera: 
mailFrom: email
smtp:
  host: X.X.X.X
  login: null
  password: null
  port: 25
  useSSL: false
  secureSocketOptions: None
No olvide agregar el Parameter mailFrom a la raíz.
Recomendamos utilizar la opción con autenticación (con usuario y contraseña).

​
Certificado TLS

Deberá contar con un certificado comodín o específico para un dominio. Si su instalación de Vantage va a conectarse a servicios externos mediante la actividad personalizada (Custom activity) o va a exportar a sistemas externos, el certificado debe estar 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 utilizará como dirección IP virtual para acceder al endpoint del servidor de la API de Kubernetes para configurar y gestionar 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 archivos de configuración: 
k8s:
  api:
    ip: X.X.X.X
2. Acceso a los servicios de Vantage. Una dirección IP estática que se utilizará para acceder a los servicios de Vantage mediante HTTPS. Debe crearse de antemano un registro A de DNS 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: 
loadbalancer:
  external_ip: X.X.X.X

​
Registro DNS para el acceso posterior a Vantage

Sin requisitos específicos. El instalador requiere un dominio principal y un nombre DNS que se utilizará para acceder a Vantage. El registro DNS debe apuntar a la dirección IP asignada para el acceso a Vantage.

​
Almacenamiento externo

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 con alta disponibilidad se describen en la Guía de rendimiento. ABBYY Vantage despliega 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 verse afectada por reinicios inesperados y fallos de las máquinas virtuales. Dado que esto puede provocar la pérdida de los datos almacenados, se recomienda utilizar almacenamiento externo durante la instalación. ABBYY Vantage le permite definir el uso de tipos de almacenamiento específicos de las formas que se indican a continuación.

​
Uso del almacenamiento local en los discos duros de las máquinas virtuales proporcionadas

En este caso, los volúmenes con acceso POSIX compatible ReadWriteOnce se aprovisionarán localmente en el directorio /opt/local_path_provisioner en cada nodo de Kubernetes. Para los tipos de volumen ReadWriteMany, Vantage desplegará un in-cluster nfs-kernel-server en el primer nodo abbyy_services (la IP de este nodo es la primera en el bloque correspondiente en el archivo inventory). Los datos del servidor NFS se almacenarán en el directorio /opt/local_path_provisioner, por lo que asegúrese de disponer de un volumen/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 de capacidad. Para una 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 según la carga de procesamiento. Para obtener detalles sobre la capacidad requerida, consulte la Guía de rendimiento.
Si el almacenamiento local de volúmenes persistentes se queda sin espacio, Vantage puede dejar de funcionar con pérdida de algunos datos. Le recomendamos que supervise el espacio libre por su parte y configure alertas cuando el espacio sea reducido, de modo 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 utilizarlo como almacenamiento de Vantage para determinados servicios, 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 en el archivo env_specific.yml tendrá el siguiente aspecto: 
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <dirección IP de su servidor NFS>
          path: <recurso compartido exportado de su servidor NFS>
Para que Vantage funcione correctamente, recomendamos que el directorio raíz del servidor NFS (por ejemplo, /opt/nfs) esté configurado con los siguientes permisos y propietario: 
drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/
A continuación se muestra un ejemplo de configuración de un directorio en el archivo /etc/exports cuando se utiliza una máquina Linux como servidor NFS: 
/opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532)
Si necesitas conectar otro tipo de almacenamiento, consulta la sección Defining your own storage classes a continuación.

​
Definir sus propias clases de almacenamiento

Si desea utilizar almacenamiento externo que no sea NFS, siga los pasos que se indican a continuación:
  1. Durante el proceso de instalación, después de crear el clúster de Kubernetes (paso 4 en Running the installation scripts), despliegue los controladores CSI (Container Storage Interface) correspondientes y cree clases de almacenamiento para ellos.
  2. Complete la sección k8s en el archivo env_specific.yml utilizando el siguiente código:
k8s:
  storage:
    rwo:
      class_name: "<rwo posix compatible storage class>"
    rwx:
      class_name: "<read_write_many_storage_class>"
  1. Continúe con la instalación.
Para el almacenamiento NFS, configure lo siguiente en env_specific.yml: 
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <your nfs server IP address>
          path: <your nfs server exported share>
Si el almacenamiento local de volúmenes persistentes se queda sin espacio, Vantage puede dejar de funcionar y provocar pérdida de datos. Supervise el espacio libre y configure alertas.