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 Kubernetes Administrator's Guide

Last Published:
Product(s): NetBackup (11.0.0.1)
  1. Overview of NetBackup for Kubernetes
    1.  
      Overview
    2.  
      Features of NetBackup support for Kubernetes
  2. Deploying and configuring the NetBackup Kubernetes operator
    1.  
      Prerequisites for NetBackup Kubernetes Operator deployment
    2.  
      Deploy service package on NetBackup Kubernetes operator
    3.  
      Port requirements for Kubernetes workload
    4.  
      Upgrade the NetBackup Kubernetes operator
    5.  
      Delete the NetBackup Kubernetes operator
    6.  
      Configure NetBackup Kubernetes data mover
    7.  
      Automated configuration of NetBackup protection for Kubernetes
    8. Customize Kubernetes workload
      1.  
        Prerequisites for backup from snapshot and restore from backup operations
      2.  
        DTE client settings supported in Kubernetes
      3.  
        Customization of datamover properties
    9.  
      Troubleshooting NetBackup servers with short names
    10.  
      Data mover pod schedule mechanism support
    11.  
      Validating accelerator storage class
  3. Deploying certificates on NetBackup Kubernetes operator
    1.  
      Deploy certificates on the Kubernetes operator
    2.  
      Perform Host-ID-based certificate operations
    3.  
      Perform ECA certificate operations
    4.  
      Identify certificate types
  4. Managing Kubernetes assets
    1.  
      Add a Kubernetes cluster
    2. Configure settings
      1.  
        Change resource limits for Kuberentes resource types
      2.  
        Configure autodiscovery frequency
      3.  
        Configure permissions
      4.  
        Asset cleanup
    3.  
      Add protection to the assets
    4. Scan for malware
      1.  
        Assets by workload type
  5. Managing Kubernetes intelligent groups
    1.  
      About intelligent group
    2.  
      Create an intelligent group
    3.  
      Delete an intelligent group
    4.  
      Edit an intelligent group
  6. Managing Kubernetes policies
    1.  
      Create a policy
  7. Protecting Kubernetes assets
    1.  
      Protect an intelligent group
    2.  
      Remove protection from an intelligent group
    3.  
      Configure backup schedule
    4.  
      Configure backup options
    5.  
      Configure backups
    6.  
      Configure Auto Image Replication (A.I.R.) and duplication
    7.  
      Configure storage units
    8.  
      Volume mode support
    9.  
      Configure application consistent backup
  8. Managing image groups
    1. About image groups
      1.  
        Image expire
      2.  
        Image copy
  9. Protecting Rancher managed clusters in NetBackup
    1.  
      Add Rancher managed RKE cluster in NetBackup using automated configuration
    2.  
      Add Rancher managed RKE cluster manually in NetBackup
  10. Recovering Kubernetes assets
    1.  
      Explore and validate recovery points
    2.  
      Restore from snapshot
    3.  
      Restore from backup copy
    4.  
      Restore virtual machine from Snapshot or backups
  11. About incremental backup and restore
    1.  
      Incremental backup and restore support for Kubernetes
  12. Enabling accelerator based backup
    1.  
      About NetBackup Accelerator support for Kubernetes workloads
    2.  
      Controlling disk space for track logs on primary server
    3.  
      Effect of storage class behavior on Accelerator
    4.  
      About Accelerator forced rescan
    5.  
      Warnings and probable reason for Accelerator backup failures
  13. Enabling FIPS mode in Kubernetes
    1.  
      Enable Federal Information Processing Standards (FIPS) mode in Kubernetes
  14. About Openshift Virtualization support
    1.  
      OpenShift Virtualization support
    2.  
      Application consistent virtual machines backup
    3.  
      Troubleshooting for virtualization
  15. Troubleshooting Kubernetes issues
    1.  
      Error during the primary server upgrade: NBCheck fails
    2.  
      Error during an old image restore: Operation fails
    3.  
      Error during persistent volume recovery API
    4.  
      Error during restore: Final job status shows partial failure
    5.  
      Error during restore on the same namespace
    6.  
      Datamover pods exceed the Kubernetes resource limit
    7.  
      Error during restore: Job fails on the highly loaded cluster
    8.  
      Custom Kubernetes role created for specific clusters cannot view the jobs
    9.  
      Openshift creates blank non-selected PVCs while restoring applications installed from OperatorHub
    10.  
      NetBackup Kubernetes operator become unresponsive if PID limit exceeds on the Kubernetes node
    11.  
      Failure during edit cluster in NetBackup Kubernetes 10.1
    12.  
      Backup or restore fails for large sized PVC
    13.  
      Restore of namespace file mode PVCs to different file system partially fails
    14.  
      Restore from backup copy fails with image inconsistency error
    15.  
      Connectivity checks between NetBackup primary, media, and Kubernetes servers.
    16.  
      Error during accelerator backup when there is no space available for track log
    17.  
      Error during accelerator backup due to track log PVC creation failure
    18.  
      Error during accelerator backup due to invalid accelerator storage class
    19.  
      Error occurred during track log pod start
    20.  
      Failed to setup the data mover instance for track log PVC operation
    21.  
      Error to read track log storage class from configmap
    22.  
      Restore operation fails when restoring single VM to a different cluster
    23.  
      Auto-deployment of the Kubernetes workload fails during backupservercert creation
    24.  
      Auto-deployment of the Kubernetes workload fails with time-out error
    25.  
      Fail Fast restore strategy fails with error 2890 K8s restore data operation failed.

Restore virtual machine from Snapshot or backups

NetBackup features to restore the virtual machines from snapshot function as well as from backups for a particular name space. The performed backups and snapshots are displayed on the Recovery points tab.

Note:

This feature is applicable to backups taken in this 11.1 release. However, for backups taken in older releases, select Restore namespace option. Refer step 4 in the following procedure.

Warning:

Restoring virtual machines from a KubeVirt-enabled OpenShift cluster to a Vanilla Kubernetes cluster (without KubeVirt) results in only PVCs being restored. VM objects will not be visible or functional due to the absence of KubeVirt on the target cluster.

Ensure that the target Kubernetes cluster has KubeVirt installed and configured before restoring VM workloads from a KubeVirt-enabled source. Without KubeVirt, only PVCs will be restored, and VM definitions will be ignored or fail to deploy.

To restore a virtual machine

  1. On the left, click Workloads > Kubernetes.
  2. On the Namespace tab, click the namespace of the asset that you want to recover.
  3. Click Recovery points tab.

    The Recovery points tab shows you all the recovery points with the date, time, and copies of the backup. You can set filters to filter the displayed recovery points. Click the date in the Date column, to view the details of the recovery point. The Recovery points details dialog shows the resources that were backed up, like config maps, secrets, persistent volumes, pod, and so on.

  4. In the Copies column, click the # copies button. For example, if there are two copies, the button displays as 2 copies.
  5. Locate the recovery point of which you want to restore the virtual machine. Click kebab menu and select Restore virtual machine.
  6. Restore virtual machine wizard is displayed.
  7. On the first tab of Recovery target, The target cluster is auto-populated. Click Next.
  8. Recovery options step is displayed. Select one option from All virtual machines or Specific virtual machine.
  9. Select Clear virtual machine MAC address during restore option if you want to remove the old assigned MAC address so that a new one can be generated when the VM starts up again.
  10. Select at least one option from Failure strategy to recover. The following are the available options:

    Note:

    If a failure occurs during the restore of metadata or PVCs, the restore job runs according to the failure strategy selected. However, the dependent resources of selected virtual machines will be recovered automatically.

    • Select Fail fast to terminate the restore for any failure occurrence. (Default selected)

    • Select Proceed ahead to continue restoring the next PVC. If the parent image (first image) restore fails then the restore job terminates.

    • Select Retry to specify a retry count for the metadata or PVC restore. If the restore fails even after retries, then the restore job terminates. You can select up to Five retries. Default is Three.

      Note:

      The selected failure strategy is displayed in the Activity monitor.

  11. Click Next.
  12. NetBackup displays the summary information of the selected or specified values. Click Start recovery.
  13. Once you click Start recovery, NetBackup take you to Restore activity tab and displays the job activity initiated.

    Note:

    You can also view the recovery activity in Activity monitor.