Vyatta NOS documentation

Learn how to install, configure, and operate Vyatta Network Operating System (Vyatta NOS), which helps to drive our virtual networking and physical platforms portfolio.

interfaces openvpn <vtunx> ipv6 router-advert

Specifies the router advertisements (RA) to be sent from an OpenVPN interface.

set interfaces openvpn vtunx ipv6 router-advert [ cur-hop-limit limit ] [ default-lifetime lifetime ] [ default-preference preference ] [ link-mtu mtu ] [ managed-flag state ] [ max-interval interval ] [ min-interval interval ] [ other-config-flag state ] [ prefix ipv6net [ autonomous-flag state | on-link-flag state | preferred-lifetime lifetime | valid-lifetime lifetime ] ] [ reachable-time time ] [ retrans-timer time ] [ send-advert state ]
delete interfaces openvpn vtunx ipv6 router-advert [ cur-hop-limit ] [ default-lifetime ] [ default-preference ] [ link-mtu ] [ managed-flag ] [ max-interval ] [ min-interval ] [ other-config-flag ] [ prefix ipv6net [ autonomous-flag | on-link-flag | preferred-lifetime | valid-lifetime ] ] [ reachable-time ] [ retrans-timer ] [ send-advert ]
show interfaces openvpn vtunx ipv6 router-advert

Router advertisements are not sent on an interface.

vtunx
The identifier for the OpenVPN interface. This may be vtun0 to vtun x, where x is a non-negative integer.
cur-hope-limit limit
Limits the Hop Count field of the IP header for outgoing (unicast) IP packets. This limit is placed in the Hop Count field. The limit ranges from 0 through 255. The default limit is 64. A limit of 0 means that the limit is unspecified by the router.
default-lifetime lifetime
Specifies the lifetime, in seconds, associated with the default router. The lifetime either is 0, which indicates the router is not a default router, or it ranges from the interval specified in the max-interval argument through 9000 (18.2 hours). If not entered, the lifetime is three times the interval specified in the max-interval argument.
default-preference preference
Specifies the preference associated with the default router. The preference is one of the following:

low: Makes the default router low preference.

medium: Makes the default router medium preference. The default preference is medium.

high: Makes the default router high preference.

link-mtu mtu
Specifies the MTU to be advertised for the link. The MTU either is 0 or it ranges from 1280 through the maximum MTU for the type of link, as defined in RFC 2464. The default MTU is 0, which means the MTU is not specified in the router advertisement message. That is because it is expected that the MTU is configured directly on the interface itself and not for routing advertisements. You can configure this option in cases where the link MTU is not well known.

If the MTU entered here does not match the MTU configured on the interface, the system issues a warning but does not fail.

managed-flag state
Specifies whether to use the administered protocol for address autoconfiguration. The state is one of the following:

true: Specifies that hosts use the administered (stateful) protocol for address autoconfiguration in addition to any addresses autoconfigured using stateless address autoconfiguration.

false: Specifies that hosts use only stateless address autoconfiguration. The default state is false.

max-interval interval
Specifies the maximum time, in seconds, allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 4 through 1800. The default interval is 600 (10 minutes).
min-interval interval
Specifies the minimum time, in seconds, allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 3 through 0.75 times the interval specified in the max-interval argument. The default interval is 0.33 times the interval specified in the max-interval argument.
other-config-flag state
Specifies that the interface uses the administered (stateful) protocol for autoconfiguration of non-address information, as defined in RFC 4862. The state is one of the following:

true: Specifies that hosts use the administered protocol for autoconfiguration of non-address information.

false: Specifies that hosts use stateless autoconfiguration of non-address information. The default state is false.

prefix ipv6net
Multi-node. Specifies an IPv6 prefix, in the format ipv6-address/prefix, to be advertised on the IPv6 interface.

You can define more than one IPv6 prefix by configuring multiple prefix configuration nodes.

autonomous-flag state
Specifies whether the IPv6 prefix can be used for autonomous address configuration as defined in RFC 4862. The state is one of the following:

true: Specifies that the prefix can be used for autonomous address configuration. The default state is true.

false: Specifies that the prefix cannot be used for autonomous address configuration.

on-link-flag state
Specifies whether the IPv6 prefix can be used for on-link determination, as defined in RFC 4862. The state is one of the following:

true: Specifies that the prefix can be used for on-link determination. The default state is true.

false: Specifies that the advertisement makes no statement about on-link or off-link properties of the prefix. For instance, the prefix might be used for address configuration with some addresses belonging to the prefix being on-link and others being off-link.
preferred-lifetime lifetime
Specifies the lifetime, in seconds, that the addresses generated from the IPv6 prefix through Stateless Address Autoconfiguration (SLAAC) is to remain preferred, as defined in RFC 4862. The lifetime is with respect to the time the packet is sent. The lifetime ranges from 1 through 4294967296 plus the infinity keyword, which represents forever. (The actual value of infinity is a byte in which all bits are set to 1s: 0XFFFFFFFF.) The default lifetime is 604800 (7 days).
valid-lifetime lifetime
Specifies the lifetime, in seconds, that the IPv6 prefix is valid for the purpose of on-link determination, as defined in RFC 4862. The lifetime is with respect to the time the packet is sent. The lifetime ranges from 1 through 4294967296 plus the infinity keyword, which represents forever. (The actual value of infinity is a byte in which all bits are set to 1s: 0XFFFFFFFF.) The default lifetime is 2592000 (30 days).
reachable-time time
Specifies the length of time, in milliseconds, for which the system assumes a neighbor is reachable after having received a reachability confirmation. This time is used by address resolution and the Neighbor Unreachability Detection algorithm (see Section 7.3 of RFC 2461). The time ranges from 0 through 3600000, where 0 means the reachable time is not specified in the router advertisement message. The default time is 0.
retrans-timer time
Specifies the length of time, in milliseconds, between retransmitted NS messages. This time is used by address resolution and the Neighbor Unreachability Detection algorithm (see Sections 7.2 and 7.3 of RFC 2461). The time ranges from 0 through 4294967295, where 0 means the retransmit time is not specified in the router advertisement message. The default time is 0.
send-advert state
Specifies whether router advertisements are to be sent from this interface. The state is one of the following:

true: Sends router advertisements from this interface. The default state is true.

false: Does not send router advertisements from this interface. If this state is in effect, parameters in this configuration subtree are still used to configure the local implementation parameters.

Configuration mode

interfaces {
	openvpn vtunx {
		ipv6 {
			router-advert {
				cur-hop-limit limit
				default-lifetime lifetime
				default-preference preference
				link-mtu mtu
				managed-flag state
				max-interval interval
				min-interval interval
				other-config-flag state
				prefix ipv6net {
					autonomous-flag state
					on-link-flag state
					preferred-lifetime lifetime
					valid-lifetime lifetime
				}
				reachable-time time
				retrans-timer time
				send-advert state
			}
		}
	}
}

Use this command to specify the RA to be sent from an OpenVPN interface.

Router advertisements are sent by IPv6 routers to advertise their existence to hosts on the network. IPv6 hosts do not send router advertisements.

If the router-advert node of the configuration tree is missing, router advertisements are not sent. In addition, if IPv6 forwarding is disabled either globally (by using the system ipv6 disable-forwarding command) or on the interface (by using the interfaces openvpn vtunx ipv6 disable-forwarding command), RA are not sent.

Most RA parameters are required by either the Neighbor Discovery (ND) protocol or the Stateless Address Autoconfiguration (SLAAC) protocol. These parameters are used both locally for the IPv6 implementation and become part of the RA messages sent to hosts on the network so that they can be configured appropriately.

Use the set form of this command to create the router-advert configuration node and begin to send RA.

Use the delete form of this command to remove the router-advert configuration node and stop sending RA.

Use the show form of this command to view RA configuration.