[HADOOP-13190] Mention LoadBalancingKMSClientProvider in KMS HA documentation

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.7.0
• Fix Version/s: 2.8.0, 3.0.0-alpha1
• Component/s: documentation, kms
• Labels: supportability
• Hadoop Flags: Reviewed
• Assignee: Wei-Chiu Chuang
• Reporter: Wei-Chiu Chuang
• Created: 21/May/16 04:10
• Updated: 02/Oct/19 17:13
• Resolved: 11/Aug/16 21:21

Description

Currently, there are two ways to achieve KMS HA.

The first one, and the only documented one, is running multiple KMS instances behind a load balancer. https://hadoop.apache.org/docs/stable/hadoop-kms/index.html

The other way, is make use of LoadBalancingKMSClientProvider which is added in HADOOP-11620. However the usage is undocumented.

I think we should update the KMS document to introduce LoadBalancingKMSClientProvider, provide examples, and also update kms-site.xml to explain it.

Issue Links

• relates to: HADOOP-11620 Add support for load balancing across a group of KMS for HA