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 sauvegarde des données

Quand le travail de découverte est terminé, le processus bpbrm sur le serveur de médias distribue les fichiers de charge de travail pour les hôtes de sauvegarde correspondants et lance la tâche de sauvegarde sur les hôtes de sauvegarde. À la différence du travail de découverte, le travail de sauvegarde s'exécute sur tous les hôtes de sauvegarde configurés dans la politique BigData. Se reporter à Processus de sauvegarde avec Parallel Streaming Framework.

Une fois le processus de sauvegarde lancé, le processus bpbrm s'exécute sur le serveur de médias et active la phase de sauvegarde (bpbkar) sur tous les hôtes de sauvegarde.

Le processus de la phase de sauvegarde

Le diagramme suivant illustre le processus de la phase de sauvegarde :

Figure : Processus de la phase de sauvegarde

Processus de la phase de sauvegarde

  1. Le processus bpbkar lit le fichier de charge de travail qui a été créé pendant la phase de découverte de la charge de travail. Le fichier de charge de travail contient l'identifiant de snapshot (si les snapshots sont activés pour la sauvegarde) et la hiérarchie des objets d'application. Se reporter à À propos des fichiers de charge de travail.

  2. Selon la charge de travail, l'une des étapes suivantes se produit :

    • Si les snapshots sont activés pour la sauvegarde :

      • Le fichier de charge de travail possède un ID de snapshot mentionné avant la hiérarchie des objets d'application.

      • Le processus de sauvegarde utilise l'ID de snapshot (snapname) pour remplacer (résoudre) les chemins d'accès aux objets (realpath) par les chemins d'accès réels (snappath) afin de faire référence à un chemin d'accès valide à l'objet. Pour cela, le processus de sauvegarde appelle l'API aapi_get_snappath_from_realpath pour chaque objet.

      • Ensuite, le processus de sauvegarde utilise le chemin d'accès réel pour obtenir les informations de propriétés d'objet à l'aide de l'API aapi_get_object_prop_byname. Le processus de sauvegarde stocke les informations de propriétés d'objet dans le catalogue NetBackup sur le serveur maître. Les informations qui sont enregistrées dans le catalogue sont utilisées pendant la restauration.

    • Si les snapshots sont activés pour la sauvegarde, le fichier de charge de travail possède un identifiant de snapshot qui est mentionné avant la hiérarchie des objets d'application.

      Le processus de sauvegarde utilise l'identifiant de snapshot (snapname) pour remplacer (résoudre) les chemins d'accès aux objets (realpath) par les chemins d'accès réels (snappath) afin de faire référence à un chemin d'accès valide à l'objet. Pour cela, le processus de sauvegarde appelle l'API aapi_get_snappath_from_realpath pour chaque objet. Ensuite, le processus de sauvegarde utilise le chemin d'accès réel pour obtenir les informations de propriétés d'objet à l'aide de l'API aapi_get_object_prop_byname implémentée par le plug-in. Le processus de sauvegarde stocke les informations de propriétés d'objet dans le catalogue NetBackup sur le serveur maître à des fins diverses.

  3. Le processus de sauvegarde appelle l'API aapi_open_object pour ouvrir l'objet en utilisant le chemin d'accès réel.

  4. En cas de réussite, les données qui sont représentées par l'objet sont lues en appelant de manière itérative l'API aapi_read_object.

  5. Les données qui sont lues sont envoyées au serveur de médias pour le transfert de données.

  6. Lorsque la lecture est terminée, l'objet est fermé en appelant l'API aapi_close_object.

API et processus relatifs

Pendant la phase de sauvegarde, 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 bpbkar exécute la sauvegarde sur tous les hôtes de sauvegarde.

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

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

Phase

Appels d'API

Référence de l'exemple d'API

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 sauvegarde

  1. aapi_get_snappath_from_realpath

  2. aapi_get_object_prop_byname

  3. aapi_open_object

  4. aapi_read_object

  5. aapi_close_object

  1. samplepgn_get_snappath_from_realpath_v1

  2. samplepgn_get_object_prop_byname_v1

  3. samplepgn_open_object_v1

  4. samplepgn_read_object_v1

  5. 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 sauvegarde avec Parallel Streaming Framework.

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