Passer au contenu principal

​
Liste de contrôle des prérequis

Préparez et configurez les composants externes suivants avant d’installer Vantage :
  • Une machine avec Docker et un accès à Internet (depuis laquelle Vantage est installé)
  • Des machines virtuelles (avec un accès à Internet pendant l’installation) devant servir de nœuds Kubernetes
  • Un registre de conteneurs pour stocker les images Docker
  • Des systèmes de gestion de bases de données relationnelles (SGBDR) pour le fonctionnement de Vantage
  • Un serveur SMTP pour envoyer des e-mails aux utilisateurs de Vantage
  • Un certificat TLS pour établir des communications chiffrées
  • 2 adresses IP statiques - une pour la configuration/gestion de Kubernetes, une pour l’accès à Vantage
  • Un enregistrement DNS pour l’accès à Vantage
  • Un stockage externe (facultatif pour la configuration sans haute disponibilité)

​
Prérequis de la machine d’installation

La machine depuis laquelle Vantage est installé doit disposer des éléments suivants :
  • Système d’exploitation Linux ou Windows Subsystem for Linux (WSL)
  • Docker version 19.03 ou ultérieure
  • Accès réseau à abyvtgonprm27.azurecr.io
  • Fichiers locaux contenant une clé SSH privée (sans phrase secrète) pour le compte d’utilisateur ansible
Toutes les machines virtuelles doivent utiliser la même clé SSH.

​
Exigences de l’infrastructure

Toutes les machines virtuelles peuvent fonctionner sur VMware ou Hyper-V et doivent disposer de :
  • Une adresse IP statique
  • Un compte d’utilisateur nommé ansible, avec :
    • Un accès via une clé SSH partagée
    • Un accès sudo avec l’option NOPASSWD
  • Un disque/lvm_volume dédié et extensible, monté sur /opt/local-path-provisioner sur chaque nœud worker
  • Un accès à Internet pendant l’installation vers le registre de conteneurs et les dépôts de paquets :
    • Un registre de conteneurs contenant les images synchronisées préparées comme prérequis pour l’installation de Vantage. Pour plus d’informations, consultez Downloading Container Images.
    • Dépôt de paquets : Ubuntu (archive.ubuntu.com), RHEL (cdn.redhat.com). Au lieu d’un accès aux dépôts de paquets, vous pouvez également configurer l’accès à votre propre dépôt, qui doit contenir tous les paquets requis listés ci-dessous.
Commun (toutes les distributions) :
Paquets spécifiques au système d’exploitation :

​
Accès réseau après l’installation

Après l’installation du cluster, les machines virtuelles doivent avoir accès à :
  • https://licensing-us.abbyy.com
  • Au serveur de messagerie, dont les paramètres SMTP sont spécifiés dans le fichier env_specific.yml (pour l’envoi d’invitations par e-mail, la récupération de mots de passe, etc.).
  • À tous les serveurs de messagerie depuis lesquels vous allez importer vos e-mails dans les Compétences de processus Vantage.

​
Configuration en haute disponibilité

Le nombre minimal requis de machines virtuelles est indiqué. Selon les performances attendues, un nombre différent de machines virtuelles peut être nécessaire.

​
Configuration sans haute disponibilité

La version 1.33.3 de Kubernetes sera installée lors de l’installation de Vantage.

​
Registre de conteneurs

Vous pouvez utiliser n’importe quel registre de conteneurs.

​
Exigences relatives à la base de données

Une base de données Microsoft SQL Server ou PostgreSQL avec la configuration suivante est requise :Option 1 : Microsoft SQL ServerOption 2 : PostgreSQLUn serveur de base de données externe doit être configuré, et vous devez disposer des identifiants nécessaires pour créer et gérer la nouvelle base de données.Le programme d’installation requiert l’adresse IP du serveur SQL, ainsi qu’un nom d’utilisateur et un mot de passe pour se connecter à la base de données.

​
SMTP Server

Le serveur doit fonctionner avec le protocole SMTP. Le programme d’installation nécessite l’adresse IP/le nom DNS, le port du serveur SMTP, ainsi qu’un mot de passe pour se connecter au serveur (si le serveur requiert une authentification). Le serveur SMTP doit être autorisé à envoyer des e-mails aux utilisateurs de Vantage. Configurez SMTP avec ou sans authentification dans env_specific.yml.
Nous recommandons d’utiliser l’option avec authentification (avec login et mot de passe).
Avec authentification (recommandé) Avec login et mot de passe. Dans ce cas, la section smtp du fichier env_specific.yml doit être définie comme suit :
Sans authentification Sans identifiant ni mot de passe. Dans ce cas, la section smtp du fichier env_specific.yml doit être définie comme suit :
N’oubliez pas d’ajouter le paramètre mailFrom à la racine.
Nous recommandons d’utiliser l’option avec authentification (avec login et mot de passe).

​
Certificat TLS

Vous aurez besoin d’un certificat générique ou d’un certificat spécifique à un domaine. Si votre installation Vantage doit se connecter à des services externes à l’aide de l’activité personnalisée ou exporter vers des systèmes externes, le certificat doit être délivré par une autorité de certification publique, par exemple https://letsencrypt.org/.

​
Adresses IP statiques

1. Accès à l’API Kubernetes. Une adresse IP statique sera utilisée comme adresse IP virtuelle pour accéder au point de terminaison du serveur d’API Kubernetes afin de configurer et de gérer le cluster. L’adresse IP doit être définie dans le fichier env_specific.yml comme suit. Pour plus d’informations, voir Configuration des fichiers :
2. Accès aux services Vantage. Une adresse IP statique sera utilisée pour accéder aux services Vantage via HTTPS. Un enregistrement DNS A approprié doit être créé au préalable. L’adresse IP doit être définie dans le fichier env_specific.yml comme suit. Pour plus d’informations, voir Installation :

​
Enregistrement DNS pour l’accès à Vantage

Aucune exigence particulière. Le programme d’installation nécessite un domaine principal et un nom DNS qui seront utilisés pour accéder à Vantage. L’enregistrement DNS doit pointer vers l’adresse IP dédiée à l’accès à Vantage.

​
Exigences de stockage

Le stockage externe est une exigence facultative uniquement pour la configuration sans haute disponibilité. Les exigences relatives à la taille des disques pour la configuration haute disponibilité sont décrites dans le Performance Guide.ABBYY Vantage déploie un stockage local sur les disques durs des machines virtuelles fournies, ce qui accélère l’installation du produit. Cependant, cette option peut toujours être affectée par des redémarrages inattendus et des pannes de machines virtuelles. Comme cela peut entraîner la perte des données stockées, il est recommandé d’utiliser un stockage externe lors de l’installation.ABBYY Vantage vous permet de définir l’utilisation de types de stockage spécifiques selon les modalités décrites ci-dessous.

​
Utilisation du stockage local

Dans ce cas, des volumes avec un accès ReadWriteOnce compatible POSIX seront provisionnés localement dans le répertoire /opt/local_path_provisioner sur chaque nœud Kubernetes. Pour les types de volumes ReadWriteMany, Vantage déploiera un serveur nfs-kernel-server dans le cluster sur le premier nœud abbyy_services (l’adresse IP de ce nœud est la première du bloc correspondant dans le fichier inventory). Les données du serveur NFS seront stockées dans le répertoire /opt/local_path_provisioner. Assurez-vous donc de disposer d’un volume/disque dédié pour ce chemin sur le premier nœud abbyy_services (le premier nœud de ce groupe est défini dans le fichier inventory), d’une capacité d’au moins 500 Go.Pour la configuration haute disponibilité, le premier nœud abbyy_services hébergera également le stockage local des volumes persistants. Cela nécessitera une capacité de disque dur supplémentaire en fonction de la charge de traitement. Pour plus de détails sur les capacités requises, consultez le Performance Guide.
Si le stockage local des volumes persistants arrive à saturation, Vantage peut cesser de fonctionner, avec perte possible de certaines données. Nous vous recommandons de surveiller l’espace libre de votre côté et de configurer des alertes en cas d’espace faible, afin de pouvoir ajouter du stockage à temps et d’éviter toute perte de données.

​
Utilisation d’un stockage NFS externe

Le programme d’installation de Vantage vous permet de configurer automatiquement un stockage NFS pour l’utiliser comme stockage Vantage pour certains services, comme l’importation et l’exportation vers un dossier partagé, ainsi que le stockage des données collectées par le monitoring.La section du fichier env_specific.yml se présentera comme suit :
Pour que Vantage fonctionne correctement, nous recommandons que le répertoire racine du serveur NFS (par exemple, /opt/nfs) dispose des autorisations et du propriétaire suivants :
Voici un exemple de configuration de répertoire dans le fichier /etc/exports lorsqu’une machine Linux est utilisée comme serveur NFS :
Si vous devez connecter un autre type de stockage, reportez-vous à la section Définir vos propres classes de stockage ci-dessous.

​
Définir vos propres classes de stockage

Si vous souhaitez utiliser un stockage externe autre que NFS, suivez les étapes ci-dessous :
  1. Pendant le processus d’installation, après avoir créé le cluster Kubernetes (étape 4 de Exécution des scripts d’installation), déployez les pilotes CSI (Container Storage Interface) appropriés et créez les classes de stockage correspondantes.
  2. Renseignez la section k8s dans le fichier env_specific.yml à l’aide du code suivant :
  1. Poursuivez l’installation.
Si le volume de stockage persistant local manque d’espace, Vantage peut cesser de fonctionner et entraîner une perte de données. Surveillez l’espace disponible et configurez des alertes.

​
Cluster Redis (Azure AKS uniquement)

Un cluster Redis est obligatoire uniquement pour une configuration Azure AKS en haute disponibilité. Il n’est pas requis pour les déploiements sur machine virtuelle ni pour les déploiements Azure sans haute disponibilité.
Pour les déploiements Azure AKS en haute disponibilité, un cluster Redis externe est requis avec la configuration suivante : Les options suivantes doivent être définies dans redis.conf :
La valeur maxmemory doit être définie à la moitié de la mémoire disponible sur chaque nœud Redis. Remplacez <password> par le mot de passe de votre cluster.
Azure Cache for Redis n’est actuellement pas pris en charge. Vous devez déployer Redis sur des machines virtuelles en dehors du cluster AKS. La prise en charge d’Azure Cache for Redis est prévue dans une prochaine version.