[HBASE-14367] Add normalization support to shell

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.1.2
• Fix Version/s: 1.2.0, 1.3.0, 2.0.0
• Component/s: Balancer, shell

Release Note

This patch adds shell support for region normalizer (see HBASE-13103).

3 commands have been added to hbase shell 'tools' command group (modeled on how the balancer works):

 - 'normalizer_enabled' checks whether region normalizer is turned on
 - 'normalizer_switch' allows user to turn normalizer on and off
 - 'normalize' runs region normalizer if it's turned on.

Also 'alter' command has been extended to allow user to enable/disable region normalization per table (disabled by default). Use it as

alter 'testtable', {NORMALIZATION_MODE => 'true'}

Here is the help for the normalize command:

{code}
hbase(main):008:0> help 'normalize'
Trigger region normalizer for all tables which have NORMALIZATION_MODE flag set. Returns true
 if normalizer ran successfully, false otherwise. Note that this command has no effect
 if region normalizer is disabled (make sure it's turned on using 'normalizer_switch' command).

 Examples:

   hbase> normalize
{code}

• Assignee: Mikhail Antonov
• Reporter: Lars George
• Created: 04/Sep/15 13:15
• Updated: 16/Jun/22 01:17
• Resolved: 04/Oct/15 08:34

Description

https://issues.apache.org/jira/browse/HBASE-13103 adds support for setting a normalization flag per HTableDescriptor, along with the server side chore to do the work.

What is lacking is to easily set this from the shell, right now you need to use the Java API to modify the descriptor. This issue is to add the flag as a known attribute key and/or other means to toggle this per table.

Issue Links

• is related to: HBASE-13103 [ergonomics] add region size balancing as a feature of master
• relates to: HBASE-15124 Document the new 'normalization' feature in refguid