Bug 887349

Summary:	fence_scsi man page should mention that configuring respective unfence is more than reasonable
Product:	Red Hat Enterprise Linux 6	Reporter:	Jan Pokorný [poki] <jpokorny>
Component:	fence-agents	Assignee:	Marek Grac <mgrac>
Status:	CLOSED ERRATA	QA Contact:	Cluster QE <mspqa-list>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.4	CC:	acathrow, cluster-maint, fdinitto, lnovich, mjuricek, slevine
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	fence-agents-3.1.5-27.el6	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:
Clones:	987070 (view as bug list)		Environment:
Last Closed:	2013-11-21 07:16:57 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:
Bug Blocks:	865161, 893574, 893575, 987070

Description Jan Pokorný [poki] 2012-12-14 17:53:02 UTC

From a recent discussion about fence_sanlock, it came out that fence_scsi
is another example of fence agent requiring unfence configured for a proper
function.  Contrary to fence_sanlock, fence_scsi man page does not document
this.  IMHO, any nontrivial restriction leading to nontrivial issues when
not abided should be documented.

# rpm -qf /usr/share/man/man8/fence_scsi.8.gz
fence-agents-3.1.5-17.el6.x86_64

Comment 1 Ryan O'Hara 2013-02-07 15:11:48 UTC

The fence_scsi agent doesn't *require* unfencing, the cluster requires it. In other words, unfencing is a cluster concept. The fence_scsi agent can be used outside of cluster product, in which case unfencing is meaningless. NACK.

Comment 2 Jan Pokorný [poki] 2013-02-22 09:48:50 UTC

Ah, ok.

If it is not even recommendable in general (is it?), please close the bug.

Comment 3 Jan Pokorný [poki] 2013-02-22 11:21:00 UTC

Well, the whole man page seems to talk about fence_scsi in the context
of cluster, so this bug is completely valid.

Comment 4 Fabio Massimo Di Nitto 2013-04-17 09:31:03 UTC

Let´s add a note, that when fence_scsi is used in a cluster context, unfecing should be configured/executed.

This should make everybody happy.

Comment 5 Marek Grac 2013-05-27 13:23:16 UTC

Fixed in upstream:


https://git.fedorahosted.org/cgit/fence-agents.git/commit/?id=d6504496b019dcd6bd066dd398b898b87d4ddd49

Comment 11 Steven J. Levine 2013-07-22 15:53:38 UTC

I should add a similar note to the Cluster Administration manual so I'm cloning this as a documentation bug.

Comment 13 errata-xmlrpc 2013-11-21 07:16:57 UTC

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-1562.html