retain

 

Syntax

Hierarchy Level

Release Information

Statement introduced before Junos OS Release 7.4.

Statement introduced in Junos OS Release 9.0 for EX Series switches.

Statement introduced in Junos OS Release 11.3 for the QFX Series.

Statement introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

Description

Configure statically configured routes to be deleted from or retained in the forwarding table when the routing protocol process shuts down normally.

Note

You cannot configure both retain and resolve options for a statically configured route because resolved next hops cannot be retained.

Default

Statically configured routes are deleted from the forwarding table when the routing protocol process shuts down normally.

The retention policy applied to defaults and route is as follows:

  • defaults— The default route retention policy. By default, the default route retention policy is no-retain for the configured scope using the defaults configuration statement. This default retention policy is overridden on a per route basis using the routes option.

  • route—The retention policy for this route. The default retention policy for a route is the policy of its routing table.

Options

no-retainDelete statically configured routes from the forwarding table when the routing protocol process shuts down normally. To explicitly specify that routes be deleted from the forwarding table, include the no-retain statement. Include this statement when configuring an individual route in the route portion of the static statement to override a retain option specified in the defaults portion of the statement.
retainHave a static route remain in the forwarding table when the routing protocol process shuts down normally. Doing this greatly reduces the time required to restart a system that has a large number of routes in its routing table.

Required Privilege Level

routing—To view this statement in the configuration.

routing-control—To add this statement to the configuration.

Related Documentation