Passer au contenu principal
Vantage 3.0 remplace ce modèle de déploiement. Vantage 2.7 et les versions antérieures nécessitaient l’infrastructure spécifiée par ABBYY, créée à l’aide des scripts Ansible et Azure CLI fournis par ABBYY. Ce modèle n’est pas pris en charge dans la version 3.0 : vous provisionnez votre propre infrastructure, et ABBYY ne fournit pas de scripts de provisionnement ni d’autre outil d’automatisation de l’infrastructure. Cette page s’applique uniquement à Vantage 2.7. Voir la Vue d’ensemble de Vantage 3.0 et Migrer depuis Vantage 2.7.
Cette section décrit le processus de mise à jour d’ABBYY Vantage dans la branche de versions 2.7.x. Le passage à la version 3.0 constitue une migration, et non une mise à jour ; voir Migrate from Vantage 2.7.
Avant de mettre à jour Vantage, assurez-vous que toutes les exigences de la nouvelle version, répertoriées dans la section Exigences système, sont remplies.
Le processus de mise à jour comprend les étapes suivantes :
  1. Synchroniser les images de conteneurs.
  2. Sauvegarder les données.
  3. Exécuter les scripts d’installation.
  4. Désinstaller Vantage.
  5. Mettre à jour ABBYY Vantage.

​
Synchroniser les images de conteneurs

Pour synchroniser les images de conteneurs, suivez les étapes indiquées dans Téléchargement des images de conteneurs.

​
Sauvegarder les données

Pour restaurer Vantage à la version qui s’exécutait au moment de la mise à jour, vous devez disposer d’une sauvegarde des bases de données, de Consul et de copies des secrets Kubernetes. Suivez les étapes ci-dessous pour sauvegarder correctement ces composants :
  1. Avant de créer une sauvegarde des bases de données et de Consul, vous devez arrêter le cluster. Arrêtez tous les nœuds du cluster.
  2. Créez une sauvegarde des éléments suivants :
    • Bases de données : la liste des bases de données est la suivante : 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 : le CronJob Kubernetes sauvegarde Consul sur un stockage RWX externe (tel que NFS) à l’aide du pod nommé [X].consul-backup. Vous pouvez récupérer les fichiers TGZ sauvegardés dans le dossier PVC nommé consul-backup.
  3. Démarrez le cluster. Démarrez tous les nœuds du cluster.
  4. Sauvegardez des copies des secrets Kubernetes. Pour obtenir les clés, exécutez les commandes suivantes :
Avant de créer une sauvegarde des copies des secrets Kubernetes, assurez-vous que le cluster est démarré.
Les sauvegardes sont effectuées par précaution. Si la mise à niveau réussit, vous n’aurez pas à procéder à une restauration à partir de cette sauvegarde.

​
Exécuter les scripts d’installation

Avant de mettre à jour ABBYY Vantage, suivez les étapes de Installation. Pour exécuter les scripts d’installation :
  1. Configurez les fichiers de configuration.
Par défaut, la version 2 de Technology Core est supprimée lors de la mise à jour de Vantage. Pour la conserver, ajoutez le paramètre techcore.keep_previous_version au fichier env_specific.yml et définissez sa valeur sur true.
  1. Préparez les certificats.
  2. Téléchargez les images de conteneurs.
  3. Exécutez les scripts d’installation (étapes 1 à 3).

​
Désinstaller Vantage

Exécutez le playbook suivant pour désinstaller le produit :
Ce playbook supprimera tous les services sans affecter le magasin de données.

​
Mettre à jour ABBYY Vantage

Pour mettre à jour ABBYY Vantage :
  1. Exécutez les playbooks suivants pour effectuer une vérification avant déploiement, puis lire et accepter les documents juridiques de Vantage :
Les playbooks vont :
  • Effectuer une vérification préliminaire des resources dont les paramètres sont spécifiés dans le fichier env_specific.yml du playbook (base de données, connexion SMTP, etc.).
  • Demander au System Administrator d’accepter les termes de l’EULA et de la Politique de confidentialité d’ABBYY.
  1. Exécutez le playbook suivant pour mettre à jour Vantage :
Les playbooks installeront une nouvelle version du produit. En moyenne, l’opération prendra environ 20 à 30 minutes.
Après la mise à jour d’ABBYY Vantage, vous devrez effectuer de nouveau l’autorisation. Les jetons d’autorisation obtenus avant la mise à niveau ne fonctionneront plus.
Pour utiliser Advanced Designer et Scanning Station, vous devez télécharger les nouvelles versions et les installer sur vos machines :
  • https://<your-vantage-host>/ad/latest - pour télécharger Advanced Designer
  • https://<your-vantage-host>/ss/latest - pour télécharger Scanning Station
Si le processus de mise à jour échoue, consultez la section suivante, Recovery.

​
Récupération

Si le processus de mise à niveau a échoué, suivez ces étapes :
  1. Vérifiez que les pods du cluster fonctionnent correctement et redémarrez-les si ce n’est pas le cas.
  2. Analysez les logs des pods qui ne fonctionnent pas comme prévu.
  3. Suivez les étapes de dépannage indiquées dans les logs des pods.
  4. Si la mise à niveau échoue à une étape de l’installation d’une nouvelle version de Vantage (par ex., en attente des tâches Vantage, en attente des déploiements Vantage), corrigez la cause de l’erreur, puis exécutez le playbook d’installation :

​
Installation de Vantage avec récupération des données sur un nouveau cluster

Si les étapes décrites ci-dessus n’ont pas permis de résoudre le problème, vous pouvez installer Vantage avec récupération des données sur un nouveau cluster en suivant les étapes ci-dessous :
  1. Assurez-vous de disposer de toutes les sauvegardes les plus récentes de vos données.
  2. Restaurez les données à partir des sauvegardes que vous avez créées précédemment.
  3. Préparez le fichier env_specific contenant les informations de connexion aux bases de données et au stockage externe restaurés à partir des sauvegardes.
  4. Installez Vantage en suivant les étapes décrites dans la section Exécution des scripts d’installation de la page Installation. Pour l’étape 2 (exécution du programme d’installation à partir d’une image Docker), utilisez la commande ci-dessous :
  1. Remplacez les valeurs de clé dans les secrets secretstorage-encryptionkeys et tokenmanagement-encryptionkeys par celles que vous avez sauvegardées précédemment : a. Exécutez la commande :
    b. Dans le fichier qui s’ouvre, après key-<guid>.xml, remplacez la chaîne en base64 par celle contenue dans la clé précédemment sauvegardée pour le secret secretstorage-encryptionkeys. c. Enregistrez vos modifications et fermez l’éditeur. d. Faites de même pour le secret tokenmanagement-encryptionkeys à l’aide de la commande :
  2. Après avoir remplacé les clés, redémarrez les pods secretstorage et tokenmanagement :
  1. Redémarrez les transactions. Sur une machine connectée au cluster, exécutez cette commande pour accéder au service de transactions :
Dans votre navigateur, accédez à http://localhost:8080/index.html et exécutez la méthode API suivante :
Si l’adresse de l’hôte Vantage a changé après la récupération et qu’il y a des invitations non acceptées dans le système, vous devez les renvoyer.