NAME

       fence_zvm - Power Fencing agent for GFS on System z z/VM Clusters

SYNOPSIS

       fence_zvm [OPTION]...

DESCRIPTION

       fence_zvm  is  a  Power  Fencing  agent  used  on a GFS virtual machine in a System z z/VM
       cluster.  It uses the SMAPI interface to recycle an active image.

       fence_zvm accepts options on the command line as well as from stdin.  fence_node sends the
       options  through  stdin  when  it  execs  the  agent.  fence_zvm can be run by itself with
       command line options which is useful for testing.

       Vendor URL: http://www.sinenomine.net

OPTIONS

       -o --action
              Fencing action: "off"  -  deactivate  virtual  machine;  "on"  -  activate  virtual
              machine;  "metadata"  - display device metadata" - describe fence agent parameters;
              "status" - state of virtual machine

       --delay seconds
              Time to delay fencing action in seconds

       -n --plug target
              Name of virtual machine to recycle.

       -h --help
              Print out a help message describing available options, then exit.

       -a --ip smapi Server
              Name of SMAPI server virtual machine. To be consistent with other fence agents this
              name  is  a  little  misleading:  it  is the name of the virtual machine not its IP
              address or hostname.

       --zvmsys z/VM System
              Name of z/VM on which the SMAPI server virtual machine resides. Optional - defaults
              to system on which the node is running.

       -h --help
              Display usage information

       -t --timeout = < shutdown timeout >
              Amount  of  grace time to give the virtual machine to shutdown cleanly before being
              forcibly terminated. Currently, this option is ignored.

STDIN PARAMETERS

       agent = < param >
              This option is used by fence_node(8) and is ignored by fence_zvm.

       action = < action >
              Fencing action: "off" - fence off device; "metadata"  -  display  device  metadata;
              "status" - state of device

       port = < target >
              Name of virtual machine to recycle.

       ipaddr= < server name >
              Name  of  SMAPI  server  virtual  machine. To be consistent with other fence agents
              thisname is a little misleading: it is the name of the virtual machine not  its  IP
              address or hostname.

       timeout = < shutdown timeout >
              Amount  of  grace time to give the virtual machine to shutdown cleanly before being
              forcibly terminated. Currently, this option is ignored.

SEE ALSO

       fence(8), fenced(8), fence_node(8)

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:

       Column 1                   Column 66                Column 131
       |                          |                        |
       V                          V                        V
       XXXXXXXX                   ALL                      IMAGE_OPERATIONS

       Where XXXXXXX is the name of the virtual machine where the agent resides.

       In  addition,  the  VM directory entry that defines this virtual machine requires the IUCV
       ANY statement (or IUCV <userid of SMAPI Server>). This authorizes use of IUCV  to  connect
       to the SMAPI server.

                                                                                     fence_zvm(8)