Guide du kit de développement logiciel Veritas NetBackup Parallel Streaming Framework pour développeurs

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.2)
  1. Protection de vos charges de travail à l'aide de NetBackup Parallel Streaming Framework
    1.  
      À propos du NetBackup Parallel Streaming Framework
    2.  
      À propos du kit de développement logiciel Parallel Streaming Framework
    3.  
      Processus de sauvegarde avec Parallel Streaming Framework
    4.  
      Processus de restauration avec Parallel Streaming Framework
    5.  
      Terminologie NetBackup Parallel Streaming Framework
  2. Architecture du plug-in NetBackup Parallel Streaming Framework
    1.  
      Opérations de plug-in
    2.  
      Architecture de l'API NetBackup Parallel Streaming Framework
    3.  
      Fonctions NetBackup prises en charge
  3. Déploiement du kit de développement logiciel NetBackup Parallel Streaming Framework
    1.  
      Compatibilité des systèmes d'exploitation et des plates-formes
    2.  
      Licence pour le kit de développement logiciel NetBackup Parallel Streaming Framework
    3.  
      Téléchargement du kit de développement logiciel NetBackup Parallel Streaming Framework
    4.  
      Installation du kit de développement logiciel NetBackup Parallel Streaming Framework
  4. Préparation pour le développement du plug-in
    1.  
      Préparation de votre environnement NetBackup
    2. Gestion des hôtes de sauvegarde
      1.  
        Mise en liste blanche d'un client NetBackup sur un serveur maître NetBackup
    3.  
      Création d'une politique de sauvegarde BigData
    4.  
      Gestion du mécanisme d'authentification
    5.  
      Ajout des informations d'authentification de charge de travail dans NetBackup
    6.  
      Considérations sur la sécurité
    7.  
      Certification requise pour rendre le plug-in disponible
  5. Utilisation d'un exemple de plug-in
    1.  
      À propos de l'exemple de plug-in
    2.  
      Développement d'un exemple de plug-in
  6. Développement du plug-in de charge de travail
    1.  
      À propos des phases de développement du plug-in
    2.  
      À propos de la phase d'initialisation du plug-in
    3.  
      À propos de la phase de demande du plug-in
    4.  
      À propos de la phase de déchargement du plug-in
    5. À propos de la phase de découverte de la charge de travail
      1.  
        À propos des fichiers de charge de travail
    6.  
      À propos de la phase de sauvegarde des données
    7.  
      À propos de la phase de restauration
    8.  
      À propos de la phase de récupération
    9.  
      Gestion de l'heure d'exécution d'une API
    10.  
      Vérification et test du plug-in au cours du développement
    11.  
      Mise en package du plug-in de charge de travail
  7. Déploiement du plug-in de charge de travail
    1.  
      Validation du plug-in à l'aide de l'outil de validation de somme de contrôle de fichier de NetBackup
    2.  
      Installation du plug-in de charge de travail sur un hôte de sauvegarde
    3.  
      Configuration de NetBackup pour une charge de travail
    4.  
      Exécution des sauvegardes et des restaurations d'une charge de travail
  8. Références de l'API NetBackup Parallel Streaming Framework
    1.  
      aapi_close_object
    2.  
      aapi_close_server
    3.  
      aapi_create_object
    4.  
      aapi_delete_object
    5.  
      aapi_discovery
    6.  
      aapi_flush
    7.  
      aapi_get_object_prop
    8.  
      aapi_get_object_prop_byname
    9.  
      aapi_get_server_prop
    10.  
      aapi_get_snappath_from_realpath
    11.  
      aapi_open_object
    12.  
      aapi_open_server
    13.  
      aapi_pgn_claim
    14.  
      aapi_pgn_init
    15.  
      aapi_postprocess
    16.  
      aapi_read_object
    17.  
      aapi_set_object_utimes
    18.  
      aapi_terminate
    19.  
      aapi_write_object
    20.  
      aapi_restore_preprocess
    21.  
      aapi_restore_postprocess
    22.  
      Valeurs de retour de l'API NetBackup Parallel Streaming Framework
  9. Consignation et dépannage
    1.  
      Activation de la consignation pour le plug-in

À propos de la phase de restauration

Pour un travail de restauration, l'utilisateur sélectionne le serveur NetBackup depuis lequel les objets sont restaurés et le client dont les données de sauvegarde doivent être restaurées. Cette opération exécute un processus bpbrm sur le serveur de médias pour lancer l'opération de restauration sur le serveur NetBackup à partir duquel les objets doivent être restaurés. Vous pouvez restaurer des objets à un même emplacement ou à un emplacement différent. Pour la restauration, un seul hôte de sauvegarde est utilisé. Se reporter à Processus de restauration avec Parallel Streaming Framework.

Processus de restauration

La tâche de restauration est pilotée par le processus nbtar comme illustré ci-dessous :

Figure : Processus de la phase de restauration

Processus de la phase de restauration

  1. En cas de restauration alternative, le chemin d'accès de restauration de l'objet est remplacé par un chemin d'accès de restauration alternatif à partir du chemin d'accès de l'objet sauvegardé.

    Par exemple, si le chemin d'accès de l'objet de sauvegarde est /obj-container1/obj-container2/file.txt, il est remplacé par /mnt/vol-1/obj-container1/obj-container2/file.txt où l'emplacement alternatif est mnt/vol-1

  2. L'API aapi_get_object_prop_byname est appelée avec le chemin d'accès de restauration de l'objet afin d'obtenir les propriétés d'objet.

    Par exemple, l'API aapi_get_object_prop_byname fournira les propriétés de métadonnées pour /mnt/vol-1/obj-container1/obj-container2/file.txt

  3. 4. Si le chemin d'accès de restauration de l'objet existe déjà et :

    • L'option d'écrasement est définie sur false, la restauration de l'objet est ignorée.

    • L'option d'écrasement est définie sur true, l'API aapi_delete_object est appelée pour supprimer l'objet existant.

  4. Un nouvel objet est créé à l'aide de l'implémentation de l'API aapi_create_object.

    Les informations d'objet telles que le nom, la taille, l'autorisation, les données u/mtime, le propriétaire sont transmises à l'appel aapi_create_object qui peut être utilisé pour définir les propriétés d'objet.

    L'API aapi_create_object est appelée pour tous les objets dans le chemin d'accès de restauration, à partir du premier objet jusqu'à l'objet terminal. Par conséquent, des conteneurs d'objet sont également créés s'ils ne sont pas présents.

    Par exemple, pour restaurer /mnt/vol-1/obj-container1/obj-container2/file.txt, l'API aapi_create_object est appelée cinq fois, une fois pour chaque valeur dans la hiérarchie.

    • /mnt, - conteneur d'objet

    • /mnt/vol-1 - conteneur d'objet

    • /mnt/vol-1/obj-container1, - conteneur d'objet

    • /mnt/vol-1/obj-container1/obj-container2, - conteneur d'objet

    • /mnt/vol-1/obj-container1/obj-container2/file.txt - conteneur de données

  5. L'objet est restauré en lisant son contenu sauvegardé à partir de l'image de sauvegarde et restauré en appelant l'API aapi_write_object.

    Ce processus est effectué de manière itérative et séquentielle jusqu'à ce que l'objet entier soit lu.

  6. L'API aapi_set_object_utimes est appelée pour restaurer les heures d'accès et de modification de l'objet

  7. Une fois tous les objets restaurés, l'API aapi_set_object_utimes est appelée à nouveau pour restaurer les heures d'accès et de modification du conteneur d'objet.

  8. L'objet de données est fermé en appelant l'API aapi_close_object qui effectue le nettoyage de l'objet associé.

API et processus relatifs

Pendant la phase de restauration, les processus NetBackup suivants sont déclenchés séquentiellement :

  1. Le processus bpbrm s'exécute sur le serveur de médias.

  2. Le processus nbtar exécute la sauvegarde sur tous les hôtes de sauvegarde.

Pendant la phase de restauration, les API suivantes sont appelées séquentiellement :

Tableau : Séquence des appels d'API lors de la phase de restauration

Phase

Appels d'API

Référence de l'exemple de plug-in

Le plug-in s'initialise

aapi_pgn_init

aapi_pgn_init

PSF demande le plug-in

aapi_pgn_claim

samplepgn_claim_v1

Configuration de la connexion

aapi_open_server

samplepgn_open_server_v1

Phase de restauration

  1. aapi_get_object_prop_byname

  2. aapi_delete_object

  3. aapi_create_object

  4. aapi_set_object_utimes

  5. aapi_write_object

  6. aapi_close_object

  1. samplepgn_get_object_prop_byname_v1

  2. samplepgn_delete_object_v1

  3. samplepgn_create_object_v1

  4. samplepgn_set_object_utimes_v1

  5. samplepgn_write_object_v1

  6. samplepgn_close_object_v1

Le plug-in se décharge

  1. aapi_close_server

  2. aapi_terminate

  1. samplepgn_close_server_v1

  2. samplepgn_terminate_v1

Ajout des informations de consignation pour la phase d'initialisation du plug-in dans NetBackup

Outre les erreurs existantes, vous remplissez les journaux personnalisés dans les fichiers journaux de débogage associés.

Se reporter à Activation de la consignation pour le plug-in.

Vérification et test du plug-in au cours du développement

Quand vous testez un plug-in lors du développement, examinez les journaux de la phase de développement correspondante. Le travail peut échouer jusqu'à ce que le plug-in soit créé dans son intégralité. Vous devez vérifier les journaux de réussite pour la phase spécifique.

Par exemple, si vous avez terminé le développement de la phase de découverte, la sauvegarde peut échouer, mais la découverte doit être réussie.

Se reporter à Vérification et test du plug-in au cours du développement.

Rubriques connexes

Se reporter à Processus de restauration avec Parallel Streaming Framework.

Se reporter à À propos de l'exemple de plug-in.