regionInfoMismatch (Hbck2)

Reports regions in hbase:meta whose rowkey–encoded region name does not match the encoded region name stored in the region’s cell value. This issue can occur in tables with read replicas due to HBASE-23328.

Command Syntax

hbase hbck -j <path-to-hbck2-jar> regionInfoMismatch [OPTIONS]

Options

-f, --fix: Corrects mismatched region information by updating hbase:meta.

Description

This command scans hbase:meta and identifies cases where:

• The encoded region name in the rowkey (MD5 hash), and
• The encoded region name embedded in the RegionInfo cell value

do not match.

Although this inconsistency is usually harmless during normal HBase operations, it can cause other HBCK2 tools to fail.

It is strongly recommended to run the command without the --fix option first. This allows you to:

• Review the reported discrepancies
• Validate that the regions flagged are correct
• Confirm that the tool will generate the expected serialized RegionInfo structures

After validation, rerun the command with --fix to apply corrections.

Examples

1. Report mismatched region info without making changes:

hbase hbck -j <path-to-hbck2-jar> regionInfoMismatch

2. Fix all identified mismatches:

hbase hbck -j <path-to-hbck2-jar> regionInfoMismatch --fix