Zum Hauptinhalt springen

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.

In diesem Abschnitt wird der Prozess der Aktualisierung von ABBYY Vantage auf die neueste verfügbare Release-Version beschrieben.
Bevor Sie Vantage aktualisieren, stellen Sie sicher, dass alle Anforderungen der neuen Version erfüllt sind, die im Abschnitt Systemanforderungen aufgeführt sind.
Der Aktualisierungsprozess besteht aus den folgenden Schritten:
  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 Herunterladen von Container-Images.

​
Daten sichern

Um Vantage auf die Version zurückzusetzen, die zum Zeitpunkt des Updates ausgeführt wurde, müssen Sie über ein Backup der Datenbanken, von Consul sowie über Kopien der Kubernetes-Secrets verfügen. Befolgen Sie die folgenden Schritte, um diese Komponenten ordnungsgemäß zu sichern:
  1. Bevor Sie ein Backup der Datenbanken und von Consul erstellen, müssen Sie den Cluster anhalten. 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 podweise mit dem Namen [X].consul-backup auf einem externen RWX-Speicher (z. B. NFS). Sie können die gesicherten TGZ-Dateien aus dem PVC-Ordner mit dem Namen consul-backup abrufen.
  3. Starten Sie den Cluster. Starten Sie alle Knoten im Cluster.
  4. Sichern Sie Kopien der Kubernetes-Secrets. Führen Sie zum Abrufen der Schlüssel die folgenden Befehle aus:
kubectl get secret -n abbyy-vantage secretstorage-encryptionkeys -o yaml
kubectl get secret -n abbyy-vantage tokenmanagement-encryptionkeys -o yaml
Bevor Sie eine Sicherungskopie der Kubernetes-Secrets erstellen, stellen Sie sicher, dass der Cluster läuft.
Sicherungen werden vorsorglich erstellt. Wenn das Upgrade erfolgreich verläuft, müssen Sie keine Wiederherstellung aus der Sicherung durchführen.

​
Installationsskripte ausführen

Führen Sie vor dem Aktualisieren von ABBYY Vantage die Schritte unter Installation aus. So führen Sie die Installationsskripte aus:
  1. Konfigurationsdateien einrichten.
Standardmäßig wird beim Aktualisieren von ABBYY Vantage die Technology-Core-Version 2 entfernt. Um sie beizubehalten, fügen Sie den Parameter techcore.keep_previous_version zur Datei env_specific.yml hinzu und setzen Sie seinen Wert auf true.
  1. Zertifikate vorbereiten.
  2. Container-Images herunterladen.
  3. Installationsskripte ausführen (Schritte 1–3).

​
Vantage deinstallieren

Führen Sie das folgende Playbook aus, um das Produkt zu deinstallieren: 
ansible-playbook -i inventories/k8s -v playbooks/uninstall-vantage.yml
Dieses Playbook entfernt alle Dienste, belässt den Datenspeicher jedoch unverändert.

​
ABBYY Vantage aktualisieren

So aktualisieren Sie ABBYY Vantage:
  1. Führen Sie die folgenden Playbooks aus, um eine Vorabprüfung der Bereitstellung durchzuführen und die Rechtsdokumente von Vantage zu lesen und zu akzeptieren:
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
Die Playbooks werden:
  • Eine Vorabprüfung der Ressourcen durchführen, deren Parameter in der Datei env_specific.yml des Playbooks angegeben sind (Datenbank, SMTP-Verbindung usw.).
  • Den Systemadministrator auffordern, die Bedingungen der EULA und der ABBYY-Datenschutzerklärung zu akzeptieren.
  1. Führen Sie das folgende Playbook aus, um Vantage zu aktualisieren:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
Die Playbooks installieren eine neue Version des Produkts. Im Durchschnitt dauert der Vorgang etwa 20 bis 30 Minuten.
Nach der Aktualisierung von ABBYY Vantage müssen Sie sich erneut authentifizieren. Autorisierungstoken, die vor dem Upgrade erhalten wurden, funktionieren nicht mehr.
Um mit Advanced Designer und Scanning Station zu arbeiten, müssen Sie deren neue 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 „Recovery“.

​
Wiederherstellung

Wenn der Aktualisierungsvorgang nicht erfolgreich war, gehen Sie wie folgt vor:
  1. Prüfen Sie, ob die Pods im Cluster ordnungsgemäß laufen, und starten Sie sie bei Bedarf neu.
  2. Analysieren Sie die Protokolle der Pods, die nicht wie vorgesehen laufen.
  3. Befolgen Sie die Schritte zur Fehlerbehebung, die aus den Pod-Protokollen hervorgehen.
  4. Wenn das Upgrade in einem der Schritte zur Installation einer neuen Version von Vantage fehlschlägt (z. B. beim Warten auf Vantage-Jobs oder beim Warten auf Vantage-Deployments), beheben Sie die Ursache des Fehlers und führen Sie anschließend das Installations-Playbook aus:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml

​
Installieren 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 wie folgt vorgehen:
  1. Stellen Sie sicher, dass Sie alle aktuellen Backups Ihrer Daten haben.
  2. Stellen Sie die Daten aus den zuvor erstellten Backups wieder her.
  3. Bereiten Sie die Datei env_specific vor, die die Verbindungsdaten für die aus den Backups wiederhergestellten Datenbanken und den externen Speicher enthält.
  4. Installieren Sie Vantage gemäß den Schritten unter Running the installation scripts im Abschnitt „Installation“. Verwenden Sie für Schritt 2 (Ausführen des Installers aus einem Docker-Image) den folgenden Befehl:
docker run -it --net=host \
-v $PWD/kube:/root/.kube \
-v $PWD/inventory:/ansible/inventories/k8s/inventory \
-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
--privileged \
registry.local/vantage/vantage-k8s:2.7.1
  1. Überschreiben Sie die Schlüsselwerte in den Secrets secretstorage-encryptionkeys und tokenmanagement-encryptionkeys mit den Werten, die Sie zuvor gesichert haben: a. Führen Sie den folgenden Befehl aus: 
    kubectl edit secrets -n abbyy-vantage secretstorage-encryptionkeys
    b. Suchen Sie in der Datei, die sich öffnet, nach key-<guid>.xml, und ersetzen Sie dort die Base64-Zeichenfolge durch die Base64-Zeichenfolge, die in dem zuvor für das Secret secretstorage-encryptionkeys gesicherten Schlüssel enthalten ist. c. Speichern Sie Ihre Änderungen und schließen Sie den Editor. d. Wiederholen Sie dies für das Secret tokenmanagement-encryptionkeys mit dem folgenden Befehl: 
    kubectl edit secrets -n abbyy-vantage tokenmanagement-encryptionkeys
  2. Starten Sie nach dem Überschreiben der Schlüssel die Pods secretstorage und tokenmanagement neu: 
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=secretstorage -o name)

kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
  1. Starten Sie die Vorgänge neu. Führen Sie auf einem mit dem Cluster verbundenen Computer den folgenden Befehl aus, um auf den Transaction-Dienst zuzugreifen:
kubectl port-forward -n abbyy-vantage deployments/abbyy-vantage-transactions 8080:8080
Rufen Sie in Ihrem Browser http://localhost:8080/index.html auf und führen Sie die folgende API-Methode aus: 
/api/recovery/transactions/restart
Wenn sich die Vantage-Hostadresse nach der Wiederherstellung geändert hat und sich noch nicht angenommene Einladungen im System befinden, müssen Sie diese Einladungen erneut versenden.