The fence_scsi man page in RHEL5 is incorrect. It states: "The fence_scsi fencing agent requires a minimum of three nodes in the cluster to operate. For SAN devices connected via fiber channel, these must be physical nodes. SAN devices connected via iSCSI may use virtual or physical nodes. In addition, fence_scsi cannot be used in conjunction with qdisk." There are two things are are incorrect: 1. The fence_scsi agent can be used with two node clusters in 5.4.z and later. 2. The fence_scsi agent can be used with qdisk as long at the qdisk devices are not clvmd devices and therefore subject to SCSI-PR. I suggest we simply remove this "limitations" section. The correct limitations are well defined in the tech brief.
Created attachment 578188 [details] Remove "limitations" section from man page. Most of the limitations listed in the man page were inaccurate. Since the limitations for fence_scsi are documented elsewhere, we can remove them from the man page.
Created attachment 578195 [details] Remove limitations section from man page
This request was evaluated by Red Hat Product Management for inclusion in a Red Hat Enterprise Linux release. Product Management has requested further review of this request by Red Hat Engineering, for potential inclusion in a Red Hat Enterprise Linux release for currently deployed products. This request is not yet committed for inclusion in a release.
Setting docs_scoped to +. The updated limitations are already in the Cluster Administration manual, consistent with the tech brief, so there is no further documentation impact.
Resetting docs_scoped (to unset), which is what I should have left it as.
I have verified that the paragraph is no longer present in the man page in corrected version of rpm. --- Bugged version: cman-2.0.115-96.el5 Installed corrected version: cman-2.0.115-101.el5 --- # rpm -q cman cman-2.0.115-101.el5 # diff /usr/share/man/man8/fence_scsi.8.gz ./cman-2.0.115-96.el5/usr/share/man/man8/fence_scsi.8.gz 101a102,108 > .SH LIMITATIONS > The fence_scsi fencing agent requires a minimum of three nodes in the > cluster to operate. For SAN devices connected via fiber channel, > these must be physical nodes. SAN devices connected via iSCSI may use > virtual or physical nodes. In addition, fence_scsi cannot be used in > conjunction with qdisk. >
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHBA-2013-0076.html