table of contents
OCF_HEARTBEAT_IPADDR(7) | OCF resource agents | OCF_HEARTBEAT_IPADDR(7) |
NAME¶
ocf_heartbeat_IPaddr2 - Manages virtual IPv4 and IPv6 addresses (Linux specific version)
SYNOPSIS¶
IPaddr2 [start | stop | status | monitor | meta-data | validate-all]
DESCRIPTION¶
This Linux-specific resource manages IP alias IP addresses. It can add an IP alias, or remove one. In addition, it can implement Cluster Alias IP functionality if invoked as a clone resource.
If used as a clone, you should explicitly set clone-node-max >= 2, and/or clone-max < number of nodes. In case of node failure, clone instances need to be re-allocated on surviving nodes. This would not be possible if there is already an instance on those nodes, and clone-node-max=1 (which is the default).
SUPPORTED PARAMETERS¶
ip
(unique, required, string, no default)
nic
Do NOT specify an alias interface in the form eth0:1 or anything here; rather, specify the base interface only. If you want a label, see the iflabel parameter.
Prerequisite:
There must be at least one static IP address, which is not managed by the cluster, assigned to the network interface. If you can not assign any static IP address on the interface, modify this kernel parameter:
sysctl -w net.ipv4.conf.all.promote_secondaries=1 # (or per device)
(optional, string, no default)
cidr_netmask
If unspecified, the script will also try to determine this from the routing table.
(optional, string, no default)
broadcast
(optional, string, no default)
iflabel
A label can be specified in nic parameter but it is deprecated. If a label is specified in nic name, this parameter has no effect.
(optional, string, no default)
lvs_support
Notes for IPv6: It is not necessary to enable this option on IPv6. Instead, enable ´lvs_ipv6_addrlabel´ option for LVS-DR usage on IPv6.
(optional, boolean, default false)
lvs_ipv6_addrlabel
See also ´lvs_ipv6_addrlabel_value´ parameter.
(optional, boolean, default false)
lvs_ipv6_addrlabel_value
(optional, integer, default 99)
mac
(optional, string, no default)
clusterip_hash
(optional, string, default "sourceip-sourceport")
unique_clone_address
(optional, boolean, default false)
arp_interval
(optional, integer, default 200)
arp_count
(optional, integer, default 5)
arp_bg
(optional, string, default "true")
arp_mac
You really shouldn´t be touching this.
(optional, string, default "ffffffffffff")
arp_sender
(optional, string, no default)
flush_routes
(optional, boolean, default false)
SUPPORTED ACTIONS¶
This resource agent supports the following actions (operations):
start
stop
status
monitor
meta-data
validate-all
EXAMPLE¶
The following is an example configuration for a IPaddr2 resource using the crm(8) shell:
primitive p_IPaddr2 ocf:heartbeat:IPaddr2 \
params \
ip=string \
op monitor depth="0" timeout="20s" interval="10s"
SEE ALSO¶
AUTHOR¶
Linux-HA contributors (see the resource agent source for information about individual authors)
03/22/2017 | resource-agents 3.9.2 |