Restaurer une sauvegarde

Vous pouvez restaurer une organisation ArcGIS Enterprise on Kubernetes à partir d’une sauvegarde avec ArcGIS Enterprise Manager. Toutes les données de configuration, les paramètres, les services et les objets d’infrastructure sont restaurés. Les services qui font référence à des données situées dans des data stores inscrits sont recréés.

Le mode de restauration d’une sauvegarde dépend du type d’échec et de l’accessibilité de l’organisation.

Restaurer une sauvegarde lorsque l’organisation d’origine est accessible

Si l’organisation a subi un endommagement ou une perte de données mais qu’elle reste accessible, vous pouvez restaurer une sauvegarde sans annuler son déploiement ni la redéployer. L’organisation d’origine conserve un enregistrement de toutes les sauvegardes, et vous pouvez procéder à la restauration à partir de l’une d’entre elles à l’aide de ArcGIS Enterprise Manager.

Pour restaurer une sauvegarde lorsque l’organisation d’origine est accessible, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur de votre organisation.
  2. Cliquez sur le bouton Backups (Sauvegardes).
  3. Dans la page des sauvegardes, déterminez celle que vous souhaitez restaurer et cliquez sur le bouton des options.
  4. Cliquez sur Restore (Restaurer).
  5. Indiquez la phrase secrète de chiffrement qui a été utilisée pour créer la sauvegarde.
  6. Cliquez sur Restore (Restaurer).

Au début de l’opération de restauration, une tâche est créée pour gérer l’opération ; la page de restauration affiche la progression de l’opération. L’organisation est restaurée au moment précis où la sauvegarde a été créée ; l’organisation reste inaccessible tant que la restauration n’est pas complètement terminée.

Restaurer une sauvegarde lorsque l’organisation d’origine n’est pas accessible

Vérifiez d’abord que le volume persistant d’origine contient des étiquettes qui peuvent être utilisées dans le cadre d’un sélecteur d’étiquettes lors de l’inscription d’un nouveau backup store. Vous devez également vous assurer que les paramètres suivants sont identiques dans les environnements source et cible :

  • Nom de domaine complet (FQDN) et chemin de contexte (c’est-à-dire https://dnsalias.domain.com/context)
  • Hôte de registre et référentiel (c’est-à-dire docker.io et esridocker)
  • Espace de noms Kubernetes (c’est-à-dire arcgis)
  • Domaine du cluster Kubernetes (c’est-à-dire, cluster.local)
  • Suffixe DNS du service Kubernetes (c’est-à-dire, svc.cluster.local)
  • FSGroup et ID de groupe complémentaire (si le déploiement utilise une valeur personnalisée)

Remarque :

Ces paramètres ont été spécifiés durant le déploiement.

Préparer un volume persistant existant à la liaison statique

Après l’annulation du déploiement de ArcGIS Enterprise on Kubernetes, le statut du volume persistant d’origine sera défini sur Released (Publié). Ne corrigez pas le volume persistant existant tant que la nouvelle organisation n’a pas été créée. Dès que la nouvelle organisation est disponible, vous devrez supprimer le paramètre claimRef du volume persistant pour autoriser la liaison à l’aide des sélecteurs d’étiquettes. Pour ajouter les étiquettes qui conviennent et s’assurer que le volume persistant peut être lié au volume persistant de la nouvelle organisation, procédez comme suit :

  1. Utilisez kubectl pour identifier le volume persistant qui a été utilisé pour le répertoire de sauvegarde précédent.
    kubectl get pv
    
  2. Utilisez kubectl pour attribuer une étiquette au volume persistant.

    Elle permet de lier le volume persistant au pod du nouveau backup store.

    kubectl label pv <pv name> <key>=<value>
    

    Par exemple, utilisez "arcgis/purpose":"backups" comme sélecteur d’étiquettes :

    kubectl label pv <pv name> arcgis/purpose=backups
    
  3. Corrigez le volume persistant pour vous assurer qu’il peut être lié au pod du nouveau répertoire de sauvegarde.
    kubectl patch pv <pv name> -p '{"spec":{"claimRef": null}}'
    

Inscrire le backup store

Si vous n’avez pas enregistré un emplacement intermédiaire et un backup store, procédez comme suit pour inscrire un nouveau backup store et le lier au volume persistant existant :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur de votre organisation.
  2. Cliquez sur le bouton Backups (Sauvegardes).
  3. Dans la page des sauvegardes, cliquez sur Register a backup store (Inscrire un backup store).
    1. Indiquez les informations suivantes pour l’emplacement intermédiaire :
      1. Size (GiB) (Taille [Go]) : définissez la taille du volume persistant pour l’emplacement intermédiaire. La taille minimale est de 16 Gio et doit être suffisante pour contenir la sauvegarde de chaque store.
      2. Storage class name (Nom de la classe de stockage) : définit le nom de la classe de stockage.
    2. Indiquez les informations suivantes pour le backup store :
      1. Storage type (Type de stockage) : pour relier au volume persistant, il convient de sélectionner Static (Statique). Les administrateurs doivent confirmer que le volume persistant possède les étiquettes nécessaires à la liaison et qu’il peut être lié.
      2. Backup store name (Nom du backup store) : définissez le nom du backup store. Il peut seulement inclure des lettres en minuscules, des chiffres et des tirets (-). Il ne doit pas commencer ni terminer par un tiret.
      3. Size (GiB) (Taille [Go]) : définissez la taille du volume persistant pour le backup store. La taille minimale est de 16 Gio. La valeur doit correspondre à la taille du volume persistant en cas de liaison statique. Si la valeur est supérieure à la taille du volume persistant, la réclamation de volume persistant ne pourra pas être liée au volume persistant.
      4. Storage class name (Nom de la classe de stockage) : la classe de stockage doit correspondre à celle du volume persistant existant.
      5. Label selector (Sélecteur d’étiquettes) : obligatoire en cas de provisionnement statique ; l’étiquette ou les étiquettes doit/doivent correspondre à celle(s) du volume persistant existant.
    3. Cliquez sur Register (Enregistrer).
  4. Remarque :
    Lors de la liaison à un volume persistant pré-créé pour lequel aucune classe de stockage n’a été définie, le nom de la classe de stockage doit rester vierge. Si une classe de stockage par défaut est configurée dans le cluster, le contrôleur d’admission DefaultStorageClass ajoute la classe de stockage par défaut et empêche la liaison de la réclamation de volume persistant. En pareil cas, les administrateurs doivent ajouter la spécification de classe de stockage au volume existant ou supprimer la configuration de la classe de stockage par défaut.

Si vous avez déjà enregistré un emplacement intermédiaire et un backup store, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur de votre organisation.
  2. Cliquez sur le bouton Backups (Sauvegardes).
  3. Dans la page des sauvegardes, cliquez sur Backup stores.
  4. Cliquez sur Register store (Inscrire un backup store) et indiquez les informations suivantes :
    1. Storage type (Type de stockage) : pour relier au volume persistant, il convient de sélectionner Static (Statique). Les administrateurs doivent confirmer que le volume persistant possède les étiquettes nécessaires à la liaison et qu’il peut être lié.
    2. Backup store name (Nom du backup store) : définissez le nom du backup store. Il peut seulement inclure des lettres en minuscules, des chiffres et des tirets (-). Il ne doit pas commencer ni terminer par un tiret.
    3. Size (GiB) (Taille [Go]) : définissez la taille du volume persistant pour le backup store. La taille minimale est de 16 Gio. La valeur doit correspondre à la taille du volume persistant en cas de liaison statique. Si la valeur est supérieure à la taille du volume persistant, la réclamation de volume persistant ne pourra pas être liée au volume persistant.
    4. Storage class name (Nom de la classe de stockage) : la classe de stockage doit correspondre à celle du volume persistant existant.
    5. Label selector (Sélecteur d’étiquettes) : obligatoire en cas de provisionnement statique ; l’étiquette ou les étiquettes doit/doivent correspondre à celle(s) du volume persistant existant.
  5. Cliquez sur Register (Enregistrer).

Lorsque le backup store est inscrit, toutes les sauvegardes du backup store sont répertoriées sur la page des sauvegardes, mais seules les sauvegardes de la même version sont disponibles et peuvent faire l’objet d’une restauration.

Restaurer la sauvegarde

Pour restaurer une sauvegarde, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur de votre organisation.
  2. Cliquez sur le bouton Backups (Sauvegardes).
  3. Dans la page des sauvegardes, déterminez celle que vous souhaitez restaurer et cliquez sur le bouton des options.
  4. Cliquez sur Restore (Restaurer).
  5. Indiquez la phrase secrète de chiffrement qui a été utilisée pour créer la sauvegarde.
  6. Cliquez sur Restore (Restaurer).
Remarque :

Si vous utilisez ArcGIS Web Adaptor pour accéder au client, vous devez le désinscrire de l’API Admin et le ré-inscrire pour appliquer la configuration de l’organisation restaurée.

Vérifier le statut d’une opération de restauration

Si l’organisation d’origine n’était pas accessible avant la restauration, la session utilisateur active est invalidée ; le statut des étapes restantes du processus de restauration doit être examiné à partir de API ArcGIS Enterprise Administrator une fois celui-ci disponible.

Pour accéder à l’API Status, procédez comme suit :

  1. Vérifiez de temps à autre API ArcGIS Enterprise Administrator jusqu’à ce que la page de connexion soit accessible.
  2. Connectez-vous à API ArcGIS Enterprise Administrator.
  3. Cliquez sur System (Système) > Disaster Recovery (Récupération d’urgence) > Get Status (Obtenir le statut).

L’API renvoie l’état actuel de l’opération de restauration. Vous pouvez surveiller la page au cours d’une opération de restauration pour suivre la progression.

Remarque :

API ArcGIS Enterprise Administrator est temporairement indisponible au cours d’une opération de restauration. Lorsqu’il devient disponible, l’API Status continue à renvoyer le statut de l’opération de restauration.