Live Browse and Recovery of Guest Files and Folders for VMs

A live browse operation gets information about guest files and folders during a restore operation. The information about the files and folders included in a backup is discovered during the browse operation as you select the content to restore. You can perform restores of guest files and folders from backups of Windows VMs that use NTFS, ReFS, FAT, and FAT32 file systems, and of UNIX VMs that use ext2, ext3, ext4, XFS, JFS, HFS, HFS Plus, or Btrfs file systems.

To enable extended file system support for UNIX-based virtual machines, you must deploy and use a Linux access node to access the data in the backups.

Commvault software automatically selects a Windows or Linux MediaAgent where the backup data resides for live file browse of Windows or Linux guest VMs. If a Windows MediaAgent is not available, then the software uses a Linux MediaAgent. If a Windows MediaAgent is used for live browse, then information for FAT, FAT32, NTFS, and Resilient File System (ReFS) file systems is available. If a Linux MediaAgent is used, then live browse for ReFS and dynamic disks is not supported.

Cloud Storage Support

Live browse operations are supported for VM backups that reside on the following cloud storage:

• Amazon S3: S3 Standard storage class

• Google Cloud Storage: Region or multi-region storage class

• Microsoft Azure Storage: Default container storage using hot or cold access tiers with General Purpose v1 (GPv1) or General Purpose v2 (GPv2) storage account

• Oracle Cloud Infrastructure (OCI) Object Storage

Live Browse and Recovery from Tape Storage

For backups that reside on a tape storage, the Commvault software triggers a staging restore job when you initiate a guest files and folders restore. The backup content is staged to the Live Browse Cache (LBC) on the MediaAgent associated with the tape storage. After the staging restore job completes, the backup content is available for browse and restore.

If the size of the LBC is less than the size of the backup content, then the staging restore job is not triggered. Ensure that sufficient disk space is available to stage the backup content. If the LBC has less space, specify the additional setting sLiveBrowseCacheLocation to change the staging location.

Considerations

• Live browse and recovery is supported from backups to magnetic disk/cloud, tape and virtual tape storage, and is not supported from a cloud archive copy with automatic recall.

  To perform live file recovery from a cloud archive copy, you can manually run the Commvault Cloud Archive Recall workflow on-demand. For more information, see Restoring Data from Archive Cloud Storage.

• Ensure that the MediaAgent has the Virtual Server Agent installed, and has access to the library and media that are required for the restore operation.

  • On the Commvault HyperScale Appliance, the CommServe software and the Virtual Server Agent and MediaAgent packages are pre-installed. If you are using a CommServe system on the HyperScale Appliance, you do not need to perform any additional configuration to enable live browse operations using VSA proxies and MediaAgents running on Linux machines.

  • In HyperScale 1.5 and HSX environments, live file browse of RedHat Enterprise Linux or Oracle Linux 8.x and 9.x VMs need a Linux MediaAgent and VSA installed on the machine. You can download and deploy a recent version of the Linux access node from the Commvault store for your Commvault service pack and use it in live file browse for the VMs.

• Browsing fails if the file system on the source VM for the backup is not supported by the Linux access node. Browsing speed is affected by network latency and the complexity of the file system being browsed.

• Initial mount during browse may take time if the VM snapshot contains an inconsistent file system that requires fsck (file system check). A restore that follows the browse in quick succession does not incur that overhead because it reuses the mount point.

• If there is no activity on the VM for a specified time (10 minutes by default), the browse times out and the VM is unregistered. Once the cleanup is done, the restore job is marked as Completed.

• When restoring large volumes of guest files and folders ranging from 100s of GBs or more than one TB, Commvault recommends that you perform the Attach disk to VM restore to existing VM or another VM. Copy the required data and then delete the attached disk.

• For the fastest recovery of guest files and folders and minimal space usage for extent caching, use live browse and recovery with a restore-only file system agent on the destination VM.

• Live browse and restore is not supported if the VM encryption is enabled with Virtual Trusted Platform Module (vTPM) and if volumes are encrypted using encryption software (for example, Bitlocker).

Linux Guest VMs

• For Linux guest VMs, a Linux access node and MediaAgent can be used to browse and restore data from backups of UNIX VMs.

• When used with agentless restores, the Restore ACLs option only restores basic user/group/world permissions and timestamps. Advanced permissions are only restored when using a guest agent together with a Linux access node.

• When you perform a live browse operation on Linux files and folder, all mountable file systems are listed as individual disks. Any LVM logical volumes from the source VM are shown by name, using the naming convention VolumeGroupName-LogicalVolumeName rather than the mount paths that are used in the source VM.

• Logical volume manager (LVM) metadata processing for volumes encrypted using encryption software is currently not supported. Decrypting contents of such volumes may not be feasible during browse or restore operations because decryption requires a recovery password or a decryption key. As enumeration for the volume fails, a file-level browse operation for the encrypted volume cannot display file information.

• Permissions for guest files and folders are retained only when the user running the restore operation has permissions to change group ownership on the restored files and folders. If the user does not have change group ownership permissions, the restored files and folders are owned by the user who performed the restore.

• You cannot restore an empty folder unless you restore the parent folder. When you restore a parent folder all other folders contained in the parent folder are also restored.

• Some special files from UNIX systems cannot be restored to a Windows system. These include symbolic link files, socket files, character device files, block files, and pipe files (FIFOs).

• Symbolic links can be restored if the source files are also restored, but they will use the timestamp of the restore operation instead of the original timestamp. If the source files are not restored, symbolic link files are restored but without links; as a result the linked data cannot be read.

• Hard link files can be restored; if source files are also restored any corresponding link files use the same index node (inode).

• For UNIX file restores, the restore operation uses the Linux access node that mounts the backup (if one is available) or the preferred access node for Linux for the virtual server instance. The Linux access node must run the same or a higher OS version than the VM being browsed. For example, an access node running Oracle Linux, RHEL, or Rocky Linux 9.x can browse VMs with OS version 9.x.

• When you perform a live browse for a Linux guest VM, the directory hierarchy displays results for each guest VM using the same root directory structure as the source VM, and are restored using the same folder structure. Mounted devices are shown in the directory structure according to the following rules:

  • If a device is present in the source VM under the /etc/fstab folder with the device UUID or logical volume name, the live browse results show the device in the same location.

  • If a device cannot be located in the root file system and the device is a raw disk, the live browse results show the device under the /cvlostandfound/blkuuidOfDevice directory.

  • If a device cannot be located in the root file system and the device is a logical volume, the live browse results show the device under the /cvlostandfound/vgname-lvname directory.

Windows Guest VMs and Storage Spaces

• For Windows guest VMs, ensure that the Virtual Server Agent is installed on the Windows MediaAgent used for browse and restore operations.

• The MediaAgent that you use for live browse operations of an ReFS volume must support the version of the ReFS volume on the guest VM. For example, to live browse and restore files from an ReFS volume from a backup of a Windows Server 2016 VM, you must use a MediaAgent running on Windows Server 2016 or later. To browse and restore files from an ReFS volume from a backup of a Windows Server 2019 VM, use a MediaAgent running on Windows Server 2019 or later.

• To browse and recover files from a guest VM running Windows 2016, 10 or 11, you must use a VSA access node and MediaAgent that runs on Windows 2016 or later.

• Use live browse and recovery to restore files that have been dehydrated by Windows deduplication. The Windows version of the VSA access node and MediaAgent must be the same as or later than the Windows version of the VM for which files are being restored. For example, a MediaAgent running Windows Server 2016 or later, with the Virtual Server Agent installed and with the Windows deduplication role enabled, must be used as the VSA access node when restoring dehydrated files from a Windows Server 2016 VM.

• The MediaAgent that is used for the live browse cannot be part of a clustered environment.

• Dynamic disk configuration on the virtual disk for a storage pool is not supported.

• You cannot simultaneously browse two cloned VMs that use the same storage space information.

• Live browse of Windows storage spaces is only supported for streaming backups, auxiliary copies, and backup copies, and not directly from IntelliSnap backups.

• To browse data from a backup copy or streaming backup (and not from an IntelliSnap backup) by default during guest file restore operations, configure the PREFER_BACKUP_COPY additional setting.