[ACCUMULO-2972] ChangeSecret needs better documentation

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 1.5.0, 1.5.1, 1.6.0
• Fix Version/s: 1.6.6, 1.7.3, 1.8.1, 2.0.0
• Component/s: docs
• Labels: newbie
• Assignee: Michael Miller
• Reporter: Sean Busbey
• Created: 02/Jul/14 16:52
• Updated: 09/Sep/16 18:58
• Resolved: 09/Sep/16 18:58

Description

Right now, the only mention of how to change an instance secret is a note on the instance.secret property and the example invocation is wrong.

The correct invocation:

accumulo org.apache.accumulo.server.util.ChangeSecret

The instructions should specify the following caveats

1. The cluster must be down before running (verified by the tool)
2. The command should be run as the user that controls the existing Accumlo files in HDFS (ref ACCUMULO-2971)

The instructions for use should probably go in the troubleshooting section of the manual, and then get a link from the instance.secret property as well as the accumulo settings section that talks about the instance secret.

Issue Links

• links to: GitHub Pull Request #149