| Summary: | Corrections needed in Tiering Limitations section of the Admin Guide | ||
|---|---|---|---|
| Product: | Red Hat Gluster Storage | Reporter: | Anjana Suparna Sriram <asriram> |
| Component: | doc-Administration_Guide | Assignee: | Laura Bailey <lbailey> |
| doc-Administration_Guide sub component: | Default | QA Contact: | Bala Konda Reddy M <bmekala> |
| Status: | CLOSED CURRENTRELEASE | Docs Contact: | |
| Severity: | unspecified | ||
| Priority: | unspecified | CC: | asriram, bmohanra, mchangir, mhideo, nlevinki, rhinduja, rhs-bugs, rwheeler, storage-doc |
| Version: | rhgs-3.1 | ||
| Target Milestone: | --- | ||
| Target Release: | RHGS 3.2.0 | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | If docs needed, set a value | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2017-03-24 01:09:05 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Bug Depends On: | |||
| Bug Blocks: | 1351553 | ||
|
Description
Anjana Suparna Sriram
2016-08-29 09:31:17 UTC
Thanks for creating the BZ. There's still some engineering debate going on what the command should actually be. So, I'll comment on this patch accordingly. The following things have been confirmed: # gluster volume tier <VOLNAME> attach [force] The tier attach command can accept an optional force argument. The force argument is required when re-attaching bricks which have been detached earlier. During the detach, some configuration bits are left behind that are detected during the re-attach and the attach is aborted. Specifying the force argument assumes that the warning presented during the earlier attach attempt without the force argument has been read and understood by the user and the user knows the significance of using the force argument. # gluster volume tier <VOLNAME> detach commit The tier detach commit command does NOT accept any force argument. The tier detach commit command is supposed to be used after the tier detach start command to commit the detach operation. # gluster volume tier <VOLNAME> detach force The tier detach command accepts a force command on its own to force a detach. Laura, I'm presuming this is a question regarding 'tier <vol> attach' command. When bricks are detached and attempted for a re-attach, you'll get to see a message stating that the 'brick is already part of a volume'. When a brick is detached, the extended attributes are not removed from the detached brick(s). On a re-attach attempt, this 'stale' information is detected and a message I mentioned above is spit out. The reason that the message is spit out is to raise a flag to the user as a word of caution. If the user is confident her actions, then the 'force' argument can be passed to the 'tier <vol> attach' command to re-attach the brick(s) to the volume. Please note that argument that needs to be passed is 'force' and not '--force' perfect Have shared my review comments with Laura over an email. verified the bz on document mentioned in the comment 14. Hence moving to verified Moving to CLOSED CURRENTRELEASE since RHGS 3.2 GA was yesterday. All documentation is available from https://access.redhat.com/documentation/en/red-hat-gluster-storage/. |