Guide du kit de développement logiciel Veritas NetBackup Parallel Streaming Framework pour développeurs
- Protection de vos charges de travail à l'aide de NetBackup Parallel Streaming Framework
- Architecture du plug-in NetBackup Parallel Streaming Framework
- Déploiement du kit de développement logiciel NetBackup Parallel Streaming Framework
- Compatibilité des systèmes d'exploitation et des plates-formes
- Licence pour le kit de développement logiciel NetBackup Parallel Streaming Framework
- Téléchargement du kit de développement logiciel NetBackup Parallel Streaming Framework
- Installation du kit de développement logiciel NetBackup Parallel Streaming Framework
- Préparation pour le développement du plug-in
- Préparation de votre environnement NetBackup
- Gestion des hôtes de sauvegarde
- Création d'une politique de sauvegarde BigData
- Gestion du mécanisme d'authentification
- Ajout des informations d'authentification de charge de travail dans NetBackup
- Considérations sur la sécurité
- Certification requise pour rendre le plug-in disponible
- Utilisation d'un exemple de plug-in
- Développement du plug-in de charge de travail
- À propos des phases de développement du plug-in
- À propos de la phase d'initialisation du plug-in
- À propos de la phase de demande du plug-in
- À propos de la phase de déchargement du plug-in
- À propos de la phase de découverte de la charge de travail
- À propos de la phase de sauvegarde des données
- À propos de la phase de restauration
- À propos de la phase de récupération
- Gestion de l'heure d'exécution d'une API
- Vérification et test du plug-in au cours du développement
- Mise en package du plug-in de charge de travail
- Déploiement du plug-in de charge de travail
- Références de l'API NetBackup Parallel Streaming Framework
- aapi_close_object
- aapi_close_server
- aapi_create_object
- aapi_delete_object
- aapi_discovery
- aapi_flush
- aapi_get_object_prop
- aapi_get_object_prop_byname
- aapi_get_server_prop
- aapi_get_snappath_from_realpath
- aapi_open_object
- aapi_open_server
- aapi_pgn_claim
- aapi_pgn_init
- aapi_postprocess
- aapi_read_object
- aapi_set_object_utimes
- aapi_terminate
- aapi_write_object
- aapi_restore_preprocess
- aapi_restore_postprocess
- Valeurs de retour de l'API NetBackup Parallel Streaming Framework
- Consignation et dépannage
À propos des fichiers de charge de travail
Le plug-in crée un fichier de charge de travail pour chaque hôte de sauvegarde après le processus de découverte. Le fichier de charge de travail pour chaque hôte de sauvegarde doit contenir les informations instantanées du travail de sauvegarde associé. Des nouveaux fichiers de charge de travail doivent être créés pour chaque sauvegarde. Les fichiers de charge de travail utilisent les ID de snapshot (si les snapshots sont activés pour la sauvegarde) et la hiérarchie des objets d'application représentant les données à sauvegarder.
Le fichier de charge de travail a un format binaire et la structure est prédéfinie. Cependant, la hiérarchie des objets d'application est propre à la charge de travail. Voici la structure du fichier de charge de travail :
snapshot_name_length (uint64) snapshot_name objects_path-1_length (uint 64) object_path-1 objects_path-2_length (uint 64) object_path-2 objects_path-n_length (uint 64) object_path-n
Voici un exemple du contenu d'un fichier de charge de travail :
50 snapshot_name=snapshot1_06-05-2015_18:08:25.048027 4 /vm1 (object path is maintained in the catalog) 11 /vm1/vdisk1 (object path is maintained in the catalog) 11 /vm1/vdisk2 (object path is maintained in the catalog) 4 /vm2 (object path is maintained in the catalog) 11 /vm2/vdisk1 (object path is maintained in the catalog)
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.
Par exemple, lorsque NetBackup sauvegarde l'objet /vm1/vdisk1 avec l'ID de snapshot snapshot1_06-05-2018_18:08:25.048027, le processus de sauvegarde effectue les actions suivantes :
Il appelle l'API aapi_get_snappath_from_realpath avec le nom du snapshot, snapshot1_06-05-2018_18:08:25.048027, et le chemin d'accès à l'objet, /vm1/vdisk1, pour obtenir le chemin réel (snappath)
Il obtient le chemin d'accès réel, /snapshot1_06-05-2018_18:08:25.048027/vm2/vdisk1, qui peut être utilisé pour ouvrir et lire l'objet de disque.
Il appelle aapi_open_object pour ouvrir l'objet de disque avec le chemin réel (snappath), /snapshot1_06-05-2018_18:08:25.048027/vm2/vdisk1, et renvoie à un chemin d'accès valide à l'objet /vm1/vdisk1
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 enregistrées dans le catalogue sont utilisées pendant la restauration.
Lorsque la création de snapshots n'est pas prise en charge par le plug-in, le processus de sauvegarde traite les chemins d'accès aux objets mentionnés dans le fichier de charge de travail en tant que chemins d'accès réels et les utilise pour interroger les informations de propriété d'objet à l'aide de l'API aapi_get_object_prop_byname.
Le fichier de charge de travail est créé à l'emplacement suivant :
/chemin_installation/tmp/serveur_maître/serveur_médias/hôte_sauvegarde/nom_politique/type_appli
Remarque :
Pour sécuriser le fichier de charge de travail lors de sa création, définissez les listes de contrôle d'accès avec des autorisations de niveau racine uniquement.
Si nécessaire, le développeur du plug-in peut personnaliser l'ID de snapshot. Lorsque vous utilisez un ID de snapshot personnalisé, il est remplacé par l'ID de snapshot généré par NetBackup dans les fichiers de charge de travail. Cependant, pendant le processus de post-traitement, seul l'ID de snapshot d'origine fourni par NetBackup est utilisé. En tant que développeur, vous devez donc gérer le mappage des ID de snapshot d'origine et personnalisé.
En outre, lorsque vous utilisez un ID personnalisé et à chaque fois que NetBackup Parallel Streaming Framework, demande le chemin d'accès au snapshot à partir du chemin d'accès réel, NetBackup utilise l'ID de snapshot d'origine. Par conséquent en tant que développeur, vous devez gérer le mappage entre l'ID de snapshot d'origine et l'ID de snapshot personnalisé.
En outre, lorsque NetBackup Parallel Streaming Framework demande le chemin d'accès au snapshot à partir du chemin d'accès réel, NetBackup utilise toujours l'ID de snapshot d'origine. Par conséquent en tant que développeur, lorsque vous utilisez un ID personnalisé, vous devez gérer le mappage entre l'ID de snapshot d'origine et l'ID de snapshot personnalisé, afin que le chemin d'accès au snapshot renvoyé à Parallel Streaming Framework soit le bon.