> ## Documentation Index > Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt > Use this file to discover all available pages before exploring further. # Exigences système > Exigences matérielles, logicielles et de réseau pour ABBYY Vantage auto-hébergé sur des machines virtuelles ou Azure AKS, y compris les prérequis pour le SGBDR, SMTP et le stockage.
## 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é) * Un abonnement Microsoft Azure avec les autorisations nécessaires pour créer et gérer des ressources * Azure CLI installé sur la machine d’installation * Une machine avec Docker et un accès à Internet (depuis laquelle Vantage est installé) * Un cluster Azure Kubernetes Service (AKS) avec des pools de nœuds adaptés * Un Azure Container Registry pour stocker les images Docker * Une base de données Azure SQL pour le fonctionnement de Vantage * Des comptes de stockage Azure pour les données de Vantage * Un serveur SMTP ou Azure SendGrid pour envoyer des e-mails aux utilisateurs de Vantage * Un certificat TLS pour établir des communications chiffrées * Une adresse IP publique Azure (Standard Static IPv4) pour l’accès à Vantage * Un enregistrement DNS pour l’accès à Vantage * Un cluster Redis (requis uniquement pour la configuration en 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. * Système d’exploitation Linux ou Windows Subsystem for Linux (WSL) * Docker version 19.03 ou ultérieure * Azure CLI installé et configuré * `kubectl` installé * Accès réseau à `abyvtgonprm27.azurecr.io`
## 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](/fr/vantage/self-hosted/v2.7/installation#downloading-container-images). * Dépôt de paquets : Ubuntu ([archive.ubuntu.com](http://archive.ubuntu.com)), RHEL ([cdn.redhat.com](http://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) :** ``` curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar ``` **Paquets spécifiques au système d’exploitation :** | Ubuntu 20.04 | RHEL 8 | | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------- | | python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2 | device-mapper-libs, nss, conntrack, container-selinux, libseccomp | ### 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. Exigences du cluster Azure Kubernetes Service (AKS) : * Version de Kubernetes : 1.33.3 * Région Azure prenant en charge les tailles de VM requises * Plug-in réseau : Azure CNI recommandé * Une adresse IP publique Azure (IPv4 statique standard) pour l’ingress ### Accès réseau après l’installation Après le déploiement du cluster, le cluster AKS doit avoir accès à : * `https://licensing-us.abbyy.com` * Au serveur de messagerie ou à Azure SendGrid 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. | Kubernetes Node Type | Nœuds maîtres | Nœuds de travail (Services) | Nœuds de travail (Workers) | | ------------------------------------------------------------------------ | ---------------------- | --------------------------- | -------------------------- | | Système d’exploitation | Ubuntu 20.04 ou RHEL 8 | Ubuntu 20.04 ou RHEL 8 | Ubuntu 20.04 ou RHEL 8 | | Nombre de VM | 3 | 4 | 1 | | Cœurs CPU (pour chaque VM) | 2 | 12 | 12 | | RAM, Go (pour chaque VM) | 4 | 48 | 48 | | Stockage disque pour Kubernetes, Go (pour chaque VM) | 50 | 80 | 80 | | Disque/volume pour le point de montage `/opt/local-path-provisioner`, Go | Non requis | Minimum 40 | Minimum 40 | | Bande passante réseau, Gbit/s (pour chaque VM) | 1 | 1 | 1 | Le nombre minimal requis de nœuds est indiqué. Selon les performances attendues, des nœuds supplémentaires peuvent être nécessaires. | Node Pool Configuration | pool de nœuds de services | pool de nœuds de workers | | ----------------------- | ------------------------- | ------------------------ | | Azure VM Size | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPU (par nœud) | 8 | 16 | | RAM, Go (par nœud) | 32 | 64 | | Nombre de nœuds | 4 | 1 | | Mode du pool de nœuds | User | User | | Taille du disque OS, Go | 128 | 128 | **Labels et Taints du pool de nœuds de workers** Le pool de nœuds de workers `Standard_D16as_v5` **doit** avoir les labels et taints suivants configurés : Labels: * `k8s.abbyy.com/techcore: "true"` * `k8s.abbyy.com/overprovision-label: workers` Taints: * `k8s.abbyy.com/techcore=true:NoSchedule`
## Configuration sans haute disponibilité
| Type de nœud Kubernetes | Nœuds maîtres | Nœuds de travail (services) | Nœuds de travail (workers) | | ------------------------------------------------------------------------ | ---------------------- | --------------------------- | -------------------------- | | Système d’exploitation | Ubuntu 20.04 ou RHEL 8 | Ubuntu 20.04 ou RHEL 8 | Ubuntu 20.04 ou RHEL 8 | | Nombre de VM | 1 | 1 | 1 | | Cœurs CPU (pour chaque VM) | 2 | 12 | 12 | | RAM, Go (pour chaque VM) | 4 | 48 | 48 | | Stockage disque pour Kubernetes, Go (pour chaque VM) | 50 | 80 | 80 | | Disque/volume pour le point de montage `/opt/local-path-provisioner`, Go | Non requis | 40 minimum | 40 minimum | | Bande passante réseau, Gbit/s (pour chaque VM) | 1 | 1 | 1 | La version 1.33.3 de Kubernetes sera installée lors de l’installation de Vantage. | Configuration du pool de nœuds | pool de nœuds de services | pool de nœuds de workers | | ---------------------------------------------- | ------------------------- | ------------------------ | | Taille de VM Azure | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPU (par nœud) | 8 | 16 | | RAM, Go (par nœud) | 32 | 64 | | Nombre de nœuds | 2 | 1 | | Mode du pool de nœuds | User | User | | Taille du disque du système d’exploitation, Go | 128 | 128 | **Labels et taints du pool de nœuds de workers** Le pool de nœuds de workers `Standard_D16as_v5` **doit** être configuré avec les labels et taints suivants : Labels: * `k8s.abbyy.com/techcore: "true"` * `k8s.abbyy.com/overprovision-label: workers` Taints: * `k8s.abbyy.com/techcore=true:NoSchedule` AKS gère le plan de contrôle Kubernetes. La version 1.33.3 de Kubernetes est requise.
## Registre de conteneurs
Vous pouvez utiliser n’importe quel registre de conteneurs. Azure Container Registry (ACR) est recommandé pour les déploiements Azure. Assurez-vous que le cluster AKS dispose des autorisations de tirage depuis le registre.
## 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 Server** | Version | OS | Cœurs CPU | RAM, Go | Stockage sur disque, Go | Recherche en texte intégral | | --------------- | ----- | --------- | ------- | ---------------------------- | --------------------------- | | Enterprise 2022 | Linux | 4 | 4 | Recommandé : 400, min. : 200 | Activée | **Option 2 : PostgreSQL** | Version | Cœurs CPU | RAM, Go | Stockage sur disque, Go | | ------- | --------- | ------- | ---------------------------- | | 14+ | 4 | 4 | Recommandé : 400, min. : 200 | Un 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. Une base de données Azure SQL avec un pool élastique est requise : | Configuration | Valeur | | ----------------- | ----------------------- | | Niveau de service | Usage général | | Niveau de calcul | Standard-series (Gen 5) | | vCores | 4 | | Stockage maximal | 100 Go | La base de données Azure SQL doit être accessible depuis le cluster AKS. Vous aurez besoin du nom d'hôte du serveur, du nom de la base de données et des identifiants (nom d'utilisateur et mot de passe) pour le programme d'installation de Vantage. Assurez-vous que les règles de pare-feu de la base de données Azure SQL autorisent les connexions depuis les adresses IP sortantes du cluster AKS.
## 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 : ```yaml theme={null} smtp: host: X.X.X.X login: email password: password port: 587 useSSL: false secureSocketOptions: null ``` **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 : ```yaml theme={null} mailFrom: email smtp: host: X.X.X.X login: null password: null port: 25 useSSL: false secureSocketOptions: None ``` 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/](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 : ```yaml theme={null} k8s: api: ip: X.X.X.X ``` **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](/fr/vantage/self-hosted/v2.7/installation) : ```yaml theme={null} loadbalancer: external_ip: X.X.X.X ``` Une adresse IP publique Azure (Standard Static IPv4) est requise pour accéder aux services Vantage via HTTPS. Cette adresse IP sera utilisée par le contrôleur d’ingress. Créez l’adresse IP publique dans la même région que votre cluster AKS. Un **enregistrement DNS A** approprié doit être créé pour pointer vers cette adresse IP.
## 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](/fr/vantage/self-hosted/v2.7/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 : ```yaml theme={null} k8s: storage: rwx: external: enabled: true type: "nfs" nfs: address: path: ``` 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 : ``` drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/ ``` Voici un exemple de configuration de répertoire dans le fichier `/etc/exports` lorsqu’une machine Linux est utilisée comme serveur NFS : ``` /opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532) ``` 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](/fr/vantage/self-hosted/v2.7/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 : ```yaml theme={null} k8s: storage: rwo: class_name: "" rwx: class_name: "" ``` 3. 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. Des comptes de stockage Azure sont requis pour le stockage des données de Vantage. Créez les comptes de stockage suivants dans la même région que votre cluster AKS : | Rôle du compte de stockage | Niveau de performance | Niveau d’accès | Taille minimale | | -------------------------- | --------------------- | -------------- | --------------- | | Skills | Premium | Hot | - | | Processing | Standard | Hot | - | | Temporaire | Standard | Hot | - | | Dossiers partagés | Premium FileStorage | - | 100 GB | | Archive | Standard | Cool | - | Tous les comptes de stockage doivent être accessibles depuis le cluster AKS. Configurez des points de terminaison privés ou des points de terminaison de service selon les exigences de sécurité de votre réseau. Le programme d’installation de Vantage configurera les classes de stockage Kubernetes appropriées pour utiliser ces comptes de stockage Azure.
## 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 : | Configuration | Exigence | | ----------------------- | ----------------------------- | | Version de Redis | 6.2 ou une version ultérieure | | Nombre de nœuds | 6 ou plus | | RAM par nœud | 4 GB (minimum) | | Mode cluster | Activé | | Mot de passe du cluster | Obligatoire | | Port SSH | 22 (pour la configuration) | Les options suivantes doivent être définies dans `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 requirepass ``` La valeur `maxmemory` doit être définie à la moitié de la mémoire disponible sur chaque nœud Redis. Remplacez `` 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. * [Création de l’infrastructure Azure](/fr/vantage/self-hosted/v2.7/azure-infrastructure) - Création pas à pas des ressources Azure à l’aide de modèles ARM * [Conformité à la norme FIPS](/fr/vantage/self-hosted/v2.7/fips-compliance) - Exigences de conformité à la norme FIPS 140-2 pour les déploiements gouvernementaux * [Installation](/fr/vantage/self-hosted/v2.7/installation) - Guide d’installation complet * [Guide des performances](/fr/vantage/self-hosted/v2.7/performance-guide) - Scalabilité et optimisation des performances