Page MenuHomeClusterLabs Projects
Files F3153738

fence_zvmip.8
No OneTemporary
Actions

fence_zvmip.8
View Options

.TH fence_zvmip 8
.SH NAME
fence_zvmip - Power Fencing agent for GFS on System z z/VM Clusters using IP interface to SMAPI
.SH SYNOPSIS
.B
fence_zvmip
[\fIOPTION\fR]...
.SH DESCRIPTION
fence_zvmip is a Power Fencing agent used on a GFS virtual machine in a System z z/VM cluster.
It uses the TCP/IP SMAPI interface to recycle an active image.
fence_zvmip accepts options on the command line as well as from stdin.
fence_node sends the options through stdin when it execs the agent.
fence_zvmip can be run by itself with command line options which is useful
for testing.
Vendor URL: http://www.sinenomine.net
.SH OPTIONS
.TP
\fB-o --action\fP
Fencing action: "off" - deactivate virtual machine; "on" - activate virtual machine; "metadata" - display device metadata" - describe fence agent parameters; "status" - state of virtual machine
.TP
\fB--delay\fP \fIseconds\fP
Time to delay fencing action in seconds
.TP
\fB-n --plug\fP \fItarget\fP
Name of target virtual machine to fence
.TP
\fB-h --help\fP
Print out a help message describing available options, then exit.
.TP
\fB-a --ip\fP \fIsmapi Server\fP
Host name or IP address of SMAPI server
.TP
\fB-u --username\fP \fISMAPI authorized user\fP
Name of an authorized SMAPI user
.TP
\fB-p --password\fP \fISMAPI authorized user's password\fP
Password of the authorized SMAPI user
.TP
\fB-t --timeout\fP \fIRecycle timeout\fP
Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
forcibly terminated. Currently this is ignored.
.TP
\fB-h --help\fP
Display usage information
.SH STDIN PARAMETERS
.TP
\fIagent = < param >\fP
This option is used by fence_node(8) and is ignored by fence_zvmip.
.TP
\fIaction = < action >\fP
Fencing action: "off" - fence off device; "metadata" - display device metadata; "status" - state of device
.TP
\fIplug = < plug >\fP
Name of virtual machine to recycle.
.TP
\fIipaddr = < server host name or IP address >\fP
Host name or IP address of SMAPI server
.TP
\fIlogin = < SMAPI authorized user >\fP
Name of an authorized SMAPI user
.TP
\fIpasswd = < SMAPI authorized user's password >\fP
Password of the authorized SMAPI user
.TP
\fItimeout = < shutdown timeout >\fP
Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
forcibly terminated. Currently this is ignored.
.SH SEE ALSO
fence(8), fenced(8), fence_node(8)
.SH NOTES
To use this agent the z/VM SMAPI service needs to be configured to allow the virtual
machine running this agent to connect to it and issue the image_recycle operation.
This involves updating the VSMWORK1 AUTHLIST VMSYS:VSMWORK1. file. The entry should look
something similar to this:
.nf
Column 1 Column 66 Column 131
| | |
V V V
XXXXXXXX ALL IMAGE_OPERATIONS
.fi
Where XXXXXXX is the name of the virtual machine used in the authuser field of the request.

File Metadata

Mime Type
text/troff
Expires
Wed, Feb 26, 1:05 AM (1 d, 5 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1465075
Default Alt Text
fence_zvmip.8 (2 KB)

Event Timeline