> ## 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. # Systemanforderungen > Hardware-, Software- und Netzwerk­anforderungen für ABBYY Vantage Private Cloud auf virtuellen Maschinen oder Azure AKS, einschließlich Voraussetzungen für RDBMS, SMTP und Speicher.
## Checkliste der Voraussetzungen
Bereiten und konfigurieren Sie die folgenden externen Komponenten, bevor Sie Vantage installieren: * Einen Rechner mit Docker und Internetzugang (von dem aus Vantage installiert wird) * Virtuelle Maschinen (mit Internetzugang während der Installation), die als Kubernetes-Knoten verwendet werden * Eine Container-Registry zum Speichern von Docker-Images * Relationale Datenbankmanagementsysteme (RDBMS) für den Betrieb von Vantage * Einen SMTP-Server zum Senden von E-Mail-Nachrichten an Vantage-Benutzer * Ein TLS-Zertifikat zum Aufbau verschlüsselter Verbindungen * 2 statische IP-Adressen – eine für die Kubernetes-Konfiguration/-Verwaltung, eine für den Zugriff auf Vantage * Einen DNS-Eintrag für den Zugriff auf Vantage * Externer Speicher (optional für die Konfiguration ohne Hochverfügbarkeit) * Ein Microsoft Azure-Abonnement mit Berechtigungen zum Erstellen und Verwalten von Ressourcen * Azure CLI ist auf dem Installationsrechner installiert * Einen Rechner mit Docker und Internetzugang (von dem aus Vantage installiert wird) * Einen Azure Kubernetes Service (AKS)-Cluster mit geeigneten Node-Pools * Eine Azure Container Registry zum Speichern von Docker-Images * Eine Azure SQL-Datenbank für den Betrieb von Vantage * Azure Storage Accounts für Vantage-Daten * Einen SMTP-Server oder Azure SendGrid zum Senden von E-Mail-Nachrichten an Vantage-Benutzer * Ein TLS-Zertifikat zum Aufbau verschlüsselter Verbindungen * Eine Azure Public IP-Adresse (Standard Static IPv4) für den Zugriff auf Vantage * Einen DNS-Eintrag für den Zugriff auf Vantage * Einen Redis-Cluster (nur für die Konfiguration mit hoher Verfügbarkeit erforderlich)
## Anforderungen an die Installationsmaschine
Der Rechner, von dem aus Vantage installiert wird, benötigt: * Linux-Betriebssystem oder Windows Subsystem for Linux (WSL) * Docker-Version 19.03 oder höher * Netzwerkzugriff auf `abyvtgonprm27.azurecr.io` * Lokale Dateien, die einen privaten SSH-Schlüssel (ohne Passphrase) für das `ansible`-Benutzerkonto enthalten Alle virtuellen Maschinen müssen denselben SSH-Schlüssel haben. * Linux-Betriebssystem oder Windows Subsystem for Linux (WSL) * Docker-Version 19.03 oder höher * Azure CLI installiert und konfiguriert * kubectl installiert * Netzwerkzugriff auf `abyvtgonprm27.azurecr.io`
## Infrastrukturanforderungen
Alle virtuellen Maschinen können unter VMware oder Hyper-V ausgeführt werden und müssen folgende Anforderungen erfüllen: * Eine statische IP-Adresse * Ein Benutzerkonto mit dem Namen `ansible` mit: * SSH-Schlüsselzugriff (Shared Key) * sudo-Zugriff mit der Option NOPASSWD * Einen dedizierten, erweiterbaren Datenträger bzw. ein dediziertes, erweiterbares lvm\_volume, das auf jedem Worker-Knoten unter `/opt/local-path-provisioner` eingehängt ist * Internetzugang während der Installation zur Container-Registry und zu den Paket-Repositories: * Container-Registry mit den synchronisierten Images, die als Voraussetzung für die Vantage-Installation vorbereitet wurden. Weitere Informationen finden Sie unter [Container-Images herunterladen](/de/vantage/private-cloud/installation#downloading-container-images). * Paket-Repository: Ubuntu ([archive.ubuntu.com](http://archive.ubuntu.com)), RHEL ([cdn.redhat.com](http://cdn.redhat.com)). Anstelle des Zugriffs auf die Paket-Repositories können Sie auch den Zugriff auf Ihr eigenes Repository konfigurieren, das alle unten aufgeführten erforderlichen Pakete enthalten sollte. **Gemeinsam (alle Distributionen):** ``` curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar ``` **Betriebssystemspezifische Pakete:** | Ubuntu 20.04 | RHEL 8 | | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------- | | python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2 | device-mapper-libs, nss, conntrack, container-selinux, libseccomp | ### Netzwerkzugriff nach der Installation Nach der Cluster-Installation benötigen die virtuellen Maschinen Zugriff auf: * `https://licensing-us.abbyy.com` * Den Mailserver, für den die SMTP-Einstellungen in der Datei `env_specific.yml` angegeben sind (zum Versenden von E-Mail-Einladungen, Zurücksetzen von Passwörtern usw.). * Alle Mailserver, aus denen Sie Ihre E-Mails in Vantage Process-Skills importieren möchten. Anforderungen an den Azure Kubernetes Service (AKS)-Cluster: * Kubernetes-Version: 1.33.3 * Azure-Region, die die erforderlichen VM-Größen unterstützt * Netzwerk-Plugin: Azure CNI empfohlen * Eine Azure Public IP-Adresse (Standard Static IPv4) für Ingress ### Netzwerkzugriff nach der Installation Nach der Bereitstellung des Clusters benötigt der AKS-Cluster Zugriff auf: * `https://licensing-us.abbyy.com` * Den Mailserver oder Azure SendGrid zum Versenden von E-Mail-Einladungen, Zurücksetzen von Passwörtern usw. * Alle Mailserver, aus denen Sie Ihre E-Mails in Vantage Process-Skills importieren möchten.
## Hochverfügbare Konfiguration
Die erforderliche Mindestanzahl virtueller Maschinen ist angegeben. Abhängig von der gewünschten Performance kann eine andere Anzahl virtueller Maschinen erforderlich sein. | Kubernetes-Knotentyp | Master-Knoten | Worker-Knoten (Services) | Worker-Knoten (Workers) | | ------------------------------------------------------------------- | ------------------------ | ------------------------ | ------------------------ | | Betriebssystem | Ubuntu 20.04 oder RHEL 8 | Ubuntu 20.04 oder RHEL 8 | Ubuntu 20.04 oder RHEL 8 | | Anzahl der VMs | 3 | 4 | 1 | | CPU-Kerne (für jede VM) | 2 | 12 | 12 | | RAM, GB (für jede VM) | 4 | 48 | 48 | | Festspeicher für Kubernetes, GB (für jede VM) | 50 | 80 | 80 | | Festplatte/Volume für Mount-Punkt `/opt/local-path-provisioner`, GB | Nicht erforderlich | Mindestens 40 | Mindestens 40 | | Netzwerkbandbreite, Gbit/s (für jede VM) | 1 | 1 | 1 | Die erforderliche Mindestanzahl von Knoten ist angegeben. Unterschiedliche Leistungsanforderungen können zusätzliche Knoten erfordern. | Node-Pool-Konfiguration | Service-Knotenpool | Worker-Knotenpool | | ----------------------- | ------------------ | ------------------- | | Azure-VM-Größe | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPUs (pro Knoten) | 8 | 16 | | RAM, GB (pro Knoten) | 32 | 64 | | Anzahl der Knoten | 4 | 1 | | Node-Pool-Modus | User | User | | OS-Datenträgergröße, GB | 128 | 128 | **Labels und Taints für den Worker-Knotenpool** Der Worker-Pool `Standard_D16as_v5` **muss** mit den folgenden Labels und Taints konfiguriert sein: Labels: * `k8s.abbyy.com/techcore: "true"` * `k8s.abbyy.com/overprovision-label: workers` Taints: * `k8s.abbyy.com/techcore=true:NoSchedule`
## Ohne Konfiguration für Hochverfügbarkeit
| Kubernetes-Knotentyp | Master-Knoten | Worker-Knoten (Services) | Worker-Knoten (Workers) | | ---------------------------------------------------------------------- | ------------------------ | ------------------------ | ------------------------ | | Betriebssystem | Ubuntu 20.04 oder RHEL 8 | Ubuntu 20.04 oder RHEL 8 | Ubuntu 20.04 oder RHEL 8 | | Anzahl der VMs | 1 | 1 | 1 | | CPU-Kerne (für jede VM) | 2 | 12 | 12 | | RAM, GB (für jede VM) | 4 | 48 | 48 | | Speicherplatz für Kubernetes, GB (für jede VM) | 50 | 80 | 80 | | Datenträger/Volume für `/opt/local-path-provisioner`-Einhängepunkt, GB | Nicht erforderlich | mindestens 40 | mindestens 40 | | Netzwerkbandbreite, Gbit/s (für jede VM) | 1 | 1 | 1 | Kubernetes-Version 1.33.3 wird während der Vantage-Installation installiert. | Konfiguration des Knotenpools | Services-Knotenpool | Worker-Knotenpool | | ----------------------------- | ------------------- | ------------------- | | Azure VM-Größe | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPUs (pro Knoten) | 8 | 16 | | RAM, GB (pro Knoten) | 32 | 64 | | Anzahl der Knoten | 2 | 1 | | Node-Pool-Modus | User | User | | OS-Datenträgergröße, GB | 128 | 128 | **Labels und Taints des Worker-Knotenpools** Der `Standard_D16as_v5`-Worker-Pool **muss** mit den folgenden Labels und Taints konfiguriert sein: Labels: * `k8s.abbyy.com/techcore: "true"` * `k8s.abbyy.com/overprovision-label: workers` Taints: * `k8s.abbyy.com/techcore=true:NoSchedule` AKS verwaltet die Kubernetes-Control-Plane. Kubernetes-Version 1.33.3 ist erforderlich.
## Container Registry
Sie können eine beliebige Container Registry verwenden. Azure Container Registry (ACR) wird für Azure-Bereitstellungen empfohlen. Stellen Sie sicher, dass der AKS-Cluster über Pull-Zugriff auf die Registry verfügt.
## Datenbankanforderungen
Eine Microsoft SQL Server- oder PostgreSQL-Datenbank mit der folgenden Konfiguration ist erforderlich: **Option 1: Microsoft SQL Server** | Version | OS | CPU-Kerne | RAM, GB | Festplattenspeicher, GB | Volltextsuche | | --------------- | ----- | --------- | ------- | ------------------------- | ------------- | | Enterprise 2022 | Linux | 4 | 4 | Empfohlen: 400, Min.: 200 | Aktiviert | **Option 2: PostgreSQL** | Version | CPU-Kerne | RAM, GB | Festplattenspeicher, GB | | ------- | --------- | ------- | ------------------------- | | 14+ | 4 | 4 | Empfohlen: 400, Min.: 200 | Ein externer Datenbankserver muss eingerichtet sein, und Sie müssen über die entsprechenden Zugangsdaten verfügen, um die neue Datenbank zu erstellen und zu verwalten. Das Installationsprogramm benötigt die IP-Adresse des SQL Servers sowie einen Benutzernamen und ein Passwort, um eine Verbindung zur Datenbank herzustellen. Eine Azure SQL-Datenbank mit einem elastischen Pool ist erforderlich: | Konfiguration | Wert | | -------------------------- | ----------------------- | | Service Tier | General Purpose | | Compute Tier | Standard-series (Gen 5) | | vCores | 4 | | Maximale Speicherkapazität | 100 GB | Die Azure SQL-Datenbank muss vom AKS-Cluster aus erreichbar sein. Sie benötigen den Server-Hostnamen, den Datenbanknamen und die Zugangsdaten (Benutzername und Passwort) für das Vantage-Installationsprogramm. Stellen Sie sicher, dass die Firewall-Regeln der Azure SQL-Datenbank Verbindungen von den ausgehenden IP-Adressen des AKS-Clusters zulassen.
## SMTP-Server
Der Server sollte über das SMTP-Protokoll betrieben werden. Das Installationsprogramm benötigt die IP-Adresse/den DNS-Namen, den Port des SMTP-Servers sowie ein Passwort für die Verbindung zum Server (falls der Server eine Authentifizierung erfordert). Der SMTP-Server muss berechtigt sein, E-Mails an Vantage-Benutzer zu senden. Konfigurieren Sie SMTP mit oder ohne Authentifizierung in `env_specific.yml`. Wir empfehlen die Variante mit Authentifizierung (**mit** Benutzername und Passwort). **Mit Authentifizierung (empfohlen)** **Mit** Benutzername und Passwort. In diesem Fall sollte der Abschnitt smtp in der Datei env\_specific.yml wie folgt definiert werden: ```yaml theme={null} smtp: host: X.X.X.X login: email password: password port: 587 useSSL: false secureSocketOptions: null ``` **Ohne Authentifizierung** **Ohne** Benutzername und Passwort. In diesem Fall sollte der Abschnitt smtp in der Datei env\_specific.yml wie folgt definiert werden: ```yaml theme={null} mailFrom: email smtp: host: X.X.X.X login: null password: null port: 25 useSSL: false secureSocketOptions: None ``` Vergessen Sie nicht, den **mailFrom**-Parameter im Root-Element hinzuzufügen. Wir empfehlen, die Option mit Authentifizierung (mit Benutzername und Passwort) zu verwenden.
## TLS-Zertifikat
Sie benötigen entweder ein Wildcard- oder ein domainspezifisches Zertifikat. Wenn Ihre Vantage-Installation externe Dienste über die „Custom“-Aktivität nutzt oder in externe Systeme exportiert, sollte das Zertifikat von einer öffentlichen Zertifizierungsstelle ausgestellt werden, zum Beispiel [https://letsencrypt.org/](https://letsencrypt.org/).
## Statische IP-Adressen
**1. Kubernetes-API-Zugriff.** Eine statische IP-Adresse, die als virtuelle IP-Adresse für den Zugriff auf den Kubernetes-API-Server-Endpunkt zur Konfiguration und Verwaltung des Clusters verwendet wird. Die IP-Adresse sollte in der Datei **env\_specific.yml** wie folgt definiert werden. Weitere Informationen finden Sie im Abschnitt „Einrichten von Konfigurationsdateien“: ```yaml theme={null} k8s: api: ip: X.X.X.X ``` **2. Zugriff auf Vantage-Services.** Eine statische IP-Adresse, die für den Zugriff auf Vantage-Services über HTTPS verwendet wird. Ein entsprechender **DNS-A-Record** muss vorab angelegt werden. Die IP-Adresse sollte in der Datei **env\_specific.yml** wie folgt definiert werden. Weitere Informationen finden Sie unter [Installation](/de/vantage/private-cloud/installation): ```yaml theme={null} loadbalancer: external_ip: X.X.X.X ``` Eine Azure Public IP-Adresse (Standard Static IPv4) ist für den Zugriff auf Vantage-Services über HTTPS erforderlich. Diese IP-Adresse wird vom Ingress-Controller verwendet. Erstellen Sie die öffentliche IP-Adresse in derselben Region wie Ihren AKS-Cluster. Ein entsprechender **DNS-A-Record** muss erstellt werden, der auf diese IP-Adresse zeigt.
## DNS-Eintrag für den Zugriff auf Vantage
Keine besonderen Anforderungen. Das Installationsprogramm benötigt eine primäre Domäne und einen DNS-Namen, über den auf Vantage zugegriffen wird. Der DNS-Eintrag muss auf die IP-Adresse verweisen, die für den Zugriff auf Vantage vorgesehen ist.
## Speicheranforderungen
Externer Speicher ist nur bei der Konfiguration **Ohne Hochverfügbarkeit** eine optionale Anforderung. Die Anforderungen an die Festplattengröße für die Konfiguration mit Hochverfügbarkeit sind im Performance Guide beschrieben. ABBYY Vantage setzt lokalen Speicher auf Festplatten der bereitgestellten virtuellen Maschinen ein, was die Installation des Produkts beschleunigt. Diese Option kann jedoch weiterhin von unerwarteten Neustarts und Abstürzen der virtuellen Maschinen betroffen sein. Da dies zu einem Verlust der gespeicherten Daten führen kann, wird bei der Installation die Verwendung eines externen Speichers empfohlen. ABBYY Vantage ermöglicht es Ihnen, wie nachfolgend beschrieben festzulegen, wie bestimmte Speichertypen verwendet werden. ### Verwendung von lokalem Speicher In diesem Fall werden Volumes mit ReadWriteOnce POSIX-kompatiblem Zugriff lokal im Verzeichnis **/opt/local\_path\_provisioner** auf jedem Kubernetes-Node bereitgestellt. Für ReadWriteMany-Volume-Typen stellt Vantage einen **in-cluster nfs-kernel-server** auf dem ersten **abbyy\_services**-Node bereit (die IP dieses Nodes ist die erste im entsprechenden Block in der **inventory**-Datei). Die Daten des NFS-Servers werden im Verzeichnis **/opt/local\_path\_provisioner** gespeichert. Stellen Sie daher sicher, dass Sie auf dem ersten abbyy\_services-Node (der erste Node dieser Gruppe wird in der inventory-Datei definiert) ein dediziertes Volume/eine dedizierte Festplatte für diesen Pfad mit einer Größe von mindestens 500 GB haben. Für die Konfiguration mit Hochverfügbarkeit hostet der erste abbyy\_services-Node außerdem lokalen Persistent-Volume-Speicher. Dafür wird zusätzliche Festplattenkapazität benötigt, abhängig von der Verarbeitungslast. Einzelheiten zu den erforderlichen Mengen finden Sie im [Performance Guide](/de/vantage/private-cloud/performance-guide). Wenn der lokale Persistent-Volume-Speicher keinen freien Speicherplatz mehr hat, kann Vantage den Betrieb einstellen und es kann zu Datenverlust kommen. Wir empfehlen, dass Sie den freien Speicherplatz überwachen und Warnungen einrichten, wenn der Speicher knapp wird, damit Sie rechtzeitig zusätzlichen Speicher hinzufügen und Datenverlust verhindern können. ### Verwendung von externem NFS-Speicher Der Vantage-Installer ermöglicht es, einen NFS-Speicher automatisch zu konfigurieren, der als Vantage-Speicher für bestimmte Dienste verwendet wird, z. B. für den Import und Export in einen freigegebenen Ordner sowie für das Speichern der durch das Monitoring erfassten Daten. Der Abschnitt in der Datei `env_specific.yml` sieht wie folgt aus: ```yaml theme={null} k8s: storage: rwx: external: enabled: true type: "nfs" nfs: address: path: ``` Damit Vantage korrekt funktioniert, empfehlen wir, dass das Root-Verzeichnis des NFS-Servers (zum Beispiel /opt/nfs) über die folgenden Berechtigungen und den folgenden Besitzer verfügt: ``` drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/ ``` Nachfolgend ein Beispiel für einen Verzeichniseintrag in der Datei `/etc/exports`, wenn ein Linux-Rechner als NFS-Server verwendet wird: ``` /opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532) ``` Wenn ein anderer Speichertyp angebunden werden soll, lesen Sie den Abschnitt **Defining your own storage classes** weiter unten. ### Eigene StorageClasses definieren Wenn Sie einen externen Speicher verwenden möchten, der nicht auf NFS basiert, führen Sie die folgenden Schritte aus: 1. Installieren Sie während des Installationsprozesses, nachdem der Kubernetes-Cluster erstellt wurde (Schritt 4 unter [Running the installation scripts](/de/vantage/private-cloud/installation)), die entsprechenden CSI- (Container Storage Interface-)Treiber und erstellen Sie dafür StorageClasses. 2. Füllen Sie den Abschnitt `k8s` in der Datei `env_specific.yml` mit dem folgenden Code aus: ```yaml theme={null} k8s: storage: rwo: class_name: "" rwx: class_name: "" ``` 3. Fahren Sie mit der Installation fort. Wenn der lokale Persistent-Volume-Speicher keinen freien Speicherplatz mehr hat, kann Vantage den Betrieb einstellen, was zu Datenverlust führen kann. Überwachen Sie den freien Speicherplatz und richten Sie Warnmeldungen ein. Azure Storage Accounts sind für die Speicherung von Vantage-Daten erforderlich. Erstellen Sie die folgenden Storage Accounts in derselben Region wie Ihren AKS-Cluster: | Zweck des Storage Accounts | Performance-Tier | Access Tier | Mindestgröße | | -------------------------- | ------------------- | ----------- | ------------ | | Skills | Premium | Hot | - | | Verarbeitung | Standard | Hot | - | | Temporär | Standard | Hot | - | | Freigegebene Ordner | Premium FileStorage | - | 100 GB | | Archiv | Standard | Cool | - | Alle Storage Accounts müssen vom AKS-Cluster aus erreichbar sein. Konfigurieren Sie nach Bedarf Private Endpoints oder Service Endpoints entsprechend Ihren Netzwerksicherheitsanforderungen. Der Vantage-Installer konfiguriert die entsprechenden Kubernetes StorageClasses, um diese Azure Storage Accounts zu verwenden.
## Redis-Cluster (nur Azure AKS)
Ein Redis-Cluster ist **nur für Azure AKS-Bereitstellungen mit hoher Verfügbarkeit (Highly Available) erforderlich**. Er ist nicht erforderlich für Virtual-Machine-Bereitstellungen oder Azure-Bereitstellungen ohne hohe Verfügbarkeit. Für Azure AKS-Bereitstellungen mit hoher Verfügbarkeit ist ein externer Redis-Cluster mit der folgenden Konfiguration erforderlich: | Configuration | Requirement | | ---------------- | -------------------------- | | Redis Version | 6.2 oder höher | | Number of Nodes | 6 oder mehr | | RAM per Node | 4 GB (mindestens) | | Cluster Mode | Aktiviert | | Cluster Password | Erforderlich | | SSH Port | 22 (für die Konfiguration) | Die folgenden Optionen müssen in `redis.conf` gesetzt werden: ``` 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 ``` Der Wert `maxmemory` sollte auf die Hälfte des auf jedem Redis-Knoten verfügbaren Speichers festgelegt werden. Ersetzen Sie `` durch Ihr Clusterkennwort. Azure Cache for Redis wird **derzeit nicht unterstützt**. Sie müssen Redis auf virtuellen Maschinen außerhalb des AKS-Clusters bereitstellen. Die Unterstützung für Azure Cache for Redis ist für ein zukünftiges Release geplant. * [Erstellen einer Azure-Infrastruktur](/de/vantage/private-cloud/azure-infrastructure) - Schrittweise Erstellung von Azure-Ressourcen mithilfe von ARM-Vorlagen * [FIPS-Konformität](/de/vantage/private-cloud/fips-compliance) - FIPS-140-2-Konformitätsanforderungen für behördliche Bereitstellungen * [Installation](/de/vantage/private-cloud/installation) - Umfassende Installationsanleitung * [Leistungsleitfaden](/de/vantage/private-cloud/performance-guide) - Skalierung und Leistungsoptimierung