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 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 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
Paquetes específicos del sistema operativo:
Ubuntu 20.04RHEL 8
python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2device-mapper-libs, nss, conntrack, container-selinux, libseccomp

​
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 sus correos electrónicos en las Habilidades de proceso de Vantage.

​
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.33.3 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 de Microsoft SQL Server o PostgreSQL con la siguiente configuración:Opción 1: Microsoft SQL Server
VersiónSONúcleos de CPURAM, GBAlmacenamiento en disco, GBBúsqueda de texto completo
Enterprise 2022Linux44Recomendado: 400, mín.: 200Habilitada
Opción 2: PostgreSQL
VersiónNúcleos de CPURAM, GBAlmacenamiento en disco, GB
14+44Recomendado: 400, mín.: 200
Es necesario configurar un servidor de base de datos 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 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.

​
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 aú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 un almacenamiento externo durante la instalación.ABBYY Vantage le permite definir el uso de tipos de almacenamiento específicos de las siguientes maneras.

​
Uso de almacenamiento local

En este caso, los volúmenes con acceso ReadWriteOnce compatible con POSIX se aprovisionarán localmente en el directorio /opt/local_path_provisioner en cada nodo de Kubernetes. Para los tipos de volúmenes ReadWriteMany, Vantage implementará 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 debe asegurarse de que tiene 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 tamaño.Para la configuración de alta disponibilidad, el primer nodo abbyy_services también alojará el almacenamiento de volúmenes persistentes locales. Requerirá capacidad de disco duro adicional en función de la carga de procesamiento. Para obtener más información sobre la capacidad necesaria, consulta la Guía de rendimiento.
Si el almacenamiento de volúmenes persistentes locales se queda sin espacio, Vantage puede dejar de funcionar y perderse algunos datos. Le recomendamos que supervise el espacio libre de su lado y configure alertas cuando el espacio sea bajo, 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 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) adecuados y cree clases de almacenamiento para ellos.
  2. Rellene 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.
Si el almacenamiento de volumen persistente local se queda sin espacio, Vantage puede dejar de funcionar y provocar pérdida de datos. Supervise el espacio libre y configure alertas.

​
Redis Cluster (solo Azure AKS)

Un clúster de Redis es obligatorio solo para la configuración de alta disponibilidad (HA) de Azure AKS. No se requiere para implementaciones en máquinas virtuales ni para implementaciones de Azure sin HA.
Para implementaciones de alta disponibilidad de Azure AKS, se requiere un clúster externo de Redis con la siguiente configuración:
ConfiguraciónRequisito
Versión de Redis6.2 o posterior
Número de nodos6 o más
RAM por nodo4 GB (mínimo)
Modo de clústerHabilitado
Contraseña de clústerObligatoria
Puerto SSH22 (para configuración)
Se deben establecer las siguientes opciones en redis.conf: 
appendonly yes
cluster-config-file nodes-6379.conf
cluster-enabled yes
cluster-node-timeout 5000
cluster-require-full-coverage no
maxclients 10000
maxmemory 2048mb
maxmemory-policy noeviction
repl-backlog-size 256mb
repl-ping-slave-period 5
save ""
slave-serve-stale-data yes
stop-writes-on-bgsave-error no
supervised auto
masterauth <password>
requirepass <password>
El valor de maxmemory debe configurarse en la mitad de la memoria disponible en cada nodo de Redis. Reemplace <password> por la contraseña de su clúster.
Azure Cache for Redis no es compatible actualmente. Debe implementar Redis en máquinas virtuales fuera del clúster de AKS. Está previsto incorporar compatibilidad con Azure Cache for Redis en una versión futura.