Provided by: resource-agents_3.9.2-5ubuntu4_i386 bug

NAME

       ocf_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)