Adding a Route

Description

This command lets you add an IPv4 or IPv6 route to an existing Virtual SystemClosed Virtual Device on a VSX Gateway or VSX Cluster Member that implements the functionality of a Security Gateway. Acronym: VS. or Virtual RouterClosed Virtual Device on a VSX Gateway or VSX Cluster Member that functions as a physical router. Acronym: VR. object.

Note - This command detects IPv4 and IPv6 automatically.

Syntax

add route vd <Device Object Name> destination {<IP Address>[/<IP Prefix>] | default | default6} [{netmask <IP Netmask> | prefix <IP Prefix>}] {next_hop <Next Hop IP Address> | leads_to <VS or VR Object Name>} [propagate {true|false}]

Parameters

Parameter

Value

Notes

vd <Device Object Name>

Object name

Specifies the name of the Virtual System or Virtual Router object.

Mandatory parameter, if this is the first command in a transaction.

destination {<IP Address>[/<IP Prefix>] | default | default6}

See the Notes cell

Specifies the route destination settings:

  • <IP Address> - IPv4 or IPv6 address

  • <IP Prefix> -

    For IPv4 - Integer between 1 and 32

    For IPv6 - Integer between 64 and 128

  • default - Use the default IPv4 route

  • default6 - Use the default IPv6 route

netmask <IP Netmask>

Number

Specifies an IP Netmask:

  • For IPv4 - Number in a format X.X.X.X

  • For IPv6 - Number in a format XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX

prefix <IP Prefix>

Integer

Specifies the IP address prefix length:

  • For IPv4 - Integer between 1 and 32

  • For IPv6 - Integer between 64 and 128

next_hop <Next Hop IP Address>

IP Address

Specifies the IP address of the next hop of the route.

Notes:

  • This IP address must be on a subnet of an existing interface.

  • You must use next_hopor leads_to parameter, but not both.

leads_to <VS or VR Object Name>

Object name

Specifies the name of the Virtual System or Virtual Router object, which is the next hop for the configured route.

Note - You must use next_hopor leads_to parameter, but not both.

propagate {true|false}

  • true

  • false

Controls how to propagate the IP routes to adjacent Virtual Devices:

  • true - Propagate the IP routes

  • false - Do not propagate the IP routes (default)

Note - Applicable only if you specified the next_hop parameter.

Example - Adds route on a Virtual System VS1 that uses the default IPv4 route as a destination and Virtual Router VR3 as a next hop

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add route vd VS1 destination default leads_to VR3