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 dataplane <interface-name> ipv6 router-advert

Specifies the router advertisements to be sent from a data plane interface.

set interfaces dataplane interface-name 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 dataplane interface-name 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 ]

Router advertisements are not sent on an interface.

interface-name
The name of a data plane interface. For more information about the supported interface name formats, refer to Data Plane Interface.
cur-hop-limit limit
Specifies the hop-count field of the IP header for outgoing (unicast) IP packets. This value is placed in the Hop Count field of the IP header for outgoing (unicast) IP packets. The range is 0 to 255. The default is 64. A limit of 0 means unspecified by the router.
default-lifetime lifetime
Specifies the lifetime, in seconds, that is associated with the default router. A lifetime of 0 indicates that the router is not a default router. The lifetime ranges from the value that is configured for the max-interval option to 9000 (18.2 hours). If the lifetime is not configured, the value for this timer is three times max-interval.
default-preference preference
Specifies the preference that is associated with the default router. The preference is low, medium, or high. The default preference is medium.
link-mtu mtu
Specifies the MTU to be advertised for the link. The MTU is 0 or 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 when the link MTU is not well known.

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

managed-flag state
Whether to use the administered protocol for address autoconfiguration. The state is either of the following:

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

false: Hosts use only stateless address autoconfiguration.

The default state is false.

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

true: Hosts use the administered protocol for autoconfiguration of nonaddress information.

false: Hosts use stateless autoconfiguration of nonaddress information.

The default state is false.

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

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

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

true: The prefix can be used for autonomous address configuration.

false: The prefix cannot be used for autonomous address configuration.

The default state is true.

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

true: The prefix can be used for onlink determination.

false: The advertisement makes no statement about onlink 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 onlink and others being off-link.

The default state is true.

preferred-lifetime lifetime
Specifies the length of time, in seconds, that the addresses generated from the prefix by Stateless Address Autoconfiguration (SLAAC) is to remain preferred, as defined in RFC 4862. The interval 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 length of time, in seconds, that the prefix is valid for onlink determination, as defined in RFC 4862. The interval 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 a value of 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 a value of 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 either of the following:

true: Sends router advertisements from this interface.

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

The default state is true.

Configuration mode


interfaces {
    dataplane interface-name {
        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 router advertisements to be sent from a data plane 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 interfaces dataplane <interface-name> ipv6 disable-forwarding), router advertisements are not sent.

Most router advertisement 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 router advertisements.

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

Use the show form of this command to display router advertisement configuration.