Veritas NetBackup™ for HBase Administrator's Guide

Last Published:
Product(s): NetBackup (8.2, 8.1.2)
Platform: Linux,UNIX,Windows
  1. Introduction
    1.  
      Protecting HBase data using NetBackup
    2.  
      Backing up HBase data
    3.  
      Restoring HBase data
    4.  
      NetBackup for HBase terminologies
    5.  
      Limitations
  2. Deploying HBase plug-in for NetBackup
    1.  
      About the HBase plug-in deployment
    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.  
      Best practices for deploying the HBase plug-in
    7.  
      Post installation procedures
    8.  
      Verifying the deployment 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
    7.  
      Backup fails with error 112

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 and to obtain the RSA key, run the following command:

    ssh-keygen -l -f ssh_host_rsa_key

    This utility is available at /etc/ssh

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 [-password password 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 user_ID -application_type application_type -requiredport IP_port_number [-password password ] [-host_user_id user_ID] [-host_password password] [-host_RSA_key RSA_key_fingerprint]

    For example:

    tpconfig -add -application_server testserver.veritas.com -application_server_user_id hadoop-application_type hbase -requiredport 60010 -password hadoop -host_user_id hadoop -host_password hadoop-host_RSA_key e2:53:a3:11:96:a5:65:ff:f4:c2:e7:b6:9a:85:ed:18

    Note:

    Ensure that HBase user has admin permissions for SSH and for HBase folders.

  6. Run the tpconfig -dappservers command to verify if the NetBackup master server has the HBase credentials added.