> ## 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 Netzwerkanforderungen für die selbstgehostete Bereitstellung von ABBYY Vantage auf virtuellen Maschinen oder in Azure AKS, einschließlich der Voraussetzungen für RDBMS, SMTP und Speicher.
## Checkliste der Voraussetzungen
Bereiten Sie die folgenden externen Komponenten vor und konfigurieren Sie sie, bevor Sie Vantage installieren: * Ein 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 * Ein SMTP-Server zum Senden von E-Mail-Nachrichten an Vantage-Benutzer * Ein TLS-Zertifikat zum Aufbau verschlüsselter Kommunikation * 2 statische IP-Adressen – eine für die Kubernetes-Konfiguration/-Verwaltung, eine für den Zugriff auf Vantage * Ein DNS-Eintrag für den Zugriff auf Vantage * Externer Speicherplatz (optional für eine Konfiguration ohne Hochverfügbarkeit) * Ein Microsoft Azure-Abonnement mit Berechtigungen zum Erstellen und Verwalten von Ressourcen * Auf dem Installationsrechner installiertes Azure CLI * Ein Rechner mit Docker und Internetzugang (von dem aus Vantage installiert wird) * Ein Azure Kubernetes Service (AKS)-Cluster mit geeigneten Knotenpools * Eine Azure Container Registry zum Speichern von Docker-Images * Eine Azure SQL Database für den Betrieb von Vantage * Azure Storage Accounts für Vantage-Daten * Ein SMTP-Server oder Azure SendGrid zum Senden von E-Mail-Nachrichten an Vantage-Benutzer * Ein TLS-Zertifikat zum Aufbau verschlüsselter Kommunikation * Eine öffentliche IP-Adresse in Azure (Standard Static IPv4) für den Zugriff auf Vantage * Ein DNS-Eintrag für den Zugriff auf Vantage * Ein Redis-Cluster (nur für eine hochverfügbare Konfiguration erforderlich)
## Anforderungen an den Installationscomputer
Der Computer, von dem aus Vantage installiert wird, muss Folgendes erfüllen: * Linux OS oder Windows-Subsystem für Linux (WSL) * Docker-Version 19.03 oder höher * Netzwerkzugriff auf `abyvtgonprm27.azurecr.io` * Lokale Dateien mit einem privaten SSH-Schlüssel (ohne Passphrase) für das Benutzerkonto `ansible` Alle virtuellen Maschinen müssen denselben SSH-Schlüssel verwenden. * Linux OS oder Windows-Subsystem für 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 in VMware oder Hyper-V ausgeführt werden und müssen über Folgendes verfügen: * Eine statische IP-Adresse * Ein Benutzerkonto mit dem Namen `ansible` mit: * Zugriff per gemeinsam genutztem SSH-Schlüssel * `sudo`-Zugriff mit der Option NOPASSWD * Eine dedizierte erweiterbare Festplatte bzw. ein dediziertes erweiterbares lvm\_volume, die bzw. das auf jedem Worker-Knoten unter `/opt/local-path-provisioner` eingehängt ist * Internetzugang während der Installation zur Container-Registry und zu Paket-Repositories: * Container-Registry mit den synchronisierten Container-Images, die als Voraussetzung für die Vantage-Installation vorbereitet wurden. Weitere Informationen finden Sie unter [Herunterladen von Container-Images](/de/vantage/self-hosted/v2.7/installation#downloading-container-images). * Paket-Repository: Ubuntu ([archive.ubuntu.com](http://archive.ubuntu.com)), RHEL ([cdn.redhat.com](http://cdn.redhat.com)). Statt 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. **Allgemein (alle Distributionen):** ``` curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar ``` **OS-spezifische 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 Installation des Clusters 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 Senden von E-Mail-Einladungen, Wiederherstellen von Kennwörtern usw.). * Alle Mailserver, von denen Sie E-Mails in Vantage Process-Skills importieren werden. 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 Senden von E-Mail-Einladungen, Wiederherstellen von Kennwörtern usw. * Alle Mailserver, von denen Sie E-Mails in Vantage Process-Skills importieren werden.
## Hochverfügbare Konfiguration
Angegeben ist die mindestens erforderliche Anzahl virtueller Maschinen. Je nach Leistungsanforderungen 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 | | Festplattenspeicher für Kubernetes, GB (für jede VM) | 50 | 80 | 80 | | Festplatte/Volume für den Mount-Punkt `/opt/local-path-provisioner`, GB | Nicht erforderlich | Mindestens 40 | Mindestens 40 | | Netzwerkbandbreite, Gbit/s (für jede VM) | 1 | 1 | 1 | Angegeben ist die mindestens erforderliche Anzahl von Knoten. Je nach Leistungsanforderungen können zusätzliche Knoten erforderlich sein. | Knotenpool-Konfiguration | Services-Knotenpool | Workers-Knotenpool | | ------------------------ | ------------------- | ------------------- | | Azure VM Size | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPUs (pro Knoten) | 8 | 16 | | RAM, GB (pro Knoten) | 32 | 64 | | Anzahl der Knoten | 4 | 1 | | Knotenpool-Modus | User | User | | OS-Festplattengröße, GB | 128 | 128 | **Labels und Taints für den Workers-Knotenpool** Für den Workers-Pool `Standard_D16as_v5` **müssen** die 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`
## Konfiguration ohne 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 (pro VM) | 2 | 12 | 12 | | RAM, GB (pro VM) | 4 | 48 | 48 | | Festplattenspeicher für Kubernetes, GB (pro VM) | 50 | 80 | 80 | | Festplatte/Volume für den Mount-Punkt `/opt/local-path-provisioner`, GB | Nicht erforderlich | Mindestens 40 | Mindestens 40 | | Netzwerkbandbreite, Gbit/s (pro VM) | 1 | 1 | 1 | Kubernetes-Version 1.33.3 wird bei der Installation von Vantage installiert. | Knotenpool-Konfiguration | Knotenpool | Knotenpool | | ------------------------ | ------------------ | ------------------- | | Azure VM Size | Standard\_D8as\_v5 | Standard\_D16as\_v5 | | vCPUs (pro Knoten) | 8 | 16 | | RAM, GB (pro Knoten) | 32 | 64 | | Anzahl der Knoten | 2 | 1 | | Knotenpool-Modus | User | User | | OS-Festplattengröße, GB | 128 | 128 | **Labels und Taints für den Knotenpool** Für den `Standard_D16as_v5`-Workers-Pool **müssen** die 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. Für Azure-Bereitstellungen wird Azure Container Registry (ACR) 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 Anmeldedaten 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 Kennwort, um eine Verbindung mit der Datenbank herzustellen. Eine Azure SQL Database mit elastischem Pool ist erforderlich: | Konfiguration | Wert | | ------------------ | ----------------------- | | Dienstebene | General Purpose | | Computeebene | Standard-series (Gen 5) | | vCores | 4 | | Maximaler Speicher | 100 GB | Die Azure SQL Database muss vom AKS-Cluster aus erreichbar sein. Für das Vantage-Installationsprogramm benötigen Sie den Hostnamen des Servers, den Datenbanknamen und die Anmeldedaten (Benutzername und Kennwort). Stellen Sie sicher, dass die Firewallregeln der Azure SQL Database Verbindungen von den ausgehenden IP-Adressen des AKS-Clusters zulassen.
## SMTP-Server
Der Server sollte das SMTP-Protokoll verwenden. Das Installationsprogramm benötigt die IP-Adresse/den DNS-Namen und den Port des SMTP-Servers sowie ein Kennwort für die Verbindung zum Server (falls der Server eine Authentifizierung erfordert). Der SMTP-Server muss E-Mails an Vantage-Benutzer senden können. Konfigurieren Sie SMTP mit oder ohne Authentifizierung in `env_specific.yml`. Wir empfehlen, die Option mit Authentifizierung zu verwenden (**mit** Login und Kennwort). **Mit Authentifizierung (empfohlen)** **Mit** Login und Kennwort. In diesem Fall sollte der smtp-Abschnitt 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** Login und Kennwort. In diesem Fall sollte der smtp-Abschnitt in der Datei env\_specific.yml folgendermaßen 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 Parameter **mailFrom** zum Wurzelelement hinzuzufügen. Wir empfehlen, die Option mit Authentifizierung zu verwenden (mit Login und Kennwort).
## TLS-Zertifikat
Sie benötigen entweder ein Wildcard-Zertifikat oder ein domänenspezifisches Zertifikat. Wenn Ihre Vantage-Installation über die Benutzerdefinierte Aktivität Verbindungen zu externen Services herstellt oder in externe Systeme exportiert, sollte das Zertifikat von einer öffentlichen Zertifizierungsstelle ausgestellt sein, zum Beispiel [https://letsencrypt.org/](https://letsencrypt.org/).
## Statische IP-Adressen
**1. Zugriff auf die Kubernetes-API.** Eine statische IP-Adresse, die als virtuelle IP-Adresse für den Zugriff auf den Endpunkt des Kubernetes-API-Servers verwendet wird, um den Cluster zu konfigurieren und zu verwalten. Die IP-Adresse sollte in der Datei **env\_specific.yml** wie folgt definiert werden. Weitere Informationen finden Sie unter 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-Eintrag** muss vorab erstellt werden. Die IP-Adresse sollte in der Datei **env\_specific.yml** wie folgt definiert werden. Weitere Informationen finden Sie unter [Installation](/de/vantage/self-hosted/v2.7/installation): ```yaml theme={null} loadbalancer: external_ip: X.X.X.X ``` Für den Zugriff auf Vantage-Services über HTTPS ist eine öffentliche Azure-IP-Adresse (Standard Static IPv4) erforderlich. Diese IP-Adresse wird vom Ingress-Controller verwendet. Erstellen Sie die öffentliche IP-Adresse in derselben Region wie Ihr AKS-Cluster. Ein entsprechender **DNS-A-Eintrag** muss erstellt werden, der auf diese IP-Adresse verweist.
## DNS-Eintrag für den Zugriff auf Vantage
Keine besonderen Anforderungen. Das Installationsprogramm erfordert eine primäre Domain und einen DNS-Namen, über den auf Vantage zugegriffen wird. Der DNS-Eintrag muss auf die für den Zugriff auf Vantage vorgesehene IP-Adresse verweisen.
## Speicheranforderungen
Externer Speicher ist nur für die Konfiguration **Without high availability** optional erforderlich. Die Anforderungen an die Festplattengröße für eine hochverfügbare Konfiguration sind im Performance-Leitfaden beschrieben. ABBYY Vantage verwendet lokalen Speicher auf den Festplatten der bereitgestellten virtuellen Maschinen, was die Installation des Produkts beschleunigt. Diese Option kann jedoch weiterhin durch unerwartete Neustarts und Ausfälle virtueller Maschinen beeinträchtigt werden. Da dies zum Verlust der gespeicherten Daten führen kann, wird bei der Installation die Verwendung eines externen Speichers empfohlen. ABBYY Vantage ermöglicht Ihnen, die Verwendung bestimmter Speichertypen auf die unten beschriebenen Arten festzulegen. ### Verwendung von lokalem Speicher In diesem Fall werden Volumes mit POSIX-kompatiblem ReadWriteOnce-Zugriff lokal im Verzeichnis **/opt/local\_path\_provisioner** auf jedem Kubernetes-Knoten bereitgestellt. Für ReadWriteMany-Volume-Typen stellt Vantage auf dem ersten **abbyy\_services**-Knoten (die IP dieses Knotens ist die erste im entsprechenden Block der **inventory**-Datei) einen **in-cluster nfs-kernel-server** bereit. Die Daten des NFS-Servers werden im Verzeichnis **/opt/local\_path\_provisioner** gespeichert. Stellen Sie daher sicher, dass Sie auf dem ersten **abbyy\_services**-Knoten (der erste Knoten dieser Gruppe ist in der **inventory**-Datei definiert) ein dediziertes Volume bzw. eine dedizierte Festplatte für diesen Pfad mit einer Größe von mindestens 500 GB haben. Bei einer hochverfügbaren Konfiguration hostet der erste **abbyy\_services**-Knoten außerdem lokalen persistenten Volume-Speicher. Dafür ist abhängig von der Verarbeitungslast zusätzliche Festplattenkapazität erforderlich. Einzelheiten zu den erforderlichen Größen finden Sie im [Performance-Leitfaden](/de/vantage/self-hosted/v2.7/performance-guide). Wenn dem lokalen persistenten Volume-Speicher der Platz ausgeht, funktioniert Vantage möglicherweise nicht mehr, und es können Daten verloren gehen. Wir empfehlen, den freien Speicherplatz zu überwachen und Warnmeldungen bei knappem Speicherplatz einzurichten, damit Sie rechtzeitig zusätzlichen Speicher bereitstellen und Datenverlust verhindern können. ### Verwendung von externem NFS-Speicher Mit dem Vantage-Installationsprogramm können Sie einen NFS-Speicher automatisch so konfigurieren, dass er für bestimmte Service als Vantage-Speicher verwendet wird, z. B. für den Import und Export in einen freigegebenen Ordner sowie zum Speichern der von der Überwachung 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 ordnungsgemäß funktioniert, empfehlen wir, dem Root-Verzeichnis des NFS-Servers (zum Beispiel /opt/nfs) die folgenden Berechtigungen zuzuweisen und den folgenden Eigentümer festzulegen: ``` drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/ ``` Nachfolgend finden Sie ein Beispiel für eine Verzeichniseinstellung 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) ``` Falls ein anderer Speichertyp angebunden werden soll, siehe den Abschnitt **Eigene Speicherklassen definieren** weiter unten. ### Eigene Speicherklassen definieren Wenn Sie externen Speicher verwenden möchten, der nicht auf NFS basiert, gehen Sie wie folgt vor: 1. Stellen Sie während des Installationsprozesses nach dem Erstellen des Kubernetes-Clusters (Schritt 4 in [Ausführen der Installationsskripte](/de/vantage/self-hosted/v2.7/installation)) die entsprechenden CSI-Treiber (Container Storage Interface) bereit und erstellen Sie die zugehörigen Speicherklassen. 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 persistente Volumenspeicher voll läuft, funktioniert Vantage möglicherweise nicht mehr und es kann zu Datenverlust kommen. Überwachen Sie den freien Speicherplatz und richten Sie Warnmeldungen ein. Für den Speicherort von Vantage sind Azure-Speicherkonten erforderlich. Erstellen Sie die folgenden Speicherkonten in derselben Region wie Ihr AKS-Cluster: | Zweck des Speicherkontos | Leistungsstufe | Zugriffsebene | Mindestgröße | | ------------------------ | ------------------- | ------------- | ------------ | | Skills | Premium | Hot | - | | Processing | Standard | Hot | - | | Temporär | Standard | Hot | - | | Freigegebene Ordner | Premium FileStorage | - | 100 GB | | Archiv | Standard | Cool | - | Alle Speicherkonten müssen vom AKS-Cluster aus erreichbar sein. Konfigurieren Sie je nach Ihren Netzwerksicherheitsanforderungen private Endpunkte oder Serviceendpunkte. Das Vantage-Installationsprogramm konfiguriert die passenden Kubernetes-Speicherklassen für diese Azure-Speicherkonten.
## Redis-Cluster (nur für Azure AKS)
Ein Redis-Cluster ist **nur für eine hochverfügbare Azure-AKS-Konfiguration erforderlich**. Für Bereitstellungen auf virtuellen Maschinen oder nicht hochverfügbare Azure-Bereitstellungen ist er nicht erforderlich. Für hochverfügbare Azure-AKS-Bereitstellungen ist ein externer Redis-Cluster mit der folgenden Konfiguration erforderlich: | Konfiguration | Anforderung | | ----------------- | -------------------------- | | Redis-Version | 6.2 oder höher | | Anzahl der Knoten | 6 oder mehr | | RAM pro Knoten | 4 GB (mindestens) | | Clustermodus | aktiviert | | Cluster-Kennwort | erforderlich | | SSH-Port | 22 (für die Konfiguration) | Die folgenden Optionen müssen in `redis.conf` festgelegt 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 `maxmemory`-Wert sollte auf die Hälfte des auf jedem Redis-Knoten verfügbaren Speichers festgelegt werden. Ersetzen Sie `` durch Ihr Cluster-Kennwort. 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 eine zukünftige Release geplant. * [Erstellen der Azure-Infrastruktur](/de/vantage/self-hosted/v2.7/azure-infrastructure) - Schrittweise Erstellung von Azure-Ressourcen mit ARM-Vorlagen * [FIPS-Konformität](/de/vantage/self-hosted/v2.7/fips-compliance) - Anforderungen an die FIPS-140-2-Konformität für Bereitstellungen im Behördenumfeld * [Installation](/de/vantage/self-hosted/v2.7/installation) - Vollständige Installationsanleitung * [Performance-Leitfaden](/de/vantage/self-hosted/v2.7/performance-guide) - Skalierung und Performance-Tuning