retain

Syntax

Hierarchy Level

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-retain

Delete 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.

retain

Have 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.

Release Information

Statement introduced before Junos OS Release 7.4.

ON THIS PAGE