Bug 1419708

Summary: Update documentation to account for new names for fence agent parameters
Product: Red Hat Enterprise Linux 7 Reporter: Steven J. Levine <slevine>
Component: doc-Cluster_GeneralAssignee: Steven J. Levine <slevine>
Status: CLOSED NOTABUG QA Contact:
Severity: unspecified Docs Contact:
Priority: medium    
Version: 7.2CC: cluster-maint, cluster-qe, kgaillot, mgrac, slevine, tojeline
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 1403028 Environment:
Last Closed: 2019-06-05 14:58:13 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:
Embargoed:
Bug Depends On: 1403028    
Bug Blocks:    

Comment 3 Steven J. Levine 2017-08-10 20:02:22 UTC 
Marek:

I'm looking at all of my open BZs and I'm not sure what to do with this one.

In the RHEL 7 HA manuals, we do not document the fence agent parameters for each fence agent (as we do for RHEL 6), because that information can be found realidy with a "pcs stonith describe" command.  But I thought I might have to update any fence configuration example that uses any of the updated parameters.

But in looking at the pcs help screens -- as well as BZ#1403028 -- it looks as if the pcs command parameters have not changed for 7.4.

Are there plans to change the names of the fence parameters for pcs at this point?  If not, I can close this as not a bug since it doesn't affect existing documentation

Steven
Comment 4 Marek Grac 2017-08-11 07:41:55 UTC 
@Steven:

You are right, they were not changed in pcs yet. There is a plan to do it in 7.5.
Comment 5 Steven J. Levine 2017-08-11 14:48:47 UTC 
Keeping this BZ open for 7.5.

Thanks, Marek.
Comment 6 Steven J. Levine 2018-02-08 15:29:03 UTC 
Marek:

This BZ had fallen by the wayside for a while.

For 7.5, should I update the parameter names in the example commands in the Pacemaker documentation that I noted in comment 2?

Steven
Comment 7 Marek Grac 2018-02-26 12:09:11 UTC 
@Steven:

yes, please. In 7.5 we should prefer new names that are consistent with long options from command line (old one will work as well).
Comment 8 Steven J. Levine 2018-02-26 15:27:02 UTC 
Marek:

If support in pcs for these new names is new for 7.5, should we put something in the release notes about this?  (Perhaps associated with BZ#1403028)?
Comment 10 Marek Grac 2018-02-28 13:50:19 UTC 
Related bug: https://bugzilla.redhat.com/show_bug.cgi?id=1436217

I have talked to Tomas to confirm the situation. One day (7.6+ / plan for 8.0  ), only the new options will be shown by pcs and validation will be done in fence agents. Currently, there is no way how to do validation in fence agents via pcs so we have to wait a bit.