Restore notes and restrictions

Article:HOWTO70889  |  Created: 2012-02-08  |  Updated: 2013-10-02  |  Article URL
Article Type
How To


Restore notes and restrictions

This topic is about restores from a NetBackup backup of a VMware virtual machine.

Before you begin the restore, note the following:

  • Cross-platform restore of individual files is not supported. You can restore Windows files to Windows guest operating systems but not to Linux. You can restore Linux files to supported Linux guest operating systems but not to Windows. In other words, the restore host must be the same platform as the files that you want to restore.

    See About restore of individual files.

  • Unless a NetBackup client is installed on the virtual machine, you must do the restore from the NetBackup master server.

  • To restore files to the original virtual machine location, the destination must be specified as the virtual machine's host name (not display name or UUID).

  • To restore directly to an ESX server, the name that is specified for the restore must match the ESX server's official host name. The name must be in the same format in which it is registered in DNS and in the VMware server (whether short or fully-qualified).

    See Adding NetBackup credentials for VMware.

  • The restore fails if ESX servers are configured with short host names and the backup and restore are done through a vCenter server.

    See The restore fails if ESX servers use short host names and backups and restores use a vCenter server.

  • A virtual machine template cannot be restored to a standalone ESX server. Because templates are a feature of vCenter servers, you must restore the template through vCenter. If you restore a template to a standalone ESX server, the template is converted to a normal virtual machine and is no longer a template.

  • If the virtual machine was backed up by its display name or UUID, and the display name differs from the host name, note: You must specify the correct destination client for the restore. Use the Specify NetBackup Machines and Policy Type dialog in the NetBackup Backup, Archive, and Restore interface.

    See Invalid client error when you restore files using NetBackup BAR interface installed on the virtual machine.

  • Restore of individual files from a backup of the full virtual machine is not supported if the virtual machine contains Storage Foundation Volume Manager volumes.

  • To restore Windows NTFS-encrypted files individually, you must install a NetBackup client on the virtual machine.

    See NetBackup for VMware best practices.

  • For virtual machine restores, VMware supports the NBDSSL transport mode only for backups of vSphere 4.1 and later environments. Backups of the VMware systems that are earlier than vSphere 4.1 cannot be restored using the NBDSSL transport mode.

  • If the attempt to restore a full virtual machine fails while using the SAN transport type, try the NBD transport type instead.

  • VMware does not support the restore of virtual machines directly to an ESX 5.x server that vCenter manages. To restore the virtual machine, select the vCenter server as the destination.

    As an alternative, you can set up an independent ESX server to be used for restores. You must add NetBackup restore credentials for that ESX server by means of the VMware restore ESX server server type.

    See Adding NetBackup credentials for VMware.

  • For the SAN transport mode, the job may be slow when you restore to a vCenter Server. For greater speed, designate a VMware restore ESX server as the destination for the restore.

    See Adding NetBackup credentials for VMware.

  • For the SAN transport mode and a restore host on Windows 2008R2, the restore fails if the datastore's lun is offline. The detailed status log contains messages similar to the following:

    5/22/2013 4:10:12 AM - Info tar32(pid=5832) done. status: 24: 
    socket write failed       
    5/22/2013 4:10:12 AM - Error bpbrm(pid=5792) client restore EXIT STATUS 24: 
    socket write failed     

    Make sure the status of the SAN disk on the restore host is online (not offline). Disk status can be checked or changed using the Windows diskpart.exe utility or the Disk Management utility (diskmgmt.msc). When the disk status reads online, retry the restore.

  • A restore by means of the SAN transport mode may be slow in other circumstances. The following VMware article provides details:

    Best practices when using SAN transport for backup and restore

  • The APIs in VMware's Virtual Disk Development Kit (VDDK) contain the following limitation: The maximum write speed during virtual machine restore is roughly one third of the hardware's maximum speed. The following Symantec tech note contains further information:

    Two causes of slow NetBackup for VMware restore performance

  • When restoring large files, make sure that no snapshots are active on the destination virtual machine. Otherwise, the files are restored to the VMware configuration datastore, which may be too small to contain the files you want to restore. In that case, the restore fails.

    The configuration datastore (sometimes called the vmx directory) contains the configuration files that describe the virtual machine, such as *.vmx files. Note that active snapshots of vmdk files are also stored on the configuration datastore.

  • If you cancel the virtual machine restore before it completes, the not-fully-restored virtual machine remains at the target location. NetBackup does not delete the incomplete virtual machine when the restore job is canceled. You must manually remove the incomplete virtual machine.

  • If the virtual machine display name contains non-ASCII characters, the backup may succeed but the restore fails. To restore the virtual machine, you must change the display name to contain ASCII characters only and retry the restore.

  • Granular Recovery Technology (GRT) is not supported for third-party OST storage. See the following tech note:

    Disk Storage Types supported for Granular Recovery Technology (GRT)

  • NetBackup for VMware does not support individual file restore by means of ClientDirect Restore.

  • On a restore, NetBackup recreates the linking between a hard link and its original file only in this case: If the link file and its target file are restored in the same job. If each file is restored individually in separate restore jobs, they are restored as separate files and the link is not re-established.

  • If you restore a VM in vCloud to an expired vApp, the vApp is automatically renewed and added back into the vCloud organization. If the expired vApp contained other VMs, all those VMs are also removed from the expired list and added to the organization.

    Note that in vCloud Director, an expired vApp must be renewed before you can import a VM into that vApp.

  • With a remote connection from a Windows Java GUI that uses the English locale, the restore of files that have non-ASCII characters may fail.

    See the following tech note for further information on how to restore the files:

  • See NetBackup for VMware: notes and restrictions.

See Restore notes and restrictions on Linux

See If the recovery host is not at the same NetBackup release level as the backup host

Legacy ID


Article URL

Terms of use for this information are found in Legal Notices