NetBackup™ Commands Reference Guide

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 clientname_backuptime. 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 le numéro de copie à restaurer à partir d'une opération de restauration vSphere. Cette option permet une restauration à partir d'une copie autre que la copie principale. Par exemple, -copy 3 restaure la copie 3 de l'image de sauvegarde.

Cette option est uniquement prise en charge pour une sauvegarde complète d'une machine virtuelle VMware. Si le numéro de copie spécifié n'existe pas, la copie principale est utilisée.

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

Cette option est utile si le stockage 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ée 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.

ir_identifier 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 dans la combinaison hôte ESX et serveur de médias NetBackup.

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

Seuls les chemins d'accès par défaut sont autorisés pour cette option, et Veritas 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, ajoutez 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\user_ops\proglog

Pour plus d'informations sur l'ajout d'un chemin d'accès personnalisé, consultez la section relative à l'option BPCD_ALLOWED_PATH pour les serveurs et clients NetBackup dans le 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 des fichiers de format des disques de machine virtuelle (VMDK) qui appartiennent explicitement à la VM existante. 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
change storagepolicy[/first_vmdk_path] to NEW_STORAGEPOLICY
change storagepolicy[/second_vmdk_path] to NEW_STORAGEPOLICY
...
change storagepolicy[/n'th_vmdk_path] to NEW_STORAGEPOLICY
change storagepolicy to NEW_STORAGEPOLICY
change vmhome_storagepolicy to NEW_STORAGEPOLICY

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, ajoutez 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 relative à l'option BPCD_ALLOWED_PATH pour les serveurs et clients NetBackup dans le Guide de l'administrateur NetBackup, Volume I.

Crée une nouvelle machine virtuelle et restaure le client NetBackup et les disques que vous spécifiez dans le filename sur la nouvelle machine virtuelle. Un cas spécial appelé Restauration de disque sur place permet de remplacer tous les disques d'une machine virtuelle existante par les données de sa sauvegarde. Les disques RDM et indépendants ne sont pas remplacés ni supprimés. Dans le cas d'une restauration de disque sur place, les disques sont restaurés vers la configuration du contrôleur de disque qui est acquise au moment de la sauvegarde. Le filename est un fichier texte qui utilise le format JavaScript Object Notation (JSON)

Le codage de caractères UTF-8 doit être appliqué au fichier texte.

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
    }
  }
}

Vous trouverez ci-dessous un exemple des paramètres de restauration requis par l'option -restorespec pour la restauration de disque sur place.

{
  "BackupImageSelection": {
    "StartDate": "05/03/20 21:50:34",
    "BackupId": "bptesx60l-19vm1.rmnus.sen.symantec.com_1588560634",
    "EndDate": "05/03/20 21:50:34",
    "MasterServer": "bptms-lnr73-0029"
  },
  "ClientName": "bptesx60l-19vm1.rmnus.sen.symantec.com",
  "VMwareRestoreParameters": {
    "vmdk_compression": "none",
    "VMwareAdvancedRestoreOptions": {
      "VMShutdownWaitSeconds": 900,
      "DeleteRestoredVMOnError": "No"
    },
    "VMwareRecoveryHost": "bptms-lnr73-0029",
    "VMwareVirtualMachineDestination": {
      "ResourcePool/Vapp": "/New Datacenter/host/Test01/Resources",
      "VmxDatastore": "datastore1",
      "Datacenter": "/New Datacenter",
      "AttachDisksToExistingVM": "DeleteAllDisksAndReplace",
      "ESX": "bptesx60l-19.rmnus.sen.symantec.com",
      "VMName": "bptesx60l-19vm1",
      "Folder": "/New Datacenter/vm/",
      "PowerOn": "Yes"
    },
    "DefaultDiskProvisioning": "unknown",
    "TransportMode": "nbdssl",
    "VMwareVirtualDiskDestination": [],
    "vCenterServer": "bptesx60l-19vc"
  },
  "ClientType": "VMware",
  "RestoreType": "SelectiveDiskRestore"
}

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

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

Seconde section (facultative) : la section BackupImageSelection de filename 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 filename 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 sont ceux sui décrivent la VMwareRestoreParameters :

Quatrième Section (Requis): La sectionVMwareVirtualMachineDestination de filename 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 (requise, excepté lorsque le paramètre VMwareVirtualDestinationAttachDisksToExistingVM est DeleteAllDisksAndReplace. Si cette option est requise pour la restauration de disque sur place, la validation de la restauration échoue. La section VMwareVirtualDiskDestination de filename est une baie qui spécifie les disques à restaurer et leurs paramètres de restauration. 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 VMwareVirtualDiskDestination 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 à filename. Ce chemin d'accès doit figurer dans la liste des chemins d'accès autorisés de NetBackup.

Pour plus d'informations sur l'ajout d'un chemin d'accès personnalisé, consultez la section relative à l'option BPCD_ALLOWED_PATH pour les serveurs et clients NetBackup dans le Guide de l'administrateur 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 n'utilisiez plus 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 filename. L'option -restorespec est requise, et elle doit suivre l'option -validate.

Pour une description de filename, 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=value. 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'UUID de l'instance de la machine virtuelle initiale (à noter que l'UUID d'instance est un identifiant vCenter unique spécifique d'une machine virtuelle). La machine virtuelle est restaurée avec le même UUID d'instance que celui 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ère de nouveaux UUID de disque de machine virtuelle lors d'une récupération instantanée. Utilisez cette option avec l'option - ir_activate.

Les machines virtuelles qui sont activées avec cette option ne conservent pas le nouvel UUID vmdk lors de l'opération - ir_reactivate suivante. 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 l'image de sauvegarde d'une 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 vCenter sur lequel se trouvait la machine virtuelle à l'origine, omettez cette option.

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

Élimine les balises VMware de la restauration.

Élimine les politiques de stockage de la machine virtuelle 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.

Force NetBackup à attendre 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. Le fichier /user/openv/msg/.conf (UNIX) et le fichier install_path\VERITAS\msg\LC.CONF (Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux 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 le temps d'attente expire avant la fin de la restauration, 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.