Veritas NetBackup for HBase Administrator's Guide

Last Published:
Product(s): NetBackup (8.1.1)
Platform: Linux,UNIX,Windows
  1. Introduction
    1.  
      Protecting HBase data using NetBackup
    2.  
      Backing up HBase data
    3.  
      Restoring HBase data
    4.  
      Deploying the HBase plug-in
    5.  
      NetBackup for HBase terminologies
    6.  
      Limitations
  2. Installing and deploying HBase plug-in for NetBackup
    1.  
      About installing and deploying the HBase plug-in
    2.  
      Pre-requisites for installing the HBase plug-in
    3.  
      Operating system and platform compatibility
    4.  
      License for HBase plug-in for NetBackup
    5.  
      Preparing the HBase cluster
    6.  
      Downloading the plug-in
    7.  
      Installing the HBase plug-in
    8.  
      Best practices for deploying the HBase plug-in
    9.  
      Post installation procedures
    10.  
      Verifying the installation of the HBase plug-in
  3. Configuring NetBackup for HBase
    1.  
      About configuring NetBackup for HBase
    2. Managing backup hosts
      1.  
        Whitelisting a NetBackup client on NetBackup master server
      2.  
        Configure a NetBackup Appliance as a backup host
    3.  
      Adding HBase credentials in NetBackup
    4. Configuring the HBase plug-in using the HBase configuration file
      1.  
        Configuring NetBackup for a highly-available HBase cluster
    5.  
      Configuration for a HBase cluster that uses Kerberos
    6. Configuring NetBackup policies for HBase plug-in
      1. Creating a BigData backup policy
        1. Creating BigData policy using the NetBackup Administration Console
          1.  
            Using the Policy Configuration Wizard to create a BigData policy for HBase clusters
          2.  
            Using the NetBackup Policies utility to create a BigData policy for HBase clusters
        2.  
          Using NetBackup Command Line Interface (CLI) to create a BigData policy for HBase clusters
    7.  
      Disaster recovery of a HBase cluster
  4. Performing backups and restores of HBase
    1. About backing up a HBase cluster
      1.  
        Pre-requisite for running backup and restore operations for a HBase cluster with Kerberos authentication
      2.  
        Backing up a HBase cluster
      3.  
        Best practices for backing up a HBase cluster
    2. About restoring a HBase cluster
      1. Restoring HBase data on the same HBase cluster
        1.  
          Using the Restore Wizard to restore HBase data on the same cluster
        2.  
          Using the bprestore command to restore HBase data on the same HBase cluster
    3.  
      Restoring HBase data on an alternate HBase cluster
    4.  
      Restoring truncated tables
    5.  
      Best practices for restoring a HBase cluster
  5. Troubleshooting
    1.  
      About NetBackup for HBase debug logging
    2.  
      Backup fails with error 6609
    3.  
      Backup fails with error 6601
    4.  
      Backup fails with error 6623
    5.  
      Restore fails with error 2850
    6.  
      Backup fails with error 20

Adding HBase credentials in NetBackup

To establish a seamless communication between HBase clusters and NetBackup for successful backup and restore operations, you must add and update HBase and hadoop credentials to the NetBackup master server.

Use the tpconfig command to add credentials in NetBackup master server.

For HBase you need to provide the RSA fingerprint when you add the credentials.

For more information about the tpconfig command, see the NetBackup Commands Reference Guide.

Consider the following when you add HBase credentials:

  • For a highly-available HBase cluster, ensure that the user for the primary and fail-over HMaster is the same.

  • Use the credentials of the application server that you will use when configuring the BigData policy.

  • For a hadoop cluster that uses Kerberos, specify "kerberos" as application_server_user_id value.

  • For a hbase cluster that uses Kerberos, specify the actual Kerberos user name as application_server_user_id value.

  • RSA key must be in MD5 format.

  • Ensure that RSA is supported on the backup host. Run the following command:

    ssh-keygen -l -f ssh_host_rsa_key

To obtain the RSA fingerprint for HBase

  1. Run the following command:

    ssh-keyscan -t ssh-rsa application_server_name > tmp.keyhas 2>/dev/null

  2. Run the following command:

    ssh-keygen -l -f tmp.keyhas

  3. Copy the RSA fingerprint. You need to provide this fingerprint when you add the HBase credentials.

To authorize HMaster servers without providing RSA key

  1. Login to each of your backup hosts as root user.
  2. Run the following command to make HMaster as known host.

    Note:

    Ensure that the root/.ssh directory is present.

    Remove any old keys for HMaster from /root/.ssh/known_hosts file before running the command.

    ssh-keyscan -t ssh-rsa <HMASTER_HOST_NAME> >> ~/.ssh/known_hosts

  3. Run the -tpconfig command without the RSA fingerprint.

To add credentials in NetBackup

  1. Run tpconfig command from the following directory paths:

    On UNIX systems, /usr/openv/volmgr/bin/

    On Windows systems, install_path\Volmgr\bin\

  2. Run the tpconfig --help command. A list of options which are required to add, update, and delete HBase credentials is displayed.
  3. Run the tpconfig -add -application_server application_server_name -application_server_user_id user_ID -application_type application_type -requiredport IP_port_number [-password password [-key encryption_key]] command by providing appropriate values for each parameter to add hadoop credentials.

    For example, if you want to add credentials for hadoop server which has application_server_name as Hadoop1, then run the following command using the appropriate <user_ID> and <password> details.

    tpconfig -add -application_server servername -application_type 1 -application_server_user_id Hadoop -

  4. You are prompted to enter the password.
  5. Run the tpconfig -add -application_server application_server_name -application_server_user_id hmaster:username:RSA fingerprint -application_type application_type -requiredport IP_port_number [-key encryption_key]] command by providing appropriate values for each parameter to add HBase credentials.

    For example, if you want to add credentials for HBase server which has application_server_name as HBase1, then run the following command using the appropriate <user_ID> and <password> details.

    tpconfig -add -application_server servername -application_type 2 -application_server_user_id hmaster:Hbase:ec:33:1c:28:9b:5f:3b:c8:59:61:a1:35:1c:4b:60:5a

  6. You are prompted to enter the password. Enter the password as Hmaster:password.
  7. Run the tpconfig -dappservers command to verify if the NetBackup master server has the HBase credentials added.