l Commands – Part II

lfa-policy-map

lfa-policy-map

Syntax

lfa-policy-map route-nh-template template-name

no lfa-policy-map

Context

[Tree] (config>service>vprn>isis>if lfa-policy-map)

Full Context

configure service vprn isis interface lfa-policy-map

Description

This command applies a route next-hop policy template to the IS-IS interface for the VPRN instance.

When a route next-hop policy template is applied to an interface in IS-IS, it is applied in both level 1 and level 2. When a route next-hop policy template is applied to an interface in OSPF, it is applied in all areas. However, the command in an OSPF interface context can only be executed under the area in which the specified interface is primary and then applied in that area and in all other areas where the interface is secondary. If the user attempts to apply it to an area where the interface is secondary, the command fails.

If the user excluded the interface from LFA using the command loopfree-alternate-exclude, the LFA policy, if applied to the interface, has no effect.

Finally, if the user applied a route next-hop policy template to a loopback interface or to the system interface, the command will not be rejected, but it will result in no action being taken.

The no form deletes the mapping of a route next-hop policy template to an OSPF or IS-IS interface.

Parameters

template-name

Specifies the name of the template, up to 32 characters.

Platforms

All

lfa-policy-map

Syntax

lfa-policy-map route-nh-template template-name

no lfa-policy-map

Context

[Tree] (config>router>ospf3>area>if lfa-policy-map)

[Tree] (config>router>ospf>area>if lfa-policy-map)

[Tree] (config>router>isis>if lfa-policy-map)

[Tree] (config>service>vprn>ospf>area>if lfa-policy-map)

[Tree] (config>service>vprn>ospf3>area>if lfa-policy-map)

Full Context

configure router ospf3 area interface lfa-policy-map

configure router ospf area interface lfa-policy-map

configure router isis interface lfa-policy-map

configure service vprn ospf area interface lfa-policy-map

configure service vprn ospf3 area interface lfa-policy-map

Description

This command applies a route next-hop policy template to an OSPF or IS-IS interface.

When a route next-hop policy template is applied to an interface in IS-IS, it is applied in both level 1 and level 2. When a route next-hop policy template is applied to an interface in OSPF, it is applied in all areas. However, the command in an OSPF interface context can only be executed under the area in which the specified interface is primary and then applied in that area and in all other areas where the interface is secondary. If the user attempts to apply it to an area where the interface is secondary, the command fails.

If the user excluded the interface from LFA using the command loopfree-alternate-exclude, the LFA policy, if applied to the interface, has no effect.

Finally, if the user applied a route next-hop policy template to a loopback interface or to the system interface, the command will not be rejected, but it results in no action being taken.

The no form deletes the mapping of a route next-hop policy template to an OSPF or IS-IS interface.

Default

no lfa-policy-map

Parameters

template-name

Specifies the name of the template, up to 32 characters.

Platforms

All

li

li

Syntax

li

Context

[Tree] (config li)

Full Context

configure li

Description

Commands in this context configure lawful intercept (LI) parameters.

Platforms

All

li

Syntax

[no] li

Context

[Tree] (config>system>security>profile li)

Full Context

configure system security profile li

Description

This command enables the Lawful Intercept (LI) profile identifier.

The no form of this command disables the LI profile identifier.

Platforms

All

li-filter

li-filter

Syntax

li-filter

Context

[Tree] (config>li li-filter)

Full Context

configure li li-filter

Description

Commands in this context configure the li-filter branch to create LI filter lists and entries.

Platforms

All

li-filter-associations

li-filter-associations

Syntax

li-filter-associations

Context

[Tree] (config>li li-filter-associations)

Full Context

configure li li-filter-associations

Description

Commands in this context configure the LI filter associations entries that are inserted into normal filters.

Platforms

All

li-filter-block-reservation

li-filter-block-reservation

Syntax

li-filter-block-reservation

Context

[Tree] (config>li li-filter-block-reservation)

Full Context

configure li li-filter-block-reservation

Description

This command enable the LI filter block reservation branch to configure lawful intercept filter reservations.

Platforms

All

li-filter-lock-state

li-filter-lock-state

Syntax

li-filter-lock-state {locked | unlocked-for-li-users | unlocked-for-all-users}

no li-filter-lock-state

Context

[Tree] (config>li li-filter-lock-state)

Full Context

configure li li-filter-lock-state

Description

This command configures the lock state of the filters used by LI. With the configurable filter lock for LI feature an LI user can control the behavior of filters when they are used for LI.

Prior to Release 12.0.R1, when a filter entry was used as a Lawful Intercept (LI) mirror source criteria, all subsequent attempts to modify the filter were then blocked to avoid having the LI session impacted by a non-LI user.

The no form of this command reverts to the default.

Default

li-filter-lock-state locked

Parameters

locked

When an li-source criteria is configured that references any entry of filter Y, then filter Y can no longer be changed (until there are no longer any li-source references to entries of filter Y).

unlocked-for-li-users

Filters can continue to be edited by LI users only even when an li-source references an entry in that filter.

unlocked-for-all-users

Filters can continue to be edited by all users even when an li-source references an entry in that filter.

Platforms

All

li-group

li-group

Syntax

li-group isa-group-id

no li-group

Context

[Tree] (config>li>x-interfaces>x3 li-group)

Full Context

configure li x-interfaces x3 li-group

Description

This command configures the ISA group used for the X3 interface.

The no form of this command reverts to the default.

Parameters

isa-group-id

Specifies the ISA group ID.

Values

1 to 4

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

li-ip-filter

li-ip-filter

Syntax

li-ip-filter li-filter-name [create]

no li-ip-filter li-filter-name

Context

[Tree] (config>li>li-filter li-ip-filter)

Full Context

configure li li-filter li-ip-filter

Description

This command creates a Lawful Interception (LI) IPv4 filter list, or enters the CLI context for a LI IPv4 filter list. LI IPv4 filters are used as a manner to create confidential IPv4 filter based li-source entries. The LI IPv4 filter entries are inserted/merged into normal IPv4 filters as configured with the li-filter-associations and li-filter-block-reservation commands, but the LI IPv4 filter entries are not visible to users without LI permissions.

The no form of this command removes the LI IPv4 filter name from the configuration.

Parameters

li-filter-name

Specifies the name of the IPv4 address filter. Filter names cannot start with an underscore character (for example, "_my-filter”) and cannot use the name "default”.

Platforms

All

li-ip-filter

Syntax

[no] li-ip-filter li-filter-name

Context

[Tree] (config>li>li-filter-assoc li-ip-filter)

Full Context

configure li li-filter-associations li-ip-filter

Description

Specifies the li-ip-filter that will have its entries inserted into a list of normal IP filters.

The no form of this command removes the LI filter name from the configuration.

Parameters

li-filter-name

Specifies an existing li-ip-filter, up to 32 characters.

Platforms

All

li-ip-filter

Syntax

li-ip-filter li-filter-name entry li-entry-id [li-entry-id] [intercept-id intercept-id [intercept-id]] [session-id session-id [session-id]]

no li-ip-filter li-filter-name [entry li-entry-id [li-entry-id]]

Context

[Tree] (config>li>li-source li-ip-filter)

Full Context

configure li li-source li-ip-filter

Description

This command enables lawful interception (LI) of packets that match specific entries in an existing LI IP filter that has been associated with a normal IP filter. The specification of an li-ip-filter entry as an li-source means that packets matching the li-ip-filter entry will be intercepted on all interfaces/saps/and so on where the associated normal ip-filter(s) are applied.

Parameters

li-filter-name

Specifies the name of the li-ip-filter, up to 32 characters.

li-entry-id

Specifies the entry ID in the li-ip-filter that is to be used as an li-source criteria.

Values

1 to 65535

intercept-id

Specifies the intercept-id that is inserted into the packet header for all mirrored packets of the associated li-source entry. This intercept ID can be used (for example by a downstream LI gateway) to identify the particular LI session to which the packet belongs. For all types of li-source entries (filter, nat, sap, subscriber), when the mirror service is configured with ip-udp-shim routable encap, an intercept-id field (as part of the routable encap) is always present in the mirrored packets. If there is no intercept-id configured for an li-source entry, then the default value will be inserted. When the mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no intercept ID is inserted and none can be specified against the li-source entries.

session-id

Specifies the session-id that is inserted into the packet header for all mirrored packets of the associated li-source entry. This session-id can be used (for example by a downstream LI Gateway) to identify the particular LI session to which the packet belongs. The session-id is only valid and used for mirror services that are configured with ip-udp-shim routable encap (config>mirror>mirror-dest>encap>ip-udp-shim). For all types of li-source entries (filter, nat, sap, or subscriber), when the mirror service is configured with ip-udp-shim routable encap, a session-id field (as part of the routable encap) is always present in the mirrored packets. If there is no session-id configured for an li-source entry, then the default value will be inserted. When a mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no session-id is inserted and none can be specified against the li-source entries.

Platforms

All

li-ipv6-filter

li-ipv6-filter

Syntax

li-ipv6-filter li-filter-name [create]

no li-ipv6-filter li-filter-name

Context

[Tree] (config>li>li-filter li-ipv6-filter)

Full Context

configure li li-filter li-ipv6-filter

Description

This command creates a Lawful Interception (LI) IPv6 filter list, or enters the CLI context for a LI IPv6 filter list. LI IPv6 filters are used as a manner to create confidential IPv6 filter based li-source entries. The LI IPv6 filter entries are inserted or merged into normal IPv6 filters as configured with the li-filter-associations and li-filter-block-reservation commands, but the LI IPv6 filter entries are not visible to users without LI permissions.

The no form of this command removes the LI IPv6 filter name from the configuration.

Parameters

li-filter-name

Specifies the name of the IPv6 address filter. Filter names cannot start with an underscore character (for example, "_my-filter”) and cannot use the name "default”.

create

creates a LI IPv6 filter.

Platforms

All

li-ipv6-filter

Syntax

[no] li-ipv6-filter li-filter-name

Context

[Tree] (config>li>li-filter-assoc li-ipv6-filter)

Full Context

configure li li-filter-associations li-ipv6-filter

Description

This command specifies the li-ipv6-filter that will have its entries inserted into a list of normal IPv6 filters.

The no form of this command removes the filter name from the configuration.

Parameters

li-filter-name

Specifies an existing li-ipv6-filter up to 32 characters.

Platforms

All

li-ipv6-filter

Syntax

li-ipv6-filter li-filter-name entry li-entry-id [li-entry-id] [intercept-id intercept-id [intercept-id]] [session-id session-id [session-id]]

no li-ipv6-filter li-filter-name [entry li-entry-id [li-entry-id]]

Context

[Tree] (config>li>li-source li-ipv6-filter)

Full Context

configure li li-source li-ipv6-filter

Description

This command enables lawful interception (LI) of packets that match specific entries in an existing LI IPv6 filter that has been associated with a normal IPv6 filter. The specification of an li-ipv6-filter entry as an li-source means that packets matching the li-ipv6-filter entry will be intercepted on all interfaces/saps/and so on, where the associated normal ip-filter(s) are applied.

Parameters

li-filter-name

Specifies the name of the li-ipv6-filter up to 32 characters.

li-entry-id

Specifies the entry ID in the li-ipv6-filter that is to be used as an LI source criteria.

Values

1 to 65535

intercept-id

Specifies the intercept ID that is inserted into the packet header for all mirrored packets of the associated li-source entry. This intercept-id can be used (for example by a downstream LI gateway) to identify the particular LI session to which the packet belongs. For all types of li-source entries (filter, nat, sap, or subscriber), when the mirror service is configured with ip-udp-shim routable encap, an intercept-id field (as part of the routable encapsulation) is always present in the mirrored packets. If there is no intercept-id configured for an li-source entry, then the default value will be inserted. When the mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no intercept ID is inserted and none can be specified against the LI source entries.

session-id

Specifies the session ID that is inserted into the packet header for all mirrored packets of the associated li-source entry. This session-id can be used (for example, by a downstream LI gateway) to identify the particular LI session to which the packet belongs. The session-id is only valid and used for mirror services that are configured with ip-udp-shim routable encap (config>mirror>mirror-dest>encap>ip-udp-shim). For all types of li-source entries (filter, nat, sap, subscriber), when the mirror service is configured with ip-udp-shim routable encap, a session-id field (as part of the routable encap) is always present in the mirrored packets. If there is no session ID configured for an li-source entry, then the default value is inserted. When a mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no session ID is inserted and none can be specified against the li-source entries.

Platforms

All

li-local-save

li-local-save

Syntax

[no] li-local-save

Context

[Tree] (bof li-local-save)

Full Context

bof li-local-save

Description

This command specifies whether or not lawful intercept (LI) configuration is allowed to be saved to a local file. Modifying this command will not take effect until the system is rebooted.

Default

li-local-save

Platforms

All

li-mac-filter

li-mac-filter

Syntax

li-mac-filter li-filter-name [create]

no li-mac-filter li-filter-name

Context

[Tree] (config>li>li-filter li-mac-filter)

Full Context

configure li li-filter li-mac-filter

Description

This command creates a Lawful Interception (LI) MAC filter list, or enters the CLI context for a LI MAC filter list. LI MAC filters are used as a manner to create confidential MAC filter based li-source entries. The LI MAC filter entries are inserted/merged into normal MAC filters as configured via the li-filter-associations and li-filter-block-reservation commands, but the LI MAC filter entries are not visible to users without LI permissions.

The no form of this command removes the MAC LI filter name from the configuration.

Parameters

li-filter-name

Specifies the name of the MAC filter. Filter names cannot start with an underscore character (for example, "_my-filter”) and cannot use the name "default”.

Platforms

All

li-mac-filter

Syntax

[no] li-mac-filter li-filter-name

Context

[Tree] (config>li>li-filter-assoc li-mac-filter)

Full Context

configure li li-filter-associations li-mac-filter

Description

Specifies the li-mac-filter that will have its entries inserted into a list of normal mac filters.

Parameters

li-filter-name

Specifies the name of the LI MAC filter, up to 32 characters. Filter names cannot start with an underscore character (for example, "_my-filter”) and cannot use the name "default”.

Platforms

All

li-mac-filter

Syntax

li-mac-filter li-filter-name entry li-entry-id [li-entry-id] [intercept-id intercept-id [intercept-id]] [session-id session-id [session-id]]

no li-mac-filter li-filter-name [entry li-entry-id [li-entry-id]]

Context

[Tree] (config>li>li-source li-mac-filter)

Full Context

configure li li-source li-mac-filter

Description

This command enables lawful interception (LI) of packets that match specific entries in an existing LI MAC filter that has been associated with a normal MAC filter. The specification of an li-mac-filter entry as an li-source means that packets matching the li-mac-filter entry will be intercepted on all interfaces, saps and so on where the associated normal mac-filter(s) are applied.

Parameters

li-filter-name

Specifies the name of the li-mac-filter, up to 32 characters.

li-entry-id

Specifies the entry id in the li-mac-filter that is to be used as an li-source criteria.

Values

1 to 65535

intercept-id

Specifies the intercept ID that is inserted into the packet header for all mirrored packets of the associated li-source entry. This intercept ID can be used (for example, by a downstream LI gateway) to identify the particular LI session to which the packet belongs. For all types of li-source entries (filter, nat, sap, subscriber), when the mirror service is configured with ip-udp-shim routable encap, an intercept-id field (as part of the routable encap) is always present in the mirrored packets. If there is no intercept-id configured for an li-source entry, then the default value will be inserted. When the mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no intercept-id is inserted and none can be specified against the li-source entries.

session-id

Specifies the session-id that is inserted into the packet header for all mirrored packets of the associated li-source entry. This session-id can be used (for example by a downstream LI gateway) to identify the particular LI session to which the packet belongs. The session-id is only valid and used for mirror services that are configured with ip-udp-shim routable encap (config>mirror>mirror-dest>encap>ip-udp-shim). For all types of li-source entries (filter, nat, sap, subscriber), when the mirror service is configured with ip-udp-shim routable encap, a session-id field (as part of the routable encap) is always present in the mirrored packets. If there is no session-id configured for an li-source entry, then the default value will be inserted. When a mirror service is configured with ip-gre or ip-udp-shim-sampled routable encap, no session-id is inserted and none can be specified against the li-source entries.

Platforms

All

li-reserved-block

li-reserved-block

Syntax

li-reserved-block block-name [create]

no li-reserved-block block-name

Context

[Tree] (config>li>li-filter-block-reservation li-reserved-block)

Full Context

configure li li-filter-block-reservation li-reserved-block

Description

This command creates or edits an LI reserved block. An LI reserved block allows an operator to define where entries from an LI filter should be inserted into a normal filter. The block reserves a configurable number of entries in the normal filter that can only be used for entries inserted from associated LI filters. The LI filter entries that get inserted into the reserved block in each normal filter are not visible to non-LI operators. The block also defines to which normal filters the reservation is applied.

The no form of this command removes the block name from the configuration.

Parameters

block-name

Specifies the name of the MAC filter. Block names cannot start with an underscore character (for example, "_my-filter”) and cannot use the name "default”.

Platforms

All

li-separate

li-separate

Syntax

[no] li-separate

Context

[Tree] (bof li-separate)

Full Context

bof li-separate

Description

This command specifies whether or not a non-LI user has access to lawful intercept (LI) information. When this command is enabled, a user who does not have LI access will not be allowed to access CLI or SNMP objects in the li context. Modifying this command will not take effect until the system is rebooted.

When the no li-separate command is set (the default mode), those who are allowed access to the config>system>security>profile context and user command nodes are allowed to modify the configuration of the LI parameters. In this mode, a user that has a profile allowing access to the config>li and/or show>li command contexts can enter and use the commands under those nodes.

When the li-separate command is configured, only users that have the LI access capabilities set in the config>system>security>user>access li context are allowed to access the config>li and/or show>li command contexts. A user who does not have LI access is not allowed to enter the config>li and show>li contexts even though they have a profile that allows access to these nodes. When in the li-separate mode, only users with config>system>security>user>access li set in their user account have the ability modify the setting LI parameters in either their own or other profiles and user configurations.

Default

no li-separate

Platforms

All

li-source

li-source

Syntax

[no] li-source mirror-service-id [name mirror-service-name]

Context

[Tree] (config>li li-source)

Full Context

configure li li-source

Description

This command configures a lawful intercept (LI) mirror source.

Parameters

mirror-service-id

Specifies the service ID in the service domain. This ID is unique to this service and cannot be used by any other service, regardless of service type. The same service ID must be configured on every router that this particular service is defined on.

Values

service-id:1 to 2147483647

svc-name: up to 64 characters

Platforms

All

lic

lic

Syntax

lic lic-name [create]

no lic lic-name

Context

[Tree] (config>li>x-interfaces>lics lic)

Full Context

configure li x-interfaces lics lic

Description

This command configures the parameters to communicate with a specific LIC.

The no form of this command removes the LIC name.

Parameters

lic-name

Specifies the LIC name to be used as a reference, up to 32 characters.

create

Mandatory keyword to create this entry.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

lic-identifier

lic-identifier

Syntax

lic-identifier identifier

no lic-identifier

Context

[Tree] (config>li>x-interfaces>lics>lic lic-identifier)

Full Context

configure li x-interfaces lics lic lic-identifier

Description

This command configures the string that identifies this LIC.

The no form of this command reverts to the default.

Parameters

identifier

Specifies the LIC identifying string, up to 32 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

license

license

Syntax

license

Context

[Tree] (admin>system license)

Full Context

admin system license

Description

Enters a context for administrative commands related to licensing.

Platforms

All

license-file

license-file

Syntax

license-file file-url

no license-file

Context

[Tree] (bof license-file)

Full Context

bof license-file

Description

This command configures the license location and file name.

The no form of this command removes the file URL from the configuration.

Parameters

file-url

Specifies the file-url.

Values

file-url

{local-url | remote-url} (up to 180 characters)

local-url

[cflash-id/][file-path]

remote-url

[{ftp://| tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:, cf1-A:, cf1-B:, cf2:, cf2-A:, cf2-B:, cf3:, cf3-A:, cf3-B:

Platforms

All

lics

lics

Syntax

lics

Context

[Tree] (config>li>x-interfaces lics)

Full Context

configure li x-interfaces lics

Description

Commands in this context configure the Network Element to communicate with LI Centers (LICs).

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

lifetime

lifetime

Syntax

lifetime minimum minimum maximum maximum

no lifetime

Context

[Tree] (config>service>nat>pcp-server-policy lifetime)

Full Context

configure service nat pcp-server-policy lifetime

Description

This command configures the lifetime of explicit mappings made by the PCP servers.

Default

lifetime minimum 120 maximum 86400

Parameters

minimum

Specifies the minimum lifetime of explicit mappings made by the PCP servers using this PCP policy, in seconds.

Values

60 to 86399

maximum

Specifies the maximum lifetime of explicit mappings made by the PCP servers using this PCP policy, in seconds.

Values

61 to 86400

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

lifetime

Syntax

lifetime {seconds | forever}

Context

[Tree] (config>system>script-control>script-policy lifetime)

Full Context

configure system script-control script-policy lifetime

Description

This command is used to configure the maximum amount of time that a script may run.

Default

lifetime 3600

Parameters

seconds

Specifies the maximum amount of time that a script may run, in seconds.

Values

0 to 21474836

Default

3600 (1 hour)

forever

Specifies to allow a script to run indefinitely.

Platforms

All

limit

limit

Syntax

limit {all-packet-matches | first-session-match}

Context

[Tree] (debug>app-assure>group>traffic-capture>record limit)

Full Context

debug application-assurance group traffic-capture record limit

Description

This command records limit conditions.

Parameters

all-packet-matches

Records all the packets matching the condition.

first-session-match

Records only the first session matching the condition.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

limit-init-exchange

limit-init-exchange

Syntax

limit-init-exchange [reduced-max-exchange-timeout seconds]

no limit-init-exchange

Context

[Tree] (config>ipsec>ike-policy limit-init-exchange)

Full Context

configure ipsec ike-policy limit-init-exchange

Description

This command limits the number of ongoing IKEv2 initial exchanges per tunnel to 1. When the system receives a new IKEv2 IKE_SA_INIT request when there is an ongoing IKEv2 initial exchange from same peer, then system reduces the timeout value of the existing exchange to the specified reduced-max-exchange-timeout. If the reduced-max-exchange-timeout is disabled, then the system does not reduce the timeout value.

The no form of this command reverts to the default value.

Default

limit-init-exchange reduced-max-exchange-timeout 2

Parameters

seconds

Specifies the maximum timeout for the in-progress initial IKE exchange.

Values

2 to 60, disabled

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

limit-mac-move

limit-mac-move

Syntax

limit-mac-move [blockable | non-blockable]

no limit-mac-move

Context

[Tree] (config>service>vpls>spoke-sdp limit-mac-move)

[Tree] (config>service>vpls>sap limit-mac-move)

Full Context

configure service vpls spoke-sdp limit-mac-move

configure service vpls sap limit-mac-move

Description

This command indicates whether or not the mac-move agent, when enabled using config>service>vpls>mac-move or config>service>epipe>mac-move, limits the MAC re-learn (move) rate on this SAP.

Default

limit-mac-move blockable

Parameters

blockable

Specifies that the agent monitors the MAC re-learn rate on the SAP, and it blocks it when the re-learn rate is exceeded.

non-blockable

Specifies that this SAP is not blocked, and another blockable SAP is blocked instead.

Platforms

All

limit-mac-move

Syntax

limit-mac-move [blockable | non-blockable]

no limit-mac-move

Context

[Tree] (config>service>pw-template limit-mac-move)

Full Context

configure service pw-template limit-mac-move

Description

This command indicates whether or not the mac-move agent will limit the MAC re-learn (move) rate.

Default

limit-mac-move blockable

Parameters

blockable

The agent will monitor the MAC re-learn rate, and it will block it when the re-learn rate is exceeded.

non-blockable

When specified, a SAP will not be blocked, and another blockable SAP will be blocked instead.

Platforms

All

limit-pir-zero-drain

limit-pir-zero-drain

Syntax

[no] limit-pir-zero-drain

Context

[Tree] (config>qos>adv-config-policy>child-control>bandwidth-distribution limit-pir-zero-drain)

Full Context

configure qos adv-config-policy child-control bandwidth-distribution limit-pir-zero-drain

Description

This command is used to configure the system to use the minimum configurable PIR instead of an H-QoS derived zero operational PIR. The default behavior is to allow the operational PIR of the queue to remain the last configured value while setting the queue MBS to zero (preventing queuing of newly arriving packets). Retaining the previous PIR value may cause a momentary burst above an aggregate rate associated with the queue as it drains. Using the limit-pir-zero-drain command causes the queue to drain at the lowest rate possible (typically 1 kb/s) that limits overrun situations.

The no form of this command reverts to default behavior.

Platforms

All

limit-unused-bandwidth

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>port>ethernet>network>egr>qgrp>agg-rate limit-unused-bandwidth)

[Tree] (config>port>ethernet>access>egr>qgrp>agg-rate limit-unused-bandwidth)

[Tree] (config>service>vprn>sub-if>grp-if>sap>egress limit-unused-bandwidth)

[Tree] (config>port>ethernet>access>egress>vport limit-unused-bandwidth)

Full Context

configure port ethernet network egress queue-group agg-rate limit-unused-bandwidth

configure port ethernet access egress queue-group agg-rate limit-unused-bandwidth

configure service vprn subscriber-interface group-interface sap egress limit-unused-bandwidth

configure port ethernet access egress vport limit-unused-bandwidth

Description

This command specifies to limit the unused bandwidth and allow a tighter control in allocation of bandwidth by HQoS. When enabled, HQoS algorithm distributes any unused aggregate bandwidth between queues operating below their fair share rates. This allows a simplified aggregate rate protection while allocating bandwidth by HQoS.

The no form of this command reverts to the default.

Platforms

All

  • configure port ethernet access egress vport limit-unused-bandwidth
  • configure port ethernet access egress queue-group agg-rate limit-unused-bandwidth
  • configure port ethernet network egress queue-group agg-rate limit-unused-bandwidth

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface sap egress limit-unused-bandwidth

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>service>vprn>sub-if>grp-if>sap>egress>agg-rate limit-unused-bandwidth)

[Tree] (config>service>ies>if>sap>egress>agg-rate limit-unused-bandwidth)

[Tree] (config>service>ies>sub-if>grp-if>sap>egress>agg-rate limit-unused-bandwidth)

Full Context

configure service vprn subscriber-interface group-interface sap egress agg-rate limit-unused-bandwidth

configure service ies interface sap egress agg-rate limit-unused-bandwidth

configure service ies subscriber-interface group-interface sap egress agg-rate limit-unused-bandwidth

Description

This command enables aggregate rate overrun protection.

The no form of this command reverts to the default.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service ies subscriber-interface group-interface sap egress agg-rate limit-unused-bandwidth
  • configure service vprn subscriber-interface group-interface sap egress agg-rate limit-unused-bandwidth

All

  • configure service ies interface sap egress agg-rate limit-unused-bandwidth

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>service>cpipe>sap>egress>agg-rate limit-unused-bandwidth)

[Tree] (config>service>epipe>sap>egress>agg-rate limit-unused-bandwidth)

[Tree] (config>service>ipipe>sap>egress>agg-rate limit-unused-bandwidth)

Full Context

configure service cpipe sap egress agg-rate limit-unused-bandwidth

configure service epipe sap egress agg-rate limit-unused-bandwidth

configure service ipipe sap egress agg-rate limit-unused-bandwidth

Description

This command is used to enable (or disable) aggregate rate overrun protection on the agg-rate context.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

  • configure service cpipe sap egress agg-rate limit-unused-bandwidth

All

  • configure service epipe sap egress agg-rate limit-unused-bandwidth
  • configure service ipipe sap egress agg-rate limit-unused-bandwidth

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>service>vpls>sap>egress>encap-defined-qos>encap-group>agg-rate limit-unused-bandwidth)

[Tree] (config>service>template>vpls-sap-template>egress>agg-rate limit-unused-bandwidth)

[Tree] (config>service>vpls>sap>egress>agg-rate limit-unused-bandwidth)

Full Context

configure service vpls sap egress encap-defined-qos encap-group agg-rate limit-unused-bandwidth

configure service template vpls-sap-template egress agg-rate limit-unused-bandwidth

configure service vpls sap egress agg-rate limit-unused-bandwidth

Description

This command is used to enable aggregate rate overrun protection on the agg-rate context.

The no form of this command disables the overrun protection.

Platforms

All

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>service>vprn>if>sap>egress>agg-rate limit-unused-bandwidth)

Full Context

configure service vprn interface sap egress agg-rate limit-unused-bandwidth

Description

This command is used to enable (or disable) aggregate rate overrun protection on the agg-rate context.

Platforms

All

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>qos>scheduler-policy>tier>scheduler limit-unused-bandwidth)

Full Context

configure qos scheduler-policy tier scheduler limit-unused-bandwidth

Description

This command is used to enable (or disable) aggregate rate overrun protection on the agg-rate context.

Platforms

All

limit-unused-bandwidth

Syntax

[no] limit-unused-bandwidth

Context

[Tree] (config>service>cust>multi-service-site>egress>agg-rate limit-unused-bandwidth)

Full Context

configure service customer multi-service-site egress agg-rate limit-unused-bandwidth

Description

This command is used to enable aggregate rate overrun protection.

The no form of the command disables aggregate rate overrun protection.

Default

no limit-unused-bandwidth

Platforms

All

line-length

line-length

Syntax

line-length {110 | 220 | 330 | 440 | 550 | 660}

Context

[Tree] (config>system>sync-if-timing>bits>output line-length)

Full Context

configure system sync-if-timing bits output line-length

Description

This command configures the line-length parameter of the BITS output, This is the distance in feet between the network element and the office clock (BITS/SSU). There are two possible BITS-out interfaces, one for each CPM. They are configured together, but they are displayed separately in the show command. This command is only applicable when the interface-type is DS1.

Default

line-length 110

Parameters

110

Specifies that the distance is from 0 to 110 feet.

220

Specifies that the distance is from 110 to 220 feet.

330

Specifies that the distance is from 220 to 330 feet.

440

Specifies that the distance is from 330 to 440 feet.

550

Specifies that the distance is from 440 to 550 feet.

660

Specifies that the distance is from 550 to 660 feet.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

link

link

Syntax

link port-id {primary | secondary}

no link port-id

Context

[Tree] (config>lag>link-map-profile link)

Full Context

configure lag link-map-profile link

Description

This command designates one of the configured ports of the LAG to be used on egress as either a primary or secondary link (based on the option selected) by all SAPs and network interfaces that use this LAG link map profile.

Links are part of a profile When a link is added or deleted, all SAPs and network interfaces that use this link-map-profile may be re-hashed if required.

The no form of this command deletes the link from this LAG link mapping profile. A port must be deleted from all LAG link profiles if it is to be deleted from the LAG.

Parameters

port-id

Specifies a physical port ID that is an existing member of this LAG.

port-id

slot/mda/port[.channel]

eth-sat-id

esat-id/slot/port

esat

keyword

id

1 to 20

pxc-id

pxc-id.sub-port

pxc

keyword

id

1 to 64

sub-port

a, b

primary

Designates one of the configured ports of the LAG to be used on egress as a primary link by SAPs/network interfaces that use this LAG link map profile.

secondary

Designates one of the configured ports of the LAG to be used on egress as a secondary link by SAPs/network interfaces that use this LAG link map profile.

Platforms

All

link

Syntax

[no] link

Context

[Tree] (config>test-oam>link-meas>template>ret-path link)

Full Context

configure test-oam link-measurement measurement-template twamp-light return-path link

Description

This command includes a return path sub-TLV link. The link sub-tlv instructs a Session-Reflector configured for type stamp to use the receiving logical IP interface for the transmission of the response packet from the reflector to the session-sender. The destination of the reflected packet must be installed in the forwarding table and reachable out the IP interface or the packet is dropped by the Session-Reflector. When there are parallel non-equal cost return paths between the Session-Reflector and the Session-Sender the response packet can only be returned on the lowest cost path.

Default

no link

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

link-addr

link-addr

Syntax

link-addr ipv6-address

no link-addr

Context

[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>slaac link-addr)

[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>dhcpv4-nat link-addr)

[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>slaac link-addr)

[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>ia-na link-addr)

[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>ia-na link-addr)

[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>dhcpv4-nat link-addr)

Full Context

configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client slaac link-addr

configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client dhcpv4-nat link-addr

configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client slaac link-addr

configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client ia-na link-addr

configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client ia-na link-addr

configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client dhcpv4-nat link-addr

Description

This command specifies the ipv6-address that should be included in the link-address field of the relay header. This can be used for pool selection by the DHCPv6 server.

The no form of this command falls back to the default.

Parameters

ipv6-address

Specifies the IPv6 address up to 32 characters.

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

link-address

link-address

Syntax

link-address ipv6-address

no link-address

Context

[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>relay link-address)

[Tree] (config>service>ies>if>ipv6>dhcp6-relay link-address)

[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>relay link-address)

[Tree] (config>service>vprn>if>ipv6>dhcp6-relay link-address)

[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host link-address)

[Tree] (config>service>vprn>sub-if>ipv6>dhcp6>relay link-address)

[Tree] (config>service>ies>sub-if>ipv6>dhcp6>relay link-address)

Full Context

configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay link-address

configure service ies interface ipv6 dhcp6-relay link-address

configure service ies subscriber-interface group-interface ipv6 dhcp6 relay link-address

configure service vprn interface ipv6 dhcp6-relay link-address

configure subscriber-mgmt local-user-db ipoe host link-address

configure service vprn subscriber-interface ipv6 dhcp6 relay link-address

configure service ies subscriber-interface ipv6 dhcp6 relay link-address

Description

This command configures the link address used for prefix selection at the DHCP server.

The link-address is a field in DHCP6 Relay-Forward message that is used in DHCP6 server to select the IPv6 address (IA-NA) or IPv6 prefix (IA-PD) from a pool with configured prefix range covering the link-address. The selection scope is the pool or a prefix range within the pool.

The no form of this command reverts to the default.

Default

no link-address

Parameters

ipv6-address

Specifies the link-address.

Values

ipv6-address

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x - [0 to FFFF]H

d - [0 to 255]D

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay link-address
  • configure service ies subscriber-interface group-interface ipv6 dhcp6 relay link-address
  • configure service ies subscriber-interface ipv6 dhcp6 relay link-address
  • configure subscriber-mgmt local-user-db ipoe host link-address
  • configure service vprn subscriber-interface ipv6 dhcp6 relay link-address

All

  • configure service vprn interface ipv6 dhcp6-relay link-address
  • configure service ies interface ipv6 dhcp6-relay link-address

link-address

Syntax

link-address ipv6-address

no link-address

Context

[Tree] (config>service>ies>if>sap>ipsec-gw>dhcp6 link-address)

[Tree] (config>service>vprn>if>sap>ipsec-gw>dhcp6 link-address)

Full Context

configure service ies interface sap ipsec-gw dhcp6 link-address

configure service vprn interface sap ipsec-gw dhcp6 link-address

Description

This command specifies the link address of the relayed DHCPv6 packets sent by the system.

Default

no link-address

Parameters

ipv6-address

Specifies a global unicast IPv6 address.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

link-bandwidth

link-bandwidth

Syntax

link-bandwidth

Context

[Tree] (config>service>vprn>bgp>group link-bandwidth)

[Tree] (config>service>vprn>bgp>group>neighbor link-bandwidth)

Full Context

configure service vprn bgp group link-bandwidth

configure service vprn bgp group neighbor link-bandwidth

Description

This command enables the configuration context for handling the link-bandwidth extended community attached to specific BGP routes.

When all used multipaths of an IP prefix correspond to BGP routes with a link-bandwidth extended community, the datapath is programmed to do weighted ECMP across the BGP next-hops in proportion to the bandwidth values.

Platforms

All

link-bandwidth

Syntax

link-bandwidth

Context

[Tree] (config>router>bgp>group link-bandwidth)

[Tree] (config>router>bgp>group>neighbor link-bandwidth)

Full Context

configure router bgp group link-bandwidth

configure router bgp group neighbor link-bandwidth

Description

This command enables the configuration context for handling the link-bandwidth extended community attached to specific BGP routes.

When all used multipaths of an IP prefix correspond to BGP routes with a link-bandwidth extended community, the datapath is programmed to do weighted ECMP across the BGP next-hops in proportion to the bandwidth values.

Platforms

All

link-fault

link-fault

Syntax

link-fault local-port-action {log-only | out-of-service}

Context

[Tree] (config>port>ethernet>efm-oam>peer-rdi-rx link-fault)

Full Context

configure port ethernet efm-oam peer-rdi-rx link-fault

Description

This command defines how to react to the reception of a link fault flag set in the informational PDU from a peer.

Default

link-fault local-port-action out-of-service

Parameters

local-port-action

Defines whether or not the local port will be affected when a link fault is received from a peer.

log-only

Keyword that prevents the port from being affected when the local peer receives a link fault. The dying gasp will be logged but the port will remain operational.

out-of-service

Keyword that causes the port to enter a non-operation down state with a port state of link up. The error will be logged upon reception of link fault event. The port will not be available to service data but will continue to carry Link OAM traffic to ensure the link is monitored.

Platforms

All

link-group

link-group

Syntax

[no] link-group link-group-name

Context

[Tree] (config>service>vprn>isis link-group)

Full Context

configure service vprn isis link-group

Description

This command configures a link-group for the router or VPRN instance.

The no form of this command removes the specified link-group.

Parameters

link-group-name

Name of the link-group to be added or removed from the router or VPRN service.

Platforms

All

link-group

Syntax

link-group link-group-name

no link-group

Context

[Tree] (config>router>isis link-group)

Full Context

configure router isis link-group

Description

This command specifies the IS-IS link group associated with this particular level of the interface.

Default

no link-group

Parameters

link-group-name

Specifies an IS-IS link group name, up to 32 characters in length, on the system.

Platforms

All

link-local-address

link-local-address

Syntax

link-local-address ipv6-address [dad-disable]

no link-local-address

Context

[Tree] (config>router>if>ipv6 link-local-address)

[Tree] (config>service>ies>if>ipv6 link-local-address)

[Tree] (config>service>vprn>sub-if>ipv6 link-local-address)

[Tree] (config>service>ies>sub-if>ipv6 link-local-address)

[Tree] (config>service>vprn>if>ipv6 link-local-address)

Full Context

configure router interface ipv6 link-local-address

configure service ies interface ipv6 link-local-address

configure service vprn subscriber-interface ipv6 link-local-address

configure service ies subscriber-interface ipv6 link-local-address

configure service vprn interface ipv6 link-local-address

Description

This command configures the IPv6 Link Local address that is used as a virtual SRRP IPv6 address by the Master SRRP node. This address is sent in the Router Advertisements initiated by the Master SRRP node. Clients use this address as IPv6 default-gateway. Both SRRP nodes, Master and Backup, must be configured with the same Link Local address.

Only one link-local-address is allowed per interface.

CAUTION:

Removing a manually configured link local address may impact routing protocols or static routes that have a dependency on that address. It is not recommended to remove a link local address when there are active IPv6 subscriber hosts on an IES or VPRN interface.

The no form of this command reverts to the default.

Parameters

ipv6-address

Specifies the IPv6 address in the form:

Values

ipv6-address:

x:x:x:x:x:x:x:x

x:x:x:x:x:x:d.d.d.d

x - [0..FFFF]H

d - [0..255]D

dad-disable

Disables Duplicate Address Detection (DAD) and sets the address to preferred, even if there is a duplicated address.

Platforms

All

  • configure service ies interface ipv6 link-local-address
  • configure router interface ipv6 link-local-address
  • configure service vprn interface ipv6 link-local-address

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface ipv6 link-local-address
  • configure service ies subscriber-interface ipv6 link-local-address

link-local-modifier

link-local-modifier

Syntax

link-local-modifier modifier

no link-local-modifier

Context

[Tree] (config>service>ies>if>ipv6>secure-nd link-local-modifier)

Full Context

configure service ies interface ipv6 secure-nd link-local-modifier

Description

This command configures the Cryptographically Generated Address (CGA) modifier for link-local addresses.

Parameters

modifier

Specifies the modifier in 32 hexadecimal nibbles.

Values

0x0 to 0xFFFFFFFF

Platforms

All

link-local-modifier

Syntax

link-local-modifier modifier

no link-local-modifier

Context

[Tree] (config>service>vprn>if>send link-local-modifier)

Full Context

configure service vprn interface ipv6 secure-nd link-local-modifier

Description

This command configures the Cryptographically Generated Address (CGA) modifier for link-local addresses.

Parameters

modifier

Specifies the modifier in 32 hexadecimal nibbles.

Values

0x0–0xFFFFFFFF

Platforms

All

link-local-modifier

Syntax

link-local-modifier modifier

no link-local-modifier

Context

[Tree] (config>router>if>ipv6>secure-nd link-local-modifier)

Full Context

configure router interface ipv6 secure-nd link-local-modifier

Description

This command configures the Cryptographically Generated Address (CGA) modifier for link-local addresses.

Parameters

modifier

Specifies the modifier in 32 hexadecimal nibbles.

Values

0x0 to 0xFFFFFFFF

Platforms

All

link-map-profile

link-map-profile

Syntax

link-map-profile link-map-profile-id [create]

no link-map-profile link-map-profile-id

Context

[Tree] (config>lag link-map-profile)

Full Context

configure lag link-map-profile

Description

This command creates the link map profile that can control which LAG ports are to be used on egress or enables the configuration context for previously created link map profile. link map profiles are not created by default.

The no form of this command, deletes the specified link map profile.

Parameters

link-map-profile-id

An integer from 1 to 64 that defines a unique LAG link map profile on this LAG.

Platforms

All

link-measurement

link-measurement

Syntax

link-measurement

Context

[Tree] (config>test-oam link-measurement)

Full Context

configure test-oam link-measurement

Description

Commands in this context configure various link measurement template attributes that are inherited on associated IP interfaces for delay reporting to the routing engine.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

link-monitoring

link-monitoring

Syntax

[no] link-monitoring

Context

[Tree] (config>port>ethernet>efm-oam>discovery>advertise-capabilities link-monitoring)

Full Context

configure port ethernet efm-oam discovery advertise-capabilities link-monitoring

Description

When the link monitoring function is in a no shutdown state, the Link Monitoring capability (EV) is advertised to the peer through the EFM OAM protocol. This may not be desired if the remote peer does not support the Link Monitoring functionality.

The no version of this command suppresses the advertisement of capabilities.

Default

link-monitoring

Platforms

All

link-monitoring

Syntax

link-monitoring

Context

[Tree] (config>port>ethernet>efm-oam link-monitoring)

Full Context

configure port ethernet efm-oam link-monitoring

Description

This context contains link monitoring specific options defining the various local thresholds, port interaction and peer notification methods. In order to activate Link monitoring function, this context must be configured with the no shutdown option. Shutting down link monitoring will clear all historical link monitoring counters. If the port was removed from service and placed in a non-operational down state and a port state of link up because a signal failure threshold was crossed and link monitoring is shutdown, the port will be returned to service assuming no underlying conditions prevent this return to service.

When the link monitoring function is in a no shutdown state, the Link Monitoring capability (EV) is advertised to the peer through the EFM OAM protocol. This may not be desired if the remote peer does not support the Link Monitoring functionality.

Platforms

All

link-specific-rate

link-specific-rate

Syntax

link-specific-rate packet-rate-limit

no link-specific-rate

Context

[Tree] (config>sys>security>cpu-protection link-specific-rate)

Full Context

configure system security cpu-protection link-specific-rate

Description

This command configures a link-specific rate for CPU protection. This limit is applied to all ports within the system. The CPU will receive no more than the configured packet rate for all link level protocols such as LACP from any one port. The measurement is cleared each second and is based on the ingress port.

Default

link-specific-rate 15000

Parameters

packet-rate-limit

Specifies a packet arrival rate limit, in packets per second, for link level protocols.

Values

1 to 65535, max (no limit)

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-7s, 7750 SR-14s, 7950 XRS

link-state-export-enable

link-state-export-enable

Syntax

[no] link-state-export-enable

Context

[Tree] (config>router>bgp link-state-export-enable)

Full Context

configure router bgp link-state-export-enable

Description

This command enables the export of link-state information from the BGP-LS address family into the local Traffic Engineering Database (TED).

The no form of this command disables the export of link state information into the TED.

Default

no link-state-export-enable

Platforms

All

link-state-import-enable

link-state-import-enable

Syntax

[no] link-state-import-enable

Context

[Tree] (config>router>bgp link-state-import-enable)

Full Context

configure router bgp link-state-import-enable

Description

This command enables the import of link-state information into the BGP-LS address family for advertisement to other BGP neighbors.

The no form of this command disables the import of link state information into the BGP-LS address family.

Default

no link-state-import-enable

Platforms

All

link-type

link-type

Syntax

link-type {pt-pt | shared}

no link-type [pt-pt | shared]

Context

[Tree] (config>service>vpls>sap>stp link-type)

[Tree] (config>service>template>vpls-sap-template>stp link-type)

[Tree] (config>service>vpls>spoke-sdp>stp link-type)

Full Context

configure service vpls sap stp link-type

configure service template vpls-sap-template stp link-type

configure service vpls spoke-sdp stp link-type

Description

This command instructs STP on the maximum number of bridges behind this SAP or spoke-SDP. If there is only a single bridge, transitioning to forwarding state will be based on handshaking (fast transitions). If more than two bridges are connected via a shared media, their SAP or spoke-SDPs should all be configured as shared, and timer-based transitions are used.

The no form of this command returns the link type to the default value.

Default

link-type pt-pt

Platforms

All

link-type

Syntax

link-type {pt-pt | shared}

no link-type

Context

[Tree] (config>service>pw-template>stp link-type)

Full Context

configure service pw-template stp link-type

Description

This command instructs STP on the maximum number of bridges behind this SAP or spoke SDP. If there is only a single bridge, transitioning to forwarding state will be based on handshaking (fast transitions). If more than two bridges are connected via a shared media, their SAP or spoke SDPs should all be configured as shared, and timer-based transitions are used.

The no form of this command returns the link type to the default value.

Default

link-type pt-pt

Platforms

All

linktrace

linktrace

Syntax

linktrace {mac-address | remote-mepid mep-id} mep mep-id domain md-index association ma-index [ttl ttl-value]

Context

[Tree] (oam>eth-cfm linktrace)

Full Context

oam eth-cfm linktrace

Description

The command initiates a linktrace test.

Parameters

mac-address

Specifies a unicast MAC address destination.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx

remote-mepid mep-id

Specifies the remote MEP ID of the peer within the association. The domain and association information are derived from the source mep for the session. The Layer 2 IEEE MAC address is resolved from previously-learned remote MAC addressing, derived from the reception and processing of the ETH-CC PDU. The local MEP must be administratively enabled.

Values

1 to 8191

mep mep-id

Specifies the local MEP ID.

Values

1 to 8191

md-index

Specifies the MD index.

Values

1 to 4294967295

ma-index

Specifies the MA index.

Values

1 to 4294967295

ttl-value

Specifies the TTL for a returned linktrace.

Values

0 to 255

Default

64

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

listen

listen

Syntax

listen

Context

[Tree] (config>system>netconf listen)

Full Context

configure system netconf listen

Description

Commands in this context configure NETCONF listening parameters.

Platforms

All

listening-port

listening-port

Syntax

listening-port port

no listening-port

Context

[Tree] (config>system>grpc listening-port)

Full Context

configure system grpc listening-port

Description

This command configures the listening port for the gRPC server.

The no form of this command reverts to the default.

Default

listening-port 57400

Parameters

port

Specifies the port number.

Values

1024 to 49151, 57400

Default

57400

Platforms

All

listening-port

Syntax

listening-port port

no listening-port

Context

[Tree] (config>system>security>ssh listening-port)

Full Context

configure system security ssh listening-port

Description

This command configures the default SSH port for SSH connections arriving in VPRN or base routing.

The no form of this command configures the default SSH port to 22.

Default

no listening-port

Parameters

port

Specifies the port number.

Values

1024 to 49151

Platforms

All

listening-port

Syntax

listening-port port

no listening-port

Context

[Tree] (config>system>security>telnet listening-port)

Full Context

configure system security telnet listening-port

Description

This command configures the default Telnet port for Telnet connections arriving in VPRN or base routing.

The no form of this command configures the default Telnet port to 23.

Default

no listening-port

Parameters

port

Specifies the port number.

Values

1024 to 49151

Platforms

All

live-output

live-output

Syntax

live-output {ip-address | fqdn} [port port] [router {router-instance | service-name service-name}]

no live-output

Context

[Tree] (config>call-trace>trace-profile live-output)

Full Context

configure call-trace trace-profile live-output

Description

This command specifies a live output destination for this trace. When configured, captures will not be stored locally but sent (over UDP) to the server in the specified routing context. The destination can be specified as either an IP address or a DNS FQDN. The live-output and debug-output commands are mutually exclusive.

The no form of this command disables live output streaming.

Parameters

ip-address

Specifies the IPv4 or IPv6 address of the server to stream to.

fqdn

Specifies the FQDN that represents the server in DNS, up to 255 characters.

port

Specifies the UDP port on which the server is listening.

Values

1 to 65535

Default

29770

router-instance

Specifies the router instance in which the live output is forwarded.

service-name

Specifies the name of the Layer 3 service in which the live output is forwarded.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

lldp

lldp

Syntax

lldp

Context

[Tree] (config>port>ethernet lldp)

Full Context

configure port ethernet lldp

Description

Commands in this context configure Link Layer Discovery Protocol (LLDP) parameters on the specified port.

Platforms

All

lldp

Syntax

lldp

Context

[Tree] (config>port>ethernet lldp)

Full Context

configure port ethernet lldp

Description

Commands in this context configure Link Layer Discovery Protocol (LLDP) parameters on the specified port.

Platforms

All

lldp

Syntax

lldp

Context

[Tree] (config>system lldp)

Full Context

configure system lldp

Description

Commands in this context configure system-wide Link Layer Discovery Protocol parameters.

Platforms

All

lldp-member-template

lldp-member-template

Syntax

lldp-member-template

Context

[Tree] (config>lag lldp-member-template)

Full Context

configure lag lldp-member-template

Description

Commands in this context configure the LLDP parameters for member ports.

Platforms

All

llf

llf

Syntax

[no] llf

Context

[Tree] (config>service>epipe>sap>ethernet llf)

Full Context

configure service epipe sap ethernet llf

Description

This command enables Link Loss Forwarding (LLF) on an Ethernet port. This feature provides an end-to-end OAM fault notification for Ethernet VLL service. It brings down the Ethernet port (Ethernet LLF) or sends a SONET/SDH Path AIS (ATM LLF) toward the attached CE when there is a local fault on the Pseudowire or service, or a remote fault on the SAP or pseudowire, signaled with label withdrawal or T-LDP status bits. It ceases when the fault disappears.

The Ethernet port must be configured for null encapsulation.

This feature is also supported in Epipes with BGP-EVPN enabled. In this case, upon removal of the EVPN destination, the port is brought oper-down with flag LinkLossFwd, however the AD per-EVI route for the SAP is still advertised (the SAP is kept oper-up).

The no form of this command disables LLF on an Ethernet port.

Default

no llf

Platforms

All

lmm

lmm

Syntax

lmm [test-id test-id] [create]

no lmm

Context

[Tree] (config>oam-pm>session>ethernet lmm)

Full Context

configure oam-pm session ethernet lmm

Description

This command configures the LMM test ID to be assigned to the Tx and Rx counter-based loss test and creates the individual test. LMM does not carry this test ID in the PDU; the value is of local significance.

The no form of this command removes the LMM test function from the PM Session.

Parameters

test-id

Specifies the value to be placed in the 4-byte test ID field of an ETH-DMM PDU.

Values

0 to 2147483647 | auto

auto - automatically assigns a test-id
create

Creates the test.

Platforms

All

lns-group

lns-group

Syntax

lns-group lns-group-id

no lns-group

Context

[Tree] (config>service>vprn>l2tp>group lns-group)

[Tree] (config>router>l2tp>group lns-group)

[Tree] (config>service>vprn>l2tp>group>tunnel lns-group)

[Tree] (config>router>l2tp>group>tunnel lns-group)

Full Context

configure service vprn l2tp group lns-group

configure router l2tp group lns-group

configure service vprn l2tp group tunnel lns-group

configure router l2tp group tunnel lns-group

Description

This command configures the ISA LNS group for the L2TP group.

The no form of this command removes the LNS group ID from the configuration.

Default

no lns-group

Parameters

lns-group-id

Specifies the LNS group ID.

Values

1 to 4

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

lns-group

Syntax

lns-group lns-group-id [create]

no lns-group lns-group-id

Context

[Tree] (config>isa lns-group)

Full Context

configure isa lns-group

Description

This command configures an LNS group.

The no form of the command removes the LNS group ID from the configuration.

Parameters

lns-group-id

Specifies the LNS group identifier.

Values

1 to 4

create

Mandatory keyword used when creating tunnel group in the ISA context. The create keyword requirement can be enabled/disabled in the environment>create context.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

load

load

Syntax

load file-url [overwrite | insert | append]

Context

[Tree] (candidate load)

Full Context

candidate load

Description

This command loads a previously saved candidate configuration into the current candidate. The edit point will be set to the end of the loaded configuration lines. The candidate configuration cannot be modified while a load is in progress.

Default

If the candidate is empty then a load without any of the optional parameters (such as overwrite, and so on) will load the file-url into the candidate. If the candidate is not empty then one of the options, such as overwrite, insert, and so on, must be specified.

Parameters

file-url

Specifies the directory and filename to load.

overwrite

Discards the contents of the current candidate and replace it with the contents of the file.

insert

Inserts the contents of the file at the current edit point.

append

Inserts the contents of the file at the end of the current candidate.

Platforms

All

load-balance-key

load-balance-key

Syntax

load-balance-key [vendor vendor-id [vendor-id]] attribute-type attribute-type [attribute-type]

load-balance-key source-ip-udp

no load-balance-key

Context

[Tree] (config>service>vprn>radius-proxy>server load-balance-key)

[Tree] (config>router>radius-proxy>server load-balance-key)

Full Context

configure service vprn radius-proxy server load-balance-key

configure router radius-proxy server load-balance-key

Description

This command specifies the key used in calculating a hash to select an external RADIUS server from the pool of configured servers.

The key can be the source IP and source UDP port tuple, or the specified RADIUS attribute in RADIUS packets.

The no form of this command removes the parameters from the configuration.

Parameters

vendor-id

Specifies the vendor-id of vendor-specific attribute.

Values

0 to 16777215

attribute-type

Specifies that the key is constructed with the attributes in the RADIUS message.

Values

1 to 255

source-ip-udp

Specifies that the key consists of the source IP address and source UDP port of the RADIUS message.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

load-balance-method

load-balance-method

Syntax

load-balance-method {per-session | per-tunnel}

no load-balance-method

Context

[Tree] (config>service>vprn>l2tp>group load-balance-method)

[Tree] (config>router>l2tp>group>tunnel load-balance-method)

[Tree] (config>service>vprn>l2tp>group>tunnel load-balance-method)

[Tree] (config>router>l2tp>group load-balance-method)

Full Context

configure service vprn l2tp group load-balance-method

configure router l2tp group tunnel load-balance-method

configure service vprn l2tp group tunnel load-balance-method

configure router l2tp group load-balance-method

Description

This command is applicable only to LNS. By default traffic load balancing between the BB-ISAs is based on sessions. Each session is individually assigned to an BB-ISA during session establishment phase.

By introducing MLPPPoX, all sessions of a bundle must be terminated on the same LNS BB-ISA. This is necessary for two reasons:

  • QoS in the carrier IOM has a uniform view of the subscriber

  • a single BB-ISA is responsible for MLPPPoX encapsulation/fragmentation for a given bundle.

Therefore, if fragmentation is enabled, load-balancing per tunnel must be configured. In the per tunnel load-balancing mode, all sessions within the same tunnel are terminated on the same LNS BB-ISA.

In the case that we have MLPPPoX sessions with a single member link, both load-balancing methods are valid.

The no form of this command reverts to the default.

Default

load-balance-method per-session

Parameters

per-session

Specifies that the traffic load balancing between the LNS BB-ISAs is based on individual PPPoE sessions.

per-tunnel

Specifies that the traffic load balancing between the LNS BB-ISAs is based on tunnels.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

load-balancing

load-balancing

Syntax

load-balancing

Context

[Tree] (config>service>epipe load-balancing)

Full Context

configure service epipe load-balancing

Description

This command enables the load-balancing context to configure interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load-balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Default

not applicable

Platforms

All

load-balancing

Syntax

load-balancing

Context

[Tree] (config>service>vpls load-balancing)

[Tree] (config>service>template>vpls-template load-balancing)

Full Context

configure service vpls load-balancing

configure service template vpls-template load-balancing

Description

This command enables the load-balancing context to configure interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load-balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Platforms

All

load-balancing

Syntax

load-balancing

Context

[Tree] (config>service>ies>if load-balancing)

Full Context

configure service ies interface load-balancing

Description

This command enables the load-balancing context to configure interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Platforms

All

load-balancing

Syntax

load-balancing

Context

[Tree] (config>service>vprn>nw-if load-balancing)

Full Context

configure service vprn network-interface load-balancing

Description

This command enables the load-balancing context to configure interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load-balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Platforms

All

load-balancing

Syntax

load-balancing

Context

[Tree] (config>router>if load-balancing)

Full Context

configure router interface load-balancing

Description

This command enables the load-balancing context to configure interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load-balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Platforms

All

load-balancing

Syntax

load-balancing

Context

[Tree] (config>system load-balancing)

Full Context

configure system load-balancing

Description

This command enables the load-balancing context to configure the interface per-flow load balancing options that will apply to traffic entering this interface and egressing over a LAG/ECMP on system-egress. This is a per interface setting. For load-balancing options that can also be enabled on the system level, the options enabled on the interface level overwrite system level configurations.

Platforms

All

load-balancing-algorithm

load-balancing-algorithm

Syntax

load-balancing-algorithm option

no load-balancing-algorithm

Context

[Tree] (config>port>ethernet load-balancing-algorithm)

[Tree] (config>port>tdm>e3 load-balancing-algorithm)

[Tree] (config>port>sonet-sdh>path load-balancing-algorithm)

[Tree] (config>port>tdm>ds3 load-balancing-algorithm)

[Tree] (config>port>tdm>ds1>channel-group load-balancing-algorithm)

[Tree] (config>port>tdm>e1>channel-group load-balancing-algorithm)

Full Context

configure port ethernet load-balancing-algorithm

configure port tdm e3 load-balancing-algorithm

configure port sonet-sdh path load-balancing-algorithm

configure port tdm ds3 load-balancing-algorithm

configure port tdm ds1 channel-group load-balancing-algorithm

configure port tdm e1 channel-group load-balancing-algorithm

Description

This command specifies the load balancing algorithm to be used on this port.

In the default mode, no load-balancing-algorithm, the port inherits the global settings. The value is not applicable for ports that do not pass any traffic.

The configuration of load-balancing-algorithm at logical port level has three possible values:

  • include-l4 — Enables inherits system-wide settings including Layer 4 source and destination port value in hashing algorithm.

  • exclude-l4 — Layer 4 source and destination port value will not be included in hashing.

  • no load-balancing-algorithm — Inherits system-wide settings.

The hashing algorithm addresses finer spraying granularity where many hosts are connected to the network. To address more efficient traffic distribution between network links (forming a LAG group), a hashing algorithm extension takes into account Layer 4 information (src/dst L4-protocol port). The hashing index can be calculated according to the following algorithm:

If [(TCP or UDP traffic) & enabled]

hash (<TCP/UDP ports>, <IP addresses>)

else if (IP traffic)

hash (<IP addresses>)

else

hash (<MAC addresses>)

endif

This algorithm will be used in all cases where IP information in per-packet hashing is included (refer to "Traffic Load Balancing Options” in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Interface Configuration Guide). However the Layer 4 information (TCP/UDP ports) will not be used in the following cases:

  • fragmented packets

Default

no load-balancing-algorithm

Parameters

option

Specifies the load balancing algorithm to be used on this port.

Values

include-l4 — Specifies that the source and destination ports are used in the hashing algorithm.exclude-l4 — Specifies that the source and destination ports are not used in the hashing algorithm.

Platforms

All

  • configure port ethernet load-balancing-algorithm

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e

  • configure port tdm ds3 load-balancing-algorithm
  • configure port tdm e1 channel-group load-balancing-algorithm
  • configure port tdm ds1 channel-group load-balancing-algorithm
  • configure port tdm e3 load-balancing-algorithm

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

  • configure port sonet-sdh path load-balancing-algorithm

load-balancing-weight

load-balancing-weight

Syntax

load-balancing-weight value

no load-balancing-weight [value]

Context

[Tree] (config>service>vprn>static-route-entry>next-hop load-balancing-weight)

Full Context

configure service vprn static-route-entry next-hop load-balancing-weight

Description

This command configures a weighted ECMP load-balancing weight for a static route next-hop.

If all of the ECMP next-hops of a static route have a configured load-balancing-weight then packets matching the route are sprayed according to the relative weights. In other words, the next-hop interface with the largest load-balancing weight should receive the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface and effectively disables weighted ECMP for the entire static route.

Parameters

value

Specifies the cost metric value.

Values

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight [weight]

no load-balancing-weight

Context

[Tree] (config>service>vprn>ospf3>area>if load-balancing-weight)

[Tree] (config>service>vprn>ospf>area>if load-balancing-weight)

Full Context

configure service vprn ospf3 area interface load-balancing-weight

configure service vprn ospf area interface load-balancing-weight

Description

This command configures the weighted ECMP load-balancing weight for an IS-IS, OSPF, and OSPF3 interface. If the interface becomes an ECMP next hop for an IPv4 or IPv6 route, and all the other ECMP next hops are interfaces with configured (non-zero) load-balancing weights, then the traffic distribution over the ECMP interfaces is proportional to the weights. This means that the interface with the largest load-balancing weight receives the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface which effectively disables weighted ECMP for any IP prefix that has this interface as a next hop.

Default

no load-balancing-weight

Parameters

weight

Specifies the load balancing weight.

Values

1 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight weight

no load-balancing-weight

Context

[Tree] (config>service>vprn>isis>if load-balancing-weight)

Full Context

configure service vprn isis interface load-balancing-weight

Description

This command configures the weighted ECMP load-balancing weight for an IS-IS interface of the VPRN. If the interface becomes an ECMP next-hop for IPv4 or IPv6 route and all the other ECMP next-hops are interfaces with configured (non-zero) load-balancing weights, then the traffic distribution over the ECMP interfaces is proportional to the weights. In other words, the interface with the largest load-balancing-weight should receive the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface and, therefore, effectively disables weighted ECMP for any IP prefix that has this interface as a next-hop.

Default

no load-balancing-weight

Parameters

weight

Specifies the load balancing weight.

Values

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight weight

no load-balancing-weight

Context

[Tree] (config>router>ldp>if-params>if load-balancing-weight)

Full Context

configure router ldp interface-parameters interface load-balancing-weight

Description

This command configures the load balancing weight for the LDP interface. The load balancing weight, normalized to 64, is used for weighted ECMP of LDP labeled packets over direct network IP interfaces.

If the interface becomes an ECMP next hop for an LDP FEC, and all the other ECMP next hops are interfaces with configured (non-zero) load-balancing weights, then the traffic distribution over the ECMP interfaces is proportional to the normalized weight with a granularity of 64.

If one or more of the LDP interfaces in the ECMP set does not have a configured load-balancing weight, then the system falls back to ECMP.

The no form of this command removes the load balancing weight for the LDP interface.

Parameters

weight

Specifies the load balancing weight value.

Values

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight weight

no load-balancing-weight

Context

[Tree] (config>router>mpls>lsp load-balancing-weight)

Full Context

configure router mpls lsp load-balancing-weight

Description

This command assigns a weight to an MPLS LSP for use in the weighted load-balancing, or weighted ECMP, over MPLS feature.

Parameters

weight

Specifies a 32-bit integer representing the weight of the LSP.

Values

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight weight

no load-balancing-weight

Context

[Tree] (config>router>mpls>fwd-policies>fwd-policy>nh-grp load-balancing-weight)

Full Context

configure router mpls forwarding-policies forwarding-policy next-hop-group load-balancing-weight

Description

This command configures the load balancing weight of an NHG entry in a forwarding policy.

A weight for each NHG of a policy must be assigned to the weighted ECMP forwarding to operate over the set of NHGs of the policy.

The no form of this command removes the load balancing weight from an NHG entry in a forwarding policy.

Parameters

weight

Specifies the load balancing weight value.

Values

1 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight value

no load-balancing-weight [value]

Context

[Tree] (config>router>static-route-entry>next-hop load-balancing-weight)

Full Context

configure router static-route-entry next-hop load-balancing-weight

Description

This command configures a weighted ECMP load-balancing weight for a static route next-hop.

If all of the ECMP next-hops of a static route have a configured load-balancing-weight then packets matching the route are sprayed according to the relative weights. In other words, the next-hop interface with the largest load-balancing weight should receive the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface and effectively disables weighted ECMP for the entire static route.

Parameters

value

Specifies the load balancing weight value.

Values

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight [value]

no load-balancing-weight

Context

[Tree] (config>router>isis>interface load-balancing-weight)

Full Context

configure router isis interface load-balancing-weight

Description

This command configures the weighted ECMP load-balancing weight for an IS-IS interface. If the interface becomes an ECMP next hop for an IPv4 or IPv6 route, and all the other ECMP next hops are interfaces with configured (non-zero) load-balancing weights, then the traffic distribution over the ECMP interfaces is proportional to the weights. In other words, the interface with the largest load-balancing weight should receive the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface and therefore effectively disables weighted ECMP for any IP prefix that has this interface as a next hop.

Default

no load-balancing-weight

Parameters

value

0 to 4294967295

Platforms

All

load-balancing-weight

Syntax

load-balancing-weight [weight]

no load-balancing-weight

Context

[Tree] (config>router>ospf3>area>if load-balancing-weight)

[Tree] (config>router>ospf>area>if load-balancing-weight)

Full Context

configure router ospf3 area interface load-balancing-weight

configure router ospf area interface load-balancing-weight

Description

This command configures the weighted ECMP load-balancing weight for an OSPF or OSPF3 interface. If the interface becomes an ECMP next hop for an IPv4 or IPv6 route, and all the other ECMP next hops are interfaces with configured (non-zero) load-balancing weights, then the traffic distribution over the ECMP interfaces is proportional to the weights. This means that the interface with the largest load-balancing weight receives the most forwarded traffic if weighted ECMP is applicable.

The no form of this command disables weighted ECMP for the interface which effectively disables weighted ECMP for any IP prefix that has this interface as a next hop.

Default

no load-balancing-weight

Parameters

weight

Specifies the load balancing weight.

Values

1 to 4294967295

Platforms

All

local

local

Syntax

[no] local

Context

[Tree] (config>subscr-mgmt>sla-profile>control local)

Full Context

configure subscriber-mgmt sla-profile control local

Description

This command enables a session that is set up with local control plane handling to use this SLA profile. This command cannot be disabled.

Default

local

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local

Syntax

[no] local

Context

[Tree] (config>subscr-mgmt>sub-profile>control local)

Full Context

configure subscriber-mgmt sub-profile control local

Description

This command enables a session that is set up with local control plane handling to use this subscriber profile. This command cannot be disabled.

Default

local

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local

Syntax

local [inherit | all | vc-only | none]

Context

[Tree] (config>service>vprn>ttl-propagate local)

Full Context

configure service vprn ttl-propagate local

Description

This command overrides the global configuration of the TTL propagation for locally generated packets which are forwarded over a MPLS LSPs in a given VPRN service context.

The global configuration is performed under config>router>ttl-propagate>vprn-local.

The default behavior for a given VPRN instance is to inherit the global configuration for the same command. The user can explicitly set the default behavior by configuring the inherit value

Default

local inherit

Parameters

inherit

Specifies the TTL propagation behavior is inherited from the global configuration under config>router>ttl-propagate>vprn-local.

none

Specifies the TTL of the IP packet is not propagated into the VC label or labels in the transport label stack.

vc-only

Specifies the TTL of the IP packet is propagated into the VC label and not into the labels in the transport label stack.

all

Specifies the TTL of the IP packet is propagated into the VC label and all labels in the transport label stack.

Platforms

All

local

Syntax

local

Context

[Tree] (config>ipsec>ts-list local)

Full Context

configure ipsec ts-list local

Description

Commands in this context configure local TS-list parameters. The TS-list is the traffic selector of the local system, such as TSr, when the system acts as an IKEv2 responder.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-address

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>service>vprn>l2tp local-address)

[Tree] (config>router>l2tp>group>tunnel local-address)

[Tree] (config>service>vprn>l2tp>group>tunnel local-address)

[Tree] (config>router>l2tp>group local-address)

[Tree] (config>router>l2tp local-address)

[Tree] (config>service>vprn>l2tp>group local-address)

Full Context

configure service vprn l2tp local-address

configure router l2tp group tunnel local-address

configure service vprn l2tp group tunnel local-address

configure router l2tp group local-address

configure router l2tp local-address

configure service vprn l2tp group local-address

Description

This command configures the local address.

The no form of this command removes the local IP address from the configuration.

Default

no local-address

Parameters

ip-address

Specifies the IP address used during L2TP authentication.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>subscr-mgmt>bgp-prng-plcy local-address)

Full Context

configure subscriber-mgmt bgp-peering-policy local-address

Description

This command configures the local IP address used by the group or neighbor when communicating with BGP peers.

Outgoing connections use the local-address as the source of the TCP connection when initiating connections with a peer.

When a local address is not specified, the 7750 SR OS uses the system IP address when communicating with IBGP peers and uses the interface address for directly connected EBGP peers. This command is used at the neighbor level to revert to the value defined under the group level.

The no form of this command removes the configured local-address for BGP.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Parameters

ip-address

Specifies the IPv4 or IPv6 address of the local address.

For IPv4, the local address is expressed in dotted decimal notation. Allowed values are a valid routable IP address on the router, either an interface or system IP address.

For IPv6, the local address is expressed in semi-colon hexadecimal notation. Allowed values is an interface or a system IP address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x - [0 to FFFF]H

d - [0 to 255]D

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>service>vpls>gsmp>group>neighbor local-address)

[Tree] (config>service>vprn>gsmp>group>neighbor local-address)

Full Context

configure service vpls gsmp group neighbor local-address

configure service vprn gsmp group neighbor local-address

Description

This command configures the source ip-address used in the connection towards the neighbor. The local address is optional. If specified the node will accept connections only for that address in the service running ANCP. The address may be created after the reference but connections will not be accepted until it is created. If the local address is not used, the system accepts connections on any interface within the routing context.

The no form of this command reverts to the default.

Parameters

ip-address

Specifies the source IP address to be used in the connection toward the neighbor.

Values

ip-address: a.b.c.d. (unicast address only)

Platforms

All

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>subscr-mgmt>wlan-gw>tunnel-query local-address)

Full Context

configure subscriber-mgmt wlan-gw tunnel-query local-address

Description

This command enables matching on tunnels that are terminated by the specified IP address on the WLAN-GW.

The no form of this command disables matching on the local IP address.

Default

no local-address

Parameters

ip-address

Specifies the IPv4 or IPv6 address.

Platforms

7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>service>vprn>bgp>group local-address)

[Tree] (config>service>vprn>bgp>group>neighbor local-address)

Full Context

configure service vprn bgp group local-address

configure service vprn bgp group neighbor local-address

Description

Configures the local IP address used by the group or neighbor when communicating with BGP peers.

Outgoing connections use the local-address as the source of the TCP connection when initiating connections with a peer.

When a local address is not specified, the OS uses the system IP address when communicating with IBGP peers and uses the interface address for directly connected EBGP peers. This command is used at the neighbor level to revert to the value defined under the group level.

The no form of this command removes the configured local-address for BGP.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Parameters

no local-address

The router ID is used when communicating with IBGP peers and the interface address is used for directly connected EBGP peers.

ip-address

The local address expressed in dotted decimal notation. Allowed values are a valid routable IP address on the router, either an interface or system IP address.

Platforms

All

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>service>vprn>msdp local-address)

[Tree] (config>service>vprn>msdp>peer local-address)

[Tree] (config>service>vprn>msdp>group>peer local-address)

[Tree] (config>service>vprn>msdp>group local-address)

Full Context

configure service vprn msdp local-address

configure service vprn msdp peer local-address

configure service vprn msdp group peer local-address

configure service vprn msdp group local-address

Description

This command configures the local end of a Multicast Source Discovery Protocol (MSDP) session. For MSDP to function, at least one peer must be configured. When configuring a peer, you must include this local-address command to configure the local end of the MSDP session. This address must be present on the node and is used to validate incoming connections to the peer and to establish connections to the remote peer.

If the user enters this command, then the address provided is validated and will be used as the local address for MSDP peers from that point. If a subsequent local-address command is entered, it will replace the existing configuration and existing sessions will be terminated.

Similarly, when the no form of this command is entered, the existing local address will be removed from the configuration and the existing sessions will be terminated.

Whenever a session is terminated, all information pertaining to and learned from that peer will be removed.

Whenever a new peering session is created or a peering session is lost, an event message should be generated.

The no form of this command removes the local address from the configuration.

Default

no local-address

Parameters

ip-address

Specifies an existing address on the node.

Platforms

All

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>router>pcep>pce local-address)

[Tree] (config>router>pcep>pcc local-address)

Full Context

configure router pcep pce local-address

configure router pcep pcc local-address

Description

This command configures the local IPv4 address of the PCEP speaker.

The PCEP protocol operates over TCP using destination TCP port 4189. The PCE client (PCC) always initiates the connection. After the user configures the PCEP local IPv4 address and the peer IPv4 address on the PCC, the latter initiates a TCP connection to the PCE. If both a local IPv4 and a local IPv6 address are configured, the connection uses the local address that is the same family as the peer address. When the connection is established, the PCC and PCE exchange OPEN messages, which initializes the PCEP session and exchanges the session parameters to be negotiated.

By default, the PCC attempts to reach the remote PCE address out of band using the management port. If it cannot, it attempts to reach the remote PCE address in band. The user can change the configuration of the peer to attempt connecting in band only or out of band only. When the session comes up out of band, the management IP address is used as the local address. The local IPv4 address configured by the user is only used for in-band sessions and is otherwise ignored.

The no form of the command removes the configured local address of the PCEP speaker.

Parameters

ip-address

Specifies the IP address of the PCEP speaker to be used for in-band sessions.

Platforms

VSR-NRC

  • configure router pcep pce local-address

All

  • configure router pcep pcc local-address

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>router>msdp>peer local-address)

[Tree] (config>router>msdp local-address)

[Tree] (config>router>msdp>group local-address)

[Tree] (config>router>msdp>group>peer local-address)

Full Context

configure router msdp peer local-address

configure router msdp local-address

configure router msdp group local-address

configure router msdp group peer local-address

Description

This command configures the local end address of an MSDP session. For MSDP to function, at least one peer must be configured, and the peer must have a local address configured. This address must be present on the node and is used to validate incoming connections to the peer and to establish connections to the remote peer.

The specified IP address is validated and used as the local address for MSDP peers from that point. If a subsequent address is configured, it replaces the existing configuration and terminate any existing sessions.

When a session is terminated, all information pertaining to and learned from that peer is removed.

When a new peering session is created or a peering session is lost, an event message is generated.

The no form of this command removes the local address from the configuration. Removing the local address terminates any existing sessions.

Default

no local-address

Parameters

ip-address

Specifies an existing address on the node.

Platforms

All

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>router>origin-validation>rpki-session local-address)

Full Context

configure router origin-validation rpki-session local-address

Description

This command configures the local address to use for setting up the TCP connection used by an RPKI-Router session. The default local-address is the outgoing interface IPv4 or IPv6 address. The local-address cannot be changed without first shutting down the session.

Default

no local-address

Parameters

ip-address

Specifies an IPv4 address or an IPv6 address.

Platforms

All

local-address

Syntax

local-address [ip-int-name | ip-address | ipv6-address]

no local-address

Context

[Tree] (config>router>bgp>group>neighbor local-address)

[Tree] (config>router>bgp>group local-address)

Full Context

configure router bgp group neighbor local-address

configure router bgp group local-address

Description

This command configures the local IP address used by the group or neighbor when communicating with BGP peers.

Outgoing connections use the local-address as the source of the TCP connection when initiating connections with a peer.

When a local address is not specified, the router uses the system IP address when communicating with IBGP peers and uses the interface address for directly connected EBGP peers. This command is used at the neighbor level to revert to the value defined under the group level.

When set to a router interface, the local-address inherits the primary IPv4 or IPv6 address of the router interface depending on whether BGP is configured for IPv4 or IPv6. If the corresponding IPv4 or IPv6 address is not configured on the router interface, the BGP sessions that have this interface set as the local-address are kept down until an interface address is configured on the router interface.

The no form of this command removes the configured local-address for BGP.

The no form of this command used at the group level returns the configuration to the value defined at the global level.

The no form of this command used at the neighbor level returns the configuration to the value defined at the group level.

Default

no local-address

Parameters

ip-address

Specifies the local address expressed in dotted decimal notation. Allowed value is a valid routable IP address on the router, either an interface or system IP address.

Values

ipv4-address:

  • a.b.c.d (host bits must be 0)

ipv6-address

Specifies the local address expressed in dotted decimal notation. Allowed value is a valid routable IPv6 address on the router, either an interface or system IPv6 address.

Values

ipv6-address:

  • x:x:x:x:x:x:x:x (eight 16-bit pieces)

  • x:x:x:x:x:x:d.d.d.d

  • x: [0 to FFFF]H

  • d: [0 to 255]D

ip-int-name

Specifies the IP interface name whose address the local address will inherit. The interface can be any network interface configured on the system.

Platforms

All

local-address

Syntax

local-address ip-address | ipv6-address

no local-address

Context

[Tree] (config>bmp>station>connection local-address)

Full Context

configure bmp station connection local-address

Description

This command configures the local IP address used by the local router when communicating with the BMP monitoring station. This configuration is optional.

Outgoing connections use the local-address as the source of the TCP connection when initiating connections with a monitoring station.

The BMP session may flap when this parameter is changed. Shut down the BMP session before changing the values.

The no form of this command removes the configured local-address for the BMP session. The default is to use the system IP address.

Default

local-address ip-address (system IP address)

Parameters

ip-address

Specifies the local address expressed in dotted decimal notation. Allowed value is a valid routable IP address on the router, either an interface or system IP address.

Values

ipv4-address:

  • a.b.c.d (host bits must be 0)

ipv6-address

Specifies the local address expressed in dotted decimal notation. Allowed value is a valid routable IPv6 address on the router, either an interface or system IPv6 address.

Values

ipv6-address:

  • x:x:x:x:x:x:x:x (eight 16-bit pieces)

  • x:x:x:x:x:x:d.d.d.d

  • x: [0 to FFFF]H

  • d: [0 to 255]D

Platforms

All

local-address

Syntax

local-address ip-address

no local-address

Context

[Tree] (config>anysec>tnl-enc>sec-term-pol local-address)

Full Context

configure anysec tunnel-encryption security-termination-policy local-address

Description

This command configures the local IPv4 or IPv6 address for the system IP or loopback node SID. This is used to program the FP5 label stack to match the incoming ANYsec tunnel and decryption of the tunnel.

The no form of this command removes the IP address that is associated with ANYsec decryption.

Parameters

ip-address

Specifies the IPv4 or IPv6 address of the local address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x - [0 to FFFF]H

d - [0 to 255]D

Platforms

7750 SR-1-24D, 7750 SR-1-46S, 7750 SR-1-48D, 7750 SR-1-92S, 7750 SR-1x-48D, 7750 SR-1x-92S, 7750 SR-1se

local-address-assignment

local-address-assignment

Syntax

local-address-assignment

Context

[Tree] (config>service>vprn>sub-if>grp-if local-address-assignment)

[Tree] (config>service>ies>sub-if>grp-if local-address-assignment)

[Tree] (config>service>ies>sub-if local-address-assignment)

[Tree] (config>service>vprn>sub-if local-address-assignment)

Full Context

configure service vprn subscriber-interface group-interface local-address-assignment

configure service ies subscriber-interface group-interface local-address-assignment

configure service ies subscriber-interface local-address-assignment

configure service vprn subscriber-interface local-address-assignment

Description

Commands in this context configure local address assignment parameters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-address-assignment

Syntax

local-address-assignment [terminate-only]

no local-address-assignment

Context

[Tree] (debug>service>id>ppp>event local-address-assignment)

Full Context

debug service id ppp event local-address-assignment

Description

This command enables debugging for local-address-assignment events.

The no form of this command disables debugging.

Parameters

terminate-only

Enables debugging for local address assignment.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-address-assignment

Syntax

[no] local-address-assignment

Context

[Tree] (config>service>vprn>if>sap>ipsec-gw local-address-assignment)

[Tree] (config>service>ies>if>sap>ipsec-gw local-address-assignment)

Full Context

configure service vprn interface sap ipsec-gw local-address-assignment

configure service ies interface sap ipsec-gw local-address-assignment

Description

Commands in this context configure local address assignments for the IPsec gateway.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-address-ipv6

local-address-ipv6

Syntax

local-address-ipv6 ipv6-address

no local-address-ipv6

Context

[Tree] (config>router>pcep>pce local-address-ipv6)

[Tree] (config>router>pcep>pcc local-address-ipv6)

Full Context

configure router pcep pce local-address-ipv6

configure router pcep pcc local-address-ipv6

Description

This command configures the local IPv6 address of the PCEP speaker.

The PCEP protocol operates over TCP using destination TCP port 4189. The PCE client (PCC) always initiates the connection. After the user configures the PCEP local IPv6 address and the peer IPv6 address on the PCC, the latter initiates a TCP connection to the PCE. If both a local IPv4 and a local IPv6 address are configured, the connection uses the local address that is the same family as the peer address. When the connection is established, the PCC and PCE exchange OPEN messages, which initializes the PCEP session and exchanges the session parameters to be negotiated.

By default, the PCC attempts to reach the remote PCE address out of band using the management port. If it cannot, it attempts to reach the remote PCE address in-band. The user can change the configuration of the peer to attempt connecting in band only or out of band only. When the session comes up out of band, the management IP address is used as the local address. The local IPv6 address configured by the user is only used for in-band sessions and is otherwise ignored.

The no form of the command removes the configured local address of the PCEP speaker.

Parameters

ipv6-address

Specifies the IP address of the PCEP speaker to be used for in-band sessions.

Platforms

VSR-NRC

  • configure router pcep pce local-address-ipv6

All

  • configure router pcep pcc local-address-ipv6

local-age

local-age

Syntax

local-age aging-timer

no local-age [aging-timer]

Context

[Tree] (config>service>template>vpls-template local-age)

[Tree] (config>service>vpls local-age)

Full Context

configure service template vpls-template local-age

configure service vpls local-age

Description

Specifies the aging time for locally learned MAC addresses in the forwarding database (FDB) for the Virtual Private LAN Service (VPLS) instance. In a VPLS service, MAC addresses are associated with a Service Access Point (SAP) or with a service destination point (SDP). MACs associated with a SAP are classified as local MACs, and MACs associated with an SDP are remote MACs.

Like in a Layer 2 switch, learned MACs can be aged out if no packets are sourced from the MAC address for a period of time (the aging time). In each VPLS service instance, there are independent aging timers for local learned MAC and remote learned MAC entries in the FDB. The local-age timer specifies the aging time for local learned MAC addresses.

The no form of this command returns the local aging timer to the default value.

Default

local age 300 — Local MACs aged after 300 seconds.

Parameters

aging-timer

Specifies the aging time for local MACs expressed in seconds

Values

60 to 86400

Platforms

All

local-as

local-as

Syntax

local-as as-number [private]

no local-as

Context

[Tree] (config>subscr-mgmt>bgp-prng-plcy local-as)

Full Context

configure subscriber-mgmt bgp-peering-policy local-as

Description

This command configures a BGP virtual autonomous system (AS) number.

In addition to the AS number configured for BGP in the config>router>autonomous-system context, a virtual (local) AS number is configured. The virtual AS number is added to the as-path message before the router’s AS number makes the virtual AS the second AS in the as-path.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). Thus, by specifying this at each neighbor level, it is possible to have a separate as-number per EBGP session.

When a command is entered multiple times for the same AS, the last command entered is used in the configuration. The private attribute can be added or removed dynamically by reissuing the command.

Changing the local AS at the global level in an active BGP instance causes the BGP instance to restart with the new local AS number. Changing the local AS at the global level in an active BGP instance causes BGP to re-establish the peer relationships with all peers in the group with the new local AS number. Changing the local AS at the neighbor level in an active BGP instance causes BGP to re-establish the peer relationship with the new local AS number.

This is an optional command and can be used in the following circumstance:

Provider router P is moved from AS1 to AS2. The customer router that is connected to P, however, is configured to belong to AS1. To avoid reconfiguring the customer router, the local-as value on router P can be set to AS1. Thus, router P adds AS1 to the as-path message for routes it advertises to the customer router.

The no form of this command used at the global level will remove any virtual AS number configured.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Parameters

as-number

Specifies the virtual autonomous system number, expressed as a decimal integer.

Values

1 to 4294967295

private

Specifies that the local-as number is hidden in paths learned from the peering.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-as

Syntax

local-as as-number [private] [no-prepend-global-as]

no local-as

Context

[Tree] (config>service>vprn>bgp local-as)

[Tree] (config>service>vprn>bgp>group>neighbor local-as)

[Tree] (config>service>vprn>bgp>group local-as)

Full Context

configure service vprn bgp local-as

configure service vprn bgp group neighbor local-as

configure service vprn bgp group local-as

Description

This command configures a BGP virtual autonomous system (AS) number.

In addition to the global AS number configured for BGP in the config>router>autonomous-system context, a virtual (local) AS number can be configured to support various AS number migration scenarios. The local AS number is added to the to the beginning the as-path attribute ahead of the router’s AS number.

This configuration parameter can be set at three levels: global level (applies to all EBGP peers), group level (applies to all EBGP peers in peer-group) or neighbor level (only applies to EBGP specified peer). Thus, by specifying this at each neighbor level, it is possible to have a separate local-as per EBGP session. The local-as command is not supported for IBGP sessions. When the optional private keyword is specified in the command the local-as number is not added to inbound routes from the EBGP peer that has local-as in effect.

When a command is entered multiple times for the same AS, the last command entered is used in the configuration. The private attribute can be added or removed dynamically by reissuing the command.

Changing the local AS at the global level in an active BGP instance causes the BGP instance to restart with the new local AS number. Changing the local AS at the global level in an active BGP instance causes BGP to re-establish the peer relationships with all peers in the group with the new local AS number. Changing the local AS at the neighbor level in an active BGP instance causes BGP to re-establish the peer relationship with the new local AS number.

This is an optional command and can be used in the following circumstance:

Provider router P is moved from AS1 to AS2. The customer router that is connected to P, however, is configured to belong to AS1. To avoid reconfiguring the customer router, the local-as value on router P can be set to AS1. Thus, router P adds AS1 to the as-path message for routes it advertises to the customer router.

The no form of this command used at the global level removes any virtual AS number configured.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default

no local-as

Parameters

as-number

The virtual autonomous system number, expressed as a decimal integer.

Values

1 to 65535

private

Specifies the local-as is hidden in paths learned from the peering.

no-prepend-global-as

Specifies that the global-as is hidden in paths announced to the EBGP peer.

Platforms

All

local-as

Syntax

local-as as-number [private] [no-prepend-global-as]

no local-as

Context

[Tree] (config>router>bgp>group>neighbor local-as)

[Tree] (config>router>bgp local-as)

[Tree] (config>router>bgp>group local-as)

Full Context

configure router bgp group neighbor local-as

configure router bgp local-as

configure router bgp group local-as

Description

This command configures a BGP local autonomous system (AS) number. In addition to the global AS number configured for BGP using the autonomous-system command, a local AS number can be configured to support various AS number migration scenarios.

When the local-as command is applied to a BGP neighbor and the local-as is different from the peer-as, the session comes up as EBGP and by default the global-AS number and then (in that order) the local-as number are prepended to the AS_PATH attribute in outbound routes sent to the peer. In received routes from the EBGP peer, the local AS is prepended to the AS path by default, but this can be disabled with the private option.

When the local-as command is applied to a BGP neighbor and the local-as is the same as the peer-as, the session comes up as IBGP, and by default, the global-AS number is prepended to the AS_PATH attribute in outbound routes sent to the peer.

This configuration parameter can be set at three levels: global level (applies to all BGP peers), group level (applies to all BGP peers in group) or neighbor level (only applies to one specific BGP neighbor). By specifying this at the neighbor level, it is possible to have a separate local-as for each BGP session.

When the optional no-prepend-global-as command is configured, the global-as number is not added in outbound routes sent to an IBGP or EBGP peer.

When a command is entered multiple times for the same AS, the last command entered is used in the configuration. The private option can be added or removed dynamically by reissuing the command. Changing the local AS at the global level in an active BGP instance causes the BGP instance to restart with the new local AS number. Changing the local AS at the global level in an active BGP instance causes BGP to re-establish the peer relationships with all peers in the group with the new local AS number. Changing the local AS at the neighbor level in an active BGP instance causes BGP to re-establish the peer relationship with the new local AS number.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default

no local-as

Parameters

as-number

Specifies the virtual autonomous system number expressed as a decimal integer.

Values

1 to 4294967295

private

Specifies the local-as is hidden in paths learned from the peering.

no-prepend-global-as

Specifies that the global-as is hidden in paths announced to the BGP peer.

Platforms

All

local-attachment-circuit

local-attachment-circuit

Syntax

local-attachment-circuit ac-name [endpoint endpoint-name] [bgp bgp-instance] [create]

no local-attachment-circuit ac-name

Context

[Tree] (config>service>epipe>bgp-evpn local-attachment-circuit)

Full Context

configure service epipe bgp-evpn local-attachment-circuit

Description

This command configures a local attachment circuit (AC) in which the local Ethernet tag can be configured.

The no form of this command disables the context.

Default

no local-attachment-circuit

Parameters

ac-name

Specifies the name of the local attachment circuit, up to 32 characters.

endpoint-name

Specifies the name of the endpoint, up to 32 characters.

bgp-instance

Specifies the BGP instance ID.

Values

1 to 2

Default

1

create

Keyword used to create the local AC.

Platforms

All

local-auth-db

local-auth-db

Syntax

local-auth-db name

no local-auth-db

Context

[Tree] (config>service>dynsvc>policy>auth local-auth-db)

Full Context

configure service dynamic-services dynamic-services-policy authentication local-auth-db

Description

This command configures the local authentication database to be used for local authentication of data-triggered dynamic services.

Local authentication and RADIUS authentication are mutually exclusive.

The no form of this command removes the local authentication database from the configuration and disables local authentication.

Parameters

name

local authentication database name, up to 32 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-auth-db

Syntax

local-auth-db name [create]

no local-auth-db name

Context

[Tree] (config>service>dynsvc local-auth-db)

Full Context

configure service dynamic-services local-auth-db

Description

This command creates a local authentication database that can be used for local authentication of data-triggered dynamic services.

The no form of this command removes the local authentication database from the configuration.

Parameters

name

Specifies a local authentication database name, up to 32 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-dhcp-server

local-dhcp-server

Syntax

local-dhcp-server server-name [create]

no local-dhcp-server server-name

Context

[Tree] (config>router>dhcp local-dhcp-server)

[Tree] (config>service>vprn>dhcp local-dhcp-server)

Full Context

configure router dhcp local-dhcp-server

configure service vprn dhcp local-dhcp-server

Description

This command instantiates a local DHCP server. A local DHCP server can serve multiple interfaces but is limited to the routing context it was which it was created.

The no form of this command reverts to the default.

Parameters

server-name

Specifies the name of local DHCP server, up to 32 characters.

create

Keyword used to create the local DHCP server. The create keyword requirement can be enabled or disabled in the environment>create context.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-dhcp-server

Syntax

local-dhcp-server server-name [create] [auto-provisioned]

no local-dhcp-server server-name

Context

[Tree] (config>router>dhcp6 local-dhcp-server)

Full Context

configure router dhcp6 local-dhcp-server

Description

This command instantiates a DHCP6 server. A local DHCP6 server can serve multiple interfaces but is limited to the routing context it was which it was created.

The no form of this command reverts to the default.

Parameters

server-name

Specifies the name of local DHCP6 server, up to 32 characters.

create

Keyword used to create the local DHCP or DHCP6 server. The create keyword requirement can be enabled or disabled in the environment>create context.

auto-provisioned

Specifies the auto provisioning mode. This parameter only applies to DHCP6 creation to configure DHCP6 default values.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-dhcp-server

Syntax

[no] local-dhcp-server server-name [lease-address ip-prefix[prefix-length]]

[no] local-dhcp-server server-name [mac ieee-address]

[no] local-dhcp-server server-name [link-local-address ipv6z-address]

Context

[Tree] (debug>router local-dhcp-server)

Full Context

debug router local-dhcp-server

Description

This command enables, disables or configures debugging for a local DHCP server.

Parameters

server-name

Specifies an existing local DHCP server name.

ip-prefix[/prefix-length]

Specifies the IP prefix and prefix length of the subnet.

Values

ip-prefix — a.b.c.d (host bits must be 0)

length — 0 to 32

ieee-address

Specifies that the provisioned MAC address for the local DHCP server.

ipv6z-address

Specifies the IPv6z address.

ipv6-address:

x:x:x:x:x:x:x:x [-interface]

x:x:x:x:x:x:d.d.d.d [-interface]

x: [0 to FFFF]H

d: [0 to 255]D

interface

up to 32 characters, mandatory for link local addresses

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-dhcp-server

Syntax

[no] local-dhcp-server

Context

[Tree] (config>redundancy>multi-chassis>peer>sync local-dhcp-server)

Full Context

configure redundancy multi-chassis peer sync local-dhcp-server

Description

This command synchronizes DHCP server information.

Default

no local-dhcp-server

Platforms

All

local-dhcp-server

Syntax

local-dhcp-server local-server-name

no local-dhcp-server

Context

[Tree] (config>service>vprn>if>ipv6 local-dhcp-server)

[Tree] (config>service>ies>if local-dhcp-server)

Full Context

configure service vprn interface ipv6 local-dhcp-server

configure service ies interface local-dhcp-server

Description

This command assigns a DHCP server to the interface.

Parameters

local-server-name

Specifies an existing local server name.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-dhcp-server

Syntax

local-dhcp-server local-server-name

no local-dhcp-server

Context

[Tree] (config>router>if local-dhcp-server)

[Tree] (config>router>if>ipv6 local-dhcp-server)

Full Context

configure router interface local-dhcp-server

configure router interface ipv6 local-dhcp-server

Description

This command instantiates a local DHCP server. A local DHCP server can serve multiple interfaces but is limited to the routing context in which it was created.

The no form of this command reverts to the default value.

Default

no local-dhcp-server

Parameters

local-server-name

Specifies the name of local DHCP server, up to 32 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-ecid

local-ecid

Syntax

local-ecid emulated circuit identifier

no local-ecid

Context

[Tree] (config>service>epipe>sap>cem local-ecid)

Full Context

configure service epipe sap cem local-ecid

Description

This command defines the Emulated Circuit Identifiers (ECID) to be used for the local (source) end of the circuit emulation service.

The no form of this command removes the ECID from the configuration.

Default

local-ecid 65535

Parameters

emulated circuit identifier

Specifies the value to be used as the local (source) ECID for the circuit emulation service. On CES packet reception, the ECID in the packet will be compared to the configured local-ecid value. These must match for the packet payload to be used for the TDM circuit. The remote-ecid value is inserted into the MEF-8 CES packet to be transmitted.

Values

0 to 1048575

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e

local-end

local-end

Syntax

local-end {ip-address | ipv6-address}

no local-end

Context

[Tree] (config>service>sdp local-end)

Full Context

configure service sdp local-end

Description

This command configures the local-end address of the following SDP encapsulation types:

  • IPv6 address of the termination point of a SDP of encapsulation l2tpv3 (L2TP v3 tunnel).

  • IPv4/IPv6 source address of a SDP of encapsulation eth-gre-bridged (L2oGRE SDP).

  • IPv4 source address of a SDP of encapsulation gre (GRE SDP).

A change to the value of the local-end parameter requires that the SDP be shut down.

When used as the source address of a SDP of encapsulation gre (GRE SDP), the primary IPv4 address of any local network IP interface, loopback or otherwise, may be used.

The address of the following interfaces are not supported:

  • unnumbered network IP interface

  • IES interface

  • VPRN interface

  • CSC VPRN interface

The local-end parameter value adheres to the following rules:

  • A maximum of 15 distinct address values can be configured for all GRE SDPs under the config>service>sdp>local-end context, and all L2oGRE SDPs under the config>service>system>gre-eth-bridged>tunnel-termination context.

  • The same source address cannot be used in both contexts since an address configured for a L2oGRE SDP matches an internally created interface that is not available to other applications.

  • The local-end address of a GRE SDP, when different from system, need not match the primary address of an interface that has the MPLS-over-GRE termination subnet configured, unless a GRE SDP or tunnel from the far-end router terminates on this address.

The no form of the command removes the address from the local-end configuration.

Parameters

ip-address | ipv6-address

Specifies a IPv4 or IPv6 address for local-end of an SDP in dotted decimal notation.

Values

ip-address

a.b.c.d

ipv6-address

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x - [0..FFFF]H

d - [0..255]D

Platforms

All

local-fcc-port

local-fcc-port

Syntax

local-fcc-port port

no local-fcc-port

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>video local-fcc-port)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>video local-fcc-port)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>source-override>video local-fcc-port)

Full Context

configure mcast-management multicast-info-policy bundle channel video local-fcc-port

configure mcast-management multicast-info-policy bundle video local-fcc-port

configure mcast-management multicast-info-policy bundle channel source-override video local-fcc-port

Description

This command configures the local port on which Fast Channel Change (FCC) requests are received. The value of this object can only be set for the default bundle and will be used by all bundles and channels.

The local-fcc-port port value is the only configuration parameter in the bundle "default” context.

The no form of the command removes the port from the video configuration.

Parameters

port

Specifies a local port for FCC requests.

Values

1024 to 5999, 6251 to 65535

Platforms

7450 ESS, 7750 SR, 7750 SR-s

local-filtering

local-filtering

Syntax

local-filtering

Context

[Tree] (config>app-assure>group>url-filter local-filtering)

Full Context

configure application-assurance group url-filter local-filtering

Description

This command configures a URL filter policy for local filtering in order to filter traffic based on a list of URLs located on a file stored in the router compact flash.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-forward

local-forward

Syntax

local-forward local-forward-id [create]

no local-forward local-forward-id

Context

[Tree] (config>system>satellite local-forward)

Full Context

configure system satellite local-forward

Description

This command creates a local-forward instance.

A local-forward instance creates a traffic bypass within the Ethernet satellite, which allows traffic to be forwarded between satellite client ports.

The no form of this command deletes the specified local-forward instance.

Parameters

local-forward-id

Specifies the ID number for the local-forward instance.

Values

1 to 10240

create

Creates a new local-forward instance.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

local-gateway-address

local-gateway-address

Syntax

local-gateway-address [ip-address | ipv6-address]

no local-gateway-address

Context

[Tree] (config>router>if>ipsec>ipsec-tunnel local-gateway-address)

[Tree] (config>service>ies>if>ipsec>ipsec-tunnel local-gateway-address)

Full Context

configure router interface ipsec ipsec-tunnel local-gateway-address

configure service ies interface ipsec ipsec-tunnel local-gateway-address

Description

This command configures local gateway address of the IPsec gateway.

Parameters

ip-address

Specifies a unicast IPv4 address, up to 64 characters.

ipv6-address

Specifies a unicast global unicast IPv6 address, up to 64 characters.

Platforms

VSR

local-gateway-address

Syntax

local-gateway-address ip-address

no local-gateway-address

Context

[Tree] (config>service>ies>if>sap>ipsec-gw local-gateway-address)

[Tree] (config>service>vprn>if>sap>ipsec-gw local-gateway-address)

Full Context

configure service ies interface sap ipsec-gw local-gateway-address

configure service vprn interface sap ipsec-gw local-gateway-address

Description

This command configures local gateway address of the IPsec gateway.

Parameters

ip-address

Specifies a unicast IPv4 address or a global unicast IPv6 address. This address must be within the subnet of the public interface.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-gateway-address

Syntax

local-gateway-address ip-address peer ip-address delivery-service service-id

no local-gateway-address

Context

[Tree] (config>service>vprn>if>sap>ipsec-tunnel local-gateway-address)

Full Context

configure service vprn interface sap ipsec-tunnel local-gateway-address

Description

This command specifies the local gateway address used for the tunnel and the address of the remote security gateway at the other end of the tunnel remote peer IP address to use.

Default

no local-gateway-address

Parameters

ip-address

IP address of the local end of the tunnel.

delivery-service service-id

The ID of the IES or VPRN (front-door) delivery service of this tunnel. Use this service-id to find the VPRN used for delivery.

Values

service-id: 1 to 2147483648

svc-name: Specifies an existing service name up to 64 characters in length.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-id

local-id

Syntax

local-id type [value value]

no local-id

Context

[Tree] (config>service>vprn>if>sap>ipsec-gw local-id)

[Tree] (config>service>ies>if>ipsec>ipsec-tunnel>dyn local-id)

[Tree] (config>ipsec>trans-mode-prof>dyn local-id)

[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel>dyn local-id)

[Tree] (config>service>vprn>if>sap>ipsec-tun>dyn local-id)

[Tree] (config>router>if>ipsec>ipsec-tunnel>dyn local-id)

[Tree] (config>service>ies>if>sap>ipsec-gw local-id)

Full Context

configure service vprn interface sap ipsec-gw local-id

configure service ies interface ipsec ipsec-tunnel dynamic-keying local-id

configure ipsec ipsec-transport-mode-profile dynamic-keying local-id

configure service vprn interface ipsec ipsec-tunnel dynamic-keying local-id

configure service vprn interface sap ipsec-tunnel dynamic-keying local-id

configure router interface ipsec ipsec-tunnel dynamic-keying local-id

configure service ies interface sap ipsec-gw local-id

Description

This command specifies the local ID used for IDi or IDr for IKEv2 negotiation.

The default behavior depends on the local-auth-method as follows:

  • Psk: local tunnel IP address

  • Cert-auth: subject of the local certificate

The no form of this command removes the parameters from the configuration.

Default

no local-id

Parameters

type

Specifies the type of local ID payload, which could be IPv4 or IPv6 address or FQDN domain name or distinguish the name of the subject in the X.509 certificate.

Values

ipv4 — Specifies to use IPv4 as the local ID type; the default value is the local tunnel end-point address.

ipv6 — Specifies to use IPv6 as the local ID type; the default value is the local tunnel end-point address.

fq1dn — Specifies to use FQDN as the local ID type. The value must be configured.

value

Specifies the data type as an enumerated integer that describes the local identifier type used for IDi or IDr for IKEv2, up to 255 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

  • configure ipsec ipsec-transport-mode-profile dynamic-keying local-id
  • configure service vprn interface sap ipsec-gw local-id
  • configure service ies interface sap ipsec-gw local-id
  • configure service vprn interface sap ipsec-tunnel dynamic-keying local-id

VSR

  • configure service vprn interface ipsec ipsec-tunnel dynamic-keying local-id
  • configure router interface ipsec ipsec-tunnel dynamic-keying local-id
  • configure service ies interface ipsec ipsec-tunnel dynamic-keying local-id

local-ip

local-ip

Syntax

local-ip {ip-prefix/prefix-length | ip-prefix netmask | any}

Context

[Tree] (config>service>vprn>ipsec>sec-plcy>entry local-ip)

[Tree] (config>router>ipsec>sec-plcy>entry local-ip)

Full Context

configure service vprn ipsec security-policy entry local-ip

configure router ipsec security-policy entry local-ip

Description

This command configures the local (from the VPN) IP prefix/mask for the policy parameter entry.

Only one entry is necessary to describe a potential flow. The local-ip and remote-ip commands can be defined only once. The system evaluates:

  • the local IP as the source IP when traffic is examined in the direction of the flows from private to public and as the destination IP when traffic flows from public to private

  • the remote IP as the source IP when traffic flows public to private and as the destination IP when traffic flows from private to public

Parameters

ip-prefix

The destination address of the aggregate route in dotted decimal notation

Values

a.b.c.d (host bits must be 0)

prefix-length 1 to 32

netmask

The subnet mask in dotted decimal notation

any

keyword to specify that it can be any address

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn ipsec security-policy entry local-ip

VSR

  • configure router ipsec security-policy entry local-ip

local-ip-address

local-ip-address

Syntax

local-ip-address ip-address

no local-ip-address

Context

[Tree] (config>lag>bfd>family local-ip-address)

Full Context

configure lag bfd family local-ip-address

Description

This command is used to specify the IPv4 or IPv6 address of the BFD source.

The no form of this command removes this address from the configuration.

Default

no local-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x:-[0 to FFFF]H

d: [0 to 255]D

Platforms

All

local-ip-range-start

local-ip-range-start

Syntax

local-ip-range-start ip-address

no local-ip-range-start

Context

[Tree] (config>isa>nat-group>inter-chassis-redundancy local-ip-range-start)

Full Context

configure isa nat-group inter-chassis-redundancy local-ip-range-start

Description

This command configures the first IP address that is assigned to a first member ISA in the nat-group. The remaining member ISAs in the nat-group are automatically assigned the consecutive IP addresses, starting from the first IP address. These IP addresses are used to communicate between the ISAs on redundant nodes for the purpose of flow synchronization. Traffic from the first local IP address (member ISA), is sent to the first IP address from the remote IP range.

The no form of this command reverts to the default.

Default

no local-ip-range-start

Parameters

ip-address

Specifies the first IP address from the range assigned to the first member ISA in the form of a.b.c.d

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

local-lsr-id

local-lsr-id

Syntax

local-lsr-id {system | interface} [32bit-format]

local-lsr-id interface-name [32bit-format]

no local-lsr-id

Context

[Tree] (config>router>ldp>if-params>if>ipv4 local-lsr-id)

[Tree] (config>router>ldp>if-params>if>ipv6 local-lsr-id)

Full Context

configure router ldp interface-parameters interface ipv4 local-lsr-id

configure router ldp interface-parameters interface ipv6 local-lsr-id

Description

This command enables the use of the address of the local LDP interface, or any other network interface configured on the system, as the LSR-ID to establish link LDP Hello adjacency and LDP session with directly connected LDP peers. The network interface can be a loopback or not.

Link LDP sessions to all peers discovered over a given LDP interface share the same local LSR-ID. However, LDP sessions on different LDP interfaces can use different network interface addresses as their local LSR-ID.

By default, the LDP session to a peer uses the system interface address as the LSR-ID unless explicitly configured using this command. The system interface must always be configured on the router, or the LDP protocol will not come up on the node. There is no requirement to include the system interface in any routing protocol.

At initial configuration, the LDP session to a peer will remain down while the network interface used as LSR-ID is down. LDP will not try to bring it up using the system interface.

If the network IP interface used as LSR-ID goes down, the LDP sessions to all discovered peers using this LSR-ID go down.

When an interface other than the system is used as the LSR-ID, the transport connection (TCP) for the link LDP session will also use the address of that interface as the transport address. If the system or interface value is configured in the config>router>ldp>if-params>if>ipv4 or config>router>ldp>if-params>if>ipv6> transport-address context, it will be overridden with the address of the LSR-ID interface.

When the local-lsr-id command is enabled with the 32bit-format option, an SR OS LSR will be able to establish an LDP IPv6 Hello adjacency and an LDP IPv6 session with an RFC 7552 compliant peer LSR. The LSR uses a 32-bit LSR-ID set to the value of the IPv4 address of the specified local LSR-ID interface and a 128-bit transport address set to the value of the IPv6 address of the specified local LSR-ID interface.

Note:

The system interface cannot be used as a local LSR-ID with the 32bit-format option enabled because the system interface is the default LSR-ID and transport address for all LDP sessions to peers on this LSR. This configuration is blocked in the CLI.

If the user enables the 32bit-format option in the IPv6 context of a running LDP interface, the already established LDP IPv6 Hello adjacency and LDP IPv6 session will be brought down and re-established with the new 32-bit LSR-ID value.

If the user changes the LSR-ID value between system, interface, and interface-name, or enables the 32bit-format option while the LDP session is up, LDP will immediately tear down all sessions using this LSR-ID and will attempt to re-establish them using the new LSR-ID.

The no form of this command returns to the default behavior, in which case the system interface address is used as the LSR-ID.

Default

no local-lsr-id

Parameters

system

Specifies the use of the address of the system interface as the value of the LSR-ID of this LDP LSR.

interface

Specifies the use of the address of the local LDP interface as the value of the LSR-ID of this LDP LSR.

interface-name interface-name

Specifies the name, up to 32 character, of the network IP interface (which address is used as the LSR-ID of this LDP LSP). An interface name cannot be in the form of an IP address. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes.

32bit-format

Specifies the use of the IPv4 address of the local LSR-ID interface as the LSR-ID of this LDP LSR.

Platforms

All

local-lsr-id

Syntax

local-lsr-id interface-name [32bit-format]

no local-lsr-id

Context

[Tree] (config>router>ldp>targ-session>peer-template local-lsr-id)

[Tree] (config>router>ldp>targ-session>peer local-lsr-id)

Full Context

configure router ldp targeted-session peer-template local-lsr-id

configure router ldp targeted-session peer local-lsr-id

Description

This command enables the use of the address of any network interface configured on the system, as the LSR-ID to establish a targeted LDP Hello adjacency and a targeted LDP session with an LDP peer. The network interface can be a loopback or not.

By default, the targeted LDP session to a peer uses the system interface address as the LSR-ID and as the transport address, unless explicitly configured using this command. The system interface must always be configured on the router, or the LDP protocol will not come up on the node. There is no requirement to include the system interface in any routing protocol.

When the local-lsr-id command is enabled with the 32bit-format option, an SR OS LSR will be able to establish a targeted LDP IPv6 Hello adjacency and a targeted LDP IPv6 session with an RFC 7552 compliant peer LSR. The LSR uses a 32-bit LSR-ID set to the value of the IPv4 address of the specified local LSR-ID interface and a 128-bit transport address set to the value of the IPv6 address of the specified local LSR-ID interface.

Note:

The system interface cannot be used as a local LSR-ID with the 32bit-format option enabled because the system interface is the default LSR-ID and transport address for all targeted LDP sessions to peers on this LSR. This configuration is blocked in the CLI.

If the user enables the 32bit-format option in the IPv6 context of a running targeted LDP peer, the already established targeted LDP IPv6 Hello adjacency and targeted LDP IPv6 session will be brought down and re-established with the new 32-bit LSR-ID value.

If the user changes the local LSR-ID value or enables/disables the 32bit-format option, while the targeted LDP session is up, LDP will immediately tear down the targeted session using this LSR-ID and will attempt to re-establish it using the new LSR-ID.

The no form of this command returns to the default behavior, in which case the system interface address is used as the LSR-ID.

Default

no local-lsr-id

Parameters

interface-name

Specifies the name, up to 32 characters, of the network IP interface (which address is used as the LSR-ID of this LDP LSP). An interface name cannot be in the form of an IP address. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes.

32bit-format

Specifies the use of the IPv4 address of the local LSR-ID interface as the LSR-ID of this LDP LSR.

Platforms

All

local-max-checkpoints

local-max-checkpoints

Syntax

local-max-checkpoints [number-of-files]

no local-max-checkpoints

Context

[Tree] (config>system>rollback local-max-checkpoints)

Full Context

configure system rollback local-max-checkpoints

Description

This command configures the maximum number of rollback checkpoint files when the rollback-location is on local compact flash.

Default

no local-max-checkpoints

Parameters

number of files

Specifies the maximum rollback files on a compact flash.

Values

1 to 50

Platforms

All

local-monitoring-policer

local-monitoring-policer

Syntax

[no] local-monitoring-policer policer-name [create]

Context

[Tree] (config>sys>security>dist-cpu-protection>policy local-monitoring-policer)

Full Context

configure system security dist-cpu-protection policy local-monitoring-policer

Description

This command configures a monitoring policer that is used to monitor the aggregate rate of several protocols arriving on an object (for example, SAP). When the local-monitoring-policer is determined to be in a nonconforming state (at the end of a minimum monitoring time of 60 seconds) then the system will attempt to allocate dynamic policers for the particular object for any protocols associated with the local monitor (for example, using the protocol name enforcement dynamic policer-name CLI command).

If the system cannot allocate all the dynamic policers within 150 seconds, it will stop attempting to allocate dynamic policers, raise a LocMonExcdAllDynAlloc log event, and go back to using the local monitor. The local monitor may then detect exceeded packets again and make another attempt at allocating dynamic policers.

Once this policer-name is referenced by a protocol then this policer will be instantiated for each "object” that is created and references this DDoS policy. If there is no policer free then the object will be blocked from being created.

Parameters

policy-name

Specifies name of the policy, up to 32 characters.

Platforms

All

local-name

local-name

Syntax

local-name host-name

no local-name

Context

[Tree] (config>router>l2tp local-name)

[Tree] (config>service>vprn>l2tp local-name)

[Tree] (config>router>l2tp>group local-name)

[Tree] (config>service>vprn>l2tp>group>tunnel local-name)

[Tree] (config>service>vprn>l2tp>group local-name)

[Tree] (config>router>l2tp>group>tunnel local-name)

Full Context

configure router l2tp local-name

configure service vprn l2tp local-name

configure router l2tp group local-name

configure service vprn l2tp group tunnel local-name

configure service vprn l2tp group local-name

configure router l2tp group tunnel local-name

Description

This command creates the local host name used by this system for the tunnels in this L2TP group during the authentication phase of tunnel establishment. It can be used to distinguish tunnels.

The no form of this command removes the host name from the configuration.

Default

no local-name

Parameters

host-name

Specifies the host name, up to 64 characters in length, that the router will use to identify itself during L2TP authentication.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-port-action

local-port-action

Syntax

local-port-action {log-only | out-of-service}

Context

[Tree] (config>port>ethernet>efm-oam>link-mon>local-sf-action local-port-action)

Full Context

configure port ethernet efm-oam link-monitoring local-sf-action local-port-action

Description

This command configures the parameters that define if and how the local port will be affected when the local signal failure threshold (sf-threshold) has been reached within the configured window.

Interactions: The signal failure threshold will trigger these actions.

Default

local-port-action out-of-service

Parameters

log-only

Keyword that prevents the port from being affected when the configured signal failure threshold is reach within the window. The event will be logged but the port will remain operational.

out-of-service

Keyword that causes the port to enter a non-operation down state with a port state of link up. The error will be logged when the configured signal failure threshold (sf-threshold) is reached within the window. The port will not be available to service data but will continue to carry Link OAM traffic to ensure the link is monitored.

Platforms

All

local-preference

local-preference

Syntax

local-preference local-preference

no local-preference

Context

[Tree] (config>subscr-mgmt>bgp-prng-plcy local-preference)

Full Context

configure subscriber-mgmt bgp-peering-policy local-preference

Description

This command enables setting the BGP local-preference attribute in incoming routes if not specified and configures the default value for the attribute. This value is used if the BGP route arrives from a BGP peer without the local-preference integer set.

The specified value can be overridden by any value set via a route policy.

The no form of this command at the global level specifies that incoming routes with local-preference set are not overridden and routes arriving without local-preference set are interpreted as if the route had local-preference value of 100.

Parameters

local-preference

The local preference value to be used as the override value, expressed as a decimal integer.

Values

0 to 4294967295

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-preference

Syntax

local-preference local-preference

no local-preference

Context

[Tree] (config>service>vprn>bgp local-preference)

[Tree] (config>service>vprn>bgp>group local-preference)

[Tree] (config>service>vprn>bgp>group>neighbor local-preference)

Full Context

configure service vprn bgp local-preference

configure service vprn bgp group local-preference

configure service vprn bgp group neighbor local-preference

Description

This command enables setting the BGP local-preference attribute in incoming routes if not specified and configures the default value for the attribute. This value is used if the BGP route arrives from a BGP peer without the local-preference integer set.

The specified value can be overridden by any value set via a route policy. This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command at the global level specifies that incoming routes with local-preference set are not overridden and routes arriving without local-preference set are interpreted as if the route had local-preference value of 100.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default

no local-preference - Does not override the local-preference value set in arriving routes and analyze routes without local preference with value of 100.

Parameters

local-preference

The local preference value to be used as the override value, expressed as a decimal integer.

Values

0 to 4294967295

Platforms

All

local-preference

Syntax

local-preference local-preference

no local-preference

Context

[Tree] (config>router>bgp>group local-preference)

[Tree] (config>router>bgp>group>neighbor local-preference)

[Tree] (config>router>bgp local-preference)

Full Context

configure router bgp group local-preference

configure router bgp group neighbor local-preference

configure router bgp local-preference

Description

This command enables setting the BGP local-preference attribute in incoming routes if not specified and configures the default value for the attribute.

This value is used if the BGP route arrives from a BGP peer without the local-preference integer set.

The specified value can be overridden by any value set via a route policy. This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to the specified peer). The most specific value is used.

The no form of this command at the global level specifies that incoming routes with local-preference set are not overridden and routes arriving without local-preference set are interpreted as if the route had local-preference value of 100.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default

no local-preference

Parameters

local-preference

Specifies the local preference value to be used as the override value expressed as a decimal integer.

Values

0 to 4294967295

Platforms

All

local-preference

Syntax

local-preference preference [equal | or-higher | or-lower]

no local-preference

Context

[Tree] (config>router>policy-options>policy-statement>entry>from local-preference)

Full Context

configure router policy-options policy-statement entry from local-preference

Description

This command matches BGP routes based on local preference (the value in the LOCAL_PREF attribute).

If no comparison qualifiers are present (equal, or-higher, or-lower), then equal is the implied default.

A non-BGP route does not match a policy entry if it contains the local-preference command.

Default

no local-preference

Parameters

preference

Specifies the local preference value.

Values

0 to 4294967295, or a parameter name delimited by starting and ending at-sign (@) characters

equal

Specifies that matched routes should have the same local preference as the value specified.

or-higher

Specifies that matched routes should have the same or a greater local preference as the value specified.

or-lower

Specifies that matched routes should have the same or a lower local preference as the value specified.

Platforms

All

local-preference

Syntax

local-preference preference

no local-preference

Context

[Tree] (config>router>policy-options>policy-statement>default-action local-preference)

[Tree] (config>router>policy-options>policy-statement>entry local-preference)

Full Context

configure router policy-options policy-statement default-action local-preference

configure router policy-options policy-statement entry local-preference

Description

This command assigns a BGP local preference to routes matching a route policy statement entry.

If no local preference is specified, the BGP configured local preference is used.

The no form of this command disables assigning a local preference in the route policy entry.

Default

no local-preference

Parameters

preference

Specifies the local preference expressed as a decimal integer.

Values

0 to 4294967295 name — Specifies the local preference parameter variable name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes. Policy parameters must start and end with at-signs (@); for example, "@variable@”.

Platforms

All

local-prefix

local-prefix

Syntax

local-prefix local-prefix [create]

no local-prefix local-prefix

Context

[Tree] (config>service>pw-routing local-prefix)

Full Context

configure service pw-routing local-prefix

Description

This command configures one or more node prefix values to be used for MS-PW routing. At least one prefix must be configured on each node that is an S-PE or a T-PE.

The no form of this command removes a previously configured prefix, and will cause the corresponding route to be withdrawn if it has been advertised in BGP.

Default

no local-prefix

Parameters

local-prefix

Specifies a 32 bit prefix for the AII. One or more prefix values, up to a maximum of 16, may be assigned to the 7450 ESS, 7750 SR, or 7950 XRS node. The global ID can contain the 2-octet or 4-octet value of the provider's Autonomous System Number (ASN). The presence of a global ID based on the provider's ASN ensures that the AII for spoke-SDPs configured on the node will be globally unique.

Values

<global-id>:<ip-addr>| <raw-prefix>

ip-addr

a.b.c.d

raw-prefix

1 to 4294967295

global-id

1 to 4294967295

Platforms

All

local-priority

local-priority

Syntax

local-priority local-priority

Context

[Tree] (config>service>vprn>ptp>peer local-priority)

Full Context

configure service vprn ptp peer local-priority

Description

This command configures the local priority used to choose between PTP TimeTransmitters in the best TimeTransmitter clock algorithm (BTCA).

The value 1 is the highest priority and 255 is the lowest priority.

If the PTP profile is ieee1588-2008, the priority of a peer cannot be configured.

If the PTP profile is g8265dot1-2010, this parameter configures the priority used to choose between TimeTransmitter clocks with the same quality. Refer to the G.8265.1 standard for more information

If the PTP profile is g8275dot1-2014 or g8275dot2-2016, this parameter sets the value of the localPriority associated with the Announce messages received from the external clocks (ptp>peer or ptp>port), or the local clock (PTP). Refer to the ITU-T G.8275.1/G.8275.2 standard for detailed information

Default

local-priority 128

Parameters

local-priority

Specifies the value of the local priority.

Values

1 to 255

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

local-priority

Syntax

local-priority priority

Context

[Tree] (config>system>ptp local-priority)

[Tree] (config>system>ptp>peer local-priority)

[Tree] (config>system>ptp>port local-priority)

Full Context

configure system ptp local-priority

configure system ptp peer local-priority

configure system ptp port local-priority

Description

This command configures the local priority used to choose between PTP TimeTransmitters in the best TimeTransmitter clock algorithm (BTCA).

The value 1 is the highest priority and 255 is the lowest priority.

If the PTP profile is ieee1588-2008, the priority of a peer cannot be configured.

If the PTP profile is g8265dot1-2010, this parameter configures the priority used to choose between TimeTransmitter clocks with the same quality. Refer to the G.8265.1 standard for more information

If the PTP profile is g8275dot1-2014 or g8275dot2-2016, this parameter sets the value of the localPriority associated with the Announce messages received from the external clocks (ptp>peer or ptp>port), or the local clock (PTP). Refer to the ITU-T G.8275.1/G.8275.2 standard for detailed information

Default

local-priority 128

Parameters

priority

Specifies the value of the local priority.

Values

1 to 255

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

local-proxy-arp

local-proxy-arp

Syntax

[no] local-proxy-arp

Context

[Tree] (config>service>vprn>sub-if>grp-if local-proxy-arp)

[Tree] (config>service>ies>if local-proxy-arp)

[Tree] (config>service>vprn>if local-proxy-arp)

[Tree] (config>service>ies>sub-if>grp-if local-proxy-arp)

Full Context

configure service vprn subscriber-interface group-interface local-proxy-arp

configure service ies interface local-proxy-arp

configure service vprn interface local-proxy-arp

configure service ies subscriber-interface group-interface local-proxy-arp

Description

This command enables local proxy ARP. When local proxy ARP is enabled on an IP interface, the system responds to all ARP requests for IP addresses belonging to the subnet with its own MAC address, and thus becomes the forwarding point for all traffic between hosts in that subnet.

When local-proxy-arp is enabled, ICMP redirects on the ports associated with the service are automatically blocked.

The no form of this command reverts to the default.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn subscriber-interface group-interface local-proxy-arp
  • configure service ies subscriber-interface group-interface local-proxy-arp

All

  • configure service vprn interface local-proxy-arp
  • configure service ies interface local-proxy-arp

local-proxy-arp

Syntax

[no] local-proxy-arp

Context

[Tree] (config>router>if local-proxy-arp)

Full Context

configure router interface local-proxy-arp

Description

This command enables local proxy ARP on the interface.

Default

no local-proxy-arp

Platforms

All

local-proxy-nd

local-proxy-nd

Syntax

[no] local-proxy-nd

Context

[Tree] (config>service>vprn>if>ipv6 local-proxy-nd)

[Tree] (config>service>ies>if>ipv6 local-proxy-nd)

Full Context

configure service vprn interface ipv6 local-proxy-nd

configure service ies interface ipv6 local-proxy-nd

Description

This command enables local proxy neighbor discovery on the interface.

When this command is enabled, the interface replies to neighbor solicitation requests when both the hosts are on the same subnet. In this case, ICMP redirects are disabled. When this command is disabled, the interface does not reply to neighbor solicitation requests if both the hosts are on the same subnet.

The no form of this command reverts to the default.

Platforms

All

local-proxy-nd

Syntax

[no] local-proxy-nd

Context

[Tree] (config>router>if>ipv6 local-proxy-nd)

Full Context

configure router interface ipv6 local-proxy-nd

Description

This command enables local proxy neighbor discovery on the interface.

The no form of this command disables local proxy neighbor discovery.

Platforms

All

local-routes-domain-id

local-routes-domain-id

Syntax

local-routes-domain-id [global-field:local-field]

no local-routes-domain-id

Context

[Tree] (config>service>vprn local-routes-domain-id)

Full Context

configure service vprn local-routes-domain-id

Description

This command specifies the domain ID that is used in the D-PATH attribute for local routes before those routes are exported to a BGP neighbor using BGP-IPVPN, EVPN-IFF, EVPN-IFL or PE-CE BGP. A local route is a non-BGP route installed in the VPRN route table and learned using static route or an IGP.

The domain IDs are used in the D-PATH attribute, in accordance with draft-ietf-bess-evpn-ipvpn-interworking. The D-PATH attribute is modified by gateway routers, where a gateway is defined as a PE where a VPRN is instantiated, and that VPRN advertises or receives routes from multiple BGP owners (for example, EVPN-IFL and BGP-IPVPN).

The D-PATH attribute is used on gateways to detect loops (for received routes where the D-PATH contains a local domain ID) and to make BGP best path selection decisions based on the D-PATH length (shorter D-PATH is preferred).

The no form of this command removes the domain ID for local routes.

Default

no local-routes-domain-id

Parameters

global-field:local-field

Specifies the domain ID for local routes.

Values

4byte-GlobalAdminValue:2byte-LocalAdminValue

4byte-GlobalAdminValue:

0 to 4294967295

2byte-LocalAdminValue

0 to 65535

Platforms

All

local-rt-port

local-rt-port

Syntax

local-rt-port port

no local-rt-port

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>source-override>video local-rt-port)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>video local-rt-port)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>video local-rt-port)

Full Context

configure mcast-management multicast-info-policy bundle channel source-override video local-rt-port

configure mcast-management multicast-info-policy bundle channel video local-rt-port

configure mcast-management multicast-info-policy bundle video local-rt-port

Description

This command configures the local port on which retransmission (RET) requests are received. The value of this object can only be set for the default bundle and will be used by all channels.

The local-rt-port port value is the only configuration parameter in the bundle "default” context.

The no form of the command removes the port from the video configuration.

Parameters

port

Specifies a local port for RT requests.

Values

1024 to 5999, 6251 to 65535

Platforms

7450 ESS, 7750 SR, 7750 SR-s

local-rt-server

local-rt-server

Syntax

[no] local-rt-server

Context

[Tree] (config>isa>video-group local-rt-server)

Full Context

configure isa video-group local-rt-server

Description

This command enables the local RET server for the group. A local RET server cannot be enabled if an FCC server or ad insertion is enabled.

The no form of the command disables the server.

Default

no local-rt-server

Platforms

7450 ESS, 7750 SR, 7750 SR-s

local-rt-server

Syntax

[no] local-rt-server

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>video-policy>video-if>sd local-rt-server)

[Tree] (config>mcast-mgmt>mcast-info-plcy>video-policy>video-if>hd local-rt-server)

[Tree] (config>mcast-mgmt>mcast-info-plcy>video-policy>video-if>pip local-rt-server)

Full Context

configure mcast-management multicast-info-policy video-policy video-interface sd local-rt-server

configure mcast-management multicast-info-policy video-policy video-interface hd local-rt-server

configure mcast-management multicast-info-policy video-policy video-interface pip local-rt-server

Description

This command enables the local retransmission server function for requests directed to the IP address.

The no form of the command disables the retransmission server.

Default

no local-rt-server

Platforms

7450 ESS, 7750 SR, 7750 SR-s

local-rt-server

Syntax

local-rt-server [disable]

no local-rt-server

Context

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>video local-rt-server)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>video local-rt-server)

[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>source-override>video local-rt-server)

Full Context

configure mcast-management multicast-info-policy bundle video local-rt-server

configure mcast-management multicast-info-policy bundle channel video local-rt-server

configure mcast-management multicast-info-policy bundle channel source-override video local-rt-server

Description

This command enables the local retransmission server capability on the ISA video group.

RET server parameters can be configured in a multicast information policy or a service, but the parameters will have no effect if the RET server is disabled or if the video group is administratively disabled (shutdown).

The no form of the command returns the parameter to the default value where the RET server is disabled on the video group.

Default

no local-rt-server

Parameters

disable

Specifies to disable the RET server.

Platforms

7450 ESS, 7750 SR, 7750 SR-s

local-sf-action

local-sf-action

Syntax

local-sf-action

Context

[Tree] (config>port>ethernet>efm-oam>link-monitoring local-sf-action)

Full Context

configure port ethernet efm-oam link-monitoring local-sf-action

Description

This command defines how crossing the local signal failure threshold (sf-threshold) will be handled. This includes local actions and if and how to notify the peer that the threshold has been crossed.

Platforms

All

local-source-address

local-source-address

Syntax

local-source-address {ip-int-name | ip-address}

no local-source-address

Context

[Tree] (config>system>telemetry>persistent>subscription local-source-address)

Full Context

configure system telemetry persistent-subscriptions subscription local-source-address

Description

This command is used to assign a source IP address in the respective persistent subscription context for use when packets are sent out.

The no form of this command removes this address from the configuration.

Parameters

ip-int-name

Specifies the source IP address name, up to 64 characters.

ip-address

Specifies the source IP address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x:-[0 to FFFF]H

d: [0 to 255]D

Platforms

All

local-source-address

Syntax

local-source-address {ip-int-name | ip-address}

no local-source-address

Context

[Tree] (config>system>grpc-tunnel>destination-group>destination local-source-address)

Full Context

configure system grpc-tunnel destination-group destination local-source-address

Description

This command configures a local source IP address in the destination group context for use when packets are sent out.

The no form of this command removes this address from the configuration.

Default

no local-source-address

Parameters

ip-int-name

Specifies the source IP address name, up to 64 characters.

ip-address

Specifies the source IPv4 address (in dotted decimal notation) or IPv6 address.

Values

ipv4-address:

a.b.c.d

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x:-[0 to FFFF]H

d: [0 to 255]D

Platforms

All

local-sr-protection

local-sr-protection

Syntax

local-sr-protection local-sr-protection

no local-sr-protection

Context

[Tree] (config>router>mpls>lsp local-sr-protection)

[Tree] (config>router>mpls>lsp-template local-sr-protection)

Full Context

configure router mpls lsp local-sr-protection

configure router mpls lsp-template local-sr-protection

Description

This command configures the SR LFA protection needed for the adjacencies used in the path computation of an SR-TE LSP by the local CSPF.

The default value of the command is preferred. The local CSPF will prefer a protected adjacency over an unprotected adjacency whenever both exist for a TE link. However, the entire computed path can combine both types of adjacencies.

When the user enables the mandatory value, CSPF uses it as an additional path constraint and selects protected adjacencies exclusively in computing the path of the SR-TE LSP. CSPF will return no path if all candidate paths that otherwise satisfy all other LSP path constraints do not have an unprotected SID for each of their TE links.

Similarly, if the user enables the value none, CSPF uses it as an additional path constraint and selects unprotected adjacencies exclusively in computing the path of the SR-TE LSP. CSPF will return no path if all candidate paths that otherwise satisfy all other LSP path constraints do not have a protected SID for each of their TE links.

The no form of this command returns the command to its default value.

Default

no local-sr-protection

Parameters

local-sr-protection

Specifies the local-sr-protection for LSPs.

Values

none — Selects unprotected adjacencies only in the SR-TE LSP path computation.

preferred — Prefers protected adjacencies in the SR-TE LSP path computation.

mandatory — Selects protected adjacencies only in the SR-TE LSP path computation.

Platforms

All

local-state

local-state

Syntax

local-state {admin-down | up}

no local-state

Context

[Tree] (config>bfd>seamless-bfd>reflector local-state)

Full Context

configure bfd seamless-bfd reflector local-state

Description

This command specifies the setting of the local state field in reflected seamless BFD control packets.

The no form of this command means that the field is not explicitly set by the reflector.

Default

local-state up

Parameters

admin-down

Specifies that the local state of the reflected seamless BFD control packets is administratively down.

up

Specifies that the local state of the reflected seamless BFD control packets is up.

Platforms

All

local-switching-service-state

local-switching-service-state

Syntax

local-switching-service-state {pbb-tunnel | sap}

Context

[Tree] (config>service>epipe>pbb local-switching-service-state)

Full Context

configure service epipe pbb local-switching-service-state

Description

In a PBB Epipe with two SAPs and a PBB tunnel, this command controls whether the operational status of the PBB-Epipe service depends on the status of the PBB tunnel only.

Default

local-switching-service-state sap

Parameters

pbb-tunnel

Specifies that the operational state of the PBB-Epipe service is up if the PBB tunnel is operationally up, irrespective of the operational state of the two SAPs.

sap

Specifies that the operational state of the PBB-Epipe service is up, if two of the three endpoints (PBB tunnel and two SAPs) are up. This option implies that at least one of the SAPs must be up for the PBB-Epipe service to be operationally up.

Platforms

All

local-user-db

local-user-db

Syntax

local-user-db local-user-db-name [create]

no local-user-db local-user-db-name

Context

[Tree] (config>subscr-mgmt local-user-db)

Full Context

configure subscriber-mgmt local-user-db

Description

Commands in this context configure a local user database.

The no form of this command reverts to the default.

Parameters

local-user-db-name

Specifies the name of a local user database, up to 32 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

local-v6-ip

local-v6-ip

Syntax

local-v6-ip ipv6-prefix/prefix-length

local-v6-ip any

no local-v6-ip

Context

[Tree] (config>service>vprn>ipsec>sec-plcy>entry local-v6-ip)

[Tree] (config>router>ipsec>sec-plcy>entry local-v6-ip)

Full Context

configure service vprn ipsec security-policy entry local-v6-ip

configure router ipsec security-policy entry local-v6-ip

Description

This command specifies the local v6 prefix for the security-policy entry.

Parameters

ipv6-prefix/prefix-length

Specifies the local v6 prefix and length

Values

ipv6-address/prefix: ipv6-address

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x [0 to FFFF]H

d [0 to 255]D

host bits must be 0

:: not allowed

prefix-length [1 to 128]

any

keyword to specify that it can be any address.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

  • configure service vprn ipsec security-policy entry local-v6-ip

VSR

  • configure router ipsec security-policy entry local-v6-ip

location

location

Syntax

location cflash-id

no location

Context

[Tree] (config>system>persistence>dhcp-server location)

[Tree] (config>system>persistence>nat-fwd location)

[Tree] (config>system>persistence>ancp location)

[Tree] (config>system>persistence>python location)

[Tree] (config>system>persistence>subscriber-mgmt location)

Full Context

configure system persistence dhcp-server location

configure system persistence nat-port-forwarding location

configure system persistence ancp location

configure system persistence python-policy-cache location

configure system persistence subscriber-mgmt location

Description

This command instructs the system where to write the persistency files for the corresponding application. Each application creates two files on the flash card, one with suffix .i<version>, referencing an index file, and the other with suffix .0<version>, where <version> is a 2-digit number reflecting the file version. These versions are not related to the SR OS release running on the node. The <version> can remain the same over two major releases, for example, when no format change is made to the persistency file. On boot, the system scans the file systems looking for the corresponding persistency files, and the load begins.

For example, in the subscriber management context, the location specifies the flash device on a CPM card where the data for handling subscriber management persistency is stored.

The no form of this command returns the system to the default. If there is a change in file location while persistence is running, a new file will be written on the new flash, and then the old file will be removed.

Default

no location

Parameters

cflash-id

Specifies the compact flash device name.

Values

cf1:, cf2:, cf3:

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

  • configure system persistence dhcp-server location
  • configure system persistence subscriber-mgmt location

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

  • configure system persistence nat-port-forwarding location

All

  • configure system persistence python-policy-cache location
  • configure system persistence ancp location

location

Syntax

location {cf1 | cf2}

Context

[Tree] (config>call-trace location)

Full Context

configure call-trace location

Description

This command specifies the compact flash (CF) configuration to store call trace files.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

location

Syntax

location cflash-id

no location

Context

[Tree] (config>system>persistence>application-assurance location)

Full Context

configure system persistence application-assurance location

Description

This command instructs the system where to write the file. The name of the file is: appassure.db. On boot the system scans the file systems looking for appassure.db, if it finds it, it starts to load it.

The no form of this command returns the system to the default. If there is a change in file location while persistence is running, a new file will be written on the new flash, and then the old file will be removed.

Default

no location

Parameters

cflash-id

Specifies the compact flash type.

Values

cf1:, cf2:, cf3:

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

location

Syntax

location remote-url

no location

Context

[Tree] (config>service>nat>deterministic-script location)

Full Context

configure service nat deterministic-script location

Description

This command configures the remote location where the Python script will be exported. The Python script is then used off-line to perform reverse query. If this command is configured, the Python script generation is triggered by any modification of the deterministic NAT configuration. The new script reflects the change in mappings caused by configuration change. However, the script must be manually exported to the outside location with the admin nat save-deterministic-nat command. The script cannot be stored locally on the system.

The script allows two forms of queries:

  • Forward – input is NAT inside parameters, output is NAT outside parameters.

  • Backward – input is NAT outside parameters, output is NAT inside parameters.

Forward Query:

user@external-server:/home/ftp/pub/det-nat-script$ ./det-nat.py -f -s 10 -a 10.0.5.10 

output:

subscriber has public ip address 198.51.100.1 from service 0 and is using ports [1324 - 1353]

Reverse Query:

user@external-server:/home/ftp/pub/det-nat-script$./det-nat.py -b -s 0 -a 198.51.100.1 -p 3020

output:

subscriber has private ip address 10.0.5.66 from service 10

Default

no location

Parameters

remote-url

A remote location where the script is stored:

[{ftp:// | tftp://}<login>:<pswd>@ <remote-locn>/][<file-path>]

Maximum length is 180 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

location

Syntax

location location

no location

Context

[Tree] (config>system location)

Full Context

configure system location

Description

This command creates a text string that identifies the system location for the device.

Only one location can be configured. If multiple locations are configured, the last one entered overwrites the previous entry.

The no form of the command reverts to the default value.

Parameters

location

Specifies the location as a character string. The string may be up to 80 characters. Any printable, seven-bit ASCII characters can be used within the string. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes.

Platforms

All

location

Syntax

location file-url

no location

Context

[Tree] (config>system>script-control>script location)

Full Context

configure system script-control script location

Description

This command is used to identify the location of a script to be scheduled.

The no form of the command removes the location.

Default

no location

Parameters

file-url

Specifies the location to search for scripts.

Values

local-url | remote-url

local-url — [cflash-id/] [file-path] 200 chars max, including cflash-id directory length 99 characters max each

remote url — [{ftp:// | tftp://}login:password@remote-location/][file-path] 255 characters max directory length 99 characters max each

remote-location — [hostname | ipv4-address | ipv6-address]

ipv4-address — a.b.c.d

ipv6-address — x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x — [0 to FFFF]H

d — [0 to 255]D

interface — 32 characters max, for link local addresses

cflash-id — cf1:, cf1-A:, cf1-B:, cf2:, cf2-A:, cf2-B:, cf3:, cf3-A:, cf3-B:

Platforms

All

location

Syntax

location cflash-id [backup-cflash-id]

no location

Context

[Tree] (config>log>file-id location)

Full Context

configure log file-id location

Description

This command specifies the primary and optional backup location where the log or billing file will be created.

The location command is optional. If the location command not explicitly configured, log files will be created on cf1: and accounting files will be created on cf2: without overflow onto other devices. Generally, cf3: is reserved for system files (configurations, images, and so on).

When multiple location commands are entered in a single file ID context, the last command overwrites the previous command.

When the location of a file ID that is associated with an active log ID is changed, the log events are not immediately written to the new location. The new location does not take effect until the log is rolled over either because the rollover period has expired or a clear log log-id command is entered to manually rollover the log file.

When creating files, the primary location is used as long as there is available space. If no space is available, an attempt is made to delete unnecessary files that are past their retention date.

If sufficient space is not available an attempt is made to remove the oldest to newest closed log or accounting files. After each file is deleted, the system attempts to create the new file.

A medium severity trap is issued to indicate that a compact flash is either not available or that no space is available on the specified flash and that the backup location is being used.

A high priority alarm condition is raised if none of the configured compact flash devices for this file ID are present or if there is insufficient space available. If space does become available, then the alarm condition will be cleared.

Log files are created on cf1: and accounting files are created on cf2.

Use the no form of this command to revert to default settings.

Default

no location

Parameters

cflash-id

Specify the primary location.

Values

cflash-id: cf1:, cf2:, cf3:

backup-cflash-id

Specify the secondary location.

Values

cflash-id: cf1:, cf2:, cf3:

Platforms

All

location

Syntax

location location-id [primary-ip-address ipv4-address] [secondary-ip-address ipv4-address] [tertiary-ip-address ipv4-address]

Context

[Tree] (config>router>bgp>optimal-route-reflection location)

Full Context

configure router bgp optimal-route-reflection location

Description

This command configures the location ID for the for the route reflector. A BGP neighbor can be associated with a location if it is a route-reflector client.

Parameters

location-id

Specifies an optimal-route-reflection location.

Values

1 to 255

ipv4-address

Specifies the primary, secondary, or tertiary IP address.

Values

primary ipv4-address, secondary ipv4-address, tertiary ipv4-address

Platforms

All

locator

locator

Syntax

locator name function end-b6-encaps-red [function-value function-value]

no locator

Context

[Tree] (conf>router>segment-routing>sr-policies>policy>srv6>binding-sid locator)

Full Context

configure router segment-routing sr-policies static-policy segment-routing-v6 binding-sid locator

Description

This command configures binding SID locator parameters for a local SRv6 policy. This command and the ip-address command in the conf>router>segment-routing>sr-policies>policy>srv6>binding-sid context for a remote SRv6 policy are mutually exclusive.

The no form of the command removes the configuration.

Parameters

name

Specifies the name of the locator, up to 64 characters. A corresponding locator name must exist in the config>router>segment-routing>srv6 context.

end-b6-encaps-red

Keyword to configure End.B6.Encaps.Red as the End.B6 function that must be implemented by the datapath.

function-value

Specifies the optional function value. If a function value is configured, the router checks whether this function value is available for the named locator. If no function value is configured, the router dynamically allocates a value.

Values

1 to 1048575

Default

no function value

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR

locator

Syntax

[no] locator locator-name

Context

[Tree] (config>router>segment-routing>srv6 locator)

Full Context

configure router segment-routing segment-routing-v6 locator

Description

This command configures the name of an SRv6 locator to be used by the routing protocols and services. This also creates the context to configure the locator block, locator node, function and argument lengths.

A limit of 16 locators per system is enforced.

The no form of this command removes the specified locator name.

Parameters

locator-name

Specifies a locator name, up to 64 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR

locator

Syntax

[no] locator locator-name

Context

[Tree] (config>router>segment-routing>srv6>inst locator)

Full Context

configure router segment-routing segment-routing-v6 base-routing-instance locator

Description

This command refers to a locator name defined under the config>router>segment-routing>srv6 context. This command assigns a locator to BGP for use with base router routes.

The no form of this command removes the reference to a locator name locator.

Parameters

locator-name

Specifies a locator name, up to 64 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR

locator

Syntax

[no] locator locator-name

Context

[Tree] (config>router>isis>srv6 locator)

Full Context

configure router isis segment-routing-v6 locator

Description

This command refers to a locator name defined under the config>router>segment-routing>srv6 context.

This command assigns a locator to each algorithm in an IS-IS instance. The same locator of a specific algorithm number can be shared with other IGP instances and BGP instances in IP-VPN or EVPN.

The locator block, locator node, function and argument lengths are defined under the config>router>segment-routing>srv6 context.

The no form of this command removes the reference to a locator name.

Parameters

locator-name

Specifies a locator name, up to 64 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR

locator

Syntax

[no] locator locator-name

Context

[Tree] (config>service>vpls>srv6 locator)

[Tree] (config>service>vprn>srv6 locator)

[Tree] (config>service>epipe>srv6 locator)

Full Context

configure service vpls segment-routing-v6 locator

configure service vprn segment-routing-v6 locator

configure service epipe segment-routing-v6 locator

Description

This command refers to a locator name defined under the config>router>segment-routing>srv6 context.

This command assigns a locator to the SRv6 instance in the service. The same locator can be referenced in multiple BGP instances used by IPVPN or EVPN.

The locator block, locator node, function and argument lengths are defined under the config>router>segment-routing>srv6 context.

The no form of this command removes the reference to a locator name.

Parameters

locator-name

Specifies a locator name, up to 64 characters.

Platforms

7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR

lock

lock

Syntax

[no] lock

Context

[Tree] (configure>system>security>profile>netconf>base-op-authorization lock)

Full Context

configure system security profile netconf base-op-authorization lock

Description

This command authorizes a user associated with the profile to send a NETCONF <lock> RPC. This lock RPC allows a NETCONF client to lock a configuration datastore.

The no form of the command denies the user from requesting a lock.

Default

no lock

Platforms

All

lock-override

lock-override

Syntax

[no] lock-override

Context

[Tree] (config>system>script-control>script-policy lock-override)

Full Context

configure system script-control script-policy lock-override

Description

This command allows a triggered EHS/CRON script to execute while there is a datastore lock, started by an MD interface, in place.

A triggered EHS/CRON script queues until an ongoing commit (or confirmed-commit) is done. When an EHS/CRON script is triggered while the lock-override CLI knob is on, SR OS behaves as follows.

When an exclusive session is in place:

  • Keep if it is an MD-CLI session. Disconnect if it is a NETCONF session

  • Lose the exclusive lock

  • Lose any uncommitted configuration changes

When a global session is in place:

  • Keep the MD-CLI or NETCONF session

  • Keep the uncommitted configuration changes

  • An update may be required after committing the EHS/CRON script configuration changes

The no form of this command does not allow the script to execute while there is a datastore lock in place.

Default

lock-override

Platforms

All

lockout

lockout

Syntax

lockout failed-attempts count duration duration-minutes block block-minutes [max-port-per-ip number-of-ports]

no lockout

Context

[Tree] (config>ipsec>ike-policy lockout)

Full Context

configure ipsec ike-policy lockout

Description

This command enables the lockout mechanism for the IPsec tunnel. The system will lock out an IPsec client for the configured time interval if the number of failed authentications exceeds the configured value within the specified duration. This command only applies when the system acts as a tunnel responder.

A client is defined as the tunnel IP address plus the port.

Optionally, the max-port-per-ip parameter can be configured as the maximum number of ports allowed behind the same IP address. If this threshold is exceeded, then all ports behind the IP address are blocked.

The no form of this command disables the lockout mechanism.

Default

no lockout

Parameters

count

Specifies the maximum number of failed authentications allowed during the duration-minutes interval.

Values

1 to 64

Default

3

duration-minutes

Specifies the interval of time, in minutes, during which the configured failed authentication count must be exceeded in order to trigger a lockout.

Values

1 to 60

Default

5

block-minutes

Specifies the number of minutes that the client is blocked if the configured failed authentication count is exceeded.

Values

1 to 1440, infinite

Default

10

number-of-ports

Specifies the maximum number of ports allowed behind the same IP address.

Values

1 to 32000

Default

16

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

lockout

Syntax

clear lockout {user user-name | all}

Context

[Tree] (admin>clear lockout)

Full Context

admin clear lockout

Description

This command is used to clear any lockouts for a specific user, or for all users.

Parameters

user-name

Clears the locked username.

all

Clears all locked usernames.

Platforms

All

lockout-reset-time

lockout-reset-time

Syntax

lockout-reset-time seconds

no lockout-reset-time

Context

[Tree] (config>subscr-mgmt>host-lockout-plcy lockout-reset-time)

Full Context

configure subscriber-mgmt host-lockout-policy lockout-reset-time

Description

This command configures the time that needs to elapse from the point a client enters lockout to when the client’s lockout time can be reset to the configured minimum value. The range is 1 second.

The no form of this command reverts to the default value.

Default

lockout-reset-time 60

Parameters

seconds

Specifies the lockout reset time, in seconds.

Values

1 to 86400

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

lockout-time

lockout-time

Syntax

lockout-time [min seconds] [max seconds]

no lockout-time

Context

[Tree] (config>subscr-mgmt>host-lockout-plcy lockout-time)

Full Context

configure subscriber-mgmt host-lockout-policy lockout-time

Description

This command configures the time for which a client stays in the lockout state during which authentication and ESM host creation is suppressed.

The no form of this command reverts to the default value.

Default

lockout-time min 10 max 3600

Parameters

min seconds

Specifies the minimum lockout-time for this host lockout policy.

Values

1 to 86400

Default

10 seconds

max seconds

Specifies the maximum lockout-time for this host lockout policy.

Values

1 to 86400

Default

3600 seconds

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

log

log

Syntax

log

Context

[Tree] (config log)

Full Context

configure log

Description

Commands in this context are used to configure both event logs and accounting logs. Event logs control the generation, dissemination and recording of system events for monitoring status and troubleshooting faults within the system. Event logging configuration includes syslog, snmp notifications (traps), NETCONF notifications and other types of event log outputs. Accounting logs collect comprehensive accounting statistics and write them to XML files on the compact flash in order to support a variety of billing models.

Platforms

All

log

Syntax

[no] log

Context

[Tree] (config>service>vprn>static-route-entry>next-hop>cpe-check log)

[Tree] (config>service>vprn>static-route-entry>indirect>cpe-check log)

Full Context

configure service vprn static-route-entry next-hop cpe-check log

configure service vprn static-route-entry indirect cpe-check log

Description

This optional parameter enables the ability to log transitions between active and in-active based on the CPE connectivity check. Events will be sent to the system log, syslog and SNMP traps.

Default

no log

Platforms

All

log

Syntax

[no] log

Context

[Tree] (config>service>vprn>sub-if>grp-if>sap>static-host>managed-routes>route-entry>cpe-check log)

[Tree] (config>service>ies>sub-if>grp-if>sap>static-host>managed-routes>route-entry>cpe-check log)

Full Context

configure service vprn subscriber-interface group-interface sap static-host managed-routes route-entry cpe-check log

configure service ies subscriber-interface group-interface sap static-host managed-routes route-entry cpe-check log

Description

This command configures the ability to log transitions between active and inactive based on the CPE connectivity check.

Default

no log

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

log

Syntax

log

Context

[Tree] (config>service>vprn log)

Full Context

configure service vprn log

Description

Commands in this context configure event logging within a specific VPRN.

By default, the log events in a VPRN log are a subset of the complete set of possible log events in SR OS. See the config>log>services-all-events command for more details.

Platforms

All

log

Syntax

log

Context

[Tree] (config>li log)

Full Context

configure li log

Description

Commands in this context configure an event log for LI.

Platforms

All

log

Syntax

log log-id

no log

Context

[Tree] (config>filter>mac-filter>entry log)

[Tree] (config>filter>ip-filter>entry log)

[Tree] (config>filter>ipv6-filter>entry log)

Full Context

configure filter mac-filter entry log

configure filter ip-filter entry log

configure filter ipv6-filter entry log

Description

This command associates a filter log to the current filter policy entry and therefore enables logging for that filter entry.

The filter log must exist before a filter entry can be enabled to use the filter log.

The no form of the command disables logging for the filter entry.

Default

no log

Parameters

log-id

Specifies the filter log ID expressed as a decimal integer.

Values

101 to 199

Platforms

All

log

Syntax

log log-id [create]

no log log-id

Context

[Tree] (config>filter log)

Full Context

configure filter log

Description

This command, creates a configuration context for the specified filter log if it does not exist, and enables the context to configure the specified filter log.

The no form of the command deletes the filter log. The log cannot be deleted if there are filter entries configured to write to the log. All filter entry logging associations need to be removed before the log can be deleted.

Default

log 101

Parameters

log-id

Specifies the filter log ID expressed as a decimal integer.

Values

101 to 199

create

This keyword is required to create the configuration context. After it is created, the context can be enabled with or without the create keyword.

Platforms

All

log

Syntax

[no] log

Context

[Tree] (config>router>static-route-entry>indirect>cpe-check log)

[Tree] (config>router>static-route-entry>next-hop>cpe-check log)

Full Context

configure router static-route-entry indirect cpe-check log

configure router static-route-entry next-hop cpe-check log

Description

This optional parameter enables the ability to log transitions between active and in-active based on the CPE connectivity check. Events will be sent to the system log, syslog and SNMP traps.

Default

no log

Platforms

All

log

Syntax

[no] log

Context

[Tree] (config>system>security>mgmt-access-filter>ip-filter>entry log)

[Tree] (config>system>security>mgmt-access-filter>ipv6-filter>entry log)

[Tree] (config>system>security>mgmt-access-filter>mac-filter>entry log)

Full Context

configure system security management-access-filter ip-filter entry log

configure system security management-access-filter ipv6-filter entry log

configure system security management-access-filter mac-filter entry log

Description

This command enables match logging. When enabled, matches on this entry will cause the Security event mafEntryMatch to be raised.

Default

no log

Platforms

All

log

Syntax

log log-id

Context

[Tree] (config>sys>security>cpm-filter>ip-filter>entry log)

[Tree] (config>sys>security>cpm-filter>ipv6-filter>entry log)

[Tree] (config>sys>security>cpm-filter>mac-filter>entry log)

Full Context

configure system security cpm-filter ip-filter entry log

configure system security cpm-filter ipv6-filter entry log

configure system security cpm-filter mac-filter entry log

Description

This command specifies the log in which packets matching this entry should be entered. The value zero indicates that logging is disabled.

The no form of this command deletes the log ID.

Parameters

log-id

Specifies the log ID where packets matching this entry should be entered.

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-anno-interval

log-anno-interval

Syntax

log-anno-interval log-interval

no log-anno-interval

Context

[Tree] (config>system>ptp log-anno-interval)

Full Context

configure system ptp log-anno-interval

Description

This command configures the announce message interval used for both unicast and multicast messages.

For unicast messages, it defines the announce message interval that is requested during unicast negotiation to any peer. This controls the announce message rate sent from remote peers to the local node. It does not affect the announce message rate that may be sent from the local node to remote peers. Remote peers may request an announce message rate anywhere within the acceptable grant range.

For multicast messages, used on PTP Ethernet ports, this configures the message interval used for Announce messages transmitted by the local node.

This value also defines the interval between executions of the BTCA within the node.

The announce-interval cannot be changed unless the PTP is shut down.

Note:

In order to minimize BTCA driven reconfigurations, the IEEE recommends that the announce-interval should be consistent across the entire 1588 network.

The no form of this command reverts the configuration to the default value. The default value varies depending on the configuration of the profile command.

Default

log-anno-interval 1 (1 packet every 2 seconds) for ieee1588-2008

log-anno-interval 1 (1 packet every 2 seconds) for g8265dot1-2010

log-anno-interval -3 (8 packets per second) for g8275dot1-2014

log-anno-interval 1 (1 packet every 2 seconds) for g8275dot2-2016

Parameters

log-interval

Specifies the announce packet interval, in log form.

Values

-3 to 4

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-anno-interval

Syntax

log-anno-interval log-interval

no log-anno-interval

Context

[Tree] (config>system>ptp>alternate-profile log-anno-interval)

Full Context

configure system ptp alternate-profile log-anno-interval

Description

This command configures the announce message interval used for multicast messages within the alternate profile.

For multicast messages used on PTP Ethernet ports, this command configures the message interval used for announce messages transmitted by the local node

This value has no impact on the interval used for the BTCA, which is controlled by the value defined for the primary profile.

This value can only be changed when the alternate profile is shut down.

The no form of this command reverts to the default value.

Default

log-anno-interval -3 (eight packets per second)

Parameters

log-interval

Specifies the announce packet interval, in log form.

Values

-3 to 4

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-delay-interval

log-delay-interval

Syntax

log-delay-interval log-interval

no log-delay-interval

Context

[Tree] (config>system>ptp>port log-delay-interval)

Full Context

configure system ptp port log-delay-interval

Description

This command configures the minimum interval used for multicast Delay_Req messages. This parameter is applied on a per-port basis. For ports in a timeReceiver state, it shall be the interval used, unless the parent port indicates a longer interval. For a port in timeTransmitter state, it shall be the interval advertised to external timeReceiver ports as the minimum acceptable interval for Delay_Req messages from those timeReceiver ports.

It is a requirement of the 1588 standard that a port in timeReceiver state shall check the logMessageInterval field of received multicast Delay_Resp messages. If the value of the logMessageInterval field of those messages is greater than the value programmed locally for the generation of Delay_Req messages, then the timeReceiver must change to use the greater value (i.e. longer interval) for the generation of Delay_Req messages. This requirement is supported in the router.

The parameter is only applicable to ports and not to peers.

The no form of this command reverts the configuration to the default value. The default value varies depending on the configuration of the profile command.

Default

log-delay-interval -6 (64 packets per second) for ieee1588-2008

log-delay-interval -6 (64 packets per second) for g8265dot1-2010

log-delay-interval -4 (16 packets per second) for g8275dot1-2014

log-delay-interval -6 (64 packets per second) for g8275dot2-2016

Parameters

log-interval

Specifies the Delay_Req message interval, in log form.

Values

-6 to 0

Default

-6

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-events

log-events

Syntax

log-events [verbose]

no log-events

Context

[Tree] (config>sys>security>dist-cpu-protection>policy>local-monitoring-policer log-events)

Full Context

configure system security dist-cpu-protection policy local-monitoring-policer log-events

Description

This command controls the creation of log events related to local-monitoring-policer status and activity.

Default

log-events

Parameters

verbose

Sends the same events as just "log-events” plus DcpLocMonExcd, DcpLocMonExcdAllDynAlloc, and DcpLocMonExcdAllDynFreed. The optional "verbose” includes some events that are more likely used during debug/tuning/investigations

Platforms

All

log-events

Syntax

[no] log-events [verbose]

no log-events

Context

[Tree] (config>sys>security>dist-cpu-protection>policy>protocol>dyn-para log-events)

Full Context

configure system security dist-cpu-protection policy protocol dynamic-parameters log-events

Description

This command controls the creation of log events related to dynamic enforcement policer status and activity.

Default

log-events

Parameters

verbose

This parameter sends the same events as just "log-events” plus Hold Down Start, Hold Down End, DcpDynamicEnforceAlloc and DcpDynamicEnforceFreed events. This includes the allocation/de-allocation events (typically used for debug/tuning only – could be very noisy even when there is nothing much of concern).

Platforms

All

log-events

Syntax

log-events [verbose]

no log-events

Context

[Tree] (config>sys>security>dist-cpu-protection>policy>static-policer log-events)

Full Context

configure system security dist-cpu-protection policy static-policer log-events

Description

This command controls the creation of log events related to static-policer status and activity.

Default

log-events

Parameters

verbose

Sends the same events as just "log-events” plus Hold Down Start and Down End events. The optional "verbose” includes some events that are more likely used during debug/tuning/investigations.

Platforms

All

log-files-total-size

log-files-total-size

Syntax

log-files-total-size megabytes

no log-files-total-size

Context

[Tree] (config>log>storage log-files-total-size)

Full Context

configure log file-storage-control log-files-total-size

Description

This command configures the limit for the total space that all log files can occupy on each storage device on the active CPM.

When this threshold is reached, log events are no longer written to the files in the \log directory until SR OS removes older log files and the occupancy is below the limit.

When unconfigured, there is no specific limit for the total size of all log files.

Only log files in the \log directory with system generated names (including no file extension) are applicable toward the total size limit.

If a user manually adds or deletes log files from the \log directory, the size of the files is not taken into account for up to 1 hour.

The configured total size limit is not validated against the actual size of the installed storage devices. If the configured limit is larger than the installed CF device, the limit is never reached.

Default

no log-files-total-size

Parameters

megabytes

Specifies the total size limit for log files, in MB.

Values

50 to 4,194,304 MB (4 TBytes, 222 MB)

Default

0

Platforms

All

log-filter

log-filter

Syntax

log-filter filter-id

no log-filter

Context

[Tree] (config>log>event-trigger>event>trigger-entry log-filter)

Full Context

configure log event-trigger event trigger-entry log-filter

Description

This command configures the log filter to be used for this trigger entry. The log filter defines the matching criteria that must be met in order for the log event to trigger the handler execution. The log filter is applied to the log event and, if the filtering decision results in a forward action, then the handler is triggered.

It is typically unnecessary to configure match criteria for the application or number in the log filter used for EHS since the particular filter is only applied for a specific log event application and number, as configured under the config>log>event-trigger context.

The no form of this command removes the log filter configuration.

Parameters

filter-id

Specifies the identifier of the filter.

Values

1 to 1500

Platforms

All

log-id

log-id

Syntax

log-id log-id [name log-name]

no log-id log-id

Context

[Tree] (config>service>vprn>log log-id)

Full Context

configure service vprn log log-id

Description

This command creates a context to configure destinations for event streams.

The log-id context is used to direct events, alarms or traps, and debug information to respective destinations.

A maximum of 30 logs can be configured.

Before an event can be associated with this log-id, the from command identifying the source of the event must be configured.

Only one destination can be specified for a log-id. The destination of an event stream can be an in-memory buffer, console, session, snmp-trap-group, Syslog, or file.

Use the event-control command to suppress the generation of events, alarms, and traps for all log destinations.

An event filter policy can be applied in the log-id context to limit which events, alarms, and traps are sent to the specified log-id.

By default, the log events in a VPRN log are a subset of the complete set of possible log events in SR OS. See the config>log>services-all-events command for more details.

The no form of this command deletes the log destination ID from the configuration.

Default

No log destinations are defined.

Parameters

log-id

Specifies the log ID number, expressed as a decimal integer.

Values

1 to 100

name log-name

Configures an optional log name, up to 64 characters, that can be used to refer to the log destination after it is created.

Platforms

All

log-id

Syntax

log-id log-id [name li-log-name]

no log-id log-id

Context

[Tree] (config>li>log log-id)

Full Context

configure li log log-id

Description

This command configures an LI event log destination. The log-id is used to direct events, alarms or traps, and debug information for specific destinations.

Parameters

log-id

Specifies the log ID, expressed as a decimal number.

Values

1 to 100

name li-log-name

Configures an optional log name, up to 64 characters, that can be used to refer to the log destination after it is created.

Platforms

All

log-id

Syntax

log-id log-id [name log-name]

no log-id log-id

Context

[Tree] (config>log log-id)

Full Context

configure log log-id

Description

This command creates a context to configure destinations for event streams.

The log-id context is used to direct events, alarms or traps, and debug information for specific destinations.

A maximum of 30 logs can be configured.

Before an event can be associated with this log ID, the from command identifying the source of the event must be configured.

Only one destination can be specified for a log-id. The destination of an event stream can be an in-memory buffer, console, session, snmp-trap-group, syslog, or file.

Use the event-control command to suppress the generation of events, alarms, and traps for all log destinations.

An event filter policy can be applied in the log-id context to limit which events, alarms, and traps are sent to the specified log-id.

Log-IDs 99 and 100 are created by the agent. Log-ID 99 captures all log messages. Log-ID 100 captures log messages with a severity level of major and above.

Note:

Log-ID 99 provides valuable information for the admin-tech file. Removing or changing the log configuration may hinder debugging capabilities. It is strongly recommended not to alter the configuration for Log-ID 99.

The no form of this command deletes the log destination ID from the configuration.

Parameters

log-id

Specifies the log ID, expressed as a decimal integer.

Values

1 to 101

name log-name

Configures an optional log name, up to 64 characters, that can be used to refer to the log destination after it is created.

Platforms

All

log-prefix

log-prefix

Syntax

log-prefix log-prefix-string

no log-prefix

Context

[Tree] (config>service>vprn>log>syslog log-prefix)

Full Context

configure service vprn log syslog log-prefix

Description

This command adds the string prepended to every syslog message sent to the syslog host.

RFC 3164, The BSD syslog Protocol, allows an alphanumeric string (tag) to be prepended to the content of every log message sent to the syslog host. This alphanumeric string can, for example, be used to identify the node that generates the log entry. The software appends a colon (:) and a space to the string and it is inserted in the syslog message after the date stamp and before the syslog message content.

Only one string can be entered. If multiple strings are entered, the last string overwrites the previous string. The alphanumeric string can contain lowercase (a-z), uppercase (A-Z) and numeric (0-9) characters.

The no form of this command removes the log prefix string.

Default

log-prefix "TMNX".

Parameters

log-prefix-string

Specifies the alphanumeric string of up to 32 characters. Spaces and colons ( : ) cannot be used in the string.

Platforms

All

log-prefix

Syntax

log-prefix prefix-text

Context

[Tree] (config>service>nat>syslog>syslog-export-policy log-prefix)

Full Context

configure service nat syslog syslog-export-policy log-prefix

Description

This command configures the syslog log prefix. For more information, refer to the 7450 ESS, 7750 SR, 7950 XRS, and VSR System Management Guide. The config>log>syslog>level hierarchy also applies to this context.

Default

log-prefix "TMNX”

Parameters

prefix-text

Specifies an alphanumeric string, up to 32 characters. Spaces and colons ( : ) cannot be used in the string.

Platforms

7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR

log-prefix

Syntax

log-prefix log-prefix-string

no log-prefix

Context

[Tree] (config>log>syslog log-prefix)

Full Context

configure log syslog log-prefix

Description

This command adds the string prepended to every syslog message sent to the syslog host.

RFC 3164, allows an alphanumeric string (tag) to be prepended to the content of every log message sent to the syslog host. This alphanumeric string can, for example, be used to identify the node that generates the log entry. The software appends a colon (:) and a space to the string and it is inserted in the syslog message after the date stamp and before the syslog message content.

Only one string can be entered. If multiple strings are entered, the last string overwrites the previous string. The alphanumeric string can contain lowercase (a-z), uppercase (A-Z) and numeric (0 to 9) characters.

The no form of this command removes the log prefix string.

Default

no log-prefix

Parameters

log-prefix-string

Specifies an alphanumeric string up to 32 characters in length. Spaces and colons ( : ) cannot be used in the string.

Platforms

All

log-sync-interval

log-sync-interval

Syntax

log-sync-interval log-interval

no log-sync-interval

Context

[Tree] (config>service>vprn>ptp>peer log-sync-interval)

Full Context

configure service vprn ptp peer log-sync-interval

Description

This command configures the message interval used for unicast event messages. It defines the message interval for both Sync and Delay_Resp messages that are requested during unicast negotiation to the specific peer. This controls the Sync and Delay_Resp message rate sent from remote peers to the local node. It does not affect the Sync or Delay_Resp packet rate that may be sent from the local node to remote peers. Remote peers may request a Sync or Delay_Resp packet rate anywhere within the acceptable grant range.

The log-sync-interval cannot be changed unless the peer is shutdown.

This command only applies to the 7450 ESS and 7750 SR.

The no form of this command reverts the value to the profile default.

Default

log-sync-interval -6 (64 packets per second) for ieee1588-2008

log-sync-interval -6 (64 packets per second) for g8265dot1-2010

log-sync-interval -4 (16 packets per second) for g8275dot1-2014

log-sync-interval -6 (64 packets per second) for g8275dot2-2016

Parameters

log-interval

Specifies the sync message interval, in log form.

Values

-6 to 0

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-sync-interval

Syntax

log-sync-interval log-interval

no log-sync-interval

Context

[Tree] (config>system>ptp>peer log-sync-interval)

Full Context

configure system ptp peer log-sync-interval

Description

This command configures the message interval used for unicast event messages. It defines the message interval for both Sync and Delay_Resp messages that are requested during unicast negotiation to the specific peer. This controls the Sync and Delay_Resp message rate sent from remote peers to the local node. It does not affect the Sync or Delay_Resp packet rate that may be sent from the local node to remote peers. Remote peers may request a Sync or Delay_Resp packet rate anywhere within the acceptable grant range.

The log-sync-interval cannot be changed unless the peer is shutdown.

The no form of this command reverts the value to the profile default.

Default

log-sync-interval -6 (64 packets per second) for ieee1588-2008

log-sync-interval -6 (64 packets per second) for g8265dot1-2010

log-sync-interval -4 (16 packets per second) for g8275dot1-2014

log-sync-interval -6 (64 packets per second) for g8275dot2-2016

Parameters

log-interval

Specifies the sync message interval, in log form.

Values

-6 to 0

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

log-sync-interval

Syntax

log-sync-interval log-interval

no log-sync-interval

Context

[Tree] (config>system>ptp>port log-sync-interval)

Full Context

configure system ptp port log-sync-interval

Description

This command configures the message interval used for transmission of multicast Sync messages.

For multicast messages used on PTP Ethernet ports, this configures the message interval used for Sync messages transmitted by the local node when the port is in Master state.

The no form of this command reverts the value to the profile default.

Default

log-sync-interval -6 (64 packets per second) for ieee1588-2008

log-sync-interval -6 (64 packets per second) for g8265dot1-2010

log-sync-interval -4 (16 packets per second) for g8275dot1-2014

log-sync-interval -6 (64 packets per second) for g8275dot2-2016

Parameters

log-interval

Specifies the message interval, in log form.

Values

-6 to 0 (This corresponds to a maximum rate of 64 packets per second, and a minimum rate of 1 packet per second.)

Default

-6

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS