NAME
fence_apc_snmp - I/O Fencing agent for APC PDU SNMP devices
SYNOPSIS
fence_apc_snmp [OPTION]...
DESCRIPTION
fence_apc is an I/O Fencing agent which can be used with the APC rPDU,
MasterSwitch and MasterSwitch+ network power switch. It logs into a
device via SNMP and reboots a specified outlet. It supports SNMP v1 and
v3 with all combinations of authenticity/privacy settings.
fence_apc_snmp accepts options on the command line as well as from
stdin. Fenced sends parameters through stdin when it execs the agent.
fence_apc_snmp can be run by itself with command line options. This is
useful for testing.
OPTIONS
-a IPaddress
IP address or hostname of the SNMP device. Can be used any
syntax supported by snmpget.
-h Print out a help message describing available options, then
exit.
-c community
The read/write community string to be used in the request.
Default private.
-n name
Name of port to fence or port index. Port can use syntax
switch:port.
-s number
The switch to operate on. Defaults to "1" if not specified.
-p password
Password for login for SNMP v3 (authentication protocol pass
phrase).
-P password
Password for privacy for SNMP v3 (privacy protocol password).
-S script
Script to run to retrieve password for login for SNMP v3
(authentication protocol pass phrase).
-R script
Script to run to retrieve privacy for SNMP v3 (privacy protocol
password).
-l login
Login name for SNMP v3 (security name).
-d version
SNMP version (1,2c,3). Default 1.
-b auth_protocol
SNMP authentication protocol (MD5|SHA).
-E sec_level
SNMP security level (noAuthNoPriv|authNoPriv|authPriv).
-B priv_protocol
SNMP privacy protocol (DES|AES).
-u udp_port
UDP/TCP port to use.
-o action
The action required. off (default), on, status, list or
monitor. Deprecated options (enable -> on and disable -> off)
can be used too.
-v Verbose. Record session to stdout, or debug file if specified
(see -D).
-D Specifies file, where will be written debug messages from
session.
-V Print out a version message, then exit.
STDIN PARAMETERS
agent = < param >
This option is used by fence_node(8) and is ignored by
fence_apc_snmp.
ipaddr = < param >
IP address or hostname of the SNMP device. Can be used any
syntax supported by snmpget.
community = < param >
The read/write community string to be used in the request.
Default private.
port = < param >
Name of port to fence or port index. Port can use syntax
switch:port.
switch = < param >
The switch to operate on. Defaults to "1" if not specified.
passwd = < param >
Password for login for SNMP v3 (authentication protocol pass
phrase).
snmp_priv_passwd
Password for privacy for SNMP v3 (privacy protocol password).
passwd_script = < param >
Script to run to retrieve password for login for SNMP v3
(authentication protocol pass phrase).
snmp_priv_passwd_script = < param>
Password for privacy for SNMP v3 (privacy protocol password).
login = < param >
Login name for SNMP v3 (security name).
snmp_version = < param >
SNMP version (1,2c,3). Default 1.
snmp_auth_prot = < param >
SNMP authentication protocol (MD5|SHA).
snmp_sec_level = < param >
SNMP security level (noAuthNoPriv|authNoPriv|authPriv).
snmp_priv_prot = < param >
SNMP privacy protocol (DES|AES).
udpport = < param >
UDP/TCP port to use.
action = < param >
The action required. off (default), on, status, list or
monitor. Deprecated options (enable -> on and disable -> off)
can be used too.
verbose = < param >
Verbose. Record session to stdout, or debug file if specified
(see debug).
debug = < param >
Specifies file, where will be written debug messages from
session.
SEE ALSO
fence(8), fence_node(8)
fence_apc_snmp(8)