Guide de référence des commandes Veritas NetBackup™

L'identifiant de l'image de sauvegarde à utiliser pour créer le fichier de paramètres afin de restaurer un ou des disques de machines virtuelles VMware, en format nomclient_heuresauvegarde. L'heure de sauvegarde est le nombre décimal de secondes depuis le 1er janvier 1970.

Utilisez cette option avec l'option -restorespecout. Ne la combinez pas avec l'option -s ou -e.

Contacte le serveur BMR pour effectuer des tâches liées à la création d'une machine virtuelle à partir de la sauvegarde de client.

Nom de la machine virtuelle tel qu'identifié dans la sauvegarde. Par exemple, si la politique a sauvegardé la machine virtuelle sous son nom d'hôte, spécifiez ce nom d'hôte.

Pour restaurer à un emplacement différent, utilisez les options -vmserver et -R.

Spécifie le nom de la configuration BMR. Le nom par défaut est le suivant : actuel. S'applique uniquement à la conversion en machine virtuelle BMR.

Spécifie quel serveur de médias exécute la récupération instantanée.

Cette option est utile si le stockage de NetBackup est configuré sur plusieurs serveurs de médias, comme pour la répartition de charge. Sans l'option -disk_media_server, le travail de récupération instantanée peut sélectionner n'importe lequel des serveurs de médias disponibles pour effectuer la restauration. Si un seul des serveurs de médias est configuré pour la récupération instantanée, spécifiez ce serveur avec l'option -disk_media_server.

Supprime les invites de confirmation.

Démarre la récupération instantanée de la machine virtuelle spécifiée. Pour VMware, la commande monte l'image de sauvegarde en tant que stockage de données NFS. La machine virtuelle est immédiatement récupérée quand les données de machine virtuelle sont accessibles sur l'hôte de MV.

Supprime la machine virtuelle restaurée spécifié de l'hôte ESX et libère les ressources de serveur de médias NetBackup. L'option -force supprime les invites de confirmation.

Termine le travail de récupération instantanée de machine virtuelle après la migration des données. Il supprime le stockage NetBackup et libère les ressources de serveur de médias. Le stockage NetBackup est constitué du stockage de données monté sur l'hôte ESX.

Répertorie les détails relatifs aux machines virtuelles activées par la récupération instantanée.

Réactive une machine virtuelle restaurée en remontant le stockage de données NFS de NetBackup. Cette commande enregistre également les machines virtuelles restaurées sur l'hôte ESX à partir du stockage de données temporaire sur l'hôte ESX.

identifiant_ir est l'identifiant numérique de la machine virtuelle dans la sortie de la commande -ir_listvm.

L'option -force supprime les invites de confirmation.

Redémarre un travail de récupération instantanée interrompu pour toutes les machines virtuelles sur la combinaison hôte ESX et serveur de médias.

Spécifie le nom du fichier dans lequel les informations de progression sont enregistrées. Cette option s'applique à la restauration vSphere et à a restauration Hyper-V.

Seuls les chemins d'accès par défaut sont autorisés pour cette option. Veritas vous recommande d'utiliser les chemins d'accès par défaut. Si vous ne pouvez pas utiliser le chemin d'accès par défaut de NetBackup dans votre configuration, vous devez ajouter des chemins d'accès personnalisés à la configuration de NetBackup. Les chemins d'accès par défaut sont les suivants.

Systèmes UNIX : /usr/openv/netbackup/logs/user_ops/proglog

Systèmes Windows : install_path\NetBackup\logs\bplist\*.log

Pour plus d'informations sur l'ajout d'un chemin d'accès personnalisé, consultez la section "Option BPCD_WHITELIST_PATH pour les serveurs et clients NetBackup" du Guide de l'administrateur NetBackup, volume I.

Cette option spécifie le serveur de médias sur lequel ont été montés les stockages de données NFS qui contiennent les images de sauvegarde quand vous réactivez des machines virtuelles. Cette option est uniquement utilisée avec la fonction -ir_reactivate_all.

Écrase les machines virtuelles et les ressources associées si elles existent déjà avec le même nom. Les ressources sont des entités telles que les fichiers de format des disques de machine virtuelle (VMDK) qui appartiennent explicitement au VM existant. Si -O est spécifié, le serveur VMware doit supprimer la machine virtuelle avant qu'il soit restauré. Si cette option n'est pas spécifiée, la restauration peut échouer. Cette option est utilisée avec les restaurations VClient et Hyper-V et avec la conversion en machine virtuelle BMR.

Spécifie un chemin d'accès au répertoire absolu à un fichier de nouveau nom, qui est utilisé pour restaurer une machine virtuelle VMware. Le fichier de nouveau nom indique que la restauration doit être redirigée vers un emplacement alternatif et spécifie des détails sur l'emplacement alternatif du client. Pour VMware, le fichier de nouveau nom peut inclure l'une des entrées suivantes :

change /first_vmdk_path to /new_first_vmdk_path 
change /second_vmdk_path to /new_second_vmdk_path 
...
change /n'th_vmdk_path to /new_nth_vmdk_path 
change vmname to NEW_VM_NAME 
change esxhost to NEW_ESX_HOST 
change datacenter to NEW_DATACENTER 
change folder to NEW_FOLDER 
change resourcepool to NEW_RESOURCEPOOL 
change datastore to NEW_DATASTORE 
change network to NEW_NETWORK
change organization to NEW_ORGANIZATION
change orgvdc to NEW_ORGVDC
change vcdserver to NEW_VCDSERVER
change vcdvapp to NEW_VCDVAPP
change vcdvapptemplate to NEW_VCDVAPPTEMPLATE
change vcdvmname to NEW_VCDVMNAME
change vcdcatalog to NEW_VCDCATALOG

La récupération instantanée utilise le sous-ensemble suivant de cette liste :

change vmname to NEW_VM_NAME
change esxhost to NEW_ESX_HOST
change resourcepool to NEW_RESOURCEPOOL
change network to NEW_NETWORK

Les remarques suivantes concernent ces entrées :

Avec NetBackup 7.7.2 et les versions ultérieures, seuls les chemins d'accès par défaut sont autorisés pour cette option. Veritas vous recommande d'utiliser les chemins d'accès par défaut. Si vous ne pouvez pas utiliser le chemin d'accès par défaut de NetBackup dans votre configuration, vous devez ajouter des chemins d'accès personnalisés à la configuration de NetBackup.

Pour plus d'informations sur l'ajout d'un chemin d'accès personnalisé, consultez la section "Option BPCD_WHITELIST_PATH pour les serveurs et clients NetBackup" du Guide de l'administrateur NetBackup, volume I.

Créée ue nouvelle machine virtuelle et restaure le client et les disques NetBackup que vous spécifiez dans le nom_fichier sur la nouvelle VM. Le nom_fichier est un fichier texte qui utilise le format JavaScript Object Notation (JSON)

Le fichier texte doit être dans le codage de caractères UTF-8.

Vous pouvez utiliser l'option -restorespecout pour créer le fichier texte formaté JSON. Vous pouvez modifier le fichier texte afin qu'il contienne uniquement les disques de machine virtuelle que vous voulez restaurer.

Ce qui suit est un exemple de paramètres de restauration que requiert l'option -restorespec.

{
  "ClientType": "VMware",
  "ClientName": "VM-client-name",
  "RestoreType": "SelectiveDiskRestore",
  "BackupImageSelection": {
    "MasterServer": "Master-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",
    "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
    }
  }
}

Les listes détaillées suivantes décrivent les cinq sections dunom_fichier. Les sections ou champs facultatifs que vous ne désirez pas utiliser doivent êtreomises dans nom_fichier.

Première Section (requis) : la section productive de nom_fichier fournit les informations requises sur le client qui contient les disques que vous désirez restaurer.

Seconde section (facultative) : la section BackupImageSelection de nom_fichier spécifie les informations requises pour identifier l'image de sauvegarde à restaurer. Si cette section n'est pas spécifiée, NetBackup restaure à partir de la sauvegarde la plus récente. Les champs suivants sont ceux sui décrivent la BackupImageSelection :

Troisième section (requise) : La section VMwareRestoreParameters du nom_fichier spécifie les attributs VMware du disque virtuel à restaurer. Tous les champs de cette section sont en facultatifs ; cependant, la sectin est requises parce qu'elle conteint deux sous-sections requises. Les champs suivants décrivent les Paramètres de restauration VMware :

Quatrième Section (Requis): La sectionDestination_VirtualMachine_VMware de nom_fichier spécifie les paramètres de restauration pour la restauration. Cette section est subordonnée à la section VMwareRestoreParameters. Il contient les champs suivants :

Cinquième section (requis) : La section Destination_VirtualDisk_VMware du nom-fichier est une matrice qui spécifie les disques à restaurer et les paramètres de restauration pour ces disques. Cette section est subordonnée à la section VMwareRestoreParameters. Elle peut contenir un ou plusieurs ensemble des champs suivants, 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.

Sixième section (facultative). La section VMwareAdvancedRestoreOptions du fichier spécifie les paramètres à restaurer sur une machine virtuelle existante. Cette section est subordonnée à la section VMwareRestoreParameters.

Spécifie le chemin d'accès du fichier dans lequel nbrestorevm écrit les paramètres du ou des disques des machines virtuelles que vous désirez restaurer. Par défaut, nbrestorevm crée le fichier dans le répertoire de travail en cours. Pour spécifier l'image de sauvegarde d'où doivent être tirés les paramètres, utilisez l'option -backupid ou les options -s et -e. Si vous spécifiez les options -s et -e, NetBackup utilise la sauvegarde la plus récente dans cette plage de dates.

Editez le fichier de sorte qu'il contienne les informations appropriées. Assurez-vous que le champ VMName contient le nom de la nouvelle VM. Assurez-vous que la section Destination_disque virtuel_VMware du fichier contient uniquement le ou les disques de la machine virtuelle que vous désirez restaurer. Utilisez le fichier édité comme fichier d'entrée pour l'option -restorespec, qui restaure le ou les disques de la machine virtuelle qui sont identifiés dans le fichier.

Par défaut, nbrestorevm crée le fichier dans le répertoire de travail en cours. Pour créer le fichier dans un autre répertoire, indiquez un nom de chemin d'accès au fichier nom_fichier. Ce chemin d'accès doit se trouver dans la liste blanche des chemins d'accès de NetBackup. Pour plus d'informations sur la procédure d'ajout d'un chemin d'accès personnalisé, consultez la rubrique « Option BPCD_WHITELIST_PATH pour les serveurs et clients NetBackup » dans le Guide de l'administrateur de NetBackup, Volume I :

Spécifie un serveur maître différent, pour restaurer une machine virtuelle à partir d'une sauvegarde qui a été faite par ce serveur maître.

Limite les images de sauvegarde sélectionnables à celles comportant des horodatages inclus dans la période spécifiée. NetBackup sélectionne la dernière image de sauvegarde appropriée située dans la plage de temps. Spécifie la date de début (-s) et la date de fin (-e) de la liste. La date de début et la date de fin délimitent la plage horaire dans laquelle rechercher une image de sauvegarde valide. La dernière image de sauvegarde valide dans la plage horaire spécifiée est utilisée pour effectuer des restaurations. Ces options sont utilisées avec toutes les fonctions, sauf la conversion en machine virtuelle BMR.

Spécifie un stockage de données temporaire sur le serveur d'hôte de machine virtuelle où se produisent tous les enregistrements jusqu'à ce que la machine virtuelle soit restaurée. Tous les enregistrements sont effectués sur ce stockage de données jusqu'à ce que le travail Storage vMotion se termine ou que vous ayez terminé d'utiliser la machine virtuelle (par exemple, dans le cadre d'un dépannage). Ce stockage de données doit exister avant que vous exécutiez la commande nbrestorevm. Cette option peut être utilisée uniquement avec l'option -ir_activate. Cette option est uniquement utilisée avec la récupération instantanée.

Valide les paramètres de restauration du disque de la machine virtuelle dans nom-fichier. L'option -restorespec est requise, et elle doit suivre l'option -validate.

Pour une description de nom-fichier, voyez la description de l'option -restorespec.

Restaure une machine virtuelle vCloud. Cette option est requise lorsque vous effectuez une restauration vers l'emplacement d'origine ou vers un autre emplacement dans vCloud.

Restaure une machine virtuelle vCloud à l'aide du stockage de données avec le plus grand espace disponible. Cette option s'applique seulement aux opérations de restauration qui ne sont pas dirigées vers l'emplacement initial.

Remplace la vApp vCloud existante.

Redirige la restauration vCloud.

Supprime la vApp si vous utilisez l'option -vcdtemplate pour enregistrer la vApp comme modèle.

Restaure une machine virtuelle vCloud sur une vApp vCloud existante. Cette option est requise quand vous restaurez vers une vApp existante comprenant une restauration de l'emplacement d'origine.

Restaure une machine virtuelle vCloud comme modèle.

Le chemin d'accès au fichier (absolu) complet contient les détails de l'environnement virtuel au format param=valeur. Un fichier veconfig contient généralement les entrées suivantes :

esxhost="bmresx.xyz.com"
name="Test_NBRestoreVM"
network="VM Network"
nbrestorediskformat="ThinVdisk"
toolsIsoPath="C:\B2V\windows_esx5.iso"
datacenter="/Test/XyzDatacenter"
folder="/Test/XyzDatacenter/vm"
resourcepool="/Test/XyzDatacenter/host/bmresx.xyz.com/Resources/resourcepoolname"
harddisk=0:"B2V_4TB"
harddisk=1:"storage1 (2)"
harddisk=2:"storage2 (1)"

Les remarques suivantes concernent ces entrées :

Le format du disque restauré sera défini sur "réinitialisé par anticipation".

Restaure les fichiers VMDK en tant que disques plats.

Spécifie l'hôte de machine virtuelle sur lequel les machines virtuelles ont été montées quand vous réactivez des machines virtuelles.

Restaure une machine virtuelle Hyper-V à l'emplacement initial.

Restaure une machine virtuelle Hyper-V à un nouvel emplacement.

Restaure une machine virtuelle Hyper-V sur un emplacement intermédiaire.

Restaure l'UUID du BIOS de la machine virtuelle au lieu d'en créer un nouveau.

Pour Vmware : Restaure l'UUID du BIOS de la machine virtuelle au lieu d'en créer un nouveau.

Pour Hyper-V : Restaure le GUID de la machine virtuelle au lieu de créer un nouveau.

Conserve l'instance UUID de la machine virtuelle initiale (à noter que l'instance UUID est un identifiant vCenter unique spécifique d'une machine virtuelle). La machine virtuelle est restaurée avec la même instance UUID qu'elle a obtenu lors de sa sauvegarde.

Si la restauration de la machine virtuelle est effectuée vers un hôte ESXi autonome, cette option est ignorée.

Si une machine virtuelle avec la même instance UUID existe à l'emplacement cible de restauration, NetBackup assigne un nouvel UUID à la machine virtuelle.

Conserve la version matérielle lors de la récupération. Cette option s'applique uniquement à la récupération de machines virtuelles VMware.

Générer de nouveaux UUID de disque de machine virtuelle pendant une récupération instantanée. Utilisez cette option avec l'option - ir_activate.

Les machines virtuelles qui s'activent avec cette option ne conservent pas le nouvel UUID vmdk pendant une opération - ir_reactivate ultérieure. Dans un tel scénario, les VMDK reprennent leurs UUID au moment de la sauvegarde.

Spécifie que vous ne voulez pas restaurer les fichiers communs lorsque vous restaurez une machine virtuelle Hyper-V.

Met automatiquement sous tension la machine virtuelle après la restauration.

Spécifie l'hôte d'accès VMware. Il remplace le VMProxy utilisé par défaut pour la sauvegarde des machines virtuelles.

Les politiques de cycle de vie du stockage (SLP) peuvent utiliser Auto Image Replication pour répliquer une image de sauvegarde de machine virtuelle vers un autre domaine NetBackup. Pour restaurer la machine virtuelle à partir de l'image répliquée, vous devez inclure l'option -vmproxy. Utilisez l'option -vmproxy pour spécifier l'hôte de sauvegarde (hôte d'accès) du domaine sur lequel la machine virtuelle a été répliquée.

Supprime tous les périphériques amovibles montés tels que les images de CD/DVD-ROM.

Spécifie un emplacement cible différent pour l'opération de restauration (par exemple, serveur ESX ou vCenter). Il remplace le serveur de la machine virtuelle utilisée par défaut pour la sauvegarde des machines virtuelles. Pour restaurer sur le même vCenter où la machine virtuelle se trouvait à l'origine, omettez cette option.

Élimine l'interface réseau de la machine virtuelle.

Elimine les balises VMware de la restauration.

Le format du disque restauré sera défini sur "dynamique".

Spécifie le mode de transport VMware. Voici un exemple de format de mode_transport_vm : san:hotadd:nbd:nbdssl.

Permet aux fichiers VMDK VMware d'être restaurés dans le stockage de données où le fichier VMX est spécifié. Un fichier de nouveau nom qui assigne un chemin d'accès au fichier vmdk différent remplace cette option.

Restaure une machine virtuelle VMware.

NetBackup attend la fin des opérations du serveur avant de vous renvoyer à l'invite système.

Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Les fichiers /usr/openv/msg/.conf (UNIX) et install_path\VERITAS\msg\LC.CONF (Windows) contiennent des informations telles que le format de date et d'heure pour chaque paramètre régional pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.

Consultez la section "Spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.

Vous pouvez éventuellement spécifier un temps d'attente en heures, minutes et secondes. Le temps d'attente maximal est de 23:59:59. Si ce temps d'attente expire avant la fin de la restauration, l'exécution de la commande se termine en indiquant un délai. cependant, la restauration du serveur se termine.

Si vous spécifiez la valeur 0 (zéro) ou si vous ne spécifiez aucune valeur, le temps d'attente de la fin de l'exécution de la commande est indéfini.