Bug 1330647

Summary: Syntax error in High Availability Add-On Reference for pcmk_host_map
Product: Red Hat Enterprise Linux 7 Reporter: Matt Ruzicka <mruzicka>
Component: doc-High_Availability_Add-On_ReferenceAssignee: Steven J. Levine <slevine>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.2CC: ofamera, rhel-docs
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-06 21:28:54 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:

Description Matt Ruzicka 2016-04-26 16:23:44 UTC 
Document URL: 

 https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html-single/High_Availability_Add-On_Reference/index.html#s1-redundantfence-HAAR

Section Number and Name: 

 4.11. Configuring Fencing for Redundant Power Supplies

Describe the issue: 

 The 'pcs stonith create' example section has incorrect syntax for the pcmk_host_map= parameter.  It specifies the use of a comma(,) between nodes, but the Admin Guide specifies a semi-colon(;).  Current case indicates the semi-colin(;) is correct.

Suggestions for improvement: 

Current Syntax - 

=====
# pcs stonith create apc1 fence_apc_snmp ipaddr=apc1.example.com login=user passwd='7a4D#1j!pz864' pcmk_host_map="node1.example.com:1,node2.example.com:2"

# pcs stonith create apc2 fence_apc_snmp ipaddr=apc2.example.com login=user passwd='7a4D#1j!pz864' pcmk_host_map="node1.example.com:1,node2.example.com:2"
=====

Appears the correct syntax should be -

=====
# pcs stonith create apc1 fence_apc_snmp ipaddr=apc1.example.com login=user passwd='7a4D#1j!pz864' pcmk_host_map="node1.example.com:1;node2.example.com:2"

# pcs stonith create apc2 fence_apc_snmp ipaddr=apc2.example.com login=user passwd='7a4D#1j!pz864' pcmk_host_map="node1.example.com:1;node2.example.com:2"
=====

 * I would suggest verifying this with a clusterha expert to verify.

Additional information: 

Admin Guide example from "1.3. Fencing Configuration" -

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html-single/High_Availability_Add-On_Administration/index.html#s1-fenceconfig-HAAA

=====
[root@z1 ~]# pcs stonith create myapc fence_apc_snmp params \
ipaddr="zapc.example.com" pcmk_host_map="z1.example.com:1;z2.example.com:2" \
pcmk_host_check="static-list" pcmk_host_list="z1.example.com,z2.example.com" \
login="apc" passwd="apc"
======
Comment 4 Steven J. Levine 2016-05-06 16:25:00 UTC 
I have rebuilt the 7.2 version of the document and tagged and submitted it for publication. The corrected version should appear on the Customer Portal in a few hours.  When it is there I will close this BZ.

This is the build:

Red_Hat_Enterprise_Linux-High_Availability_Add-On_Reference-7-web-en-US-2.1-14.el6eng
Comment 5 Steven J. Levine 2016-05-06 21:28:54 UTC 
The updated example can now be seen here on the customer Portal;

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/High_Availability_Add-On_Reference/s1-redundantfence-HAAR.html