> ## 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 Private Cloud 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.
Cette section décrit le processus de mise à jour d'ABBYY Vantage vers la dernière version disponible.
Avant de mettre à jour Vantage, assurez-vous que tous les prérequis de la nouvelle version répertoriés dans la section [System Requirements](/fr/vantage/private-cloud/system-requirements) sont remplis.
Le processus de mise à jour se compose des é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 la procédure décrite dans [Téléchargement des images de conteneurs](/fr/vantage/private-cloud/installation#downloading-container-images).
## Sauvegarder les données
Pour pouvoir restaurer Vantage dans l'état où il se trouvait 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. Effectuez 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) dans un pod nommé `[X].consul-backup`. Vous pouvez récupérer les fichiers TGZ sauvegardés depuis le répertoire PVC nommé `consul-backup`.
3. Démarrez le cluster. Démarrez tous les nœuds du cluster.
4. Sauvegardez les **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 sauvegarder les copies des secrets Kubernetes, assurez-vous que le cluster est démarré.
Les sauvegardes sont effectuées par mesure de précaution. En cas de mise à niveau réussie, vous n’aurez pas besoin de restaurer la sauvegarde.
## Exécuter les scripts d’installation
Avant de mettre à jour ABBYY Vantage, suivez les étapes de la section [Installation](/fr/vantage/private-cloud/installation).
Pour exécuter les scripts d’installation :
1. Configurez les fichiers de configuration.
Par défaut, la version 2 du noyau technologique 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 attribuez-lui la valeur `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 tout en conservant le stockage de données intact.
## Mettre à jour ABBYY Vantage
Pour mettre à jour ABBYY Vantage :
1. Exécutez les playbooks suivants pour effectuer une vérification de prédéploiement et pour lire et accepter les documents juridiques relatifs à 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 ressources dont les paramètres sont spécifiés dans le fichier `env_specific.yml` du playbook (base de données, connexion SMTP, etc.).
* Demander à l’administrateur système d’accepter les conditions du CLUF et la Politique de confidentialité 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, le processus prendra environ 20 à 30 minutes.
Après la mise à jour d'ABBYY Vantage, vous devrez vous authentifier de nouveau. Les jetons d'autorisation obtenus avant la mise à niveau ne fonctionneront plus.
Pour travailler avec Advanced Designer et Scanning Station, vous devez télécharger leurs 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, voir la section suivante : Récupération.
## Récupération
Si le processus de mise à jour a échoué, suivez les étapes suivantes :
1. Vérifiez que les pods du cluster fonctionnent correctement et redémarrez-les s’ils ne fonctionnent pas correctement.
2. Analysez les journaux des pods qui ne fonctionnent pas comme prévu.
3. Suivez les étapes de dépannage indiquées dans les journaux des pods.
4. Si la mise à niveau échoue à n’importe quelle étape de l’installation d’une nouvelle version de Vantage (par exemple, en attendant les tâches Vantage, en attendant les 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 ne suffisent pas, vous pouvez installer Vantage avec récupération des données sur un nouveau cluster en procédant comme suit :
1. Assurez-vous de disposer des 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 de la section Installation, à partir de [Running the installation scripts](/fr/vantage/private-cloud/installation#running-the-installation-scripts). 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 des clés dans les secrets `secretstorage-encryptionkeys` et `tokenmanagement-encryptionkeys` par les valeurs 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 base64 par la chaîne base64 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` en utilisant 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, ouvrez l’adresse `http://localhost:8080/index.html`, puis exécutez la méthode d’API suivante :
```
/api/recovery/transactions/restart
```
Si, après la restauration, l'adresse de l'hôte Vantage a changé et que le système contient des invitations en attente d'acceptation, vous devez les renvoyer.