Appendix A. Fence Device Parameters
This appendix provides tables with parameter descriptions of fence devices. You can configure the parameters with luci, by using the
ccs command, or by editing the etc/cluster/cluster.conf file. For a comprehensive list and description of the fence device parameters for each fence agent, see the man page for that agent.
Note
The parameter for a fence device specifies an arbitrary name for the device that will be used by Red Hat High Availability Add-On. This is not the same as the DNS name for the device.
Note
Certain fence devices have an optional parameter. The parameter allows you to specify that a fence-device password is supplied from a script rather than from the parameter. Using the parameter supersedes the parameter, allowing passwords to not be visible in the cluster configuration file (
/etc/cluster/cluster.conf).
Table A.1, “Fence Device Summary” lists the fence devices, the fence device agents associated with the fence devices, and provides a reference to the table documenting the parameters for the fence devices.
Table A.2, “APC Power Switch (telnet/SSH)” lists the fence device parameters used by
fence_apc, the fence agent for APC over telnet/SSH.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the APC device connected to the cluster into which the fence daemon logs by means of telnet/ssh. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP Port (optional) | ipport | The TCP port to use to connect to the device. The default port is 23, or 22 if Use SSH is selected. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port | port | The port. |
| Switch (optional) | switch | The switch number for the APC switch that connects to the node when you have multiple daisy-chained switches. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Use SSH | secure | Indicates that system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
Table A.3, “APC Power Switch over SNMP” lists the fence device parameters used by
fence_apc_snmp, the fence agent for APC that logs into the SNP device by means of the SNMP protocol.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the APC device connected to the cluster into which the fence daemon logs by means of the SNMP protocol. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP port | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string; the default value is private. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | The port. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.4, “Brocade Fabric Switch” lists the fence device parameters used by
fence_brocade, the fence agent for Brocade FC switches.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Brocade device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address assigned to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Force IP Family | inet4_only, inet6_only | Force the agent to use IPv4 or IPv6 addresses only |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’\$’. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port | port | The switch outlet number. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
| Unfencing | unfence section of the cluster configuration file | When enabled, this ensures that a fenced node is not re-enabled until the node has been rebooted. This is necessary for non-power fence methods (that is, SAN/storage fencing). When you configure a device that requires unfencing, the cluster must first be stopped and the full configuration including devices and unfencing must be added before the cluster is started. For more information about unfencing a node, see the fence_node(8) man page. For information about configuring unfencing in the cluster configuration file, see Section 8.3, “Configuring Fencing”. For information about configuring unfencing with the ccs command, see Section 6.7.2, “Configuring a Single Storage-Based Fence Device for a Node”. |
Table A.5, “Cisco MDS” lists the fence device parameters used by
fence_cisco_mds, the fence agent for Cisco MDS.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Cisco MDS 9000 series device with SNMP enabled. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP port (optional) | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3). |
| SNMP Community | community | The SNMP community string. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | The port. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.6, “Cisco UCS” lists the fence device parameters used by
fence_cisco_ucs, the fence agent for Cisco UCS.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Cisco UCS device. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP port (optional) | ipport | The TCP port to use to connect to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSL | ssl | Use SSL connections to communicate with the device. |
| Sub-Organization | suborg | Additional path needed to access suborganization. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.7, “Dell DRAC 5” lists the fence device parameters used by
fence_drac5, the fence agent for Dell DRAC 5.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | The name assigned to the DRAC. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the DRAC. |
| IP Port (optional) | ipport | The TCP port to use to connect to the device. |
| Login | login | The login name used to access the DRAC. |
| Password | passwd | The password used to authenticate the connection to the DRAC. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
| Module Name | module_name | (optional) The module name for the DRAC when you have multiple DRAC modules. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’\$’. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
Table A.8, “Eaton Network Power Controller (SNMP Interface) (Red Hat Enterprise Linux 6.4 and later)” lists the fence device parameters used by
fence_eaton_snmp, the fence agent for the Eaton over SNMP network power switch.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Eaton network power switch connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port (optional) | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string; the default value is private. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. This parameter is always required. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.9, “Egenera BladeFrame” lists the fence device parameters used by
fence_egenera, the fence agent for the Egenera BladeFrame.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Egenera BladeFrame device connected to the cluster. |
| CServer | cserver | The host name (and optionally the user name in the form of username@hostname) assigned to the device. Refer to the fence_egenera(8) man page for more information. |
| ESH Path (optional) | esh | The path to the esh command on the cserver (default is /opt/panmgr/bin/esh) |
| Username | user | The login name. The default value is root. |
| lpan | lpan | The logical process area network (LPAN) of the device. |
| pserver | pserver | The processing blade (pserver) name of the device. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Unfencing | unfence section of the cluster configuration file | When enabled, this ensures that a fenced node is not re-enabled until the node has been rebooted. This is necessary for non-power fence methods (that is, SAN/storage fencing). When you configure a device that requires unfencing, the cluster must first be stopped and the full configuration including devices and unfencing must be added before the cluster is started. For more information about unfencing a node, see the fence_node(8) man page. For information about configuring unfencing in the cluster configuration file, see Section 8.3, “Configuring Fencing”. For information about configuring unfencing with the ccs command, see Section 6.7.2, “Configuring a Single Storage-Based Fence Device for a Node”. |
Table A.10, “Emerson Network Power Switch (SNMP interface) (Red Hat Enterprise LInux 6.7 and later) ” lists the fence device parameters used by
fence_emerson, the fence agent for Emerson over SNMP.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Emerson Network Power Switch device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port (optional) | udpport | UDP/TCP port to use for connections with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP privacy protocol password | snmp_priv_passwd | The SNMP Privacy Protocol Password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.11, “ePowerSwitch” lists the fence device parameters used by
fence_eps, the fence agent for ePowerSwitch.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the ePowerSwitch device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Name of Hidden Page | hidden_page | The name of the hidden page for the device. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.12, “Fence virt (Serial/VMChannel Mode)” lists the fence device parameters used by
fence_virt, the fence agent for virtual machines using VM channel or serial mode .
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Fence virt fence device. |
| Serial Device | serial_device | On the host, the serial device must be mapped in each domain's configuration file. For more information, see the fence_virt man page. If this field is specified, it causes the fence_virt fencing agent to operate in serial mode. Not specifying a value causes the fence_virt fencing agent to operate in VM channel mode. |
| Serial Parameters | serial_params | The serial parameters. The default is 115200, 8N1. |
| VM Channel IP Address | channel_address | The channel IP. The default value is 10.0.2.179. |
| Timeout (optional) | timeout | Fencing timeout, in seconds. The default value is 30. |
| Domain | port (formerly domain) | Virtual machine (domain UUID or name) to fence. |
ipport | The channel port. The default value is 1229, which is the value used when configuring this fence device with luci. | |
| Delay (optional) | delay | Fencing delay, in seconds. The fence agent will wait the specified number of seconds before attempting a fencing operation. The default value is 0. |
Table A.13, “Fence virt (fence_xvm/Multicast Mode) ” lists the fence device parameters used by
fence_xvm, the fence agent for virtual machines using multicast.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Fence virt fence device. |
| Timeout (optional) | timeout | Fencing timeout, in seconds. The default value is 30. |
| Domain | port (formerly domain) | Virtual machine (domain UUID or name) to fence. |
| Delay (optional) | delay | Fencing delay, in seconds. The fence agent will wait the specified number of seconds before attempting a fencing operation. The default value is 0. |
Table A.14, “Fujitsu Siemens Remoteview Service Board (RSB)” lists the fence device parameters used by
fence_rsb, the fence agent for Fujitsu-Siemens RSB.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the RSB to use as a fence device. |
| IP Address or Hostname | ipaddr | The host name assigned to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| Path to SSH Identity File | identity_file | The Identity file for SSH. |
| TCP Port | ipport | The port number on which the telnet service listens. The default value is 3172. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’\$’. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
Table A.15, “HP BladeSystem (Red Hat Enterprise Linux 6.4 and later)” lists the fence device parameters used by
fence_hpblade, the fence agent for HP BladeSystem.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | The name assigned to the HP Bladesystem device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the HP BladeSystem device. |
| IP Port (optional) | ipport | The TCP port to use to connect to the device. |
| Login | login | The login name used to access the HP BladeSystem device. This parameter is required. |
| Password | passwd | The password used to authenticate the connection to the fence device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’\$’. |
| Missing port returns OFF instead of failure | missing_as_off | Missing port returns OFF instead of failure. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
The fence agents for HP iLO devices (
fence_ilo and) HP iLO2 devices (fence_ilo2) share the same implementation. Table A.16, “HP iLO and HP iLO2” lists the fence device parameters used by these agents.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the server with HP iLO support. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP Port (optional) | ipport | TCP port to use for connection with the device. The default value is 443. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
The fence agents for HP iLO devices over SSH (
fence_ilo_ssh), HP iLO3 devices over SSH (fence_ilo3_ssh), and HP iLO4 devices over SSH (fence_ilo4_ssh) share the same implementation. Table A.17, “HP iLO over SSH, HP iLO3 over SSH, HPiLO4 over SSH (Red Hat Enterprise Linux 6.7 and later)” lists the fence device parameters used by these agents.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the server with HP iLO support. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| Path to SSH Identity File | identity_file | The Identity file for SSH. |
| TCP Port | ipport | UDP/TCP port to use for connections with the device; the default value is 23. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’MP>’, ’hpiLO->’. |
| Method to Fence | method | The method to fence: on/off or cycle |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
Table A.18, “HP iLO MP” lists the fence device parameters used by
fence_ilo_mp, the fence agent for HP iLO MP devices.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the server with HP iLO support. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP Port (optional) | ipport | TCP port to use for connection with the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The Identity file for SSH. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’MP>’, ’hpiLO->’. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
Table A.19, “HP Moonshot iLO (Red Hat Enterprise Linux 6.7 and later)” lists the fence device parameters used by
fence_ilo_moonshot, the fence agent for HP Moonshot iLO devices.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the server with HP iLO support. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSH | secure | Indicates that the system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| Path to SSH Identity File | identity_file | The Identity file for SSH. |
| TCP Port | ipport | UDP/TCP port to use for connections with the device; the default value is 22. |
| Force Command Prompt | cmd_prompt | The command prompt to use. The default value is ’MP>’, ’hpiLO->’. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Delay (seconds) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
Table A.20, “IBM BladeCenter” lists the fence device parameters used by
fence_bladecenter, the fence agent for IBM BladeCenter.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the IBM BladeCenter device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP port (optional) | ipport | TCP port to use for connection with the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Use SSH | secure | Indicates that system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
Table A.21, “IBM BladeCenter SNMP” lists the fence device parameters used by
fence_ibmblade, the fence agent for IBM BladeCenter over SNMP.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the IBM BladeCenter SNMP device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port (optional) | udpport | UDP/TCP port to use for connections with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP privacy protocol password | snmp_priv_passwd | The SNMP Privacy Protocol Password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.22, “IBM iPDU (Red Hat Enterprise Linux 6.4 and later)” lists the fence device parameters used by
fence_ipdu, the fence agent for iPDU over SNMP devices.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the IBM iPDU device connected to the cluster into which the fence daemon logs by means of the SNMP protocol. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string; the default value is private. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP Authentication Protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.23, “IF MIB” lists the fence device parameters used by
fence_ifmib, the fence agent for IF-MIB devices.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the IF MIB device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port (optional) | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.24, “Intel Modular” lists the fence device parameters used by
fence_intelmodular, the fence agent for Intel Modular.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the Intel Modular device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| UDP/TCP Port (optional) | udpport | The UDP/TCP port to use for connection with the device; the default value is 161. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| SNMP Version | snmp_version | The SNMP version to use (1, 2c, 3); the default value is 1. |
| SNMP Community | community | The SNMP community string; the default value is private. |
| SNMP Security Level | snmp_sec_level | The SNMP security level (noAuthNoPriv, authNoPriv, authPriv). |
| SNMP Authentication Protocol | snmp_auth_prot | The SNMP authentication protocol (MD5, SHA). |
| SNMP Privacy Protocol | snmp_priv_prot | The SNMP privacy protocol (DES, AES). |
| SNMP Privacy Protocol Password | snmp_priv_passwd | The SNMP privacy protocol password. |
| SNMP Privacy Protocol Script | snmp_priv_passwd_script | The script that supplies a password for SNMP privacy protocol. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
The fence agents for IPMI over LAN (
fence_ipmilan,) Dell iDRAC (fence_idrac), IBM Integrated Management Module (fence_imm), HP iLO3 devices (fence_ilo3), and HP iLO4 devices (fence_ilo4) share the same implementation. Table A.25, “IPMI (Intelligent Platform Management Interface) LAN, Dell iDrac, IBM Integrated Management Module, HPiLO3, HPiLO4” lists the fence device parameters used by these agents.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the fence device connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| Login | login | The login name of a user capable of issuing power on/off commands to the given port. |
| Password | passwd | The password used to authenticate the connection to the port. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Authentication Type | auth | Authentication type: none, password, or MD5. |
| Use Lanplus | lanplus | True or 1. If blank, then value is False. It is recommended that you enable Lanplus to improve the security of your connection if your hardware supports it. |
| Ciphersuite to use | cipher | The remote server authentication, integrity, and encryption algorithms to use for IPMIv2 lanplus connections. |
| Privilege level | privlvl | The privilege level on the device. |
| IPMI Operation Timeout | timeout | Timeout in seconds for IPMI operation. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. The default value is 2 seconds for fence_ipmilan, fence_idrac, fence_imm, and fence_ilo4. The default value is 4 seconds for fence_ilo3. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Method to Fence | method | The method to fence: on/off or cycle |
Table A.26, “Fence kdump” lists the fence device parameters used by
fence_kdump, the fence agent for kdump crash recovery service. Note that fence_kdump is not a replacement for traditional fencing methods; The fence_kdump agent can detect only that a node has entered the kdump crash recovery service. This allows the kdump crash recovery service to complete without being preempted by traditional power fencing methods.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the fence_kdump device. |
| IP Family | family | IP network family. The default value is auto. |
| IP Port (optional) | ipport | IP port number that the fence_kdump agent will use to listen for messages. The default value is 7410. |
| Operation Timeout (seconds) (optional) | timeout | Number of seconds to wait for message from failed node. |
| Node name | nodename | Name or IP address of the node to be fenced. |
Table A.27, “Multipath Persistent Reservation Fencing (Red Hat Enterprise Linux 6.7 and later)” lists the fence device parameters used by
fence_mpath, the fence agent for multipath persistent reservation fencing.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the fence_mpath device. |
| Devices (Comma delimited list) | devices | Comma-separated list of devices to use for the current operation. Each device must support SCSI-3 persistent reservations. |
| Use sudo when calling third-party software | sudo | Use sudo (without password) when calling 3rd party software. |
| Path to sudo binary (optional) | sudo_path | Path to sudo binary (default value is /usr/bin/sudo. |
| Path to mpathpersist binary (optional) | mpathpersist_path | Path to mpathpersist binary (default value is /sbin/mpathpersist. |
| Path to a directory where the fence agent can store information (optional) | store_path | Path to directory where fence agent can store information (default value is /var/run/cluster. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Unfencing | unfence section of the cluster configuration file | When enabled, this ensures that a fenced node is not re-enabled until the node has been rebooted. This is necessary for non-power fence methods. When you configure a device that requires unfencing, the cluster must first be stopped and the full configuration including devices and unfencing must be added before the cluster is started. For more information about unfencing a node, see the fence_node(8) man page. For information about configuring unfencing in the cluster configuration file, see Section 8.3, “Configuring Fencing”. For information about configuring unfencing with the ccs command, see Section 6.7.2, “Configuring a Single Storage-Based Fence Device for a Node”. |
| Key for current action | key | Key to use for the current operation. This key should be unique to a node and written in /etc/multipath.conf. For the "on" action, the key specifies the key use to register the local node. For the "off" action, this key specifies the key to be removed from the device(s). This parameter is always required. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.28, “RHEV-M fencing (RHEL 6.2 and later against RHEV 3.0 and later)” lists the fence device parameters used by
fence_rhevm, the fence agent for RHEV-M fencing.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | Name of the RHEV-M fencing device. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP Port (optional) | ipport | The TCP port to use for connection with the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Use SSL | ssl | Use SSL connections to communicate with the device. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Port (Outlet) Number | port | Physical plug number or name of virtual machine. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.29, “SCSI Reservation Fencing” lists the fence device parameters used by
fence_scsi, the fence agent for SCSI persistent reservations.
Note
Use of SCSI persistent reservations as a fence method is supported with the following limitations:
- When using SCSI fencing, all nodes in the cluster must register with the same devices so that each node can remove another node's registration key from all the devices it is registered with.
- Devices used for the cluster volumes should be a complete LUN, not partitions. SCSI persistent reservations work on an entire LUN, meaning that access is controlled to each LUN, not individual partitions.
It is recommended that devices used for the cluster volumes be specified in the format
/dev/disk/by-id/xxx where possible. Devices specified in this format are consistent among all nodes and will point to the same disk, unlike devices specified in a format such as /dev/sda which can point to different disks from machine to machine and across reboots.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the SCSI fence device. |
| Unfencing | unfence section of the cluster configuration file | When enabled, this ensures that a fenced node is not re-enabled until the node has been rebooted. This is necessary for non-power fence methods (that is, SAN/storage fencing). When you configure a device that requires unfencing, the cluster must first be stopped and the full configuration including devices and unfencing must be added before the cluster is started. For more information about unfencing a node, see the fence_node(8) man page. For information about configuring unfencing in the cluster configuration file, see Section 8.3, “Configuring Fencing”. For information about configuring unfencing with the ccs command, see Section 6.7.2, “Configuring a Single Storage-Based Fence Device for a Node”. |
| Node name | nodename | The node name is used to generate the key value used for the current operation. |
| Key for current action | key | (overrides node name) Key to use for the current operation. This key should be unique to a node. For the "on" action, the key specifies the key use to register the local node. For the "off" action,this key specifies the key to be removed from the device(s). |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
Table A.30, “VMware Fencing (SOAP Interface) (Red Hat Enterprise Linux 6.2 and later)” lists the fence device parameters used by
fence_vmware_soap, the fence agent for VMware over SOAP API.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | Name of the virtual machine fencing device. |
| IP Address or Hostname | ipaddr | The IP address or host name assigned to the device. |
| IP Port (optional) | ipport | The TCP port to use for connection with the device. The default port is 80, or 443 if Use SSL is selected. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| VM name | port | Name of virtual machine in inventory path format (for example, /datacenter/vm/Discovered_virtual_machine/myMachine). |
| VM UUID | uuid | The UUID of the virtual machine to fence. |
| Delay (optional) | delay | The number of seconds to wait before fencing is started. The default value is 0. |
| Use SSL | ssl | Use SSL connections to communicate with the device. |
Table A.31, “WTI Power Switch” lists the fence device parameters used by
fence_wti, the fence agent for the WTI network power switch.
| luci Field | cluster.conf Attribute | Description |
|---|---|---|
| Name | name | A name for the WTI power switch connected to the cluster. |
| IP Address or Hostname | ipaddr | The IP or host name address assigned to the device. |
| IP Port (optional) | ipport | The TCP port to use to connect to the device. |
| Login | login | The login name used to access the device. |
| Password | passwd | The password used to authenticate the connection to the device. |
| Password Script (optional) | passwd_script | The script that supplies a password for access to the fence device. Using this supersedes the parameter. |
| Force command prompt | cmd_prompt | The command prompt to use. The default value is [’RSM>’, ’>MPC’, ’IPS>’, ’TPS>’, ’NBB>’, ’NPS>’, ’VMR>’] |
| Power Wait (seconds) | power_wait | Number of seconds to wait after issuing a power off or power on command. |
| Power Timeout (seconds) | power_timeout | Number of seconds to continue testing for a status change after issuing a power off or power on command. The default value is 20. |
| Shell Timeout (seconds) | shell_timeout | Number of seconds to wait for a command prompt after issuing a command. The default value is 3. |
| Login Timeout (seconds) | login_timeout | Number of seconds to wait for a command prompt after login. The default value is 5. |
| Times to Retry Power On Operation | retry_on | Number of attempts to retry a power on operation. The default value is 1. |
| Use SSH | secure | Indicates that system will use SSH to access the device. When using SSH, you must specify either a password, a password script, or an identity file. |
| SSH Options | ssh_options | SSH options to use. The default value is -1 -c blowfish. |
| Path to SSH Identity File | identity_file | The identity file for SSH. |
| Port | port | Physical plug number or name of virtual machine. |
