Zum Hauptinhalt springen
Vantage 3.0 ersetzt dieses Bereitstellungsmodell. Vantage 2.7 und frühere Versionen erforderten die von ABBYY vorgegebene Infrastruktur, die mithilfe von ABBYY bereitgestellten Ansible- und Azure-CLI-Skripten eingerichtet wurde. In 3.0 wird dieses Modell nicht unterstützt: Sie stellen Ihre eigene Infrastruktur bereit, und ABBYY stellt keine Provisionierungsskripte oder andere Automatisierung für die Infrastruktur bereit. Diese Seite gilt nur für Vantage 2.7. Siehe den Vantage 3.0 Überblick und Migration von Vantage 2.7.
Dieser Abschnitt beschreibt den Prozess zum Aktualisieren von ABBYY Vantage innerhalb der Release-Reihe 2.7.x. Der Wechsel zu 3.0 ist eine Migration und kein Update; siehe Migration von Vantage 2.7.
Stellen Sie vor dem Aktualisieren von Vantage sicher, dass alle im Abschnitt System Requirements aufgeführten Anforderungen der neuen Release erfüllt sind.
Der Aktualisierungsprozess umfasst die folgenden Schritte:
  1. Container-Images synchronisieren.
  2. Daten sichern.
  3. Installationsskripte ausführen.
  4. Vantage deinstallieren.
  5. ABBYY Vantage aktualisieren.

​
Container-Images synchronisieren

Um Container-Images zu synchronisieren, befolgen Sie die Schritte im Abschnitt Container-Images herunterladen.

​
Daten sichern

Um Vantage auf die zum Zeitpunkt des Updates ausgeführte Version wiederherzustellen, benötigen Sie ein Backup der Datenbanken, von Consul sowie Kopien der Kubernetes-Secrets. Führen Sie die folgenden Schritte aus, um diese Komponenten ordnungsgemäß zu sichern:
  1. Bevor Sie ein Backup der Datenbanken und von Consul erstellen, müssen Sie den cluster stoppen. Fahren Sie alle Knoten im cluster herunter.
  2. Erstellen Sie ein Backup von:
    • Datenbanken: Die Liste der Datenbanken lautet: apigatewayregistry, auth, auth-identity, catalogstorage, cron, documentset, folderimport, interactive-jobs, mail, mailimport, permissions, publicapi, reporting, secretstorage, security-audit, skillinfo, skillmonitor, storage, subscriptions, tokenmanagement, transactions, workflows, workspace.
    • Consul: Ein Kubernetes-CronJob sichert Consul in einem externen RWX-Speicher (z. B. NFS) in einem Pod mit dem Namen [X].consul-backup. Sie können die gesicherten TGZ-Dateien aus dem PVC-Ordner consul-backup abrufen.
  3. Starten Sie den cluster. Starten Sie alle Knoten im cluster.
  4. Sichern Sie Kopien der Kubernetes-Secrets. Führen Sie die folgenden Befehle aus, um die Schlüssel abzurufen:
Bevor Sie Sicherungskopien der Kubernetes-Secrets erstellen, stellen Sie sicher, dass der Cluster gestartet ist.
Backups werden nur vorsorglich erstellt. Bei einem erfolgreichen Upgrade ist keine Wiederherstellung aus dem Backup erforderlich.

​
Führen Sie die Installationsskripte aus

Bevor Sie ABBYY Vantage aktualisieren, führen Sie die Schritte unter Installation aus. So führen Sie die Installationsskripte aus:
  1. Richten Sie die Konfigurationsdateien ein.
Standardmäßig wird beim Aktualisieren von Vantage die Technology Core-Version 2 gelöscht. Damit sie erhalten bleibt, fügen Sie der Datei env_specific.yml den Parameter techcore.keep_previous_version hinzu und setzen seinen Wert auf true.
  1. Bereiten Sie die Zertifikate vor.
  2. Laden Sie die Container-Images herunter.
  3. Führen Sie die Installationsskripte aus (Schritte 1–3).

​
Vantage deinstallieren

Um das Produkt zu deinstallieren, führen Sie das folgende Playbook aus:
Dieses Playbook entfernt alle Services, ohne den Data Store zu beeinträchtigen.

​
ABBYY Vantage aktualisieren

So aktualisieren Sie ABBYY Vantage:
  1. Führen Sie die folgenden Playbooks aus, um eine Vorabprüfung vor der Bereitstellung durchzuführen und die rechtlichen Dokumente von Vantage zu lesen und zu akzeptieren:
Die Playbooks führen folgende Schritte aus:
  • Eine Vorabprüfung der Ressourcen durchführen, deren Parameter in der Datei env_specific.yml des playbook angegeben sind (Datenbank, SMTP-Verbindung usw.).
  • Den System Administrator auffordern, die Bedingungen der EULA und der ABBYY-Datenschutzrichtlinie zu akzeptieren.
  1. Führen Sie das folgende playbook aus, um Vantage zu aktualisieren:
Die Playbooks installieren eine neue Version des Produkts. Im Durchschnitt dauert der Vorgang etwa 20–30 Minuten.
Nachdem ABBYY Vantage aktualisiert wurde, müssen Sie die Autorisierung erneut durchführen. Vor dem Upgrade erhaltene Autorisierungs-Token funktionieren nicht mehr.
Um mit Advanced Designer und Scanning Station zu arbeiten, müssen Sie die neuen Versionen herunterladen und auf Ihren Rechnern installieren:
  • https://<your-vantage-host>/ad/latest - zum Herunterladen von Advanced Designer
  • https://<your-vantage-host>/ss/latest - zum Herunterladen von Scanning Station
Wenn der Aktualisierungsvorgang fehlschlägt, lesen Sie den folgenden Abschnitt „Wiederherstellung“.

​
Wiederherstellung

Wenn der Aktualisierungsvorgang nicht erfolgreich war, führen Sie die folgenden Schritte aus:
  1. Prüfen Sie, ob die Pods im Cluster einwandfrei funktionieren, und starten Sie sie neu, falls dies nicht der Fall ist.
  2. Analysieren Sie die Protokolle der Pods, die nicht wie vorgesehen funktionieren.
  3. Befolgen Sie die Schritte zur Fehlerbehebung in den Pod-Protokollen.
  4. Wenn das Upgrade bei einem beliebigen Schritt der Installation einer neuen Version von Vantage fehlschlägt (z. B. beim Warten auf Vantage-Jobs oder Vantage-Deployments), beheben Sie die Ursache des Fehlers und führen Sie dann das Installations-Playbook aus:

​
Installation von Vantage mit Datenwiederherstellung auf einem neuen Cluster

Wenn die oben beschriebenen Schritte nicht geholfen haben, können Sie Vantage mit Datenwiederherstellung auf einem neuen Cluster installieren, indem Sie die folgenden Schritte ausführen:
  1. Stellen Sie sicher, dass Ihnen alle aktuellen Backups Ihrer Daten vorliegen.
  2. Stellen Sie die Daten aus den zuvor erstellten Backups wieder her.
  3. Bereiten Sie die Datei env_specific mit den Verbindungsdaten für die aus Backups wiederhergestellten Datenbanken und den externen Speicher vor.
  4. Installieren Sie Vantage, indem Sie die Schritte unter Ausführen der Installationsskripte im Abschnitt Installation befolgen. Verwenden Sie für Schritt 2 (Ausführen des Installationsprogramms aus einem Docker-Image) den folgenden Befehl:
  1. Überschreiben Sie die Schlüsselwerte in den Kubernetes-Secrets secretstorage-encryptionkeys und tokenmanagement-encryptionkeys mit den Werten, die Sie zuvor gesichert haben: a. Führen Sie den Befehl aus:
    b. Ersetzen Sie in der Datei, die sich nach key-<guid>.xml öffnet, die Base64-Zeichenfolge durch die Base64-Zeichenfolge aus dem Schlüssel, den Sie zuvor für das Secret secretstorage-encryptionkeys gesichert haben. c. Speichern Sie Ihre Änderungen und schließen Sie den Editor. d. Wiederholen Sie dasselbe für das Secret tokenmanagement-encryptionkeys mit dem Befehl:
  2. Starten Sie nach dem Überschreiben der Schlüssel die Pods secretstorage und tokenmanagement neu:
  1. Starten Sie die Vorgänge neu. Führen Sie auf einem mit dem Cluster verbundenen Computer diesen Befehl aus, um auf den Vorgangs-Service zuzugreifen:
Rufen Sie in Ihrem Browser http://localhost:8080/index.html auf und führen Sie die folgende API-Methode aus:
Wenn sich die Host-Adresse von Vantage nach der Wiederherstellung geändert hat und im System noch nicht akzeptierte Einladungen vorhanden sind, müssen Sie diese Einladungen erneut versenden.