> ## 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.
# Mise à jour d’ABBYY Vantage
> Mettre à jour une installation auto-hébergée d’ABBYY Vantage vers une nouvelle version : synchroniser les images de conteneurs, sauvegarder les données, exécuter les scripts d’installation et restaurer si nécessaire.
**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](/fr/vantage/self-hosted/v3.0/introduction) et [Migrer depuis Vantage 2.7](/fr/vantage/self-hosted/v3.0/migration-from-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](/fr/vantage/self-hosted/v3.0/migration-from-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](/fr/vantage/self-hosted/v2.7/system-requirements), sont remplies.
Le processus de mise à jour comprend les étapes suivantes :
1. [Synchroniser les images de conteneurs](#synchronize-container-images).
2. [Sauvegarder les données](#back-up-data).
3. [Exécuter les scripts d’installation](#run-the-installation-scripts).
4. [Désinstaller Vantage](#uninstall-vantage).
5. [Mettre à jour ABBYY Vantage](#update-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](/fr/vantage/self-hosted/v2.7/installation#downloading-container-images).
## 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 :
```bash theme={null}
kubectl get secret -n abbyy-vantage secretstorage-encryptionkeys -o yaml
kubectl get secret -n abbyy-vantage tokenmanagement-encryptionkeys -o yaml
```
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](/fr/vantage/self-hosted/v2.7/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`.
2. Préparez les certificats.
3. Téléchargez les images de conteneurs.
4. Exécutez les scripts d’installation (étapes 1 à 3).
## Désinstaller Vantage
Exécutez le playbook suivant pour désinstaller le produit :
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/uninstall-vantage.yml
```
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 :
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
```
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.
2. Exécutez le playbook suivant pour mettre à jour Vantage :
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
```
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:///ad/latest` - pour télécharger Advanced Designer
* `https:///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 :
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
```
### 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](/fr/vantage/self-hosted/v2.7/installation#running-the-installation-scripts) de la page Installation. Pour l’étape 2 (exécution du programme d’installation à partir d’une image Docker), utilisez la commande ci-dessous :
```bash theme={null}
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
```
5. 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 :
```bash theme={null}
kubectl edit secrets -n abbyy-vantage secretstorage-encryptionkeys
```
b. Dans le fichier qui s’ouvre, après `key-.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 :
```bash theme={null}
kubectl edit secrets -n abbyy-vantage tokenmanagement-encryptionkeys
```
6. Après avoir remplacé les clés, redémarrez les pods `secretstorage` et `tokenmanagement` :
```bash theme={null}
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=secretstorage -o name)
```
```bash theme={null}
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
```
7. Redémarrez les transactions. Sur une machine connectée au cluster, exécutez cette commande pour accéder au service de transactions :
```bash theme={null}
kubectl port-forward -n abbyy-vantage deployments/abbyy-vantage-transactions 8080:8080
```
Dans votre navigateur, accédez à `http://localhost:8080/index.html` et exécutez la méthode API suivante :
```
/api/recovery/transactions/restart
```
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.