Search <book_title>...

Guide de l'administrateur NetBackup™ for VMware

Last Published: 2023-01-17

Product(s): NetBackup (10.1.1)

Fichier de restauration de disque de la machine virtuelle VMware

Cette rubrique décrit les paramètres utilisés par NetBackup pour restaurer un ou des disques de machine virtuelle. NetBackup requiert que les paramètres soient décrits dans un fichier texte qui utilise le format JavaScript Object Notation (JSON). La commande NetBackup nbrestorevm lit le fichier pour obtenir les informations nécessaires concernant les disques de machine virtuelle. NetBackup n'a aucune condition requise pour le nom de fichier autre que celles imposées par le système d'exploitation.

Vous pouvez utiliser la commande nbrestorevm pour générer le fichier à partir d'une sauvegarde existante. La manière de procéder est décrites dans une rubrique différente.

Se reporter à Création du fichier de restauration de disque de machine virtuelle VMware.

Voici un exemple de modèle du fichier requis :

{
  "ClientType": "VMware",
  "ClientName": "VM-client-name",
  "RestoreType": "SelectiveDiskRestore",
  "BackupImageSelection": {
    "PrimaryServer": "Primary-server-name",
    "StartDate": "mm/dd/yy hh:mm:ss",
    "EndDate": "mm/dd/yy hh:mm:ss",
    "BackupId": "clientname_timestamp"
  },
  "VMwareRestoreParameters": {
    "vCenterServer": "vCenter-name-for-restore",
    "VMwareRecoveryHost": "Recovery-host-name",
    "DefaultDiskProvisioning": "thin",
    "TransportMode": "san:hotadd:nbd",
    "vmdk_compression": "none",
    "VMwareVirtualMachineDestination": {
      "VMName": "Restore-vm-name",
      "AttachDisksToExistingVM": "No",
      "PowerOn": "No",
      "Datacenter": "Path-of-Datacenter-for-destination-vm",
      "ESX": "Hostname-of-the-ESX-host",
      "Folder": "Path-to-destination-VM-folder",
      "ResourcePool/Vapp": "Path-of-vApp-or-resource-pool-destination",
      "VmxDatastore": ""
    },
    "VMwareVirtualDiskDestination": [
      {
         "VirtualDisk" : "/DS1/BackedupVM/BackedupVM.vmdk",
         "OverwriteExistingDisk": "No",
         "Datastore": "[Datastore-name]",
         "Path": "",
         "Provisioning": "thin"
         "Controller": "scsi0-0"     
      },
      {
         "VirtualDisk": "/DS2/BackedupVM/BackedupVM_1.vmdk",
         "OverwriteExistingDisk": "No",
         "Datastore": "",
         "Path": "[datastore_name] MyVm/MyVM_1.vmdk",
         "Provisioning": "eagerzeroed"
         "Controller": "scsi0-1"
      }
    ]
    "VMwareAdvancedRestoreOptions": {
      "DeleteRestoredVMOnError": "No",
      "VMShutdownWaitSeconds": 900
    }
  }
}

Voici un exemple de fichier requis pour la restauration de disque sur place :

{
  "BackupImageSelection": {
    "StartDate": "mm/dd/yy hh:mm:ss",
    "BackupId": "clientname_timestamp"
    "EndDate": "mm/dd/yy hh:mm:ss",
    "PrimaryServer": "Primary-server-name",
  },
  "ClientName": "VM-client-name",
  "VMwareRestoreParameters": {
    "vmdk_compression": "none",
    "VMwareAdvancedRestoreOptions": {
      "VMShutdownWaitSeconds": 900,
      "DeleteRestoredVMOnError": "No"
    },
    "VMwareRecoveryHost": "VM-recovery-host-name",
    "VMwareVirtualMachineDestination": {
      "ResourcePool/Vapp": "Path-of-vApp-or-resource-pool-destination",
      "VmxDatastore": "Vmx-datastore-name",
      "Datacenter": "Path-of-Datacenter-for-destination-vm",
      "AttachDisksToExistingVM": "DeleteAllDisksAndReplace",
      "ESX": "Hostname-of-the-ESX-host",
      "VMName": "Restore-vm-name",
      "Folder": "Path-to-destination-VM-folder",
      "PowerOn": "Yes"
    },
    "DefaultDiskProvisioning": "unknown",
    "TransportMode": "nbdssl",
    "VMwareVirtualDiskDestination": [],
    "vCenterServer": "vCenter-name-for-restore"
  },
  "ClientType": "VMware",
  "RestoreType": "SelectiveDiskRestore"
}

Les sous-sections suivantes décrivent les paramètres dans le fichier. Les sections ou champs facultatifs que vous ne désirez pas utiliser doivent être omis du fichier.

Se reporter à À propos de la restauration de disque de machine virtuelle VMware.

Champs globaux

La première section du fichier spécifie les informations requises concernant le client qui contient les disques que vous souhaitez restaurer. Le tableau suivant décrit les champs dans la première section globale :

Tableau : Champs globaux (requis)

Nom de champ	Description	Requis ?
ClientType	Type de client tel que configuré dans la politique de sauvegarde. Pour la restauration de disque de machine virtuelle VMware, utilisez VMware.	Requis.
ClientName	Nom du client tel que configuré dans la politique de sauvegarde.	Requis.
RestoreType	Type de restauration. Pour la restauration d'un disque de machine virtuelle VMware, utilisez SelectiveDiskRestore.	Requis.

BackupImageSelection

La section BackupImageSelection du fichier spécifie les informations requises par NetBackup pour identifier l'image de sauvegarde à restaurer. Si cette section n'est pas spécifiée, NetBackup restaure la sauvegarde la plus récente. Le tableau suivant décrit les champs dans la section BackupImageSelection :

Tableau : Section BackupImageSelection (facultatif)

Nom de champ	Description	Requis ?
PrimaryServer	Nom de domaine complet du serveur principal NetBackup à utiliser pour des requêtes sur les détails de machine virtuelle. S'il n'est pas spécifié, NetBackup utilise le serveur principal qui sauvegarde la machine virtuelle.	Facultatif.
StartDate	Date de début de la recherche des images de sauvegarde, au format mm/jj/aahh:mm:ss. Si plus d'une image de sauvegarde existe dans la plage de dates, NetBackup sélectionne la sauvegarde la plus récente. Si non spécifiée, la date de début est située 6 mois avant la date actuelle.	Facultatif.
EndDate	La date de fin de la recherche d'images de sauvegarde, au format mm/jj/aahh:mm:ss. Si plus d'une image de sauvegarde existe dans la plage de dates, NetBackup sélectionne la sauvegarde la plus récente. Si non spécifiée, NetBackup utilise la date du jour.	Facultatif.
BackupId	L'ID de l'image de sauvegarde à utiliser pour la restauration, au format clientname_backuptime. *backuptime* correspond au nombre décimal de secondes depuis le 1er janvier 1970. Si non spécifiée, NetBackup utilise l'image de sauvegarde la plus récente. Si vous spécifiez des valeurs valides pour StartDate, EndDate et BackupId, NetBackup restaure à partir de l'image BackupId.	Facultatif.

VMwareRestoreParameters

La section VMwareRestoreParameters du fichier contient ce qui suit :

Paramètres de restauration de la machine virtuelle. Tous les champs de cette section sont facultatifs ; cependant, la section est requise parce qu'elle contient deux sous-sections requises. Voir Tableau : Section VMwareRestoreParameters (requise).
Une sous-section VMwareVirtualMachineDestination, qui spécifie les paramètres de destination pour la restauration.
Se reporter à VMwareVirtualMachineDestination.
Une sous-section VMwareVirtualDiskDestination, qui spécifie les disques à restaurer et les paramètres de restauration pour ces disques.
Se reporter à VMwareVirtualDiskDestination.
Une sous-section VMwareAdvancedRestoreOptionsVMwareAdvancedRestoreOptions
Se reporter à VMwareAdvancedRestoreOptions.

Tableau : Section VMwareRestoreParameters (requise)

Nom de champ	Description	Requis ?
vCenterServer	Nom de l'hôte de la destination vCenter pour la restauration, au même format que spécifié dans les informations d'authentification du serveur virtuel NetBackup. Pour restaurer sur un hyperviseur ESXi autonome lorsque la sauvegarde a été effectuée via un vCenter, la valeur de ce champ doit être None (Aucun).	Facultatif.
VMwareRecoveryHost	Hôte qui exécute la restauration. Si non spécifié, NetBackup utilise la valeur d'hôte de sauvegarde de l'image de sauvegarde.	Facultatif.
DefaultDiskProvisioning	Allocation de disque par défaut pour tous les disques à restaurer : thin, thick, eagerzeroed, ou unknown. Pour chaque disque, vous pouvez remplacer cette valeur par défaut en spécifiant une valeur Provisioning différente dans la section VMwareVirtualDiskDestination du fichier. Si ni DefaultDiskProvisioning ni Provisioning ne sont spécifiés, NetBackup utilise le provisionnement tel que spécifié dans la sauvegarde.	Facultatif.
TransportMode	Combinaison de modes de transport à utiliser pour la restauration telle que spécifiée en minuscules, valeurs séparées par deux points : hotadd:nbd:nbdssl:san. L'ordre de la spécification est significatif : NetBackup tente chaque méthode tour à tour jusqu'à ce que la restauration fonctionne. Si toutes les méthodes échouent, la restauration est abandonnée. Si non spécifié, NetBackup utilise la combinaison de modes de transport qui a été utilisée pour la sauvegarde.	Facultatif.
vmdk_compression	Le type de compression vdmk à utiliser pour les restaurations vdmk complètes et sélectives. Les types de compression vdmk sont les suivants : zlib, skipz et fastlz. Si aucune valeur n'est spécifiée, NetBackup utilise la valeur none.	Facultatif.

VMwareVirtualMachineDestination

La section VMwareVirtualMachineDestination du fichier spécifie les paramètres de destination pour la restauration. Le tableau suivant décrit les champs dans la section VMwareVirtualMachineDestination. Cette section est subordonnée à la section VMwareRestoreParameters.

Tableau : Section VMwareVirtualMachineDestination (requis)

Nom de champ	Description	Requis ?
VMName	Nom d'affichage unique de la nouvelle machine virtuelle pour le ou les disques restaurés. La commande nbrestorevm ajoute un horodatage au nom du client de machine virtuelle d'origine lorsqu'elle renseigne ce champ. L'horodatage est le nombre décimal de secondes depuis le 1er janvier 1970. NetBackup restaure les disques de machine virtuelle sur une nouvelle machine virtuelle. Par conséquent, si ce nom entre en conflit avec un nom affiché existant, la restauration échoue.	Requis.
AttachDisksToExistingVM	Pour restaurer les VMDK sélectionnés vers une machine virtuelle existante ou une nouvelle machine virtuelle : Si la valeur est Yes, la machine virtuelle spécifiée dans le champ VMName doit exister dans le vCenter cible ou le serveur ESX. Si elle n'existe pas, la restauration échoue avec le code d'état 2820. Si la valeur est No, la machine virtuelle spécifiée dans le champ VMName ne doit pas exister dans le vCenter cible ou le serveur ESX. Si elle existe, la restauration échoue avec le code d'état 2820. Si la valeur est DeleteAllDisksAndReplace, la machine virtuelle spécifiée dans le champ VMName doit exister dans le vCenter cible ou le serveur ESX. Si elle n'existe pas, la restauration échoue avec le code d'état 2820. La valeur par défaut est No.	Requis.
PowerOn	Pour mettre sous tension la machine virtuelle cible après la restauration : Si la valeur est Yes, la machine virtuelle cible est mise sous tension à la fin d'une restauration réussie. Si la valeur est No , la machine virtuelle cible n'est pas allumée après la restauration. Si la restauration est effectuée sur une machine virtuelle existante, celle-ci est éteinte avant la connexion des disques virtuels à la machine virtuelle et avant la restauration. La valeur par défaut est No.	Requis.
Datacenter	Nom du datacenter VMware pour le disque virtuel, sous forme de nom de chemin d'accès. Pour restaurer sur un hyperviseur ESXi autonome lorsque la sauvegarde a été effectuée via un vCenter, la valeur de ce champ doit être None (Aucun). Si non spécifié, NetBackup utilise la valeur de la sauvegarde.	Facultatif.
ESX	Nom de l'hôte ESX sur lequel NetBackup doit restaurer les disques de machine virtuelle. Si non spécifié, NetBackup utilise la valeur de la sauvegarde.	Facultatif.
Folder	Nom de chemin d'accès du dossier de machine virtuelle dans lequel NetBackup doit restaurer les disques de machine virtuelle. Pour restaurer sur un hyperviseur ESXi autonome lorsque la sauvegarde a été effectuée via un vCenter, la valeur de ce champ doit être None (Aucun). Si non spécifié, NetBackup utilise la valeur de la sauvegarde.	Facultatif.
ResourcePool/Vapp	Nom de chemin d'accès du pool de ressources sur lequel NetBackup doit restaurer les disques de machine virtuelle. Si la restauration s'effectue vers une vApp, précisez le chemin d'accès de la vApp. Si non spécifié, NetBackup utilise la valeur de la sauvegarde.	Facultatif.
VmxDatastore	Le nom du Datastore (Stockage de données) sur lequel NetBackup doit restaurer le fichier de configuration .vmx et d'autres fichiers de configuration de machine virtuelle. Vous pouvez entourer le nom de crochets mais ce n'est pas une obligation. Si non spécifié, NetBackup utilise la valeur de la sauvegarde.	Facultatif.
DefaultDiskDatastore	Le nom du Datastore (Stockage de données) sur lequel NetBackup doit restaurer tous les disques virtuels pour la restauration de disque sur place. Si non spécifié, NetBackup utilise la valeur de la sauvegarde. Cette option est uniquement utilisée pour la restauration de disque sur place.	Facultatif.

VMwareVirtualDiskDestination

La section VMwareVirtualDiskDestination du fichier est une baie JSON qui spécifie les disques à restaurer et les paramètres de restauration pour ces disques. Elle peut contenir un ou plusieurs ensembles des champs décrits dans le tableau suivant (un ensemble par disque de machine virtuelle). Une virgule doit séparer les champs dans un ensemble, et une virgule doit séparer les ensembles. Cette section est subordonnée à la section VMwareRestoreParameters.

Remarque :

Cette section ne s'applique pas aux restaurations de disque sur place.

Tableau : Section VMwareVirtualDiskDestination (requis)

Nom de champ	Description	Requis ?
VirtualDisk	Chemin d'accès complet du disque virtuel à restaurer. Ce chemin d'accès doit correspondre exactement au chemin d'accès du fichier .vmdk lorsqu'il a été sauvegardé.	Requis.
OverwriteExistingDisk	Pour remplacer le disque virtuel existant ou les disques sur la machine virtuelle cible : Si la valeur est Yes, remplacez le disque virtuel d'origine et conservez le disque UUID. Si la valeur est No, restaurez le disque virtuel sur la machine virtuelle cible en tant que nouveau disque. VMware affecte un nouvel UUID au disque. La valeur par défaut est No.	Requis.
Datastore	Nom du Datastore (stockage de données) qui est la destination de la restauration. Vous pouvez entourer le nom de crochets mais ce n'est pas une obligation. (VMware génère le chemin d'accès du Datastore en respectant les conventions de dénomination pour la machine virtuelle.) Pour une restauration de disques virtuels sur un cluster de stockage de données, spécifiez le nom du cluster de stockage de données dans ce champ. Si non spécifié, NetBackup utilise la valeur qui est spécifiée dans le champ Path. Si ni Datastore ni Path ne sont spécifiés, NetBackup utilise le Datastore de l'image de sauvegarde.	Facultatif.
Path	Le chemin d'accès complet de la destination de restauration pour le disque virtuel, au format suivant : *[datastore_name] MyVM/MyVM.vmdk* L'option nbrestorevm-restorespecout ne remplit pas le champ Path. Si vous spécifiez l'option Path et que le chemin n'est pas disponible ou qu'un disque existe déjà à cet emplacement, la restauration échouera. Si aucun Datastore ou Path ne sont spécifiés, NetBackup utilise le Datastore de l'image de sauvegarde. Si un nom vmdk spécifique n'est pas requis, Veritas recommande que vous laissiez ce champ vide.	Facultatif.
Provisioning	Allocation de disque pour ce disque spécifique : thin, thick, eagerzeroed, ou unknown. Si non spécifié, NetBackup utilise la valeur DefaultDiskProvisioning.	Facultatif.
Controller	Contrôleur de disque virtuel auquel le disque est attaché dans la machine virtuelle d'origine. Ce champ est informationnel uniquement pour vous aider à déterminer le ou les disques virtuels qui doivent être restaurés. La valeur n'est pas utilisée pendant une restauration.	Facultatif

VMwareAdvancedRestoreOptions

La section VMwareAdvancedRestoreOptions du fichier spécifie les paramètres pour effectuer une restauration sur une machine virtuelle existante. Cette section est subordonnée à la section VMwareRestoreParameters.

Tableau : Section VMwareAdvancedRestoreOptions (facultatif)

Nom de champ	Description	Requis ?
DeleteRestoredVMOnError	NetBackup crée une machine virtuelle temporaire pendant le processus de restauration, puis attache les disques virtuels à la machine virtuelle cible. La valeur de ce paramètre détermine si NetBackup supprime la machine virtuelle temporaire si l'opération qui relie le disque échoue, comme suit : Si la valeur est Yes, supprimez la machine virtuelle temporaire. Si la valeur est No, ne supprimez pas la machine virtuelle temporaire. Si les disques ne sont pas correctement connectés à la machine virtuelle cible, vous pouvez accéder aux données sur la machine virtuelle temporaire. La valeur par défaut est No.	Facultatif.
VMShutdownWaitSeconds	Pour les restaurations pour une machine virtuelle existante, le processus de restauration arrête la machine virtuelle cible avant qu'elle attache le ou les disques. La durée de l'opération d'arrêt dépend de la charge de VMware. Ce paramètre permet de spécifier combien de temps le processus de restauration doit attendre l'arrêt avant d'abandonner la restauration. La valeur par défaut est 900 secondes (15 minutes).	Facultatif.

Nom de champ

Description

Requis ?

DeleteRestoredVMOnError

NetBackup crée une machine virtuelle temporaire pendant le processus de restauration, puis attache les disques virtuels à la machine virtuelle cible. La valeur de ce paramètre détermine si NetBackup supprime la machine virtuelle temporaire si l'opération qui relie le disque échoue, comme suit :

Si la valeur est Yes, supprimez la machine virtuelle temporaire.
Si la valeur est No, ne supprimez pas la machine virtuelle temporaire. Si les disques ne sont pas correctement connectés à la machine virtuelle cible, vous pouvez accéder aux données sur la machine virtuelle temporaire.

La valeur par défaut est No.

Facultatif.

VMShutdownWaitSeconds

Pour les restaurations pour une machine virtuelle existante, le processus de restauration arrête la machine virtuelle cible avant qu'elle attache le ou les disques. La durée de l'opération d'arrêt dépend de la charge de VMware. Ce paramètre permet de spécifier combien de temps le processus de restauration doit attendre l'arrêt avant d'abandonner la restauration.

La valeur par défaut est 900 secondes (15 minutes).

Facultatif.