Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

NetBackup™ for KVM Administrator's Guide

Last Published:
Product(s): NetBackup (11.1)
  1. Introduction
    1.  
      About NetBackup for KVM
  2. Installation and configuration overview
    1. Planning the installation for NetBackup for KVM
      1.  
        Verifying the operating system and platform compatibility
      2.  
        NetBackup server and client requirements
    2.  
      NetBackup configuration overview
  3. Managing KVM hosts
    1.  
      Add KVM hosts
    2. About KVM discovery
      1.  
        Change the autodiscovery frequency of KVM assets
      2.  
        Discover KVM host assets manually
    3.  
      Browse KVM assets
    4.  
      Validate a KVM host
    5.  
      Remove a KVM host
    6.  
      Change resource limits for KVM resource types
  4. Configuring RBAC roles for KVM administrators
    1.  
      RBAC roles for the KVM administrator
    2.  
      Assigning permissions at specific KVM object levels
  5. Protecting KVM virtual machines
    1. About configuring a backup policy for KVM
      1.  
        Limitations for KVM backups
    2.  
      About automatic virtual machine selection
    3.  
      Add a policy for KVM
    4.  
      About policy attributes
    5.  
      Schedule properties
    6.  
      Add KVM hosts to a policy
    7. Configure a query to select KVM virtual machines for backup
      1.  
        Query builder reference for KVM virtual machines
      2.  
        Use Advanced mode to create a query for virtual machine selection
      3.  
        Example queries to select VMs for backup
      4.  
        Test a VM query
      5.  
        About the Reuse VM selection query results option
    8. Backup options on the KVM attributes tab
      1.  
        Optimizations options (KVM)
      2.  
        Primary VM identifier options (KVM)
      3.  
        NetBackup character restrictions for the Primary VM identifier
      4.  
        Existing snapshot handling options (KVM)
      5.  
        KVM - Advanced attributes
    9.  
      View the protection status of KVM virtual machines
    10.  
      Perform a manual backup
  6. Recovering KVM virtual machines
    1.  
      Considerations and limitations for KVM recovery
    2.  
      About the pre-recovery check
    3.  
      Recover a KVM virtual machine
  7. Troubleshooting KVM backups and recovery
    1.  
      NetBackup logging for KVM
    2.  
      Configuring VxMS logging
    3.  
      Troubleshooting a KVM discovery or a validate operation

Troubleshooting a KVM discovery or a validate operation

Discovery or Validate operation fails for the KVM host

Recommended action: Ensure sure that the KVM host is reachable and that NetBackup services are up.

A backup of a virtual machine without a storage pool cannot be restored to the original location

If the virtual machine disk files did not reside on the storage pool during the backup, the pre-recovery check fails if the user attempts to restore to the original location. In this case, restore to an alternate location. By default for this kind of restore, the Destination storage pool and the Destination volume values are empty for the virtual machine. Select the wanted values before you continue with the restore.

A backup job fails with error 4726 - Failed to create snapshot of the specified VM.

The bpbrm logs on the media server contain the following message:

12:41:49.943 [3275984.3275984] <2> get_bpfis_msg: bpfis buff: FTL - Unable to 
quiesce VM filesystem. 
Verify the QEMU guest agent is installed and running.
12:41:49.943 [3275984.3275984] <32> get_bpfis_msg: from client alpine2: FTL - Unable 
to quiesce VM filesystem. 
Verify the QEMU guest agent is installed and running.
12:41:49.944 [3275984.3275984] <2> set_job_details: Tfile (12): LOG 1752774109 32 
bpbrm 3275984 from client 
alpine2: FTL - Unable to quiesce VM filesystem. Verify the QEMU guest agent is 
installed and running.
12:41:49.944 [3275984.3275984] <2> send_job_file: job ID 12, ftype = 3 msg len = 146, 
msg = LOG 1752774109 32 
bpbrm 3275984 from client alpine2: FTL - Unable to quiesce VM filesystem. Verify the 
QEMU guest agent is installed and running.

This error can occur if the Virtual machine quiesce option is selected without the option Perform snapshot without quiescing if quiesced snapshots fail for the backup policy.

A snapshot may fail if the virtual machine can't be quiesced. This error usually means that the QEMU agent isn't installed or isn't running on the guest system. To fix this issue, you can either resolve the QEMU agent issue on the guest VM to allow for a successful quiesce operation. Or, select the option Perform snapshot without quiescing if quiesced snapshots fail option.

A backup of a virtual machine fails if the QEMU guest agent is not installed

The KVM advanced attribute Virtual machine quiesce is enabled by default and requires that the QEMU guest agent is installed. If not, the backup fails.