OCF_HEARTBEAT_ROUTE(7) OCF resource agents OCF_HEARTBEAT_ROUTE(7)NAMEocf_heartbeat_Route - Manages network routes
SYNOPSIS
Route [start | stop | monitor | meta-data | validate-all]
DESCRIPTION
Enables and disables network routes.
Supports host and net routes, routes via a gateway address, and routes
using specific source addresses.
This resource agent is useful if a node's routing table needs to be
manipulated based on node role assignment.
Consider the following example use case:
- One cluster node serves as an IPsec tunnel endpoint.
- All other nodes use the IPsec tunnel to reach hosts in a specific
remote network.
Then, here is how you would implement this scheme making use of the
Route resource agent:
- Configure an ipsec LSB resource.
- Configure a cloned Route OCF resource.
- Create an order constraint to ensure that ipsec is started before
Route.
- Create a colocation constraint between the ipsec and Route resources,
to make sure no instance of your cloned Route resource is started on
the tunnel endpoint itself.
SUPPORTED PARAMETERS
destination
The destination network (or host) to be configured for the route.
Specify the netmask suffix in CIDR notation (e.g. "/24"). If no
suffix is given, a host route will be created. Specify "0.0.0.0/0"
or "default" if you want this resource to set the system default
route.
(unique, required, string, no default)
device
The outgoing network device to use for this route.
(unique, optional, string, no default)
gateway
The gateway IP address to use for this route.
(unique, optional, string, no default)
source
The source IP address to be configured for the route.
(unique, optional, string, no default)
table
The routing table to be configured for the route.
(optional, string, no default)
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
start
Starts the resource. Suggested minimum timeout: 20.
stop
Stops the resource. Suggested minimum timeout: 20.
monitor
Performs a detailed status check. Suggested minimum timeout: 20.
Suggested interval: 10.
reload
Suggested minimum timeout: 20.
meta-data
Retrieves resource agent metadata (internal use only). Suggested
minimum timeout: 5.
validate-all
Performs a validation of the resource configuration. Suggested
minimum timeout: 20.
EXAMPLE
The following is an example configuration for a Route resource using
the crm(8) shell:
primitive p_Route ocf:heartbeat:Route \
params \
destination=string \
op monitor timeout="20" interval="10" depth="0"
SEE ALSO
http://www.linux-ha.org/wiki/Route_(resource_agent)AUTHOR
Linux-HA contributors (see the resource agent source for information
about individual authors)
resource-agents UNKNOWN 03/24/2013 OCF_HEARTBEAT_ROUTE(7)
