PowerProtect DM : migration des métadonnées de sauvegarde Avamar File System à l’aide de GSAN Mover

SOMMAIRE

1. Présentation
2. Fonctionnalités principales
3. Conditions préalables
4. Check-list préalable à la migration
5. Téléchargement et installation
6. Configuration
7. Procédure de migration
8. Étapes de vérification
9. Dépannage
10. pratiques d'excellence

---

1. PRÉSENTATION

L’outil GSAN Mover est un utilitaire spécialisé conçu pour faciliter la migration des métadonnées de sauvegarde Avamar File System vers Dell PowerProtect Data Manager. Cet outil permet aux clients de migrer leurs ressources de système de fichiers d’Avamar vers PowerProtect Data Manager tout en conservant les métadonnées de sauvegarde historiques et en garantissant l’intégrité des données.

Remarque importante :
L’outil GSAN Mover ne permet de migrer QUE LES MÉTADONNÉES. Les données de sauvegarde restent sur le système Data Domain et ne sont ni déplacées ni modifiées pendant le processus de migration.

Applicable à :

• Dell PowerProtect Data Manager 20.1 et versions supérieures
• Dell Avamar (toutes les versions prises en charge) 
• Dell Data Domain (toutes les versions prises en charge)
• Sauvegardes de système de fichiers uniquement

---

2. FONCTIONNALITÉS PRINCIPALES

L’outil GSAN Mover offre les fonctionnalités suivantes :

• Migration des métadonnées
  Les métadonnées de sauvegarde sont transférées d’Avamar vers PowerProtect Data Manager sans déplacement des données.
• Conservation des données
  Les données de sauvegarde restent sur Data Domain, sans nécessiter de déplacement des données.
•  Traitement par lots
  La migration simultanée de plusieurs clients est prise en charge.
• Conservation des sauvegardes historiques
  Toutes les copies de sauvegarde restent accessibles après la migration.
• Aucune interruption
  La migration des métadonnées n’affecte pas les données de sauvegarde existantes.

---

3. CONDITIONS PRÉALABLES

3.1 Configuration système requise

• Exigences d’accès :
  • Serveur PowerProtect Data Manager ou hôte de travail désigné avec connectivité réseau vers :
    • Avamar Server
    • Système Data Domain
    • Serveur PowerProtect Data Manager
• Informations d’identification requises :
  • Nom d’utilisateur et mot de passe root Avamar
  • Nom d’utilisateur et mot de passe Data Domain DD Boost
  • Informations d’identification d’administrateur PowerProtect Data Manager
• Configuration réseau :
  • Accès SSH ou SCP pour le transfert de fichiers
  • Connectivité réseau entre tous les systèmes (Avamar, Data Domain, PowerProtect Data Manager)
  • Règles de pare-feu configurées pour autoriser les ports requis
• Configuration logicielle requise :
  • Environnement UNIX Linux avec shell bash
  • Espace disque suffisant pour l’outil et les logs (1 Go recommandé au minimum)
  • wget ou curl (utilitaire pour télécharger l’outil)

3.2 Vérification de l’environnement

Avant de continuer, vérifiez les points suivants :

• Environnement Avamar :
  • Le serveur Avamar Server est opérationnel et accessible.
  • Les clients de système de fichiers ont été sauvegardés avec succès.
  • La structure de domaine Avamar est documentée.
  • L’accès root est disponible.
• Environnement Data Domain :
  • Le système Data Domain est opérationnel.
  • DD Boost est configuré pour Avamar.
  • La configuration de TLS (activé ou désactivé) est connue.
  • La capacité disponible est suffisante.
• Environnement PowerProtect Data Manager :
  • Le serveur PowerProtect Data Manager est opérationnel (versions 20.1 ou supérieures)
  • L’accès administrateur est disponible.
  • PowerProtect Data Manager File System Agent peut être installé.
  • La connectivité réseau à Avamar et Data Domain a été vérifiée.

---

4. CHECK-LIST PRÉALABLE À LA MIGRATION

Effectuez les tâches suivantes avant de démarrer la migration :

[ ] Vérifiez que tous les clients de système de fichiers ont été sauvegardés avec succès dans Avamar.
[ ] Documentez la structure de domaine Avamar actuelle et la liste des clients.
[ ] Assurez-vous que Data Domain dispose d’une capacité suffisante pour garantir la continuité des opérations.
[ ] Vérifiez la configuration de TLS (activé ou désactivé) sur Data Domain.
[ ] Sauvegardez la configuration Avamar actuelle.
[ ] Vérifiez que PowerProtect Data Manager File System Agent est disponible pour les hôtes de restauration cibles.
[ ] Vérifiez la connectivité réseau entre tous les systèmes.
[ ] Planifiez une fenêtre de maintenance pour les activités de migration.
[ ] Informez les parties prenantes de la migration prévue.
[ ] Préparez un plan de restauration, le cas échéant.

---

5. TÉLÉCHARGEMENT ET INSTALLATION

5.1 Téléchargez l’outil GSAN Mover.

L’outil est disponible sur le serveur des téléchargements Dell à l’adresse suivante : https://dl.dell.com/downloads/HMP51_PTPP-GSAN-Data-Mover.gz (vous devez vous connecter au site de support Dell pour y accéder).

• Méthode 1 : utilisation de wget
wget https://dl.dell.com/downloads/HMP51_PTPP-GSAN-Data-Mover.gz (Vous devez vous connecter au support Dell pour y accéder.)
• Méthode 2 : utilisation de curl
curl -O https://dl.dell.com/downloads/HMP51_PTPP-GSAN-Data-Mover.gz (Vous devez vous connecter au support Dell pour y accéder.)

5.2 Transfert vers l’hôte cible.

Transférez le fichier téléchargé vers votre serveur PowerProtect Data Manager ou l’hôte de travail désigné :

scp HMP51_PTPP-GSAN-Data-Mover.gz <user>@<target_host>:/tmp/

Remplacez les variables <user> et <target_host> par vos valeurs d’environnement.

5.3 Décompressez le package.

Extrayez le fichier compressé :

gunzip HMP51_PTPP-GSAN-Data-Mover.gz

Si le fichier est un fichier tarball (.tar.gz) :

tar -xzf HMP51_PTPP-GSAN-Data-Mover.gz

5.4 Définissez les autorisations d’exécution.

Rendez le fichier binaire exécutable :

chmod +x ./gsan-mover

Vérifiez que le fichier est exécutable :

ls -l ./gsan-mover

La sortie attendue doit afficher les autorisations d’exécution (par exemple, -rwxr-xr-x).

---

6. CONFIGURATION

L’outil GSAN Mover nécessite deux fichiers de configuration :

6.1 Fichier de configuration (formatYAML )

Créez un fichier nommé config_input.yaml avec les détails de votre environnement :

Fichier : config_input.yaml

Avamar:
  username: root
  password: <avamar_root_password>

DataDomains:
ip: <data_domain_ip_address>
username: <dd_boost_username>
password: <dd_boost_password>
tls: <true/false>

Paramètres de configuration :

Parameter                                        Description                                                                                                    Example
─────────────────────      ─────────────────────────────────────────────      ──────────────────────
Avamar.username               Root username for the Avamar server                                                            root
Avamar.password               Root password for the Avamar server                                                            YourSecurePassword123
DataDomains.ip                IP address or FQDN of Data Domain system          192.168.1.100 or dd01.example.com
DataDomains.username          DD Boost username configured for Avamar           ddboost_user
DataDomains.password          DD Boost user password                                                                                 DDBoostPassword456
DataDomains.tls               TLS encryption setting (true or false)                                                              true or false
                              Must match Data Domain TLS configuration.

AVIS DE SÉCURITÉ :
Protégez le fichier de configuration avec des autorisations restreintes afin d’en garantir la sécurité.

Informations d’identification :

chmod 600 config_input.yaml

Vérifiez les autorisations :

ls -l config_input.yaml

Résultat attendu :

-rw------- (owner read/write only)

6.2 Fichier d’entrée des clients (formatCSV )

Créez un fichier nommé clients_input.csv répertoriant les clients de système de fichiers à migrer :

Fichier : clients_input.csv

name,domain
client1.example.com,/clients
client2.example.com,/clients
client3.example.com,/production

Définitions des colonnes du fichier CSV :

Column           Description                                               Example
────────      ────────────────────────────────────────────────────      ──────────────────────────
name             Fully Qualified Domain Name (FQDN) of the file            fileserver01.corp.example.com

domain           Avamar domain path where the client resides               /clients or /production/fileservers

Exemple avec plusieurs clients :

name,domain
fileserver01.corp.example.com,/clients
fileserver02.corp.example.com,/clients
fileserver03.corp.example.com,/production
nas01.corp.example.com,/production/nas
nas02.corp.example.com,/production/nas

 

---

7. PROCÉDURE DE MIGRATION

Suivez les étapes dans l’ordre indiqué :

ÉTAPE 1 : lancez l’outil GSAN Mover. 

Exécutez l’outil avec vos fichiers de configuration :

./gsan-mover --config-file <config_file_path> --clients-file <path_to_clients_file>

Exemple :

./gsan-mover --config-file ./config_input.yaml --clients-file ./clients_input.csv

Recommandé : capturer les logs
À des fins de dépannage et d’audit, capturez la sortie dans un fichier log :

./gsan-mover --config-file ./config_input.yaml --clients-file ./clients_input.csv 2>&1 | tee gsan-mover-$(date +%Y%m%d-%H%M%S).log

Cette opération crée un fichier log horodaté (par exemple, gsan-mover-20260512-143022.log) que vous pourrez consulter ultérieurement.

Surveiller l’exécution :

• Suivez la sortie de l’outil pour vérifier la progression.
• Attendez que l’outil indique la réussite de l’opération.
• Examinez les avertissements ou les erreurs indiqués dans la sortie.
• Consultez le fichier log pour obtenir des informations détaillées sur l’exécution.
• NE passez PAS à l’étape 2 tant que cette étape ne s’est pas terminée avec succès.

ÉTAPE 2 : désactivez la règle de sauvegarde Avamar.

ÉTAPE ESSENTIELLE : NE L’IGNOREZ PAS !
Avant de procéder à la migration dans l’interface utilisateur de PowerProtect Data Manager, vous DEVEZ désactiver la règle de sauvegarde sur le serveur Avamar Server pour les ressources à migrer. Il s’agit d’une étape obligatoire pour que PowerProtect Data Manager reconnaisse les ressources comme étant disponibles pour la migration.

Procédure :

1. Connectez-vous à la console d’administration Avamar.
2. Accédez à Administration → Policies.
3. Sélectionnez la règle de sauvegarde associée aux clients de système de fichiers en cours de migration.
4. Cliquez sur Disable pour arrêter la règle.
5. Vérifiez que la règle est désactivée (l’état doit être « Disabled » ou « Stopped »)

Important :

• La règle doit rester désactivée pendant le processus de migration.
• Vous pouvez la réactiver une fois la migration terminée, le cas échéant.
• Documentez les règles qui ont été désactivées pour référence.

ÉTAPE 3 : ajoutez Avamar en tant que source de ressources dans PowerProtect Data Manager.

3.1 Ajoutez une source de ressources Avamar.

1. Connectez-vous à l’interface utilisateur de PowerProtect Data Manager en tant qu’administrateur.
2. Accédez à Infrastructure → Asset Sources.
3. Cliquez sur + Add.
4. Sélectionnez Avamar dans la liste.
5. Saisissez le nom de domaine complet ou l’adresse IP du serveur Avamar Server.
6. Cliquez sur Verify.
7. Fournissez les informations d’identification Avamar lorsque vous y êtes invité.
8. Cliquez sur Enregistrer

3.2 Attendez la tâche de découverte.

1. Accédez à Jobs → System Jobs.
2. Localisez la tâche de découverte et de vérification préalable de la source de ressources Avamar.
3. Suivez la progression de la tâche.
4. Attendez que la tâche se termine avec succès.
5. Vérifiez qu’aucune erreur n’est signalée dans les détails de la tâche.

Durée prévue : entre 5 et 15 minutes (selon la taille de l’environnement)

ÉTAPE 4 : migrez les ressources dans PowerProtect Data Manager.

4.1. Accédez à Assets.

1. Dans l’interface utilisateur de PowerProtect Data Manager, accédez à Infrastructure → Assets.
2. Cliquez sur l’onglet Non-Migrated.
3. Vérifiez que les clients de système de fichiers figurent dans la liste.

Si ce n’est pas le cas :

• Vérifiez que l’étape 2 a été effectuée (règle Avamar désactivée).
• Attendez que la tâche de découverte se termine.
• Actualisez la page.
• Recherchez les erreurs dans les logs PowerProtect Data Manager.

4.2 Lancez la migration.

1. Sélectionnez les clients de système de fichiers que vous souhaitez migrer. (Utilisez Ctrl+Click ou Shift+Click pour sélectionner plusieurs clients.)
2. Cliquez sur le bouton Migrate to Data Manager.
3. Consultez la boîte de dialogue de confirmation de la migration.
4. Cliquez sur Confirm pour démarrer la migration.

4.3 Suivez la progression de la migration.

1. Accédez à Jobs → System Jobs.
2. Localisez la ou les tâches de migration.
3. Suivez la progression de la tâche.
4. Attendez que la tâche se termine avec succès.
5. Examinez les détails de la tâche pour vérifier l’existence d’éventuels avertissements ou problèmes.

Durée prévue : varie en fonction du volume de métadonnées (généralement de 5 à 30 minutes par client)

ÉTAPE 5 : vérifiez la migration. 

À la fin de la migration, effectuez les étapes de vérification suivantes :

5.1 Vérifiez l’état des ressources.

1. Accédez à Infrastructure → Assets.
2. Cliquez sur l’onglet Migrated.
3. Vérifiez que les ressources migrées figurent dans la liste.
4. Vérifiez que les détails des ressources sont corrects :

• • Le nom d’hôte correspond au nom de domaine complet attendu.
  • Le chemin de domaine est correct.
  • L’état Protected ou Active s’affiche.

5.2 Vérifiez les copies de sauvegarde.

1. Sélectionnez une ressource migrée dans la liste.
2. Cliquez sur View Copies (ou option similaire).
3. Vérifiez que toutes les copies de sauvegarde historiques sont visibles.
4. Pour chaque copie de sauvegarde, vérifiez ce qui suit :

• • La date et l’heure de la sauvegarde correspondent aux enregistrements Avamar.
  • La taille de la sauvegarde est raisonnable.
  • L’état de la sauvegarde est Available ou Successful.

5.3 Effectuez un test de restauration.

1. Accédez à Restore → Assets (ou Restore → File System).
2. Sélectionnez une ressource migrée.
3. Choisissez une copie de sauvegarde à restaurer (de préférence une copie récente).
4. Sélectionnez les fichiers ou les dossiers spécifiques à restaurer.
5. Choisissez un hôte de restauration cible. (PowerProtect Data Manager File System Agent doit y être installé et enregistré.)
6. Configurez les options de restauration selon les besoins.
7. Cliquez sur Restore pour exécuter l’opération.
8. Suivez la tâche de restauration dans Jobs → Restore Jobs.
9. Lorsque vous avez terminé, vérifiez l’intégrité des données restaurées :

• • Vérifiez le contenu des fichiers.
  • Vérifiez les autorisations des fichiers.
  • Confirmez les horodatages des fichiers.

 

---

8. ÉTAPES DE VÉRIFICATION

Une fois la procédure de migration terminée, effectuez les étapes de vérification supplémentaires suivantes :

8.1 Vérifiez la connectivité Data Domain.

1. Dans l’interface utilisateur de PowerProtect Data Manager, accédez à Infrastructure → Storage Systems.
2. Vérifiez que le système Data Domain est répertorié et affiche l’état Connected.
3. Vérifiez les indicateurs de capacité et d’intégrité.

8.2 Vérifiez les règles de protection.

1. Accédez à Protection Protection Policies.
2. Créez ou mettez à jour les règles de protection des ressources migrées.
3. Attribuez des règles aux clients de système de fichiers migrés.
4. Effectuez une sauvegarde manuelle pour vérifier le fonctionnement.

8.3 Vérifiez l’état de l’agent (pour les opérations de restauration).

1. Accédez à Infrastructure → Agents.
2. Vérifiez que PowerProtect Data Manager File System Agent est installé sur les hôtes cibles.
3. Vérifiez que l’état de l’agent est Registered ou Active.
4. Vérifiez que la version de l’agent est compatible avec la version de PowerProtect Data Manager.

8.4 Résultats de la migration des documents

• Répertoriez tous les clients migrés et leur état.
• Documentez tous les problèmes rencontrés et les résolutions.
• Mettez à jour les runbooks et les procédures opérationnelles.
• Archivez les fichiers de configuration et les fichiers logs.

---

9. DÉPANNAGE

Cette section fournit des solutions aux problèmes courants rencontrés lors de la migration.

PROBLÈME 1 : expiration du délai de connexion à Avamar ou Data Domain

Symptômes :

• Échec de l’outil avec erreurs d’expiration du délai de connexion
• Accès impossible à Avamar ou Data Domain
• Messages d’erreur indiquant des problèmes de connectivité réseau

Résolution :

1. Vérifiez la connectivité réseau :   

ping <avamar_ip>

ping <data_domain_ip>

2. Vérifiez les règles du pare-feu :

• • Assurez-vous que les ports requis sont ouverts.
  • Vérifiez qu’aucune liste de contrôle d’accès réseau ne bloque le trafic.

3. Vérifiez les informations d’identification :

• • Testez les informations d’identification Avamar : ssh root@<avamar_ip>
  • Vérifiez les informations d’identification DD Boost sur Data Domain.

4. Vérifiez l’état des services :

• • Assurez-vous que les services Avamar sont en cours d’exécution.
  • Vérifiez que les services Data Domain sont opérationnels.

5. Vérifiez la configuration réseau :

• • Vérifiez la résolution DNS.
  • Vérifiez le routage entre les systèmes.

PROBLÈME 2 : échecs de l’authentification

Symptômes :

• Messages d’erreur d’échec de l’authentification
• Erreurs de non-validité des informations d’identification
• Messages d’accès refusé

Résolution :

1. Vérifiez le nom d’utilisateur et le mot de passe dans config_input.yaml:

• • Recherchez les fautes de frappe ou les espaces supplémentaires.
  • Assurez-vous que le mot de passe est correct.

2. Testez manuellement les informations d’identification :

• • Établissez une connexion à Avamar via SSH : ssh root@<avamar_ip>
  • Testez les informations d’identification DD Boost sur la console Data Domain.

3. Recherchez les caractères spéciaux dans les mots de passe :

• • Certains caractères spéciaux peuvent nécessiter un échappement dans le langage YAML.
  • Envisagez d’utiliser des guillemets simples autour du mot de passe.

4. Vérifiez l’état du compte :

• • Assurez-vous que le compte n’est pas verrouillé.
  • Vérifiez la règle d’expiration des mots de passe.
  • Vérifiez que le compte dispose des autorisations requises.

PROBLÈME 3 : non-correspondance de la configuration TLS 

Symptômes :

• Échec des établissements de liaisons TLS
• Erreurs SSL/TLS dans les logs
• Erreurs de validation du certificat

Résolution :

1. Vérifiez la configuration TLS de Data Domain :

• • Connectez-vous à PowerProtect DD System Manager.
  • Vérifiez les paramètres TLS de DD Boost.

2. Faites correspondre la configuration dans config_input.yaml:

• • Si TLS est activé sur Data Domain, utilisez la configuration suivante : tls: true
  • Si TLS est désactivé sur Data Domain, utilisez la configuration suivante : tls: false

3. Vérifiez la validité du certificat (si TLS est activé) :

• • Vérifiez la date d’expiration du certificat.
  • Configurez la chaîne de certificats.

4. Testez la connectivité DD Boost :

• • Utilisez les utilitaires de test DD Boost.
  • Vérifiez que l’établissement de liaison TLS réussit.

PROBLÈME 4 : ressources absentes de l’onglet Non-Migrated de PowerProtect Data Manager

Symptômes :

• Métadonnées migrées non visibles dans PowerProtect Data Manager
• Ressources manquantes dans la liste Non-Migrated
• Liste de ressources vide après la découverte

Résolution :

1. Vérifiez que la règle de sauvegarde Avamar est désactivée (étape 2) :

• • Connectez-vous à la console d’administration Avamar.
  • Vérifiez l’état de la règle.
  • Désactivez la règle si elle n’est pas déjà désactivée.

2. Attendez que la tâche de découverte PowerProtect Data Manager soit terminée :

• • Accédez à Jobs → System Jobs.
  • Vérifiez que la tâche de découverte a été exécutée avec succès.
  • Vérifiez la durée de la tâche (elle peut prendre de 10 à 15 minutes).

3. Actualisez la page Assets :

• • Dans l’interface utilisateur de PowerProtect Data Manager, cliquez sur le bouton d’actualisation.
  • Déconnectez, puis reconnectez-vous.
  • Effacez le cache du navigateur, le cas échéant.

4. Recherchez les erreurs de découverte dans les logs PowerProtect Data Manager.

• • Accédez à System Logs.
  • Filtrez les erreurs liées à la découverte.
  • Recherchez les problèmes spécifiques dans les messages d’erreur.

5. Vérifiez la configuration de la source de ressources Avamar :

• • Accédez à Infrastructure → Asset Sources.
  • Vérifiez que le serveur Avamar Server est répertorié.
  • Vérifiez l’état de la connexion.
  • Vérifiez de nouveau les informations d’identification, le cas échéant.

PROBLÈME 5 : échec de la tâche de migration dans PowerProtect Data Manager.

Symptômes :

• État d’échec affiché pour la tâche de migration
• Messages d’erreur dans System Jobs
• Tâche terminée sans erreur

Résolution :

1. Consultez les logs détaillés des tâches dans PowerProtect Data Manager :

• • Accédez à Jobs → System Jobs.
  • Cliquez sur la tâche de migration ayant échoué.
  • Examinez les messages d’erreur et les traces de pile.

2. Vérifiez la connectivité Data Domain à partir de PowerProtect Data Manager :

• • Accédez à Infrastructure Storage Systems.
  • Vérifiez l’état de la connexion Data Domain.
  • Testez la connectivité.

3. Vérifiez la capacité et l’intégrité de Data Domain :

• • Connectez-vous à PowerProtect DD System Manager.
  • Vérifiez que la capacité est suffisante.
  • Recherchez les alertes ou avertissements éventuels.

4. Assurez-vous que DD Boost est correctement configuré :

• • Vérifiez les informations d’identification DD Boost.
  • Vérifiez la configuration de l’unité de stockage DD Boost.
  • Vérifiez la configuration d’Avamar DD Boost.

5. Vérifiez que l’outil GSAN Mover a été exécuté avec succès :

• • Passez en revue les fichiers logs GSAN Mover.
  • Assurez-vous qu’aucune erreur n’a été signalée.
  • Exécutez à nouveau GSAN Mover, le cas échéant.

6. Réessayez la migration :

• • Après avoir résolu les problèmes, relancez la migration.
  • Sélectionnez à nouveau la ressource et cliquez sur Migrate.

PROBLÈME 6 : échec de l’opération de restauration. 

Symptômes :

• Échec ou expiration de la tâche de restauration
• Données non restaurées sur l’hôte cible
• Messages d’erreur lors de la restauration

Résolution :

1. Vérifiez que PowerProtect Data Manager File System Agent est installé sur l’hôte cible :

• • Vérifiez l’installation de l’agent.
  • Vérifiez la compatibilité de la version de l’agent.

2. Vérifiez l’état d’enregistrement de l’agent dans PowerProtect Data Manager :

• • Accédez à Infrastructure → Agents.
  • Vérifiez que l’agent présente l’état Registered.
  • Enregistrez à nouveau l’agent, le cas échéant.

3. Vérifiez la connectivité réseau :

• • Testez la connectivité entre PowerProtect Data Manager et l’hôte cible.
  • Vérifiez les règles du pare-feu.
  • Vérifiez la résolution DNS.

4. Vérifiez la connectivité et les performances de Data Domain :

• • Vérifiez que Data Domain est accessible.
  • Vérifiez les mesures de performances de Data Domain.
  • Vérifiez qu’il n’y a aucun problème de capacité.

5. Consultez les logs des tâches de restauration :

• • Accédez à Jobs → Restore Jobs.
  • Cliquez sur la tâche de restauration ayant échoué.
  • Recherchez les problèmes spécifiques dans les messages d’erreur.

6. Vérifiez les autorisations de restauration :

• • Vérifiez que le répertoire cible est inscriptible.
  • Vérifiez les autorisations du système de fichiers.
  • Assurez-vous que l’espace disque est suffisant sur la cible.

9.1 Emplacements des fichiers logs

• Logs GSAN Mover :

Location: gsan-mover-<timestamp>.log (in execution directory)

Contains: Tool execution details, errors, and progress information

• Logs PowerProtect Data Manager :

Location: Available in PowerProtect Data Manager UI under Jobs → System Jobs → Job Details

Contains: Discovery, migration, and restore job details.

• Logs Avamar :

Location: /usr/local/avamar/var/ on Avamar server

Contains: Avamar system logs and backup job details

• Logs Data Domain :

Location: Accessible by Data Domain System Manager

Contains: DD Boost logs and system events

9.2 Collecte des informations de diagnostic

Si vous contactez le support technique Dell, collectez les éléments suivants :

• Fichiers logs GSAN Mover (tous les logs horodatés)
• Fichiers de configuration (config_input.yaml et clients_input.csv)

 

 

• Logs des tâches PowerProtect Data Manager (exportés à partir de System Jobs)
• Captures d’écran des messages d’erreur
• Informations sur l’environnement :
  • Version de PowerProtect Data Manager
  • Version d’Avamar
  • Version de Data Domain
  • Schéma de la topologie réseau (si disponible)

---

10. PRATIQUES D’EXCELLENCE

10.1 Phase de planification

• Migration pilote
  • Effectuez un test préalable avec un petit sous-ensemble de clients (2-3).
  • Validez l’ensemble du processus avant la migration à grande échelle.
  • Documentez les enseignements.
• Fenêtre de maintenance
  • Planifiez la migration pendant les heures creuses.
  • Prévoyez suffisamment de temps pour l’achèvement et la vérification.
  • Prévoyez une éventuelle restauration, le cas échéant.
• Documentation
  • Documentez tous les noms de domaine complets, domaines et règles des clients.
  • Créez un plan de migration détaillé.
  • Préparez les procédures de restauration.
• Communications
  • Informez les parties prenantes du planning de migration.
  • Communiquez les interruptions de service prévues (le cas échéant).
  • Communiquez l’état pendant la migration.

10.2 Phase d’exécution

• Taille de lot
  • Migrez les clients par lots faciles à gérer (de 10 à 20 à la fois).
  • Cela facilite la surveillance et le dépannage.
  • Le risque de pannes à grande échelle est réduit.
• Conservation des logs
  • Conservez tous les fichiers logs à des fins d’audit et de dépannage.
  • Utilisez des fichiers logs horodatés pour une meilleure identification et une meilleure traçabilité des événements.
  • Archivez les logs une fois la migration réussie.
• Vérification
  • Vérifiez chaque lot avant de passer au suivant.
  • Effectuez des tests de restauration pour chaque lot.
  • Documentez les résultats de la vérification.
• Configuration de sauvegarde
  • Enregistrez des copies de tous les fichiers de configuration.
  • Documentez tous les paramètres personnalisés.
  • Conservez les fichiers de configuration pour les consulter ultérieurement.

10.3 Phase de post-migration

• Recréation des règles
  • Créez de nouvelles règles de protection dans PowerProtect Data Manager.
  • Attribuez les règles aux ressources migrées.
  • Planifiez les premières tâches de sauvegarde.
• Surveillance
  • Suivez attentivement les premières tâches de sauvegarde.
  • Vérifiez la réussite et les performances de la sauvegarde.
  • Résolvez immédiatement tout problème.
• Mise à jour de la documentation
  • Mettez à jour les runbooks et les procédures opérationnelles.
  • Documentez les nouveaux workflows PowerProtect Data Manager.
  • Formez le personnel aux nouvelles procédures.
• Nettoyage
  • Archivez ou supprimez les anciennes règles Avamar une fois la migration réussie.
  • Supprimez les fichiers temporaires et les logs.
  • Mettez à jour l’inventaire des ressources.
• Performances de référence
  • Établissez des performances de référence pour le nouvel environnement.
  • Surveillez les fenêtres et les durées de sauvegarde.
  • Optimisez en fonction des besoins.

FORUM AUX QUESTIONS (FAQ)

• Q1 : Le logiciel GSAN Mover permet-il de déplacer des données de sauvegarde ?

• Q2 : La sauvegarde peut-elle se poursuivre vers Avamar pendant la migration ?

R : Non, vous devez désactiver la règle de sauvegarde Avamar pour les ressources que vous migrez. Il s’agit d’une étape obligatoire pour que PowerProtect Data Manager reconnaisse les ressources comme étant disponibles pour la migration. Le cas échéant, vous pouvez réactiver la règle après la migration ou créer de nouvelles règles dans PowerProtect Data Manager.

• Q3 : Les sauvegardes historiques sont-elles disponibles après la migration ?

R : Oui, toutes les copies de sauvegarde historiques sont visibles dans PowerProtect Data Manager après la migration et peuvent être utilisées pour les opérations de restauration. La migration des métadonnées garantit la conservation de l’historique intégral des sauvegardes.

• Q4 : La migration simultanée vers plusieurs clients est-elle possible ?

R : Oui, vous pouvez répertorier plusieurs clients dans le fichier clients_input.csv et l’outil les traite par lots. Il est toutefois recommandé de procéder à la migration par lots faciles à gérer (de 10 à 20 clients) pour faciliter le suivi et le dépannage.

• Q5 : Que se passe-t-il si la migration échoue au cours du processus ?

R : Consultez les fichiers logs pour identifier le point de défaillance. Vous pouvez réexécuter l’outil après avoir résolu le problème. Les métadonnées déjà migrées ne sont pas dupliquées. L’outil est idempotent pour la plupart des opérations.

• Q6 : La réinstallation des agents sur les clients de système de fichiers est-elle obligatoire ?

R : Pour les opérations de restauration, PowerProtect Data Manager File System Agent doit être installé sur l’hôte cible. Pour les sauvegardes en cours, vous devez configurer des règles de protection PowerProtect Data Manager. L’installation de l’agent est distincte de la migration des métadonnées.

• Q7 : La migration depuis plusieurs serveurs Avamar Server est-elle possible ?

R : Oui, mais vous devez exécuter l’outil séparément pour chaque serveur Avamar Server avec les fichiers de configuration appropriés. Chaque serveur Avamar Server nécessite son propre fichier config_input.yaml avec les informations d’identification correctes.

• Q8 : Combien de temps la migration dure-t-elle ?

R : Le temps de migration dépend du nombre de clients et de la quantité de métadonnées. Généralement, la migration des métadonnées est rapide (de 5 à 30 minutes par client), mais la découverte et la vérification PowerProtect Data Manager peuvent prendre plus de temps. Prévoyez entre 2 et 4 heures pour une migration standard de 10 à 20 clients.

• Q9 : La migration peut-elle être annulée ?

R : Les données d’origine restent dans Avamar et sur Data Domain. Vous pouvez réactiver les règles Avamar, le cas échéant. Toutefois, les métadonnées présentes dans PowerProtect Data Manager ne peuvent pas être supprimées automatiquement. Planifiez soigneusement votre migration et effectuez un test préalable à l’aide d’un groupe pilote.

• Q10 : Des interruptions de service ont-elles lieu pendant la migration ?

R : Les sauvegardes vers Avamar doivent être arrêtées (règle désactivée), mais les données restent accessibles pour les restaurations. Prévoyez une fenêtre de maintenance pour finaliser le processus de migration. En règle générale, les opérations de restauration effectuées à partir de sauvegardes existantes n’entraînent aucune interruption de service.

• Q11 : Quelles versions de PowerProtect Data Manager sont prises en charge ?

R : L’outil GSAN Mover prend en charge PowerProtect Data Manager versions 20.1 et supérieures. Vérifiez la version de PowerProtect Data Manager avant de démarrer la migration. Pour connaître la compatibilité de versions spécifiques, reportez-vous aux notes de mise à jour de Dell PowerProtect Data Manager.

• Q12 : Les sauvegardes d’application (SQL, Oracle, etc.) peuvent-elles être migrées ?

R : Non, l’outil GSAN Mover est conçu uniquement pour les sauvegardes de système de fichiers. Les sauvegardes d’application nécessitent des procédures de migration différentes. Pour obtenir des conseils sur la migration des sauvegardes d’application, contactez le support technique Dell.

• Q13 : Que dois-je faire si je rencontre une erreur qui n’est pas abordée dans cet article ?

R : Contactez le support technique Dell et fournissez les informations suivantes :

• • Fichiers logs GSAN Mover
  • Fichiers de configuration (mots de passe masqués)
  • Logs des tâches PowerProtect Data Manager
  • Messages d’erreur et captures d’écran
  • Détails de l’environnement (versions de PowerProtect Data Manager, d’Avamar, de Data Domain)

• Q14 : La migration vers un autre système Data Domain est-elle possible ?

R : Non, l’outil GSAN Mover migre les métadonnées tout en conservant les données sur le même système Data Domain. Si vous devez effectuer une migration vers un autre système Data Domain, des étapes supplémentaires sont requises. Contactez le support technique Dell pour obtenir des conseils.

• Q15 : Comment vérifier que la migration a réussi ?

R : Suivez les étapes de vérification de la section 8 :

• • Vérifiez que les ressources figurent dans la liste PowerProtect Data Manager-Migrated.
  • Vérifiez que toutes les copies de sauvegarde sont visibles.
  • Effectuez des tests de restauration pour valider l’intégrité des données.
  • Exécutez une nouvelle tâche de sauvegarde pour vérifier que la protection est active.