NetBackup™ for Hadoop Administrator's Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.3)
  1. Introduction
    1.  
      Protecting Hadoop data using NetBackup
    2.  
      Backing up Hadoop data
    3.  
      Restoring Hadoop data
    4.  
      NetBackup for Hadoop terms
    5.  
      Limitations
  2. Prerequisites and best practices for the Hadoop plug-in for NetBackup
    1.  
      About deploying the Active Directory plug-in
    2. Prerequisites for the Hadoop plug-in
      1.  
        Operating system and platform compatibility
      2.  
        License for Hadoop plug-in for NetBackup
    3.  
      Preparing the Hadoop cluster
    4.  
      Best practices for deploying the Hadoop plug-in
  3. Configuring NetBackup for Hadoop
    1.  
      About configuring NetBackup for Hadoop
    2. Managing backup hosts
      1.  
        Including a NetBackup client on NetBackup primary server allowed list
      2.  
        Configure a NetBackup Appliance as a backup host
    3.  
      Adding Hadoop credentials in NetBackup
    4. Configuring the Hadoop plug-in using the Hadoop configuration file
      1.  
        Configuring NetBackup for a highly-available Hadoop cluster
      2.  
        Configuring a custom port for the Hadoop cluster
      3.  
        Configuring number of threads for backup hosts
      4.  
        Configuring number of streams for backup hosts
      5.  
        Configuring distribution algorithm and golden ratio for backup hosts
      6. Configuring communication between NetBackup and Hadoop clusters that are SSL-enabled (HTTPS)
        1.  
          ECA_TRUST_STORE_PATH for NetBackup servers and clients
        2.  
          ECA_CRL_PATH for NetBackup servers and clients
        3.  
          HADOOP_SECURE_CONNECT_ENABLED for servers and clients
        4.  
          HADOOP_CRL_CHECK for NetBackup servers and clients
        5.  
          Example values for the parameters in the bp.conf file
    5.  
      Configuration for a Hadoop cluster that uses Kerberos
    6.  
      Hadoop.conf configuration for parallel restore
    7.  
      Create a BigData policy for Hadoop clusters
    8.  
      Disaster recovery of a Hadoop cluster
  4. Performing backups and restores of Hadoop
    1. About backing up a Hadoop cluster
      1.  
        Prerequisites for running backup and restore operations for a Hadoop cluster with Kerberos authentication
      2.  
        Best practices for backing up a Hadoop cluster
      3.  
        Backing up a Hadoop cluster
    2. About restoring a Hadoop cluster
      1.  
        Best practices for restoring a Hadoop cluster
      2. Restoring Hadoop data on the same Hadoop cluster
        1.  
          Restore Hadoop data on the same Hadoop cluster
      3.  
        Restoring Hadoop data on an alternate Hadoop cluster
    3.  
      Best practice for improving performance during backup and restore
  5. Troubleshooting
    1.  
      About troubleshooting NetBackup for Hadoop issues
    2.  
      About NetBackup for Hadoop debug logging
    3. Troubleshooting backup issues for Hadoop data
      1.  
        Backup operation fails with error 6609
      2.  
        Backup operation failed with error 6618
      3.  
        Backup operation fails with error 6647
      4.  
        Extended attributes (xattrs) and Access Control Lists (ACLs) are not backed up or restored for Hadoop
      5.  
        Backup operation fails with error 6654
      6.  
        Backup operation fails with bpbrm error 8857
      7.  
        Backup operation fails with error 6617
      8.  
        Backup operation fails with error 6616
      9.  
        Backup operation fails with error 84
      10.  
        NetBackup configuration and certificate files do not persist after the container-based NetBackup appliance restarts
      11.  
        Unable to see incremental backup images during restore even though the images are seen in the backup image selection
      12.  
        One of the child backup jobs goes in a queued state
    4. Troubleshooting restore issues for Hadoop data
      1.  
        Restore fails with error code 2850
      2.  
        NetBackup restore job for Hadoop completes partially
      3.  
        Extended attributes (xattrs) and Access Control Lists (ACLs) are not backed up or restored for Hadoop
      4.  
        Restore operation fails when Hadoop plug-in files are missing on the backup host
      5.  
        Restore fails with bpbrm error 54932
      6.  
        Restore operation fails with bpbrm error 21296
      7.  
        Hadoop with Kerberos restore job fails with error 2850
      8.  
        Configuration file is not recovered after a disaster recovery
  6.  
    Index

Restoring Hadoop data on an alternate Hadoop cluster

NetBackup lets you restore Hadoop data to another NameNode or Hadoop cluster. This type of restore method is also referred to as redirected restores.

Note:

Make sure that you have added the credentials for the alternate NameNode or Hadoop cluster in NetBackup primary server and also completed the allowlisting tasks on NetBackup primary server. For more information about how to add Hadoop credentials in NetBackup and whitlelisting procedures, See Adding Hadoop credentials in NetBackup. See Including a NetBackup client on NetBackup primary server allowed list.

To perform redirected restore for Hadoop

  1. Modify the values for rename_file and listfile as follows:

    Parameter

    Value

    rename_file

    Change /<source_folder_path> to /<destination_folder_path> ALT_APPLICATION_SERVER=<alternate name node>

    listfile

    List of all the Hadoop files to be restored

  2. Run the bprestore -S primary_server -D backup_host -C client -R rename_file -t 44 -L progress log -f listfile command on the NetBackup primary server using the modified values for the mentioned parameters in step 1.

    Where,

    -S primary_server

    Specifies the name of the NetBackup primary server.

    -D backup host

    Specifies the name of the backup host.

    -C client

    Specifies a NameNode as a source to use for finding backups or archives from which to restore files. This name must be as it appears in the NetBackup catalog.

    -f listfile

    Specifies a file (listfile) that contains a list of files to be restored and can be used instead of the file names option. In listfile, list each file path must be on a separate line.

    -L progress_log

    Specifies the name of allowlisted file path in which to write progress information.

    -t 44

    Specifies BigData as the policy type.

    -R rename_file

    Specifies the name of a file with name changes for alternate-path restores.

    Use the following form for entries in the rename file:

    change backup_filepath to restore_filepath ALT_APPLICATION_SERVER=<Application Server Name>

    The file paths must start with / (slash).

    Note:

    Ensure that you have allowlisted all the file paths such as <rename_file_path>, <progress_log_path> that are already not included as a part of NetBackup install path.