Vladimir Rodionov, Feb 2017
*** Summary of work
HBASE-14123
The new feature introduces new command-line extensions to the hbase command and, from the client side, is accessible through command-line only
Operations:
* Create full backup on a list of tables or backup set
* Create incremental backup image for table list or backup set
* Restore list of tables from a given backup image
* Show current backup progress
* Delete backup image and all related images
* Show history of backups
* Backup set operations: create backup set, add/remove table to/from backup set, etc
In the current implementation, the feature is already usable, meaning that users can backup tables and restore them using provided command-line tools. Both: full and incremental backups are supported.
This work is based on original work of IBM team (
HBASE-7912). The full list of JIRAs included in this mega patch can be found in three umbrella JIRAs:
HBASE-14030 (Phase 1),
HBASE-14123 (Phase 2) and
HBASE-14414 (Phase 3 - all resolved ones made it into the patch)
*** What are the remaining work items
All remaining items can be found in Phase 3 umbrella JIRA:
HBASE-14414.
They are split into 3 groups: BLOCKER, CRITICAL, MAJOR
Only BLOCKERs and CRITICALs are guaranteed for HBase 2.0 release.
***** BLOCKER
*
HBASE-14417 Incremental backup and bulk loading ( Patch available)
*
HBASE-14135 HBase Backup/Restore Phase 3: Merge backup images
*
HBASE-14141 HBase Backup/Restore Phase 3: Filter WALs on backup to include only edits from backup tables (Patch available)
*
HBASE-17133 Backup documentation
*
HBASE-15227 Fault tolerance support
***** CRITICAL
*
HBASE-16465 Disable split/merges during backup
We have umbrella JIRA (
HBASE-14414) to track all the remaining work
All the BLOCKER and CRITICAL JIRAs currently in open state will be implemented by 2.0 release time. Some MAJOR too, but it depends on resource availability
The former development branch (
HBASE-7912) is obsolete and will be closed/deleted after the merge.
We want backup to be a GA feature in 2.0
We are going to support full backward compatibility for backup tool in 2.0 and onwards.
**** Configuration
Backup is disabled, by default. To enable it, the following configuration properties must be added to hbase-site.xml:
hbase.backup.enable=true
hbase.master.logcleaner.plugins=YOUR_PLUGINS,org.apache.hadoop.hbase.backup.master.BackupLogCleaner
hbase.procedure.master.classes=YOUR_CLASSES,org.apache.hadoop.hbase.backup.master.LogRollMasterProcedureManager
hbase.procedure.regionserver.classes=YOUR_CLASSES,org.apache.hadoop.hbase.backup.regionserver.LogRollRegionServerProcedureManager
**** Known Issues
* Bulk loaded data is not visible for incremental backup (will be resolved by 2.0 release)
* After first backup sessions, WAL files will be accumulated in old WAL directory until the next backup sessions. Make sure, that you either run backups regularly or disable backups in the system.
* No fault tolerance yet, some backup failures may result in corrupted backup data and will require manual intervention (will be resolved by 2.0 release)
Umbrella
Blocker
HBASE-15442 HBase Backup Phase 2: Potential data loss and or data duplication in incremental backup
HBASE-14125 HBase Backup/Restore Phase 2: Cancel backup
HBASE-15331 HBase Backup/Restore Phase 2: Optimized Restore operation
HBASE-14235 HBase Backup/Restore Phase 2: Async backup procedure
HBASE-7912 HBase Backup/Restore Based on HBase Snapshot