Zum Hauptinhalt springen

​
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)

​
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.

​
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.
    • Paket-Repository: Ubuntu (archive.ubuntu.com), RHEL (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.04RHEL 8
python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2device-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.

​
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-KnotentypMaster-KnotenWorker-Knoten (Services)Worker-Knoten (Workers)
BetriebssystemUbuntu 20.04 oder RHEL 8Ubuntu 20.04 oder RHEL 8Ubuntu 20.04 oder RHEL 8
Anzahl der VMs341
CPU-Kerne (für jede VM)21212
RAM, GB (für jede VM)44848
Festspeicher für Kubernetes, GB (für jede VM)508080
Festplatte/Volume für Mount-Punkt /opt/local-path-provisioner, GBNicht erforderlichMindestens 40Mindestens 40
Netzwerkbandbreite, Gbit/s (für jede VM)111

​
Ohne Konfiguration für Hochverfügbarkeit

Kubernetes-KnotentypMaster-KnotenWorker-Knoten (Services)Worker-Knoten (Workers)
BetriebssystemUbuntu 20.04 oder RHEL 8Ubuntu 20.04 oder RHEL 8Ubuntu 20.04 oder RHEL 8
Anzahl der VMs111
CPU-Kerne (für jede VM)21212
RAM, GB (für jede VM)44848
Speicherplatz für Kubernetes, GB (für jede VM)508080
Datenträger/Volume für /opt/local-path-provisioner-Einhängepunkt, GBNicht erforderlichmindestens 40mindestens 40
Netzwerkbandbreite, Gbit/s (für jede VM)111
Kubernetes-Version 1.33.3 wird während der Vantage-Installation installiert.

​
Container Registry

Sie können eine beliebige Container Registry verwenden.

​
Datenbankanforderungen

Eine Microsoft SQL Server- oder PostgreSQL-Datenbank mit der folgenden Konfiguration ist erforderlich:Option 1: Microsoft SQL Server
VersionOSCPU-KerneRAM, GBFestplattenspeicher, GBVolltextsuche
Enterprise 2022Linux44Empfohlen: 400, Min.: 200Aktiviert
Option 2: PostgreSQL
VersionCPU-KerneRAM, GBFestplattenspeicher, GB
14+44Empfohlen: 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.

​
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: 
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: 
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/.

​
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“:
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:
loadbalancer:
  external_ip: X.X.X.X

​
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.
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:
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <IP-Adresse Ihres NFS-Servers>
          path: <exportierter Freigabepfad Ihres NFS-Servers>
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), 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:
k8s:
  storage:
    rwo:
      class_name: "<rwo posix compatible storage class>"
    rwx:
      class_name: "<read_write_many_storage_class>"
  1. 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.

​
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:
ConfigurationRequirement
Redis Version6.2 oder höher
Number of Nodes6 oder mehr
RAM per Node4 GB (mindestens)
Cluster ModeAktiviert
Cluster PasswordErforderlich
SSH Port22 (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 <password>
requirepass <password>
Der Wert maxmemory sollte auf die Hälfte des auf jedem Redis-Knoten verfügbaren Speichers festgelegt werden. Ersetzen Sie <password> 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.