[HBASE-16291] Explain the correct semantic of hbase.client.retries.number in doc

• Type: Bug
• Status: Patch Available
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 1.1.5, 1.2.2, 0.98.20, 2.0.0
• Assignee: Phil Yang
• Reporter: Phil Yang
• Created: 27/Jul/16 11:27
• Updated: 23/May/19 21:24

Description

In hbase-default.xml (and also in HBase Book), the description of hbase.client.retries.number is:

Maximum retries. Used as maximum for all retryable operations such as the getting of a cell's value, starting a row update, etc. Retry interval is a rough function based on hbase.client.pause. At first we retry at this interval but then with backoff, we pretty quickly reach retrying every ten seconds. See HConstants#RETRY_BACKOFF for how the backup ramps up. Change this setting and hbase.client.pause to suit your workload.

However, the semantic of this conf is confusing and different in various branches. After HBASE-14521, in master it means "the number of RETRIES", but in all the other branches it still means "the number of TRIES".

So I think we need make the doc clear and tell users what it is in 0.98/1.x and what it will be from 2.0

Issue Links

• relates to: HBASE-14521 Unify the semantic of hbase.client.retries.number