OCF_HEARTBEAT_ROUTE(7)

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.

    (optional, string, no default)

gateway
    The gateway IP address to use for this route.

    (optional, string, no default)

source
    The source IP address to be configured for the route.

    (optional, string, no default)

table
    The routing table to be configured for the route.

    (optional, string, no default)

family
    The address family to be used for the route ip4 IP version 4 ip6 IP version 6 detect Detect from 'destination' address.

    (optional, string, default "detect")

SUPPORTED ACTIONS

This resource agent supports the following actions (operations):

start
    Starts the resource. Suggested minimum timeout: 20s.

stop
    Stops the resource. Suggested minimum timeout: 20s.

monitor
    Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval: 10s.

reload
    Suggested minimum timeout: 20s.

meta-data
    Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

validate-all
    Performs a validation of the resource configuration. Suggested minimum timeout: 20s.

EXAMPLE CRM SHELL

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="20s" interval="10s" depth="0"

EXAMPLE PCS

The following is an example configuration for a Route resource using pcs(8)

    pcs resource create p_Route ocf:heartbeat:Route \
      destination=string \
      op monitor timeout="20s" interval="10s" OCF_CHECK_LEVEL="0"

SEE ALSO

http://clusterlabs.org/

AUTHOR

ClusterLabs contributors (see the resource agent source for information about individual authors)