p Commands – Part III
pool-manager
pool-manager
Syntax
pool-manager
Context
[Tree] (config>service>vprn>sub-if>wlan-gw pool-manager)
[Tree] (config>service>ies>sub-if>wlan-gw pool-manager)
Full Context
configure service vprn subscriber-interface wlan-gw pool-manager
configure service ies subscriber-interface wlan-gw pool-manager
Description
Commands in this context configure pool manager data for a WLAN GW subscriber interface.
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
pool-name
pool-name
Syntax
[no] pool-name
Context
[Tree] (config>service>ies>if>dhcp>option>vendor pool-name)
[Tree] (config>service>vprn>sub-if>grp-if>dhcp>option>vendor pool-name)
[Tree] (config>service>ies>sub-if>grp-if>dhcp>option>vendor pool-name)
[Tree] (config>service>vprn>if>dhcp>option>vendor pool-name)
Full Context
configure service ies interface dhcp option vendor-specific-option pool-name
configure service vprn subscriber-interface group-interface dhcp option vendor-specific-option pool-name
configure service ies subscriber-interface group-interface dhcp option vendor-specific-option pool-name
configure service vprn interface dhcp option vendor-specific-option pool-name
Description
This command sends the pool name in the Nokia vendor specific sub-option of the DHCP relay packet.
The no form of this command reverts to the default.
Platforms
All
- configure service ies interface dhcp option vendor-specific-option pool-name
- configure service vprn interface dhcp option vendor-specific-option pool-name
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
- configure service ies subscriber-interface group-interface dhcp option vendor-specific-option pool-name
- configure service vprn subscriber-interface group-interface dhcp option vendor-specific-option pool-name
pool-name
Syntax
pool-name name
no pool-name
Context
[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>dhcpv4-nat pool-name)
[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>slaac pool-name)
[Tree] (config>service>ies>sub-if>wlan-gw>pool-manager>dhcp6-client>ia-na pool-name)
[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>dhcpv4-nat pool-name)
[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>slaac pool-name)
[Tree] (config>service>vprn>sub-if>wlan-gw>pool-manager>dhcp6-client>ia-na pool-name)
Full Context
configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client dhcpv4-nat pool-name
configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client slaac pool-name
configure service ies subscriber-interface wlan-gw pool-manager dhcpv6-client ia-na pool-name
configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client dhcpv4-nat pool-name
configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client slaac pool-name
configure service vprn subscriber-interface wlan-gw pool-manager dhcpv6-client ia-na pool-name
Description
This command specifies the pool name that should be sent in the DHCPv6 messages. This is reflected in the Nokia vendor specific pool option (vendor-id 6527, option-id 0x02).
The no form of this command removes pool-name and the option will not be sent in DHCPv6.
Parameters
- name
-
Specifies the pool name up with 32 characters.
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
pool-name
Syntax
[no] pool-name
Context
[Tree] (config>router>if>dhcp>option>vendor-specific-option pool-name)
Full Context
configure router interface dhcp option vendor-specific-option pool-name
Description
This command enables the sending of the pool name in the Nokia vendor-specific suboption of the DHCP relay packet.
The no form of this command disables the feature.
Default
no pool-name
Platforms
All
pool-type
pool-type
Syntax
pool-type pool-type
Context
[Tree] (config>test-oam>twamp>twl>src-udp-pools>port pool-type)
Full Context
configure test-oam twamp twamp-light source-udp-port-pools port pool-type
Description
This command maps the specified source UDP port to the TWAMP Light application allowed to configure the source UDP port. The OAM-PM IP family of tests can only configure the source UDP port when the port pool UDP source port is configured with a pool-type oam-pm. The test-oam link-measurement measurement-template can only configure the src-udp-port when the port pool UDP source port is configured with pool-type link-measurement.A pool type cannot be changed if its current application (either an oam-pm session or link-measurement template) is configured to use the specified port, regardless of the administrative or operational state. The configuration reference linking to the source UDP prevents the change.
Default
pool-type oam-pm
Parameters
- pool-type
-
Specifies the port to an application pool.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
pop
pop
Syntax
[no] pop
Context
[Tree] (config>router>mpls>if>label-map pop)
Full Context
configure router mpls interface label-map pop
Description
This command specifies that the incoming label must be popped (removed). No label stacking is supported for a static LSP. The service header follows the top label. Once the label is popped, the packet is forwarded based on the service header.
The no form of this command removes the pop action for the in-label.
Platforms
All
populate
populate
Syntax
populate {static | dynamic | evpn} [ route-tag [1..255]]
no populate {static | dynamic | evpn}
Context
[Tree] (config>service>vprn>if>ipv6>nd-host-route populate)
[Tree] (config>service>vprn>if>arp-host-route populate)
[Tree] (config>service>ies>if>arp-host-route populate)
Full Context
configure service vprn interface ipv6 nd-host-route populate
configure service vprn interface arp-host-route populate
configure service ies interface arp-host-route populate
Description
This command enables the creation of ARP/ND host-route entries in the route-table out of a certain ARP/ND entry type.
The no form of this command reverts to the default.
Default
no populate
Parameters
- evpn
-
Enables the creation of ARP-ND host routes in the route table out of EVPN ARP/ND entries (entries learned from EVPN MAC/IP routes).
- dynamic
-
Enables the creation of ARP-ND host routes in the route table out of dynamic ARP/ND entries (learned from received ARP/ND messages from the hosts).
- static
-
Enables the creation of ARP-ND host routes in the route table out of configured static ARP/ND entries.
- route-tag [1..255]
-
Specifies the route tag that is added in the route table for ARP-ND host routes of type evpn, dynamic, or static. This tag can be matched on BGP VRF export and BGP peer export policies.
Platforms
All
port
port
Syntax
port port-id [sync-tag sync-tag] [create]
no port port-id]
Context
[Tree] (config>redundancy>multi-chassis>peer>sync port)
Full Context
configure redundancy multi-chassis peer sync port
Description
This command specifies the port to be synchronized with the multi-chassis peer and a synchronization tag to be used while synchronizing this port with the multi-chassis peer.
Parameters
- port-id
-
Specifies the port to be synchronized with the multi-chassis peer.
- sync-tag
-
Specifies a synchronization tag, up to 32 characters in length, to be used while synchronizing this port with the multi-chassis peer.
- create
-
Creates an entry; mandatory while creating an entry.
Platforms
All
port
Syntax
[no] port {port-id | aps-id | connector-port-id}
Context
[Tree] (config port)
Full Context
configure port
Description
This command enables access to the context to configure ports, multilink bundles, and bundle protection groups (BPGs). Before a port can be configured, the chassis slot must be provisioned with a valid card type and the MDA parameter must be provisioned with a valid MDA type.
Default
No ports are configured. All ports must be explicitly configured and enabled.
Parameters
- port-id
-
Specifies the physical port ID in the following format:
- eth-sat-id
-
Specifies the Ethernet satellite ID to be associated with this IP interface. This parameter applies to the 7950 XRS only.
- pxc-id
-
Specifies the PXC ID to be associated with this IP interface. This parameter applies to the 7950 XRS only.
- aps-id
-
This option configures APS on unbundled SONET/SDH ports. All SONET-SDH port parameters, with certain exceptions, for the working and protection circuit ports must be configured in the config>port>aps-id context. The working and protection circuit ports inherit all those parameters configured. The exception parameters for the working and protect circuits can be configured in the config>port>sonet-sdh context. Exception list commands include:
-
clock-source
-
[no] loopback
-
[no] report-alarm
-
section-trace
-
[no] threshold
When an configure port aps-id is created all applicable parameters under the port CLI tree (including parameters under any submenus) assume aps-id defaults, or when those are not explicitly specified, default to SONET/SDH port defaults for any SONET port.
All but a few exception SONET/SDH parameters for the working channel port must be configured in the configure port sonet-sdh context. The protection channel inherits all the configured parameters. The exception parameters for the protection channel can be configured in the configure port sonet-sdh context.
Signal failure (SF) and signal degrade (SD) alarms are not enabled by default on POS interfaces. It is recommended to change the default alarm notification configuration for POS ports that belong to APS groups in order to be notified of SF/SD occurrences to be able to interpret the cause for an APS group to switch the active line.
For path alarms, modify the logical line aps-id in the configure port aps-id <sonet-sdh>path report-alarm context. For example:
configure port aps-1 sonet-sdh path report-alarm p-ais
For line alarms, separately, modify the 2 physical ports that are members of the logical aps-id port (the working and protect lines). APS reacts only to line alarms, not path alarms. For example:
configure port 1/2/3 sonet-sdh report-alarm lb2er-sd
configure port 4/5/6 sonet-sdh report-alarm lb2er-sd
If the SD and SF threshold rates must be modified, the changes must be performed at the line level on both the working and protect APS port member.
The no form of this command deletes an aps-group-id or bundle-aps-group-id. In order for an aps- group-id to be deleted,
The same rules apply for physical ports, bundles deletions apply to APS ports/bundles deletions (for example an aps-group-id must be shutdown, have no service configuration on it, and no path configuration on it). In addition working and protection circuits must be removed before an aps-group-id may be removed.
-
- connector-port-id
-
Specifies the physical port of a connector in the following format.
Platforms
All
port
Syntax
port port-id
no port
Context
[Tree] (config>port-xc>pxc port)
Full Context
configure port-xc pxc port
Description
This command configures the referenced Ethernet port as a loopback or a cross-connect port (PXC). When this command is executed, the system automatically creates two PXC subports under this Ethernet port.
The physical PXC port does not require any external connectivity or optical transceivers to function properly. Consequently, all optic-related alarms are disabled on the port.
The physical PXC port is automatically configured as a hybrid port. The MTU is preset to 9212 bytes, the encapsulation type is set to dot1q, and dot1x tunneling is turned on.
A single physical port can be associated with more than one PXC. In other words, multiple PXCs are supported per physical port. Because PXC subports use a single physical port to transmit traffic in both directions, the nominal port bandwidth is asymmetrically divided between the two directions. For example, a 10 Gb/s Ethernet port in PXC mode can accommodate 9 Gb/s of traffic in one direction and 1 Gb/s in the other. Any other ratio can be achieved as long as the sum of the bandwidth of the two PXC subports does not exceed the bandwidth capacity of the physical port (10 Gb/s in this case).
Since the PXC uses a single physical port to transmit traffic in both directions, the nominal port bandwidth is asymmetrically divided between the two directions. For example, a 10 Gb/s Ethernet port in PXC mode can accommodate 9 Gb/s of traffic in one direction and 1 Gb/s in the other. Any other ratio can be achieved as long as the sum of the bandwidth of the two PXC subports does not exceed the bandwidth capacity of the physical port (10 Gb/s in this case).
The following rules apply to PXC port configurations:
-
Only unused physical ports (not associated with an interface or SAP) can be referenced inside of a PXC ID configuration.
-
The physical port cannot be removed from a PXC ID configuration if the corresponding PXC subports are currently in use.
-
A physical port cannot be used outside the configured PXC context. For example, a regular IP interface cannot use this physical port, or a SAP on that port cannot be associated with a service.
The no form of this command removes the port ID from the configuration.
Parameters
- port-id
-
Specifies the physical port in the slot/mda/port format.
Platforms
All
port
Syntax
port port-id [port-id] [priority priority] [sub-group sub-group-id] [hash-weight weight]
no port port-id [port-id]
Context
[Tree] (config>lag port)
Full Context
configure lag port
Description
This command adds ports to a Link Aggregation Group (LAG).
The port configuration of the first port added to the LAG is used as a basis to compare to subsequently added ports. If a discrepancy is found with a newly added port, that port will not be added to the LAG.
Multiple (space separated) ports can be added or removed from the LAG link assuming the maximum of number of ports is not exceeded.
Ports that are part of a LAG must be configured with auto-negotiate limited or disabled.
The no form of this command removes ports from the LAG.
Default
No ports are defined as members of a LAG.
Parameters
- port-id
-
Specifies the port ID.
The maximum number of ports in a LAG depends on the platform type, the hardware deployment, and the SR OS software release. Adding a port over the maximum allowed per given router or switch is blocked. Some platforms support double port scale for specific port types on LAGs with LAG ID in the range of 1 to 64 inclusive. Up to 16 ports can be specified in a single statement, up to 64 ports total.
- priority
-
Specifies the port priority used by LACP. The port priority is also used to determine the primary port. The port with the lowest priority is the primary port. In the event of a tie, the smallest port ID becomes the primary port.
- sub-group-id
-
Identifies a LAG subgroup. When using subgroups in a LAG, they should only be configured on one side of the LAG, not both. Only having one side perform the active/standby selection guarantees a consistent selection and fast convergence. The active or standby selection is signaled through LACP to the other side. The hold time should be configured when using subgroups to prevent the LAG going down when switching between active and standby subgroup since momentarily all ports are down in a LAG (break-before-make).
- weight
-
Specifies the flow hashing distribution between LAG ports.
Platforms
All
port
Syntax
port port-id
no port
Context
[Tree] (config>service>system>bgp-evpn>eth-seg port)
Full Context
configure service system bgp-evpn ethernet-segment port
Description
This command configures a port-id associated with the Ethernet-Segment. If the Ethernet-Segment is configured as all-active, then only a lag or a PW port can be associated to the Ethernet-Segment. If the Ethernet-Segment is configured as single-active, then a lag, port or sdp can be associated to the Ethernet-Segment. In any case, only one of the four objects can be configured in the Ethernet-Segment. A specified port can be part of only one Ethernet-Segment. Only Ethernet ports can be added to an Ethernet-Segment.
Default
no port
Parameters
- port-id
-
Specifies the port ID associated to the Ethernet-Segment.
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
Platforms
All
port
Syntax
port [port-id | lag-id]
no port
Context
[Tree] (config>service>sdp>binding port)
Full Context
configure service sdp binding port
Description
This command specifies the port or lag identifier, to which the pseudowire ports associated with the underlying SDP are bound. If the underlying SDP is re-routed to a port or lag other than the specified one, the pseudowire ports on the SDP are operationally brought down.
The no form of the command removes the value from the configuration.
Default
no port
Parameters
- port-id
-
Specifies the identifier of the port in the slot/mda/port format.
port-id
slot/mda/port[.channel]
pxc-id
psc-id.sub-port
pxc psc-id.sub-port
pxc: keyword
id: 1 to 64
sub-port: a, b
aps-id
aps-group-id[.channel]
aps keyword
group-id
1 to 64
group-id
1 to 16
ccag-id - ccag-<id>.<path-id>[cc-type]
ccag
keyword
id
1 to 8
path-id
a, b
cc-type[.sap-net | .net-sap]
lag-id
lag-id
lag
keyword
id
1 to 800
- lag-id
-
Specifies the LAG identifier.
Platforms
All
port
Syntax
port [evpn-mpls | sap sap-id | sdp sdp-id:vc-id | vxlan vtep ip-address vni vni-id] [detail]
no port
Context
[Tree] (debug>service>id>pim-snooping port)
Full Context
debug service id pim-snooping port
Description
This command enables or disables debugging for PIM ports.
Parameters
- sap-id
-
Only debugs packets associated with the specified SAP
- sdp-id:vc-id
-
Only debugs packets associated with the specified SDP
- detail
-
Provides detailed debugging information
- evpn-mpls
-
Debugs PIM snooping statistics for EVPN-MPLS destinations
Platforms
All
port
Syntax
[no] port port-id
Context
[Tree] (config>service>system>pw-port-list port)
Full Context
configure service system pw-port-list port
Description
This command is only applicable for VSR configurations. This command is used to select ports eligible for use with Flex PW port. Physical ports used by Flex PW port can be shared with any other Layer 2 or Layer 3 service. In other words, a Layer 3 interface using a regular SAP can be associated with a VPRN service, while the port is used by a Flex PW port. Another regular SAP from the same port can be associated with a VPLS or Epipe service at the same time.
The following rules should be followed when populating a pw-port-list:
-
A port must be in hybrid mode before it is added to a pw-port-list.
-
Before a port is removed from or added to a pw-port-list, all PW ports must be dissociated from the corresponding Epipe services (PW ports must be unconfigured). This implies that all PW SAPs must be deleted.
-
Network interfaces (configured in the Base routing context) can be configured only on ports that are in the pw-port-list.
-
A port mode (access, network, or hybrid) cannot be changed while the port is in the pw-port-list.
From this, the operator can consider adding all ports that are in hybrid mode to a pw-port-list at the beginning of the system configuration. This ensures that those ports can be used by a Flex PW port at any later time, independently of their current use.
The no form of this command removes the port ID from the configuration.
Parameters
- port-id
-
Specifies the IP of the port.
Platforms
VSR
port
Syntax
port port
no port
Context
[Tree] (config>service>vprn>aaa>rmt-srv>radius port)
Full Context
configure service vprn aaa remote-servers radius port
Description
This command configures the UDP port number to contact the RADIUS server.
The no form of this command reverts to the default value.
Default
port 1812 (as specified in RFC 2865, Remote Authentication Dial In User Service (RADIUS))
Parameters
- port
-
Specifies the UDP port number to contact the RADIUS server.
Platforms
All
port
Syntax
port value
no port
Context
[Tree] (config>service>vprn>log>syslog port)
Full Context
configure service vprn log syslog port
Description
This command configures the UDP port that will be used to send syslog messages to the syslog target host.
The port configuration is needed if the syslog target host uses a port other than the standard UDP syslog port 514.
Only one port can be configured. If multiple port commands are entered, the last entered port overwrites the previously entered ports.
The no form of this command reverts to default value.
Default
no port
Parameters
- value
-
The value is the configured UDP port number used when sending syslog messages.
Platforms
All
port
Syntax
port port
Context
[Tree] (config>app-assure>group>event-log>syslog port)
Full Context
configure application-assurance group event-log syslog port
Description
This command specifies the UDP port used by application assurance to inject the syslog events inband.
Default
port 514
Parameters
- port
-
Specifies the UDP port number.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port
Syntax
[no] port port-number
[no] port range start-port-num end-port-num
Context
[Tree] (config>app-assure>group>port-list port)
Full Context
configure application-assurance group port-list port
Description
This command specifies the server TCP or UDP port number to use in the port list definition.
The no form of this command restores the default by removing port number from the port list.
Default
no port
Parameters
- port-number
-
Specifies the port number.
- start-port-number
-
Specifies the start port number.
- end-port-number
-
Specifies the end port number.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port
Syntax
port {port-id | lag lag-id} [egress] [ingress]
no port {port-id | lag lag-id} {[egress] [ ingress]}
Context
[Tree] (config>mirror>mirror-source port)
Full Context
configure mirror mirror-source port
Description
This command enables mirroring of traffic ingressing or egressing a port (Ethernet port, SONET/SDH channel, TDM channel, or Link Aggregation Group (LAG)).
The port command associates a port or LAG to a mirror source. The port is identified by the port-id. The defined port may be Ethernet, Access or network, SONET/SDH, or TDM channel access. A network port may be a single port or a Link Aggregation Group (LAG) ID. When a LAG ID is given as the port-id, mirroring is enabled on all ports making up the LAG. If the port is a SONET/SDH interface, the channel-id must be specified to identify which channel is being mirrored (applies to the 7450 ESS and 7750 SR). Either a LAG port member or the LAG port can be mirrored.
The port is only referenced in the mirror source for mirroring purposes. The mirror source association does not need to be removed before deleting the card to which the port belongs. If the port is removed from the system, the mirroring association will be removed from the mirror source.
The same port may not be associated with multiple mirror source definitions with the ingress parameter defined. The same port may not be associated with multiple mirror source definitions with the egress parameter defined.
If a SAP is mirrored on an access port, the SAP mirroring will have precedence over the access port mirroring when a packet matches the SAP mirroring criteria. Filter and label mirroring destinations will also precedence over a port-mirroring destination.
If the port is not associated with a mirror-source, packets on that port will not be mirrored. Mirroring may still be defined for a SAP, label or filter entry, which will mirror based on a more specific criteria.
The encapsulation type on an access port or channel cannot be changed to Frame Relay if it is being mirrored (applies to the 7750 SR and 7450 ESS).
The no port command disables port mirroring for the specified port. Mirroring of packets on the port may continue due to more specific mirror criteria. If the egress or ingress parameter keywords are specified in the no command, only the ingress or egress mirroring condition will be removed.
Parameters
- port-id
-
Specifies the port ID of the 7750 SR or 7950 XRS.
The following syntax applies to the 7750 SR:
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
bgrp-id
bpgrp-type-bpgrp-num
bgrp
keyword
type
ima, ppp
bgrp-num
1 to 2000
ccag-id
ccag-id.path-id cc-type:cc-id
ccag
keyword
id
1 to 8
path-id
a, b
cc-type
sap-net, .net-sap
cc-id
0 to 4094
The following syntax applies to the 7950 XRS:
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
- lag-id
-
The LAG identifier, expressed as a decimal integer.
Note:On the 7950 XRS, the XMA ID takes the place of the MDA.
- egress
-
Specifies that packets egressing the port should be mirrored. Egress packets are mirrored to the mirror destination after egress packet modification.
- ingress
-
Specifies that packets ingressing the port should be mirrored. Ingress packets are mirrored to the mirror destination prior to ingress packet modification.
Platforms
All
port
Syntax
port {port-id | lag lag-id} {[egress] [ingress]}
no port {port-id | lag lag-id} [egress] [ingress]
Context
[Tree] (config>li>li-source port)
Full Context
configure li li-source port
Description
This command specifies the port to perform lawful intercept. It is recommended when configuring li-source>port criteria, the li-source should only contain ports. All other criteria such as SAPs and subscribers should use a different li-source.
The no form of this command reverts to the default.
Parameters
- port-id
-
Specifies the port ID to perform lawful intercept.
port-id
slot/mda/port [.channel]
aps-id
aps-<group-id>[.channel]
aps
keyword
group-id
1 to 128
eth-sat-id
esat-<id>/<slot>/[u]<port>
esat
keyword
id
1 to 20
u
keyword for up-link port
tdm-sat-id
tsat-<id>/<slot>/[<u>]<port>.<channel>
tsat
keyword
id
1 to 20
u
keyword for up-link port
pxc-id
pxc-<id>.<sub-port>
pxc
keyword
id
1 to 64
sub-port
a, b
- lag-id
-
The LAG identifier, expressed as a decimal integer.
Note:On the 7950 XRS, the XMA ID takes the place of the MDA.
- egress
-
Performs lawful intercept on egress traffic.
- ingress
-
Performs lawful intercept on ingress traffic.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port tcp-port
no port
Context
[Tree] (config>li>x-interfaces>lics>lic port)
Full Context
configure li x-interfaces lics lic port
Description
This command configures the TCP port associated with this LIC.
The no form of this command reverts to the default.
Parameters
- tcp-port
-
Specifies the TCP source port of the LIC.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port tcp-port
no port
Context
[Tree] (config>li>x-interfaces>x1 port)
Full Context
configure li x-interfaces x1 port
Description
This command configures the TCP port for the X1 interface. The system listens to this port and uses it as the source TCP port.
The no form of this command reverts to the default.
Parameters
- tcp-port
-
Specifies the TCP port.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port {port-id | lag lag-id} {[egress] [ingress]}
no port {port-id | lag lag-id} [egress] [ ingress]
Context
[Tree] (debug>mirror-source port)
Full Context
debug mirror-source port
Description
This command enables mirroring of traffic ingressing or egressing a port (Ethernet port, SONET/SDH channel, TDM channel, or Link Aggregation Group (LAG)).
The port command associates a port or LAG to a mirror source. The port is identified by the port-id. The defined port may be Ethernet, Access or network, SONET/SDH, or TDM channel access. A network port may be a single port or a Link Aggregation Group (LAG) ID. When a LAG ID is given as the port-id, mirroring is enabled on all ports making up the LAG. If the port is a SONET/SDH interface, the channel-id must be specified to identify which channel is being mirrored (applies to the 7450 ESS and 7750 SR). Either a LAG port member or the LAG port can be mirrored.
The port is only referenced in the mirror source for mirroring purposes. The mirror source association does not need to be removed before deleting the card to which the port belongs. If the port is removed from the system, the mirroring association will be removed from the mirror source.
The same port may not be associated with multiple mirror source definitions with the ingress parameter defined. The same port may not be associated with multiple mirror source definitions with the egress parameter defined.
If a SAP is mirrored on an access port, the SAP mirroring will have precedence over the access port mirroring when a packet matches the SAP mirroring criteria. Filter and label mirroring destinations will also precedence over a port-mirroring destination.
If the port is not associated with a mirror-source, packets on that port will not be mirrored. Mirroring may still be defined for a SAP, label or filter entry, which will mirror based on a more specific criteria.
The encapsulation type on an access port or channel cannot be changed to Frame Relay if it is being mirrored (applies to the 7750 SR and 7450 ESS).
The no port command disables port mirroring for the specified port. Mirroring of packets on the port may continue due to more specific mirror criteria. If the egress or ingress parameter keywords are specified in the no command, only the ingress or egress mirroring condition will be removed.
Parameters
- port-id
-
Specifies the port ID of the 7750 SR or 7950 XRS.
The following syntax applies to the 7750 SR:
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
ccag-id
ccag-id.path-id cc-type:cc-id
ccag
keyword
id
1 to 8
path-id
a,b
cc-type
sap-net, net-sap
cc-id
0 to 4094
The following syntax applies to the 7950 XRS:
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
- lag-id
-
Specifies the LAG identifier, expressed as a decimal integer.
Note:On the 7950 XRS, the XMA ID takes the place of the MDA.
- egress
-
Specifies that packets egressing the port should be mirrored. Egress packets are mirrored to the mirror destination after egress packet modification.
- ingress
-
Specifies that packets ingressing the port should be mirrored. Ingress packets are mirrored to the mirror destination prior to ingress packet modification.
Platforms
All
port
Syntax
port {lt | gt | eq} port-number
port port-list port-list-name
port range port-number port-number
no port
Context
[Tree] (config>filter>ipv6-exception>entry>match port)
[Tree] (config>filter>ip-filter>entry>match port)
[Tree] (config>filter>ipv6-filter>entry>match port)
Full Context
configure filter ipv6-exception entry match port
configure filter ip-filter entry match port
configure filter ipv6-filter entry match port
Description
This command configures a TCP/UDP/SCTP source or destination port match criterion in IPv4 and IPv6 CPM (SCTP not supported) and/or ACL filter policies. A packet matches this criterion if the packet TCP/UDP/SCTP (as configured by protocol/next-header match) source OR destination port matches either the specified port value or a port in the specified port range or port-list.
Operational Note: This command is mutually exclusive with src-port and dst-port commands. Configuring "port eq 0", may match non-initial fragments where the source/destination port values are not present in a packet fragment if other match criteria are also met.
The no form of this command deletes the specified port match criterion.
Default
no port
Parameters
- lt | gt | eq
-
Specifies the operator to use relative to port-number for specifying the port number match criteria.
- lt
-
Specifies that all port numbers less than port-number match.
- gt
-
Specifies that all port numbers greater than port-number match.
- eq
-
Specifies that the port-number must be an exact match.
- port-number
-
Specifies a source or destination port to be used as a match criterion. The port number can be expressed as a decimal integer, as well as in hexadecimal or binary format. The following value shows a decimal integer only.
- port-list port-list-name
-
Specifies an inclusive range of source or destination port values to be used as match criteria.
- range port-number port-number
-
Specifies an inclusive range of source or destination port values to be used as match criteria.
Platforms
VSR
- configure filter ipv6-exception entry match port
All
- configure filter ip-filter entry match port
- configure filter ipv6-filter entry match port
port
Syntax
[no] port port-number
[no] port range start end
Context
[Tree] (config>filter>match-list>port-list port)
Full Context
configure filter match-list port-list port
Description
This command adds a port or a range of ports to an existing port match list. The no form of this command deletes the specified port or range of ports form the list.
Parameters
- port-number
-
Specifies the port number to add to the list. The port number can be expressed as a decimal integer, as well as in hexadecimal or binary format. Below shows decimal integer only.
- start end
-
Specifies an inclusive port range between two port numbers values. The start of the range and end of the range can be expressed as decimal integers, as well as in hexadecimal or binary format. The following value shows decimal integer only.
Platforms
All
port
Syntax
port port-id
no port
Context
[Tree] (config>router>origin-validation>rpki-session port)
Full Context
configure router origin-validation rpki-session port
Description
This command configures the destination port number to use when contacting the cache server. The default port number is 323. The port cannot be changed without first shutting down the session.
Default
no port
Parameters
- port-id
-
Specifies a port ID.
Platforms
All
port
Syntax
port port-name
no port
Context
[Tree] (config>router>if port)
Full Context
configure router interface port
Description
This command creates an association with a logical IP interface and a physical port.
An interface can also be associated with the system (loopback address).
The command returns an error if the interface is already associated with another port or the system. In this case, the association must be deleted before the command is re-attempted. The port-id or port-id for Ethernet ports can be in one of the following forms:
Ethernet interfaces
If the card in the slot has MDAs/XMAs, port-id is in the slot_number/MDA or XMA _number/port_number format; for example, 1/1/3 specifies port 3 of the MDA/XMA installed in MDA/XMA slot 1 on the card installed in chassis slot 1.
SONET/SDH interfaces
When the port-id represents a POS interface, the port-id must include the channel-id. The POS interface must be configured as a network port.
The no form of this command deletes the association with the port. The no form of this command can only be performed when the interface is administratively down.
Default
no port
Parameters
- port-name
-
The physical port identifier to associate with the IP interface.
Platforms
All
port
Syntax
port port-id to port-id [create]
no port port-id
Context
[Tree] (config>system>port-topology port)
Full Context
configure system port-topology port
Description
This command is used for satellites. It identifies to the SR OS that there is an internal connection between two ports.
Permitted pairings of the two ports are:
First port |
Second port |
Router port |
Satellite uplink port |
Satellite uplink port |
Router port |
For satellites, this command configures the binding between a host port ID and the satellite uplink from the satellite chassis. The port topology can be configured with the host connected to a satellite uplink or the satellite uplink port connected to the specified host port. Both configurations are supported, as shown in the following examples:
*A:Dut-A# configure system port-topology port esat-1/1/u4 to 1/2/2 create
*A:Dut-A# configure system port-topology no port esat-1/1/u4
*A:Dut-A# configure system port-topology port 1/2/2 to esat-1/1/u4 create
*A:Dut-A# configure system port-topology no port 1/2/2
The no form of the command removes the internal connection.
Default
no port port-id
Parameters
- port-id
-
Specifies one port of an internal port connection. These ports can be router ports or Ethernet satellite uplink ports. Acceptable pairings are defined in the command description.
- create
-
Specifies the keyword required to create the binding between the two ports.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port port-id
Context
[Tree] (config>system>satellite>port-template port)
Full Context
configure system satellite port-template port
Description
This command specifies the satellite port to be reconfigured.
The no form of this command deletes the specified port configuration.
Parameters
- port-id
-
Specifies the satellite physical port ID. This must use the format slot/mda/port. Currently, all satellites have a single slot and a single MDA, so these values will always be 1. For example, port 10 would be specified as 1/1/10.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port port-id [create]
no port port-id
Context
[Tree] (config>system>ptp port)
Full Context
configure system ptp port
Description
This command configures PTP over Ethernet on the physical port. The PTP process shall transmit and receive PTP messages through the port using Ethernet encapsulation (as opposed to UDP/IPv4 encapsulation).
The frames are transmitted with no VLAN tags even if the port is configured for dot1q or qinq modes for encap-type. In addition, the received frames from the external PTP clock must also be untagged.
There are two reserved multicast addresses allocated for PTP messages (see Annex F IEEE Std 1588™-2008). Either address can be configured for the PTP messages sent through this port.
A PTP port may not be created if the PTP profile is set g8265dot1-2010.
If the port specified in the port-id supports 1588 port based timestamping, then a side effect of enabling PTP over Ethernet on the port shall be the enabling of Synchronous Ethernet on that port.
De-provisioning of the card or MDA containing the specified port is not permitted while the port is configured within PTP.
Changing the encapsulation or the port type of the Ethernet port is not permitted when PTP Ethernet Multicast operation is configured on the port.
To allocate an ethernet satellite client port as a PTP port, the ethernet satellite must first be enabled for the transparent clock function. For more information, see the config>system>satellite>eth-sat ptp-tc command.
The SyncE/1588 ports of the CPM and CCMs can be specified as a PTP port. These use the 'A/3’ and 'B/3’ designation and they both must be specified as two PTP ports if both are to be used. The active CPM sends and receives messages on both ports if they are specified and enabled.
Parameters
- port-id
-
Specifies a specific physical port.
- create
-
Creates the PTP port. This keyword is required when first creating the PTP port, if the system is configured to require it (enabled in the environment create command). Once the PTP port is created, it is possible to navigate into the context without the create keyword.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port value
no port
Context
[Tree] (config>log>syslog port)
Full Context
configure log syslog port
Description
This command configures the UDP port that will be used to send syslog messages to the syslog target host.
The port configuration is needed if the syslog target host uses a port other than the standard UDP syslog port 514.
Only one port can be configured. If multiple port commands are entered, the last entered port overwrites the previously entered ports.
The no form of this command removes the value from the configuration.
Parameters
- value
-
Specifies the value that is the configured UDP port number used when sending syslog messages.
Platforms
All
port
Syntax
port port
no port
Context
[Tree] (config>system>netconf>listen port)
Full Context
configure system netconf listen port
Description
This command specifies the port on which the SR OS NETCONF server listens for new connections. Only one port can be configured for NETCONF management.
The configured port applies to both non-VPRN and VPRN management. New NETCONF connections are able to use the configured port. The SR OS NETCONF server errors if a port, different from the configured port, is used to SSH to the SR OS NETCONF server. For NETCONF connections not using VPRN management, active NETCONF connections are not disconnected if the port used to establish the connections is changed. For NETCONF connections using VPRN management, active NETCONF connections are disconnected if the port used to establish the connections is changed.
The no form of this command resets the port on which the SR OS NETCONF server listens to the default port of 830.
Parameters
- port
-
Specifies the port on which NETCONF listens for new connections.
Platforms
All
port
Syntax
port tcp/udp port-number [mask]
port port-list port-list-name
port range tcp/udp port-number tcp/udp port-number
no port
Context
[Tree] (config>system>security>cpm-filter>ipv6-filter>entry>match port)
[Tree] (config>system>security>cpm-filter>ip-filter>entry>match port)
Full Context
configure system security cpm-filter ipv6-filter entry match port
configure system security cpm-filter ip-filter entry match port
Description
This command configures a TCP/UDP source or destination port match criterion in IPv4 and IPv6 CPM filter policies. A packet matches this criterion if packet’s TCP/UDP (as configured by protocol/next-header match) source OR destination port matches either the specified port value or a port in the specified port range or port list.
This command is mutually exclusive with src-port and dst-port commands.
The no form of this command deletes the specified port match criterion.
Default
no port
Parameters
- tcp/udp port-number
-
Specifies the source or destination port to be used as a match criterion specified as a decimal integer.
- mask
-
Specifies the 16 bit mask to be applied when matching the port.
- range tcp/udp port-number
-
Specifies an inclusive range of source or destination port values to be used as match criteria. start of the range and end of the range are expressed as decimal integers.
- port-list port-list-name
-
Specifies a string of up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port port
no port
Context
[Tree] (config>system>security>radius port)
Full Context
configure system security radius port
Description
This command configures the TCP port number to contact the RADIUS server.
The no form of this command reverts to the default value.
Default
port 1812 (as specified in RFC 2865, Remote Authentication Dial In User Service (RADIUS))
Parameters
- port
-
Specifies the TCP port number to contact the RADIUS server.
Platforms
All
port
Syntax
[no] port port-number
[no] port range start end
Context
[Tree] (config>qos>match-list>port-list port)
Full Context
configure qos match-list port-list port
Description
This command adds a port or a range of ports to an existing port match list.
The no form of this command deletes the specified port or range of ports form the list.
Parameters
- port-number
-
Specifies the port number to add to the list. The port number can be expressed as a decimal integer, as well as in hexadecimal or binary format. Below shows decimal integer only.
- range
-
Keyword specifying a range of port values.
- start
-
Specifies the start of the port range, expressed as decimal integers, as well as in hexadecimal or binary format. The following value shows decimal integer only.
- end
-
Specifies the end of the port range, expressed as decimal integers, as well as in hexadecimal or binary format. The following value shows decimal integer only.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port port
no port
Context
[Tree] (config>system>grpc-tunnel>tunnel>handler port)
Full Context
configure system grpc-tunnel tunnel handler port
Description
This command assigns the TCP port number that the handler listens to internally.
The no form of this command disables the handler from listening to a TCP port.
Default
no port
Parameters
- port
-
Specifies the TCP port number.
Platforms
All
port
Syntax
port port-number
Context
[Tree] (config>test-oam>twamp>twl>src-udp-pools port)
Full Context
configure test-oam twamp twamp-light source-udp-port-pools port
Description
This command configures the TWAMP Light reserved source UDP ports to be mapped to a specific TWAMP Light or STAMP application.
Parameters
- port-number
-
Specifies the TWAMP Light reserved source UDP port number.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port
Syntax
port [detail]
no port
Context
[Tree] (debug>open-flow>of-switch port)
Full Context
debug open-flow of-switch port
Description
This command enables debugging of a port or ports associated with the OpenFlow switch.
The no form of this command disables debugging of a port or ports associated with the OpenFlow switch.
Parameters
- detail
-
Keyword used to specify detailed debugging information about a port or ports associated with the OpenFlow switch.
Platforms
VSR
port
Syntax
port [detail]
no port
Context
[Tree] (debug>open-flow port)
Full Context
debug open-flow port
Description
This command enables debugging of a port or ports associated with OpenFlow.
The no form of this command disables debugging of a port or ports associated with OpenFlow.
Parameters
- detail
-
Keyword used to specify detailed debugging information about the port associated with OpenFlow.
Platforms
VSR
port-block-extensions
port-block-extensions
Syntax
port-block-extensions ports num-ports subscriber-limit number
port-block-extension no ports
Context
[Tree] (config>service>vprn>nat>outside>pool port-block-extensions)
[Tree] (config>router>nat>outside>pool port-block-extensions)
Full Context
configure service vprn nat outside pool port-block-extensions
configure router nat outside pool port-block-extensions
Description
This command configures a port block reserved for a dynamic NAT traffic flow for each subscriber with a port forwarding entry.
The no form of this command removes the values from the configuration.
Parameters
- num-ports
-
Specifies the size of extended port-block for L2-aware subscribers
- number
-
Specifies the limit of L2-aware NAT subscribers per an outside IP address
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-block-extensions
Syntax
port-block-extensions
Context
[Tree] (config>service>nat>up-nat-policy port-block-extensions)
Full Context
configure service nat up-nat-policy port-block-extensions
Description
Commands in this context configure the attributes for dynamic allocation of NAT port blocks beyond the initial port blocks.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-bw-oversub-factor
port-bw-oversub-factor
Syntax
port-bw-oversub-factor oversubscription-factor
no port-bw-oversub-factor
Context
[Tree] (config>qos>hs-pool-policy>mid-tier>mid-pool port-bw-oversub-factor)
Full Context
configure qos hs-pool-policy mid-tier mid-pool port-bw-oversub-factor
Description
This command modifies the size of the mid-pool when calculating the port-class pool sizes based on port bandwidth ratios. The command does not actually change the size of the mid-pool, only the size reported to the port-class pool sizing function.
Port-class pools can be sized in one of two ways: dynamically (proportionate to the bandwidth of each port) or explicitly (based on a percentage of the parent mid-pool). Explicit percentages require careful determination of the amount to give each pool. The dynamic sizing function attempts to automatically size each pool based on the relative amount of bandwidth each port-class pool is supporting compared to other port’s port-class pools. This is accomplished by determining a dynamic weight for each port with port-class pools mapped to a given mid-pool. As true with any weighted behavior, the mid-pool buffer allocation resource is distributed in a non-oversubscribed manner to its child port-class pools. The port-bw-oversub-factor oversubscription-factor allows this distribution mechanism to become proportionally oversubscribed based on the defined factor. An oversubscription-factor of 1.5 causes the port-class pool dynamic sizes to be 1.5 times bigger, allowing for a potentially more efficient utilization of the buffers represented by mid-pool.
The port-bw-oversub-factor oversubscription-factor for a mid-pool can be modified at any time, causing the corresponding port-class pool dynamic sizes to be recalculated.
A similar behavior can be obtained by increasing the mid-pool’s allocation-percent of its parent root-pool. However, the major difference in using port-bw-oversub-factor is that it provides larger port-class pools without allowing the mid-pool to use a higher number of buffers in the root pool.
The no form of the command reverts to the default.
Default
port-bw-oversub-factor 1
Parameters
- oversubscription-factor
-
Specifies the factor by which the dynamically-sized port-class pools associated with the mid-pool may oversubscribe the mid-pool. This parameter is required when the port-bw-oversub-factor command is executed.
Platforms
7750 SR-7/12/12e
port-control
port-control
Syntax
port-control [auto | force-auth | force-unauth]
Context
[Tree] (config>port>ethernet>dot1x port-control)
Full Context
configure port ethernet dot1x port-control
Description
This command configures the 802.1x authentication mode.
The no form of this command returns the value to the default.
Default
port-control force-auth
Parameters
- force-auth
-
Disables 802.1x authentication and causes the port to transition to the authorized state without requiring any authentication exchange. The port transmits and receives normal traffic without requiring 802.1x-based host authentication.
- force-unauth
-
Causes the port to remain in the unauthorized state, ignoring all attempts by the hosts to authenticate. The switch cannot provide authentication services to the host through the interface.
- auto
-
Enables 802.1x authentication. The port starts in the unauthorized state, allowing only EAPoL frames to be sent and received through the port. Both the router and the host can initiate an authentication procedure. The port will remain in unauthorized state (no traffic except EAPoL frames is allowed) until the first client is authenticated successfully. After this, traffic is allowed on the port for all connected hosts.
Platforms
All
port-down
port-down
Syntax
[no] port-down
Context
[Tree] (config>subscr-mgmt>ancp>ancp-policy port-down)
Full Context
configure subscriber-mgmt ancp ancp-policy port-down
Description
Commands in this context configure the actions taken on port-down.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
port-down
Syntax
[no] port-down port-id
Context
[Tree] (config>vrrp>policy>priority-event port-down)
Full Context
configure vrrp policy priority-event port-down
Description
This command configures a port down priority control event that monitors the operational state of a port or SONET/SDH channel. When the port or channel enters the operational down state, the event is considered set. When the port or channel enters the operational up state, the event is considered cleared.
Multiple unique port-down event nodes can be configured within the priority-event context up to the overall limit of 32 events. Up to 32 events can be defined in any combination of types.
The port-down command can reference an arbitrary port or channel. The port or channel does not need to be preprovisioned or populated within the system. The operational state of the port-down event is set as follows:
-
Set – non-provisioned
-
Set – not populated
-
Set – down
-
Cleared – up
When the port or channel is provisioned, populated, or enters the operationally up or down state, the event operational state is updated appropriately.
When the event enters the operationally down, non-provisioned, or non-populated state, the event is considered to be set. When an event transitions from clear to set, the set is processed immediately and must be reflected in the associated virtual router instances in-use priority value. As the event transitions from cleared to set, a hold-set timer is loaded with the value configured by the events hold-set command. This timer prevents the event from clearing until it expires, damping the effect of event flapping. If the event clears and becomes set again before the hold-set timer expires, the timer is reset to the hold-set value, extending the time before another clear can take effect.
When the event enters the operationally up state, the event is considered to be cleared. Once the events hold-set expires, the effects of the events priority value are immediately removed from the in-use priority of all associated virtual router instances.
The actual effect on the virtual router instance in-use priority value depends on the defined event priority and its delta or explicit nature.
The no form of the command deletes the specific port or channel monitoring event. The event may be removed at anytime. When the event is removed, the in-use priority of all associated virtual router instances will be re-evaluated. The events hold-set timer has no effect on the removal procedure.
Default
no port-down — No port down priority control events are defined.
Parameters
- port-id
-
The port ID of the port monitored by the VRRP priority control event.
The port-id can only be monitored by a single event in this policy. The port can be monitored by multiple VRRP priority control policies. A port and a specific channel on the port are considered to be separate entities. A port and a channel on the port can be monitored by separate events in the same policy.
Platforms
All
port-format
port-format
Syntax
port-format formatting
no port-format
Context
[Tree] (config>service>vprn>wpp>portals>portal port-format)
[Tree] (config>router>wpp>portals>portal port-format)
Full Context
configure service vprn wpp portals portal port-format
configure router wpp portals portal port-format
Description
This command specifies the encoding format of WPP port attribute.
The standard format is as follows:
<0 to 20 character system-name><1 character separator><2-digit slot><1-digit mda><2-digit port><4-digit top><5-digit bottom>
As a general rule, if a value is not present or is too large to fit in the field, is the field set to all zeros. The following rules apply to standard formats.
-
With a standard port, when the separator is a "-” character, the slot is the slot-id, mda is the mda-id, and the port is the port-id.
-
With an ESAT port, when the separator is a ":” character, the slot is the satellite-id, MDA is satellite slot-id, and the port is satellite port-id.
-
With a PXC port, when separator is a "#” character, the MDA is the PXC subport-id, and the port is the PXC port-id.
-
With a LAG port, the port is the lag-id.
-
With a connector port, the slot is the slot-id, the MDA is the mda-id, and the port is the connector-id.
The vendor-specific format is as follows:
With dot1q, append "%u” with the top vlan-id.
With qinq, append "%u.%u” with the top vlan-id and the bottom vlan-id.
As a general rule, there can be no trailing zeros. The string truncates if it becomes too long. 0 to 16 characters are allowed for the system name. The following rules apply to vendor-specific formats.
-
With a standard port, append "%s-%u/%u/%” with the system-name, slot-id, mda-id, and port-id.
-
With an ESAT port, append "%s-S%u/%u/%u” with the system-name, satellite-id, satellite-slot-id, and satellite-port-id.
-
With a PXC port, append "%s-P%u%c” with the system-name, PXC port-id, and PXC subport-id ? 'a' : 'b'.
-
With a LAG port, append "%s-L%u” with the system-name and lag-id.
-
With a connector port append "%s-%u%uc%u/%u” with the system-name, slot-id, mda-id, connector-id, and connector-port-id.
The no form of this command reverts to the default.
Default
port-format standard
Parameters
- formatting
-
Specifies the encoding format of the WPP port attribute.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
port-forward-logging
port-forward-logging
Syntax
[no] port-forward-logging
Context
[Tree] (config>aaa>isa-radius-plcy>acct-include-attributes port-forward-logging)
Full Context
configure aaa isa-radius-policy acct-include-attributes port-forward-logging
Description
This command enables static or PCP port-forward logging via RADIUS. Port-forward logging is supported only in conjunction with the logging of port blocks.
The no form of the command disables static or PCP port-forward logging.
Default
no port-forward-logging
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-forwarding
port-forwarding
Syntax
port-forwarding
Context
[Tree] (config>service>nat port-forwarding)
Full Context
configure service nat port-forwarding
Description
Commands in this context configure NAT port forwarding parameters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-forwarding-dyn-block-reservation
port-forwarding-dyn-block-reservation
Syntax
[no] port-forwarding-dyn-block-reservation
Context
[Tree] (config>router>nat>outside>pool port-forwarding-dyn-block-reservation)
[Tree] (config>service>vprn>nat>outside>pool port-forwarding-dyn-block-reservation)
Full Context
configure router nat outside pool port-forwarding-dyn-block-reservation
configure service vprn nat outside pool port-forwarding-dyn-block-reservation
Description
This command will enable the reservation of the dynamic port blocks when the first port forward for the subscriber is created. The dynamic port bloc allocation is logged only if the block is being utilized (mapping are created). In other words, dynamic port block reservation due to the port forward creation but without any dynamic mapping, will not be logged.
The reserved port block will be released only when the last mapping in the block expires and there is not port forward associated with the subscriber. The de-allocation log (syslog or Radius) will be generated when the dynamic port block is completely released.
Dynamic port block reservation can be enabled only if the configured maximum number of subscriber per outside IP address is less or equal then the maximum number of configured port blocks per outside IP address.
Default
no port-forwarding-dyn-block-reservation
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-forwarding-range
port-forwarding-range
Syntax
port-forwarding-range [range-start] range-end
no port-forwarding-range
Context
[Tree] (config>router>nat>outside>pool port-forwarding-range)
[Tree] (config>service>vprn>nat>outside>pool port-forwarding-range)
Full Context
configure router nat outside pool port-forwarding-range
configure service vprn nat outside pool port-forwarding-range
Description
This command configures the lower and upper limit for port forwards in the ephemeral port space (wildcard port space) of all IP addresses in a NAT pool. A well-known port range (ports 1 to 1023) is always enabled for port forwards, and it cannot be disabled for pools in NAPT mode.
Pools in 1:1 mode do not support configured port forwards. These pools do not perform port translation and they automatically forward traffic initiated on the outside toward the inside.
Port 0 is always excluded from the port forwarding range.
The upper bound of the wildcard port range is reserved for port forwards. If the value for the range-start is not provided, the wildcard port range implicitly starts at 1024.
range-start 0 cannot be configured by an operator because it is reserved for 1:1 pools that do not support configured port forwards.
If you configure port-forwarding-range 3000, configures ports 1 to 3000 as port forwards. This implies that the well-known ports and wildcard ports are contiguous. If you configure port-forwarding-range 2000 3000, the router implicitly includes ports 1 to 1023, plus enables the wildcard port range 2000 to 3000, which is now disjoined from the well-known ports.
The range-start parameter has additional values that are configurable in the CLI. 0 is reserved for pools that do not support configured port forwards (those are 1:1 pools).
range-start 1 means that well-known ports and wildcard port forwards are contiguous. This is configured by omitting the range-start parameter and only configuring the range-end parameter.
The no form of this command disables the port forwards capability in the wildcard port range of all IP addresses in a NAT pool.
Default ranges in the range-start and range-end parameters in the MIB for the NAT pools that support port forwarding ranges are set to include only well-known ports, range-start 1 and range-end 1023.
Parameters
- range-start
-
Specifies the lower boundary of the wildcard port range reserved for port forwards. When configured, the value must be less than the range-end value.
- range-end
-
Specifies the upper boundary of the wildcard port range reserved for port forwards.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-forwarding-range
Syntax
port-forwarding-range range-end
no port-forwarding-range
Context
[Tree] (config>service>nat>nat-policy port-forwarding-range)
[Tree] (config>service>nat>firewall-policy port-forwarding-range)
Full Context
configure service nat nat-policy port-forwarding-range
configure service nat firewall-policy port-forwarding-range
Description
This command configures the end of the port range available for port forwarding. The start of the range is always equal to one.
The number of ports that can be configured is half of the available block => 64512 : 2 = 32256
In combination with port-forwarding-range the formulas are:
"max port-reservation blocks" = 65535 - "port-forwarding-range"
"max port-reservation ports" = (65535 - "port-forwarding-range") / 2
with:
the default min value for "port-forwarding-range" = 1023
Also, the same applies for max port-forwarding-range if the port-reservation is already configured:
"max port-forwarding-range" = 65535 - "port-reservation blocks"
"max port-forwarding-range" = 65535 - ("port-reservation ports" * 2)
The no form of the command reverts to the default.
Default
port-forwarding-range 1023
Parameters
- range-end
-
Specifies the end of the port range available for port forwarding.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure service nat nat-policy port-forwarding-range
7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure service nat firewall-policy port-forwarding-range
port-id
port-id
Syntax
[no] port-id
Context
[Tree] (config>router>if>dhcp>option>vendor-specific-option port-id)
Full Context
configure router interface dhcp option vendor-specific-option port-id
Description
This command enables sending of the port-id in the Nokia vendor specific suboption of the DHCP relay packet
The no form of this command disables the sending.
Default
no port-id
Platforms
All
port-id-subtype
port-id-subtype
Syntax
port-id-subtype {tx-if-alias | tx-if-name | tx-local}
Context
[Tree] (config>port>ethernet>lldp>dstmac port-id-subtype)
Full Context
configure port ethernet lldp dest-mac port-id-subtype
Description
This command specifies how to encode the PortID TLV transmit to the peer. The default setting tx-local (ifindex value) is required by some versions of the NSP NSM-P to properly build the Layer 2 topology map using LLDP. Changing this value to transmit the ifname ( tx-if-name) or ifAlias (tx-if-alias) in place of the ifindex (tx-local) may affect the ability of the NSP NFM-P to build the Layer 2 topology map using LLDP.
Default
port-id-subtype tx-local
Parameters
- tx-if-alias
-
Transmits the ifAlias String (subtype 1) that describes the port as stored in the IF-MIB, either user configured or the default entry (i.e. 10/100/Gig Ethernet SFP).
- tx-if-name
-
Transmits the ifName string (subtype 5) that describes the port as stored in the IF-MIB ifName info.
- tx-local
-
The interface ifIndex value (subtype 7) as the PortID.
Platforms
All
port-id-subtype
Syntax
port-id-subtype {tx-if-alias | tx-if-name | tx-local}
Context
[Tree] (config>lag>lldp-member-template>dstmac port-id-subtype)
Full Context
configure lag lldp-member-template dest-mac port-id-subtype
Description
This command configures the encoding of the PortID TLV that is transmitted to the peer. Some versions of the NSP NFM-P require the default setting tx-local (ifIndex value) to properly build the Layer 2 topology map using LLDP. Changing this value to transmit the ifName (tx-if-name) or ifAlias (tx-if-alias) in place of the ifIndex (tx-local) may affect the ability of the NSP NFM-P to build the Layer 2 topology map using LLDP.
Default
port-id-subtype tx-local
Parameters
- tx-if-alias
-
Keyword to transmit the ifAlias String (subtype 1), which describes the port as stored in the IF-MIB, either user configured or the default entry (for example, 10/100/Gig Ethernet SFP).
- tx-if-name
-
Keyword to transmit the ifName string (subtype 5), which describes the port as stored in the IF-MIB ifName information.
- tx-local
-
Keyword to transmit the interface ifIndex value (subtype 7) as the port ID.
Platforms
All
port-limits
port-limits
Syntax
port-limits
Context
[Tree] (config>service>nat>nat-policy port-limits)
[Tree] (config>service>nat>up-nat-policy port-limits)
[Tree] (config>service>nat>firewall-policy port-limits)
Full Context
configure service nat nat-policy port-limits
configure service nat up-nat-policy port-limits
configure service nat firewall-policy port-limits
Description
This command configures the port limits of this policy.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure service nat up-nat-policy port-limits
- configure service nat nat-policy port-limits
7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure service nat firewall-policy port-limits
port-list
port-list
Syntax
port-list port-list-name [create]
no port-list port-list-name
Context
[Tree] (config>app-assure>group port-list)
Full Context
configure application-assurance group port-list
Description
This command defines an AA group or partition named port-list, which contains a list of port numbers or port ranges. The port list is then referenced in AA policy app-filters, allowing increased flexibility in the use of server ports or HTTP proxy ports for application definition.
The no form of this command removes the list.
Parameters
- port-list-name
-
Specifies the name of the port list.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-list
Syntax
port-list port-list-name [create]
no port-list port-list-name
Context
[Tree] (config>filter>match-list port-list)
Full Context
configure filter match-list port-list
Description
This command creates a list of TCP/UDP/SCTP port values or ranges for match criteria in IPv4 and IPv6 ACL and CPM filter policies.
The no form of this command deletes the specified list.
Operational notes:
SCTP port match is supported in ACL filter policies only.
A port-list must contain only TCP/UDP/SCTP port values or ranges.
A TCP/UDP/SCTP port match list cannot be deleted if it is referenced by a filter policy.
See general description related to match-list usage in filter policies.
Parameters
- port-list-name
-
Specifies a string of up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.
Platforms
All
port-list
Syntax
port-list port-list-name [create]
no port-list port-list-name
Context
[Tree] (config>qos>match-list port-list)
Full Context
configure qos match-list port-list
Description
This command creates a list of port values or ranges for match criteria in QoS policies.
The no form of this command deletes the specified list.
Parameters
- port-list-name
-
Specifies a port list name, up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port-map
port-map
Syntax
port-map client-port-id primary primary-uplink-port-id [secondary secondary-uplink-port-id]
port-map client-port-id system-default
Context
[Tree] (config>system>satellite>eth-sat port-map)
Full Context
configure system satellite eth-sat port-map
Description
This command configures the mapping between a satellite client port and its associated uplink. This command allows both a primary and an optional secondary uplink to be configured.
If a secondary uplink is configured, it is used to forward traffic if the primary uplink is down for any reason.
Before an uplink can be used as either a primary or secondary uplink, it must be configured using the port-topology configuration command.
To return the uplink association to its default the port-map client-port-id system-default command should be used.
Parameters
- client-port-id
-
Specifies the satellite client port associated with the port mapping, in the format esat- id/slot/port.
- primary-uplink-port-id
-
Specifies the primary satellite uplink to be associated with the associate client port, in the format esat-id/slot/uport where id is 1 to 20.
- secondary-uplink-port-id
-
Specifies the secondary satellite uplink to be associated with the associate client port, in the format esat-id/slot/uport where id is 1 to 20.
- system-default
-
Specifies to set the port map to the system default.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port-num
port-num
Syntax
port-num virtual-port-number
no port-num [virtual-port-number]
Context
[Tree] (config>service>vpls>spoke-sdp>stp port-num)
[Tree] (config>service>vpls>sap>stp port-num)
Full Context
configure service vpls spoke-sdp stp port-num
configure service vpls sap stp port-num
Description
This command configures the virtual port number which uniquely identifies a SAP within configuration bridge protocol data units (BPDUs). The internal representation of a SAP is unique to a system and has a reference space much bigger than the 12 bits definable in a configuration BPDU. STP takes the internal representation value of a SAP and identifies it with its own virtual port number that is unique to every other SAP defined on the TLS. The virtual port number is assigned at the time that the SAP is added to the TLS. Since the order that the SAP was added to the TLS is not preserved between reboots of the system, the virtual port number may change between restarts of the STP instance.
The virtual port number cannot be administratively modified.
Platforms
All
port-overall-rate
port-overall-rate
Syntax
port-overall-rate packet-rate-limit [low-action-priority]
no port-overall-rate
Context
[Tree] (config>sys>security>cpu-protection port-overall-rate)
Full Context
configure system security cpu-protection port-overall-rate
Description
This command configures a per-port overall rate limit for CPU protection.
Default
port-overall-rate max
Parameters
- packet-rate-limit
-
Specifies an overall per-port packet arrival rate limit in packets per second.
- action-low-priority
-
Marks packets that exceed the rate as low-priority (for preferential discard later if there is congestion in the control plane) instead of discarding them immediately.
Platforms
7450 ESS, 7750 SR-7/12/12e, 7750 SR-7s, 7750 SR-14s, 7950 XRS
port-parent
port-parent
Syntax
parent [weight weight] [level level] [ cir-weight cir-weight] [cir-level cir-level]
no parent
Context
[Tree] (config>qos>sap-egress>dynamic-queue port-parent)
Full Context
configure qos sap-egress dynamic-queue port-parent
Description
This command configures the queue treatment by the port parent that governs the available bandwidth for the queue. When multiple queues share a child status with the parent port, the weight and level options define how this queue contends with the other children for the above-CIR parent bandwidth. The cir-weight and cir-level options specify the weight the queue uses for the within-CIR port priority.
Parameters
- weight
-
Specifies the relative weight of this queue in comparison to other child queues while vying for above-CIR priority level bandwidth on the parent scheduler. Any queues defined as weighted receive no parental bandwidth, until all strict queues and schedulers on the parent have reached their maximum bandwidth or are idle. In this manner, weighted children are considered to be the lowest priority.
- level
-
Specifies the priority level of the queue (as compared to other competing schedulers and queues) used to feed to the parent, for above-CIR offered load bandwidth passes.
- cir-weight
-
Specifies the weight the queue uses at the within-CIR port priority level. This applies to any charging statistics also. The weight is specified as an integer value from 0 to 100, with 100 being the highest weight. When the cir-weight option is set to 0 (the default), the queue does not receive bandwidth during the port scheduler's within-CIR passes and the cir-level option is ignored. If the cir-weight is 1 or greater, the cir-level option comes into play.
- cir-level
-
Specifies the priority level of the queue (as compared to other competing schedulers and queues) used to fed to the port parent, for within-CIR offered load bandwidth passes.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
port-parent
Syntax
port-parent [weight weight] [ level level] [cir-weight cir-weight] [cir-level cir-level]
no port-parent
Context
[Tree] (config>qos>sap-egress>policer port-parent)
Full Context
configure qos sap-egress policer port-parent
Description
This command specifies whether this SAP egress policer feeds off a port-level scheduler. When configured, the policer is parented by a port-level scheduler. This requires that policers-hqos-manageable be configured in the SAP egress QoS policy. This command and the SAP egress policer scheduler-parent and the parent commands are mutually exclusive.
The port-parent command defines a child/parent association between an egress policer and a port-based scheduler or between an intermediate service scheduler and a port-based scheduler. The port-parent command allows for a set of within-CIR and above-CIR parameters that define the port priority levels and weights for the policer. If the port-parent command is executed without any parameters, the default parameters are used.
In this context, the port-parent command and the scheduler-parent command (used to create a parent/child association between a queue and an intermediate scheduler) are mutually exclusive. Executing a port-parent command when a scheduler-parent definition exists causes the current intermediate scheduler association to be removed and replaced by the defined port-parent association. Executing a scheduler-parent command when a port-parent definition exists causes the port scheduler association to be removed and replaced by the defined intermediate scheduler association.
Changing the parent context on a SAP egress policy policer may cause a SAP or subscriber or a multiservice site context of the policer (policy associated with a SAP or subscriber profile or a multiservice site) to enter an orphaned state. If an instance of a policer is created on a port or channel that does not have a port scheduler enabled, and the SAP egress policy creating the policer has a port parent association, the policer will be allowed to run according to its own rate parameters and will not be controlled by a virtual scheduling context. If an instance of a policer is on a port or channel that has a port scheduler configured and the SAP egress policy defines the policer as having a non-existent intermediate scheduler parent, the policer will be treated as an orphan and will be handled according to the current orphan behavior on the port scheduler.
The no form of this command removes a port scheduler parent association for the policer. When removed, if a port scheduler is defined on the port on which the policer instance exists, the policer will be treated as orphaned to the port scheduler.
Default
no port-parent
Parameters
- weight weight
-
Specifies the weight that the policer will use at the above-CIR port priority level (defined by the level parameter).
All weight values from all weighted active policers, queues, and schedulers with a common port parent are added together. Then, each individual active weight is divided by the total to determine the percentage of remaining bandwidth provided to the policer, queue, or scheduler after the higher priority level children have been serviced. A weight is considered to be active when the applicable policer, queue, or scheduler has not reached its maximum rate and still has packets to transmit.
The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the weight parameter is set to a value of 0, the policer receives bandwidth only after other children with a non-zero weight at this level.
- level level
-
Specifies the port priority that the policer uses to receive bandwidth for its above-CIR offered load.
- cir-weight cir-weight
-
Specifies the weight that the policer uses at the within-CIR port priority level (defined by the cir-level parameter).
All cir-weight values from all weighted active policers, queues, and schedulers with a common port parent are added together. Then, each individual active weight is divided by the total to determine the percentage of remaining bandwidth provided to the policer, queue, or scheduler after the higher priority level children have been serviced. A weight is considered to be active when the applicable policer, queue, or scheduler has not reached its maximum rate and still has packets to transmit.
The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the cir-weight parameter is set to a value of 0, the policer receives bandwidth only after the other children with a non-zero weight at this level.
- cir-level cir-level
-
Specifies the port priority that the policer will use to receive bandwidth for its within-CIR offered load. If the cir-level parameter is set to a value of 0 (the default value), the policer does not receive bandwidth during the port schedulers within-CIR pass and the cir-weight parameter is ignored. If the cir-level parameter is 1 or greater, the cir- weight parameter is used.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-1s, 7750 SR-1se, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, VSR
port-parent
Syntax
port-parent [weight weight] [ level level] [cir-weight cir-weight] [cir-level cir-level]
no port-parent
Context
[Tree] (config>qos>sap-egress>queue port-parent)
Full Context
configure qos sap-egress queue port-parent
Description
This command specifies whether this queue feeds off a port-level scheduler. When configured, this SAP egress queue is parented by a port-level scheduler. This object is mutually exclusive with SAP egress queue parent. Only one kind of parent is allowed.
The port-parent command defines a child/parent association between an egress queue and a port-based scheduler or between an intermediate service scheduler and a port-based scheduler. The port-parent command allows for a set of within-CIR and above-CIR parameters that define the port priority levels and weights for the queue or scheduler. If the port-parent command is executed without any parameters, the default parameters are assumed.
In this context, the port-parent command is mutually exclusive to the parent command (used to create a parent/child association between a queue and an intermediate scheduler). Executing a port-parent command when a parent definition is in place causes the current intermediate scheduler association to be removed and replaced by the defined port-parent association. Executing a parent command when a port-parent definition exists causes the port scheduler association to be removed and replaced by the defined intermediate scheduler name.
Changing the parent context on a SAP egress policy queue may cause a SAP or subscriber or multiservice site context of the queue (policy associated with a SAP or subscriber profile or multiservice site) to enter an orphaned state. If an instance of a queue is created on a port or channel that does not have a port scheduler enabled and the sap-egress policy creating the queue has a port-parent association, the queue will be allowed to run according to its own rate parameters and will not be controlled by a virtual scheduling context. If an instance of a queue is on a port or channel that has a port scheduler configured and the sap-egress policy defines the queue as having a non-existent intermediate scheduler parent, the queue will be treated as an orphan and will be handled according to the current orphan behavior on the port scheduler.
The no form of this command removes a port scheduler parent association for the queue or scheduler. If a port scheduler is defined on the port on which the queue or scheduler instance exists, the queue or scheduler will become orphaned if an port scheduler is configured on the egress port of the queue or scheduler.
Default
no port-parent
Parameters
- weight weight
-
Specifies the weight the queue or scheduler will use at the above-CIR port priority level (defined by the level parameter).
- level level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its above-CIR offered-load.
- cir-weight cir-weight
-
Specifies the weight the queue or scheduler will use at the within-CIR port priority level (defined by the cir-level parameter). The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port schedulers within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter comes into play.
- cir-level cir-level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its within-CIR offered-load. If the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port schedulers within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter comes into play.
Platforms
All
port-parent
Syntax
port-parent [weight weight] [ level level] [cir-weight cir-weight] [cir-level cir-level]
no port-parent
Context
[Tree] (config>qos>network-queue>queue port-parent)
Full Context
configure qos network-queue queue port-parent
Description
This command specifies whether this queue feeds off a port-level scheduler. For the network-queue policy context, only the port-parent command is supported. When a port scheduler exists on the port, network queues without a port-parent association will be treated as an orphan queue on the port scheduler and treated according to the current orphan behavior on the port scheduler. If the port-parent command is defined for a network queue on a port without a port scheduler defined, the network queue will operate as if a parent association does not exist. When a port scheduler policy is associated with the egress port, the port-parent command will come into effect.
When a network-queue policy is associated with an FP for ingress queue definition, the port-parent association of the queues is ignored.
The no form of this command removes a port scheduler parent association for the queue or scheduler. If a port scheduler is defined on the port then the queue or scheduler instance exists, the queue or scheduler will become orphaned.
Default
no port-parent
Parameters
- weight weight
-
Specifies the weight the queue or scheduler will use at the above-CIR port priority level (defined by the level parameter).
- level level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its above-CIR offered-load.
- cir-weight cir-weight
-
Specifies the weight the queue or scheduler will use at the within-CIR port priority level (defined by the cir-level parameter). The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the cir-weight parameter is set to a value of 0, the queue or scheduler does not receive bandwidth during the port scheduler’s within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter is used.
- cir-level cir-level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its within-CIR offered-load. If the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port scheduler’s within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter comes into play.
Platforms
All
port-parent
Syntax
port-parent [weight weight] [ level level] [cir-weight cir-weight] [cir-level cir-level]
no port-parent
Context
[Tree] (config>qos>qgrps>egr>qgrp>queue port-parent)
Full Context
configure qos queue-group-templates egress queue-group queue port-parent
Description
This command defines the port scheduling parameters used to control the queue’s behavior when a virtual egress port scheduling is enabled where the egress queue group template is applied. The port-parent command follows the same behavior and provisioning characteristics as the parent command in the SAP egress QoS policy. The port-parent command and the parent command are mutually exclusive.
The no form of this command removes the values from the configuration.
Parameters
- weight weight
-
Specifies the weight the queue or scheduler will use at the above-CIR port priority level (defined by the level parameter).
- level level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its above-CIR offered-load.
- cir-weight cir-weight
-
Specifies the weight the queue or scheduler will use at the within-CIR port priority level (defined by the cir-level parameter). The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port schedulers within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter is used.
- cir-level cir-level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its within-CIR offered-load. If the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port schedulers within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter is used.
Platforms
All
port-parent
Syntax
port-parent [weight weight] [ level level] [cir-weight cir-weight] [cir-level cir-level]
no port-parent
Context
[Tree] (config>qos>scheduler-policy>tier>scheduler port-parent)
Full Context
configure qos scheduler-policy tier scheduler port-parent
Description
The port-parent command defines a child/parent association between an egress scheduler and a port-based scheduler, or between an intermediate service scheduler and a port-based scheduler. The port-parent command allows for a set of within-CIR and above-CIR parameters that define the port priority levels and weights for the scheduler. If the port-parent command is executed without any parameters, the default parameters are assumed.
In this context, the port-parent command and the parent command (used to create a parent/child association to an intermediate scheduler) are mutually exclusive. Executing a port-parent command when a parent definition is in place causes the current intermediate scheduler association to be removed and replaced by the defined port-parent association. Executing a parent command when a port-parent definition exists causes the port scheduler association to be removed and replaced by the defined intermediate scheduler name.
Changing the parent context on a SAP egress policy policer or queue may cause a SAP or subscriber context of the policer or queue (policy associated with a SAP or subscriber profile) to enter an orphaned state. If an instance of a policer or queue is created on a port or channel that does not have a port scheduler enabled and the sap-egress policy creating the policer queue has a port-parent association, the policer or queue will be allowed to run according to its own rate parameters and will not be controlled by a virtual scheduling context. If an instance of a policer or queue is on a port or channel that has a port scheduler configured and the sap-egress policy defines the policer or queue as having a non-existent intermediate scheduler parent, the policer or queue will be treated as an orphan and will be handled according to the current orphan behavior on the port scheduler.
The no form of this command removes a port scheduler parent association for the scheduler. If a port scheduler is defined on the port that the scheduler instance exists, the scheduler will become orphaned if an port scheduler is configured on the egress port of the queue or scheduler.
Default
no port-parent
Parameters
- weight weight
-
Specifies the weight the queue or scheduler will use at the above-CIR port priority level (defined by the level parameter).
- level level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its above-CIR offered-load.
- cir-weight cir-weight
-
Specifies the weight the queue or scheduler will use at the within-CIR port priority level (defined by the cir-level parameter). The weight is specified as an integer value from 0 to 100 with 100 being the highest weight. When the cir-weight parameter is set to a value of 0, the queue or scheduler does not receive bandwidth during the port scheduler’s within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter comes into play.
- cir-level cir-level
-
Specifies the port priority the queue or scheduler will use to receive bandwidth for its within-CIR offered-load. If the cir-weight parameter is set to a value of 0 (the default value), the queue or scheduler does not receive bandwidth during the port scheduler’s within-CIR pass and the cir-level parameter is ignored. If the cir-weight parameter is 1 or greater, the cir-level parameter comes into play.
Platforms
All
port-policy
port-policy
Syntax
port-policy [port-policy]
no port-policy
Context
[Tree] (config>isa>wlan-gw-group port-policy)
Full Context
configure isa wlan-gw-group port-policy
Description
This command configures the port policy of this WLAN Gateway ISA group. If a port policy is associated with a WLAN Gateway ISA group, ports created for this group can take applicable configuration from that port policy. This port policy is applicable to those ports that take part in the per-tunnel QoS processing.
The no form of the command removes the port-policy name from the configuration.
Default
no port-policy
Parameters
- port-policy
-
Specifies the port policy of this WLAN Gateway ISA group, up to 32 characters.
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-policy
Syntax
port-policy port-policy-name [create]
no port-policy port-policy-name
Context
[Tree] (config port-policy)
Full Context
configure port-policy
Description
This command either creates a new port-policy with create parameter or enters the configuration context of an existing port-policy.
The no form of this command removes the port policy name from the configuration.
Parameters
- port-policy-name
-
Specifies the name of port-policy up to 32 characters.
- create
-
Creates the port-policy instance. The create keyword requirement can be enabled or disabled in the environment>create context.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-policy
Syntax
port-policy policy-name
no port-policy
Context
[Tree] (config>isa>lns-group port-policy)
Full Context
configure isa lns-group port-policy
Description
This command enables policies referenced in the config>port-policy context to be created under ports. These are the ports that link the carrier IOM to the ISA, and are hidden within the system (they cannot be created through the CLI). They are created automatically. Use the show port command to view information.
Currently only the port scheduler policy is supported. Each lns-esm port in the lns-group receives an independent port scheduler instance. The port schedulers are instantiated in the carrier IOM on the lns-esm ports that carry PPPoE traffic in the downstream direction towards the ISA before the PPPoE traffic is L2TP encapsulated.
The no form of the command removes the policy name from the configuration.
Default
no port-policy
Parameters
- policy-name
-
Specifies the port policy of this LNS group, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-range-block
port-range-block
Syntax
[no] port-range-block
Context
[Tree] (config>aaa>isa-radius-plcy>acct-include-attributes port-range-block)
Full Context
configure aaa isa-radius-policy acct-include-attributes port-range-block
Description
This command enables the inclusion of the NAT port range block attributes.
The no form of the command excludes NAT port range block attributes.
Default
no port-range-block
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-recorder
port-recorder
Syntax
[no] port-recorder
Context
[Tree] (debug>app-assure>group port-recorder)
Full Context
debug application-assurance group port-recorder
Description
This commands allows to stop or start the http-host-recorder. To reset the recorded values execute shutdown followed by no shutdown.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-redirect-group
port-redirect-group
Syntax
port-redirect-group {queue queue-id | policer policer-id [queue queue-id]}
no port-redirect-group
Context
[Tree] (config>qos>network>egress>fc port-redirect-group)
Full Context
configure qos network egress fc port-redirect-group
Description
This command is used to redirect the FC of a packet of a pseudowire (PW) or network IP interface to an egress port queue group.
It defines the mapping of an FC to a queue ID or a policer ID and a queue ID and redirects the lookup of the queue or policer of the same ID in some egress port queue-group instance. However, the queue-group name and instance are explicitly provided only at the time the network QoS policy is applied to egress context of a spoke-sdp or a network IP interface.
The no version of this command removes the redirection of the FC.
Parameters
- queue-id
-
This parameter must be specified when executing the port-redirect-group command. The specified queue-id must exist within the egress port queue group on each IP interface where the network QoS policy is applied.
- policer id
-
The specified policer-id must exist within the queue-group template applied to the ingress context of the forwarding plane.
Platforms
All
port-reservation
port-reservation
Syntax
port-reservation blocks num-blocks
port-reservation ports num-ports
no port-reservation
Context
[Tree] (config>router>nat>outside>pool port-reservation)
[Tree] (config>service>vprn>nat>outside>pool port-reservation)
Full Context
configure router nat outside pool port-reservation
configure service vprn nat outside pool port-reservation
Description
This command configures the size of the port block that will be assigned to a host that is served by this pool. The number of ports configured are available to UDP, TCP, and ICMP (as identifiers).
Parameters
- num-blocks
-
Specifies the number of port blocks per IP address. Setting this parameter to one (1) for large scale NAT enables 1:1 NAT for IP addresses in this pool.
- num-ports
-
Specifies the number of ports per block.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-reservation
Syntax
port-reservation num-ports
no port-reservation
Context
[Tree] (config>service>vprn>nat>outside>pool>deterministic port-reservation)
[Tree] (config>router>nat>outside>pool>deterministic port-reservation)
Full Context
configure service vprn nat outside pool deterministic port-reservation
configure router nat outside pool deterministic port-reservation
Description
This command is applicable only to deterministic NAT. It configures the number of deterministic ports per subscriber (for example a subscriber is an inside IP address in LSN44 or IPv6 address or prefix in DS-Lite). Once this command is enabled, the pool will transition into deterministic mode of operation. This means that the subscribers can use dynamic port-blocks in the pool only as a mean to expand the range of originally assigned deterministic ports. A pool with such property is referred to as deterministic pool. However, deterministic NAT and non-deterministic NAT cannot use the same pool simultaneously.
All subscribers in deterministic pool are pre-mapped during the configuration phase to outside IP addresses and deterministic port-blocks. Because of this, the deterministic pool cannot be oversubscribed with subscribers (first-come, first-served).
Once the deterministic pool becomes operational (no shutdown) a log is created. The same applies if the pool is disabled (shutdown). As a result of this one-time logging, there will be no additional logging when a subscriber starts using ports from the pre-assigned deterministic port block. This drastically reduces the logging overhead. However, when a deterministic port block is expanded by a dynamic port block, a log will be created on any allocation/de-allocation of the dynamic port block. The logs are also created for static port forwards (including PCP).
The number of subscribers per outside IP address (subscriber-limit) multiplied by the number of deterministic ports per subscriber (port-reservation) will determine the port range of an outside IP address that will be dedicated to deterministic mappings. The number of subscribers per outside IP address in deterministic NAT must be power of 2 (2^n). Once the deterministic ports are allocated, the dynamic ports are carved out of the remaining port space of the same outside IP address according to the existing port-reservation command under the same hierarchy,
Parameters
- num-ports
-
Specifies the number of ports in a deterministic port block that is allocated and dedicated to a single subscribers during the configuration phase.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-reservation
Syntax
[no] port-reservation
Context
[Tree] (config>service>nat>pcp-server-policy>option port-reservation)
Full Context
configure service nat pcp-server-policy option port-reservation
Description
This command enables/disables support for the port-reservation option.
Default
no port-reservation
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-role
port-role
Syntax
[no] port-role
Context
[Tree] (debug>service>id>stp port-role)
Full Context
debug service id stp port-role
Description
This command enables STP debugging for changes in port roles.
Platforms
All
port-scheduler-policy
port-scheduler-policy
Syntax
port-scheduler-policy port-scheduler-policy-name
no port-scheduler-policy
Context
[Tree] (config>port>ethernet>access>egress>vport port-scheduler-policy)
Full Context
configure port ethernet access egress vport port-scheduler-policy
Description
This command specifies the destination and organization strings to be used for matching subscriber hosts with this Vport.
The parent Vport of a subscriber host queue, which has the port-parent option enabled, is determined by matching the destination string dest string associated with the subscriber and the organization string org string associated with the subscriber host with the strings defined under a Vport on the port associated with the subscriber.
If a given subscriber host policers or queue does not have the port-parent option enabled, it is foster-parented to the Vport used by this subscriber and which is based on matching the dest string and org string. If the subscriber could not be matched with a Vport on the egress port, the host policer or queue will not be bandwidth controlled and competes for bandwidth directly based on its own PIR and CIR parameters.
By default, a subscriber host policer or queue with the port-parent option enabled is scheduled within the context of the port’s port scheduler policy.
The agg-rate rate, port-scheduler-policy and scheduler-policy commands are mutually exclusive. Changing between the use of a scheduler policy and the use of an agg-rate or port-scheduler-policy involves removing the existing command and applying the new command. Applying a scheduler policy to a Vport is only applicable to Ethernet interfaces.
The no form of this command removes the port-scheduler-policy-name from the configuration.
The agg-rate rate, port-scheduler-policy and scheduler-policy commands are mutually exclusive. Changing between the use of a scheduler policy and the use of an agg-rate/port-scheduler-policy involves removing the existing command and applying the new command.
The no form of this command reverts to the default.
Parameters
- port-scheduler-policy-name
-
Specifies an existing port-scheduler-policy configured in the config>qos context.
Platforms
All
port-scheduler-policy
Syntax
port-scheduler-policy port-scheduler-policy-name
no port-scheduler-policy
Context
[Tree] (config>isa>aa-grp>qos>egress>to-subscriber port-scheduler-policy)
[Tree] (config>isa>aa-grp>qos>egress>from-subscriber port-scheduler-policy)
Full Context
configure isa application-assurance-group qos egress to-subscriber port-scheduler-policy
configure isa application-assurance-group qos egress from-subscriber port-scheduler-policy
Description
This command assigns an existing port scheduler policy as applicable to the specific application assurance group traffic.
Default
no port-scheduler-policy
Parameters
- port-scheduler-policy-name
-
Specifies the name of an existing port scheduler policy.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-scheduler-policy
Syntax
port-scheduler-policy port-scheduler-name [ create]
no port-scheduler-policy port-scheduler-name
Context
[Tree] (config>qos port-scheduler-policy)
Full Context
configure qos port-scheduler-policy
Description
When a port scheduler has been associated with an egress port, it is possible to override the following parameters:
-
The max-rate allowed for the scheduler
-
The maximum rate for each priority level (1 to 8)
-
The cir associated with each priority level (1 to 8)
The orphan priority level (level 0) has no configuration parameters and cannot be overridden.
The no form of this command removes a port scheduler policy from the system. If the port scheduler policy is associated with an egress port or channel, the command will fail.
Parameters
- port-scheduler-name
-
Specifies an existing port scheduler name. Each port scheduler must be uniquely named within the system and can be up to 32 ASCII characters.
Platforms
All
port-scheduler-policy
Syntax
port-scheduler-policy src-name dst-name [overwrite]
Context
[Tree] (config>qos>copy port-scheduler-policy)
Full Context
configure qos copy port-scheduler-policy
Description
This command copies existing QoS policy entries for a QoS policy to another QoS policy.
The copy command is a configuration-level maintenance tool used to create new policies using existing policies. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.
If overwrite is not specified, an error will occur if the destination policy exists.
Parameters
- src-name dst-name
-
Indicates that the source policy and the destination policy are port scheduler policy IDs. Specify the source policy that the copy command will attempt to copy from and specify the destination policy name to which the command will copy a duplicate of the policy.
- overwrite
-
Forces the destination policy name to be copied as specified. When forced, everything in the existing destination policy will be completely overwritten with the contents of the source policy.
Platforms
All
port-set
port-set
Syntax
[no] port-set
Context
[Tree] (config>service>nat>pcp-server-policy>option port-set)
Full Context
configure service nat pcp-server-policy option port-set
Description
This command enables PORT_SET option support. When this command is disabled, the PCP uses a plain MAP option to allocate a single port at a time. This is default behavior. Instead of asking for each individual port in multiple requests through the MAP option, this port-set option allows individual ports to ask the SR OS for a set of ports at once in a single request.
The no form of this command disables PORT_SET option support.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-state
port-state
Syntax
[no] port-state
Context
[Tree] (debug>service>id>stp port-state)
Full Context
debug service id stp port-state
Description
This command enables STP debugging for port states.
The no form of the command disables debugging.
Platforms
All
port-template
port-template
Syntax
port-template template-name sat-type sat-type [create]
no port-template template-name
Context
[Tree] (config>system>satellite port-template)
Full Context
configure system satellite port-template
Description
This command creates a new port template context to define the port usage for a specific satellite type. A port template is specific to the specified satellite type. Port templates must be configured separately using different template names for each different satellite chassis type.
The no form of this command deletes the specified port template.
Parameters
- template-name
-
Specifies the name for the associated port template. This value must be unique in the network.
- sat-type
-
Specifies the type of satellite chassis associated with the port-template.
- create
-
Creates a new port template.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port-threshold
port-threshold
Syntax
port-threshold value [action { dynamic-cost | static-cost | down}] [ cost static-cost]
no port-threshold
Context
[Tree] (config>lag port-threshold)
Full Context
configure lag port-threshold
Description
This command configures the behavior for the Link Aggregation Group (LAG) if the number of operational links is equal to or below a threshold level.
Nokia recommends that operators use the weight-threshold or hash-weight-threshold command instead of the port-threshold command to control LAG operational status. For example, when 10GE and 100GE ports are mixed in a LAG, each 10GE port will have a weight of 1, while each 100GE port will have a weight of 10.
The weight-threshold or hash-weight-threshold command can also be used for LAGs with all ports of equal speed to allow a common operational model. For example, each port has a weight of 1 to mimic port-threshold and its related configuration.
The no form of this command reverts to the default values.
Default
port-threshold 0 action down
Parameters
- value
-
Specifies the decimal integer threshold number of operational links for the LAG at or below which the configured action is invoked. If the number of operational links exceeds the port-threshold value, any action taken for being below the threshold value will cease.
- action
-
Specifies the action to take if the number of active links in the LAG is at or below the threshold value.
- dynamic-cost
-
Specifies that dynamic costing is activated. As a result, the LAG remains operationally up with a cost relative to the number of operational links. The link is only regarded as operationally down when all links in the LAG are down.
- static-cost
-
Specifies that static costing is activated. As a result, the LAG remains operationally up with the configured cost, regardless of the number of operational links. The link is only regarded as operationally down when all links in the LAG are down.
- down
-
Specifies that LAG is brought operationally down if the number of operational links is equal to or less than the configured threshold value. The LAG is only regarded as up once the number of operational links exceeds the configured threshold value.
- static-cost
-
Specifies decimal integer static cost of the LAG.
Platforms
All
port-time
port-time
Syntax
[no] port-time
Context
[Tree] (config>aaa>isa-radius-plcy>acct-include-attributes port-time)
Full Context
configure aaa isa-radius-policy acct-include-attributes port-time
Description
This command enables the Alc-Nat-Port-Time RADIUS attribute, which is used to record the duration of a port-block or port-forward allocated for a NAT subscriber.
The no form of this command disables the Alc-Nat-Port-Time RADIUS attribute.
Default
no port-time
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port-topology
port-topology
Syntax
port-topology
Context
[Tree] (config>system port-topology)
Full Context
configure system port-topology
Description
This parameter creates or edits the context to configure intra-node port connections.
Default
disabled
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port-type
port-type
Syntax
port-type lag-port-type
no port-type
Context
[Tree] (config>lag port-type)
Full Context
configure lag port-type
Description
This command configures the port type for the link aggregation group.
The no form of this command reverts to the default.
Default
port-type standard
Parameters
- lag-port-type
-
Specifies the type of ports allowed in this LAG.
Platforms
7750 SR-7/12/12e
port-xc
port-xc
Syntax
port-xc
Context
[Tree] (config port-xc)
Full Context
configure port-xc
Description
Commands in this context configure port-cross connect functionality.
Platforms
All
port1
port1
Syntax
port1 {eq | neq} port-num
no port1
Context
[Tree] (debug>app-assure>group>traffic-capture>match port1)
Full Context
debug application-assurance group traffic-capture match port1
Description
This command configures debugging on port 1.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
port2
port2
Syntax
port2 {eq | neq} port-num
no port2
Context
[Tree] (debug>app-assure>group>traffic-capture>match port2)
Full Context
debug application-assurance group traffic-capture match port2
Description
This command configures debugging on port 2.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
portal
portal
Syntax
portal router router-instance name wpp-portal-name
no portal
Context
[Tree] (config>service>ies>sub-if>grp-if>wpp portal)
[Tree] (config>service>vprn>sub-if>grp-if>wpp portal)
[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>wpp portal)
Full Context
configure service ies subscriber-interface group-interface wpp portal
configure service vprn subscriber-interface group-interface wpp portal
configure subscriber-mgmt local-user-db ipoe host wpp portal
Description
This command specifies the web portal server that system talks to for the hosts on the group-interface. This command is mutually exclusive with the portal-group command.
The no form of this command removes the router instance or portal name from the configuration.
Parameters
- router-instance
-
Specifies the virtual router instance.
- wpp-portal-name
-
Specifies the name of the web portal server up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal
Syntax
[no] portal router router-instance name wpp-portal-name
Context
[Tree] (config>aaa>wpp>portal-groups>portal-group portal)
Full Context
configure aaa wpp portal-groups portal-group portal
Description
This command configures the portal for this portal group.
Parameters
- router-instance
-
Specifies the virtual router instance.
- wpp-portal-name
-
Specifies the name of the web portal server up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal
Syntax
[no] portal wpp-portal-name
Context
[Tree] (debug>router>wpp portal)
Full Context
debug router wpp portal
Description
This command enables WPP debugging for the specified WPP portal.
Parameters
- wpp-portal-name
-
Specifies the WPP portal name.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal
Syntax
[no] portal
Context
[Tree] (config>subscr-mgmt>wlan-gw>ue-query>state portal)
Full Context
configure subscriber-mgmt wlan-gw ue-query state portal
Description
This command enables matching on UEs in a portal state.
The no form of this command disables matching on UEs in a portal state, unless all state matching is disabled.
Default
no portal
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
portal-group
portal-group
Syntax
portal-group portal-group-name
no portal-group
Context
[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>wpp portal-group)
Full Context
configure subscriber-mgmt local-user-db ipoe host wpp portal-group
Description
This command configures the WPP portal group name. This command is mutually exclusive with the portal command.
Parameters
- portal-group-name
-
Specifies the WPP portal group name, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal-group
Syntax
portal-group portal-group-name [create]
no portal-group portal-group-name
Context
[Tree] (config>aaa>wpp>portal-groups portal-group)
Full Context
configure aaa wpp portal-groups portal-group
Description
This command creates a new portal group or enters the configuration context of an existing port group.
Parameters
- portal-group-name
-
Specifies the portal group name up to 32 characters.
- create
-
Keyword required to create the configuration context.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal-group
Syntax
portal-group portal-group-name
no portal-group
Context
[Tree] (config>service>ies>sub-if>grp-if>wpp portal-group)
[Tree] (config>service>vprn>sub-if>grp-if>wpp portal-group)
Full Context
configure service ies subscriber-interface group-interface wpp portal-group
configure service vprn subscriber-interface group-interface wpp portal-group
Description
This command specifies the WPP portal group for the subscriber interface. This command is mutually exclusive with the portal command.
The no form of this command removes the name from the service configuration.
Parameters
- portal-group-name
-
Specifies the portal group name up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal-groups
portal-groups
Syntax
portal-groups
Context
[Tree] (config>aaa>wpp portal-groups)
Full Context
configure aaa wpp portal-groups
Description
Commands in this context configure portal group parameters for WPP.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
portal-hold-time
portal-hold-time
Syntax
portal-hold-time seconds
no portal-hold-time
Context
[Tree] (config>subscr-mgmt>http-rdr-plcy portal-hold-time)
Full Context
configure subscriber-mgmt http-redirect-policy portal-hold-time
Description
This command configures the time for which the forwarding state applicable during redirect phase is held in the system, after the user has been authenticated on the portal. This allows the HTTP response from the portal to be forwarded back on the existing connection.
Parameters
- seconds
-
Specifies how long the system holds on to re-direct forwarding resources of a subscriber, after it has left the re-direct portal.
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
portals
portals
Syntax
portals
Context
[Tree] (config>router>wpp portals)
[Tree] (config>service>vprn>wpp portals)
Full Context
configure router wpp portals
configure service vprn wpp portals
Description
Commands in this context configure WPP portal server parameters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ports
ports
Syntax
ports
Context
[Tree] (config>qos>fp-resource-policy ports)
Full Context
configure qos fp-resource-policy ports
Description
This command enters the ports context.
Platforms
7750 SR-1, 7750 SR-s
ports
Syntax
ports num-ports
no ports
Context
[Tree] (config>service>nat>up-nat-policy>port-block-extensions ports)
Full Context
configure service nat up-nat-policy port-block-extensions ports
Description
This command configures the number of ports in extended port blocks for the NAT subscriber.
Parameters
- num-ports
-
Specifies the number of ports per extended port block.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
positive-app-id
positive-app-id
Syntax
positive-app-id
Context
[Tree] (config>app-assure>group>ip-id-asst positive-app-id)
Full Context
configure application-assurance group ip-identification-assist positive-app-id
Description
Commands in this context implement the positive application identification mechanism, which monitors the correlations between IP addresses and applications identified with a high degree of confidence independently of any IP identification assist mechanism.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
post-policer-mapping
post-policer-mapping
Syntax
post-policer-mapping mapping-policy-name [ create]
no post-policer-mapping mapping-policy-name
Context
[Tree] (config>qos post-policer-mapping)
Full Context
configure qos post-policer-mapping
Description
This command configures a post-policer mapping policy which is used to remap a packet's forwarding class and profile state to another forwarding class and profile state for post-policer traffic.
A post-policer mapping policy is created without any forwarding class or profile remapping statements. If an empty policy is applied to a SAP-egress QoS policy, no remapping occurs.
The no form of this command deletes the post-policer mapping policy. A post-policer mapping policy can only be deleted if there are no references to it.
Parameters
- mapping-policy-name
-
Specifies the name of the post-policer mapping policy, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR
post-policer-mapping
Syntax
post-policer-mapping src-name dst-name [ overwrite]
Context
[Tree] (config>qos>copy post-policer-mapping)
Full Context
configure qos copy post-policer-mapping
Description
This command copies an existing post-policer mapping policy to another policy name.
The copy command is used to create new policies using existing policies and also allows bulk modifications to an existing policy with the use of the overwrite keyword.
Parameters
- src-name
-
Specifies the source policy name that the copy command attempts to copy from.
- dst-name
-
Specifies the destination policy name to which the command copies a duplicate of the policy.
- overwrite
-
Specifies that the existing destination policy is to be replaced. Everything in the existing destination policy is overwritten with the contents of the source policy. If overwrite is not specified, an error occurs if the destination policy name exists.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR
post-policer-mapping
Syntax
post-policer-mapping mapping-policy-name
no post-policer-mapping
Context
[Tree] (config>qos>sap-egress post-policer-mapping)
Full Context
configure qos sap-egress post-policer-mapping
Description
This command applies a post-policer mapping policy in a SAP egress QoS policy. The policy contains forwarding class and profile remapping statements, which remap the forwarding class and profile state of an egress policed packet (the profile being the resulting profile after the packet has been processed by the egress policer) to another forwarding class and profile.
The remapping applies to all policers within the SAP egress QoS policy, including regular child policers and policers configured in an IP/IPv6 criteria action statement, except for dynamic policers.
Post-policer mapping is supported on FP3- and higher-based hardware, with the exception of the 7750 SR-a4/a8, which does not support egress policers resulting in the policy being ignored.
The no form of this command deletes the post-policer mapping policy from the SAP egress QoS policy.
Parameters
- mapping-policy-name
-
Specifies the name of the post-policer mapping policy, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, 7950 XRS, VSR
power
power
Syntax
power power-state
Context
[Tree] (config>system>bluetooth power)
Full Context
configure system bluetooth power
Description
This command sets the operating mode of the Bluetooth module. This can be powered off or powered on but requires the pairing button to initiate the pairing operation, or powered on and continuously pairing.
The pairing-button setting also impacts how pairing operations work.
Default
power off
Parameters
- power-state
-
Specifies the power state.
Platforms
7750 SR-1, 7750 SR-s, 7950 XRS-20e
power-priority-level
power-priority-level
Syntax
power-priority-level priority
no power-priority-level
Context
[Tree] (config>card>xiom>mda power-priority-level)
[Tree] (config>card>mda power-priority-level)
Full Context
configure card xiom mda power-priority-level
configure card mda power-priority-level
Description
This command sets the power priority value for an XMA or MDA-s on platforms that support intelligent power management.
Default
power-priority-level 150
Parameters
- priority
-
Specifies the power priority level. An operator must assign a priority value to each XMA or MDA-s using a range of number from 1 to 200. The lowest number has the highest priority. The priority number range from 1 to 100 should be used for modules considered essential for system operation. Lower priority values of 101 to 200 should be used for non-essential modules.
Platforms
7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s
- configure card xiom mda power-priority-level
7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS
- configure card mda power-priority-level
power-safety-alert
power-safety-alert
Syntax
power-safety-alert wattage
Context
[Tree] (config>system>pwr-mgmt power-safety-alert)
Full Context
configure system power-management power-safety-alert
Description
This command sets a value in watts for the Power Safety Alert. The Power Safety Alert minor alarm is generated when the system power capacity drops below the Power Safety Level (in watts) plus the Power Safety Alert. This is a critical level, which when breached the system starts shutting down IO cards based on card priority.
Parameters
- wattage
-
Specifies the number of watts for the power safety alert level.
Platforms
7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS
power-safety-level
power-safety-level
Syntax
power-safety-level percent
Context
[Tree] (config>system>pwr-mgmt power-safety-level)
Full Context
configure system power-management power-safety-level
Description
This command sets the Power Safety Level, which is a percentage of the calculated worst case power draw value. Once a Power Safety Level is configured by the operator, both the Basic and Advanced modes use the Power Safety Level as a reference for calculating the power redundancy using N+1 algorithm during startup and recovery from power depression.
Default
power-safety-level 100
Parameters
- percent
-
Specifies the Power Safety Level as a percentage of the calculated worst case power draw value.
Platforms
7750 SR-1s, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS
power-save
power-save
Syntax
[no] power-save
Context
[Tree] (config>card power-save)
Full Context
configure card power-save
Description
This command enables power-save mode on a specific card when it is not in use. Power-save mode allows a card to be installed and configured in a platform for future use, while having minimal impact on the overall power consumption. The card placed in power-save mode is forced into an idle state to consume minimal power. This command resets the card and then disallows the download of a software image when the card comes back up. To enable power-save mode, the desired card must first be shut down, then placed into power-save mode. In this mode, the card is not counted in the intelligent power management budget. Cards set to power-save mode do not pass traffic.
The no form of this command removes the card from power-save mode.
Default
no power-save
Platforms
7450 ESS, 7750 SR-7/12/12e, 7750 SR-a8, 7750 SR-2e, 7750 SR-3e, 7750 SR-2s, 7750 SR-2se, 7750 SR-7s, 7750 SR-14s, 7950 XRS
power-supply
power-supply
Syntax
power-supply power-supply-id type
Context
[Tree] (config>system power-supply)
Full Context
configure system power-supply
Description
This command configures information about the type of power supply used for each power feed connection on the router chassis. The information is used to populate queries made using the show>chassis detail and show>chassis power-supply commands.
Parameters
- power-supply-id
-
Specifies the power feed connection.
- type
-
Specifies the type of power source that is connected to the power feed connection.
Platforms
7450 ESS, 7750 SR-7/12
ppid
ppid
Syntax
ppid
Context
[Tree] (config>app-assure>group>statistics>tca>sctp-filter ppid)
Full Context
configure application-assurance group statistics threshold-crossing-alert sctp-filter ppid
Description
This command configures a TCA for the counter capturing PPID hits for the specified SCTP filter.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppid
Syntax
ppid
Context
[Tree] (config>app-assure>group>sctp-filter ppid)
Full Context
configure application-assurance group sctp-filter ppid
Description
Commands in this context configure actions for specific or default Payload Protocol Identifiers (PPIDs).
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppid-range
ppid-range
Syntax
ppid-range direction direction [create]
no ppid-range direction direction
Context
[Tree] (config>app-assure>group>statistics>tca>sctp-filter ppid-range)
Full Context
configure application-assurance group statistics threshold-crossing-alert sctp-filter ppid-range
Description
This command configures a TCA for the counter capturing hits for the specified SCTP filter PPID range command. An PPIPD range TCA can be created for traffic generated from the subscriber side of AA (from-sub) or for traffic generated from the network toward the AA subscriber (to-sub). The create keyword is mandatory when creating a TCA.
Parameters
- direction
-
Specifies the traffic direction.
- create
-
Keyword used to create the TCA.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppid-range
Syntax
ppid-range min min-ppid max max-ppid
no ppid-range
Context
[Tree] (config>app-assure>group>sctp-filter ppid-range)
Full Context
configure application-assurance group sctp-filter ppid-range
Description
This command specifies the range of PPID values that are allowed by AA SCTP filter firewall.
The no form of this command removes this PPID range.
Default
no ppid-range
Parameters
- min-ppid
-
Specifies the minimum SCTP Payload Protocol Identifier (PPID) to be permitted by the SCTP filter. The value must be less than or equal to the max max-ppid value.
- max-ppid
-
Specifies the minimum SCTP Payload Protocol Identifier (PPID) to be permitted by the SCTP filter. The value must be greater or equal to the min min-ppid value.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppk
ppk
Syntax
ppk list ppk-list-name id ppk-id
Context
[Tree] (config>service>vprn>if>sap>ipsec-tunnel>dyn ppk)
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel>dyn ppk)
[Tree] (config>service>ies>if>ipsec>ipsec-tunnel>dyn ppk)
[Tree] (config>ipsec>trans-mode-prof>dyn ppk)
[Tree] (config>router>if>ipsec>ipsec-tunnel>dyn ppk)
Full Context
configure service vprn interface sap ipsec-tunnel dynamic-keying ppk
configure service vprn interface ipsec ipsec-tunnel dynamic-keying ppk
configure service ies interface ipsec ipsec-tunnel dynamic-keying ppk
configure ipsec ipsec-transport-mode-profile dynamic-keying ppk
configure router interface ipsec ipsec-tunnel dynamic-keying ppk
Description
This command specifies the PPK to use for dynamic keying of the IPsec tunnel.
The no form of this command removes the PPK.
Default
no ppk
Parameters
- ppk-list-name
- Specifies the name of the PPK list, up to 32 characters.
- ppk-id
- Specifies the ID of a PPK entry in the list, up to 64 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure ipsec ipsec-transport-mode-profile dynamic-keying ppk
- configure service vprn interface sap ipsec-tunnel dynamic-keying ppk
VSR
- configure router interface ipsec ipsec-tunnel dynamic-keying ppk
- configure service ies interface ipsec ipsec-tunnel dynamic-keying ppk
- configure service vprn interface ipsec ipsec-tunnel dynamic-keying ppk
ppk-id
ppk-id
Syntax
ppk-id ppk-id value value-string format {ascii | hex} [hash | hash2 | custom]
no ppk-id ppk-id
Context
[Tree] (config>ipsec>ppk-list ppk-id)
Full Context
configure ipsec ppk-list ppk-id
Description
This command configures the attributes for a PPK entry within the list.
The no form of this command deletes the PPK entry from the list.
Parameters
- ppk-id
- Specifies a unique ID for the PPK, up to 64 characters.
- value-string
- Specifies the PPK value.
- ascii
- Keyword to specify that the PPK value is formatted as an ASCII string, up to 64 characters.
- hex
- Keyword that specifies the PPK value is formatted as a hexadecimal string, up to 128 hex nibbles.
- hash
- Keyword that specifies the key is entered in an encrypted form. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, cleartext form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- hash2
- Keyword that specifies the key is entered in a more complex encrypted form that involves more variables than the key value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, cleartext form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- custom
- Keyword that specifies the custom encryption to the management interface.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppk-list
ppk-list
Syntax
ppk-list ppk-list-name [create]
no ppk-list ppk-list-name
Context
[Tree] (config>ipsec ppk-list)
Full Context
configure ipsec ppk-list
Description
Commands in this context configure a list of Post-quantum Preshared Keys (PPKs) to use for IKEv2 authentication, as described in RFC 8784.
The no form of this command deletes the PPK list.
Parameters
- ppk-list-name
- Specifies the name of the PPK list, up to 32 characters.
- create
- Keyword to create the PPK list.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppk-list
Syntax
ppk-list ppk-list-name
no ppk-list
Context
[Tree] (config>ipsec>tnl-temp ppk-list)
Full Context
configure ipsec tunnel-template ppk-list
Description
This command specifies a PPK list to use in the tunnel template, which represents a list of PPKs available for the IPsec gateway. The actual PPK to use depends on the tunnel initiator.
The no form of this command removes the PPK list from the tunnel template.
Default
no ppk-list
Parameters
- ppk-list-name
- Specifies the name of the PPK list, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppk-required
ppk-required
Syntax
[no] ppk-required
Context
[Tree] (config>ipsec>ike-policy ppk-required)
Full Context
configure ipsec ike-policy ppk-required
Description
This command configures the mandatory use of PPKs for the IKEv2 key derivation process in the IKE policy.
The no form of this command configures the use of PPKs for IKEv2 as optional. The router can fall back to derive keys without PPK.
Default
no ppk-required
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
ppp
ppp
Syntax
ppp
Context
[Tree] (config>subscr-mgmt>loc-user-db ppp)
Full Context
configure subscriber-mgmt local-user-db ppp
Description
Commands in this context configure PPP host parameters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
ppp
Context
[Tree] (config>router>l2tp>group ppp)
[Tree] (config>service>vprn>l2tp>group ppp)
[Tree] (config>router>l2tp>group>tunnel ppp)
[Tree] (config>service>vprn>l2tp>group>tunnel ppp)
Full Context
configure router l2tp group ppp
configure service vprn l2tp group ppp
configure router l2tp group tunnel ppp
configure service vprn l2tp group tunnel ppp
Description
This command configures PPP for the L2TP tunnel group.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
[no] ppp [lcp] [pap] [ chap] [ipcp] [ ipv6cp] [other]
Context
[Tree] (debug>router>l2tp>packet ppp)
[Tree] (debug>router>l2tp>group>packet ppp)
[Tree] (debug>router>l2tp>assignment-id>packet ppp)
[Tree] (debug>router>l2tp>peer>packet ppp)
Full Context
debug router l2tp packet ppp
debug router l2tp group packet ppp
debug router l2tp assignment-id packet ppp
debug router l2tp peer packet ppp
Description
This command selects protocol for PPP packet debugging.
The no form of this command disables the protocols selection for PPP packet debugging.
Parameters
- lcp
-
Specifies the LCP protocol.
- pap
-
Specifies the PAP protocol.
- chap
-
Specifies the CHAP protocol.
- ipcp
-
Specifies the IPCP protocol.
- ipv6cp
-
Specifies the IPv6CP protocol.
- other
-
Specifies any other protocol.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
[no] ppp
Context
[Tree] (debug>service>id ppp)
Full Context
debug service id ppp
Description
This command enables and configures PPP debugging.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
ppp [terminate-only]
no ppp
Context
[Tree] (debug>service>id>ppp>event ppp)
Full Context
debug service id ppp event ppp
Description
This command enables debugging for PPP events.
Parameters
- terminate-only
-
Enables debugging for terminate-only PPP events.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
ppp [lcp] [pap] [chap] [ ipcp]
no ppp
Context
[Tree] (debug>service>id>ppp>packet ppp)
Full Context
debug service id ppp packet ppp
Description
This command enables debugging for specific PPP packets
Parameters
- lcp
-
Enables debugging for LCP packets.
- pap
-
Enables debugging for PAP packets.
- chap
-
Enables debugging for CHAP packets.
- ipcp
-
Enables debugging for IPCP packets.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
ppp
Context
[Tree] (debug>call-trace ppp)
Full Context
debug call-trace ppp
Description
Commands in this context set up call trace debugging for Point-to-Point Protocol sessions.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp
Syntax
ppp [lcp] [pap] [ chap] [ipcp] [ipv6cp] [ipv6]
Context
[Tree] (debug>subscr-mgmt>vrgw>brg>pppoe-client>brg-id ppp)
Full Context
debug subscriber-mgmt vrgw brg pppoe-client brg-id ppp
Description
This command specifies which messages in PPP setup are tracked by debugging. If no messages are specified, they are all tracked. LCP Echo Request and Echo Response are never shown during debugging.
Parameters
- lcp
-
Tracks lcp messages during debugging.
- pap
-
Tracks pap messages during debugging.
- chap
-
Tracks chap messages during debugging.
- ipcp
-
Tracks ipcp messages during debugging.
- ipv6cp
-
Tracks ipv6cp messages during debugging.
- ipv6
-
Tracks ipv6 messages during debugging.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-authentication
ppp-authentication
Syntax
ppp-authentication {pap | chap | pref-chap | pref-pap}
no ppp-authentication
Context
[Tree] (config>subscr-mgmt>ppp-policy ppp-authentication)
Full Context
configure subscriber-mgmt ppp-policy ppp-authentication
Description
This command configures the PPP protocol used to authenticate the PPP session.
Default
ppp-authentication pref-chap
Parameters
- pap
-
Specifies to always use PAP to authenticate the sessions.
- chap
-
Specifies to always use CHAP to authenticate the sessions.
- pref-chap
-
Specifies to attempt to use CHAP and if it fails, use PAP.
- pref-pap
-
Specifies to attempt to use PAP and if it fails, use CHAP.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-chap-challenge-length
ppp-chap-challenge-length
Syntax
ppp-chap-challenge-length min minimum-length max maximum-length
no ppp-chap-challenge-length
Context
[Tree] (config>subscr-mgmt>ppp-policy ppp-chap-challenge-length)
Full Context
configure subscriber-mgmt ppp-policy ppp-chap-challenge-length
Description
This command configures the minimum and maximum length of a PPP Chap Challenge.
When the Chap Challenge is exactly 16 bytes, it is send in the [60] CHAP-Challenge RADIUS attribute and copied in the RADIUS Authenticator field from the RADIUS Access Request.
Default
ppp-chap-challenge-length min 32 max 64
Parameters
- min minimum-length
-
Specifies the minimum PPP CHAP challenge length.
- max maximum-length
-
Specifies the maximum PPP CHAP challenge length.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-initial-delay
ppp-initial-delay
Syntax
[no] ppp-initial-delay
Context
[Tree] (config>subscr-mgmt>ppp-policy ppp-initial-delay)
Full Context
configure subscriber-mgmt ppp-policy ppp-initial-delay
Description
This command delays the sending of an LCP-configure request after the discovery phase by 40 – 60 milliseconds.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-mtu
ppp-mtu
Syntax
ppp-mtu mtu-bytes
no ppp-mtu
Context
[Tree] (config>subscr-mgmt>ppp-policy ppp-mtu)
Full Context
configure subscriber-mgmt ppp-policy ppp-mtu
Description
This command configures the maximum PPP MTU size.
Parameters
- mtu-bytes
-
Specifies the maximum PPP MTU size.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-options
ppp-options
Syntax
ppp-options
Context
[Tree] (config>subscr-mgmt>ppp-policy ppp-options)
Full Context
configure subscriber-mgmt ppp-policy ppp-options
Description
Commands in this context configure PPP options.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-policy
ppp-policy
Syntax
ppp-policy ppp-policy-name [create]
no ppp-policy ppp-policy-name
Context
[Tree] (config>subscr-mgmt ppp-policy)
Full Context
configure subscriber-mgmt ppp-policy
Description
This command configures a PPP policy. These policies are referenced from interfaces configured for PPP. Multiple PPP policies may be configured.
The default policy cannot be modified or deleted.
Default
ppp-policy default
Parameters
- ppp-policy-name
-
Specifies the PPP policy name, up to 32 characters.
- create
-
Keyword used to create the entity. The create keyword requirement can be enabled/disabled in the environment>create context.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-policy-parameters
ppp-policy-parameters
Syntax
ppp-policy-parameters
Context
[Tree] (config>subscr-mgmt>loc-user-db>ppp>host ppp-policy-parameters)
Full Context
configure subscriber-mgmt local-user-db ppp host ppp-policy-parameters
Description
This command enables the context to configure PPP policy parameters to override the values from the host associated with the PPP policy.
The PPP host uses the values configured in the PPP policy under the group interface. It is possible to use this command to override the values from the host associated with the PPP policy. Matching a pattern on the subscriber MAC address to limit the number of sessions per MAC address is possible.
When a value is configured, the system overrides that particular PPP policy parameter. The absence of specific parameters means no overriding is performed.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-sub-id-key
ppp-sub-id-key
Syntax
ppp-sub-id-key sub-id-key [sub-id-key]
no ppp-sub-id-key
Context
[Tree] (config>subscr-mgmt>auto-sub-id-key ppp-sub-id-key)
Full Context
configure subscriber-mgmt auto-sub-id-key ppp-sub-id-key
Description
This command enables certain fields to become the base for auto-generation of default sub-id name. The sub-id name is auto-generated if there is not a more specific method available. Examples of these specific methods would be a default sub-id name as a sap-id, a preconfigured static string or explicit mappings based on RADIUS/LUDB returned strings.
In case that a more specific sub-id name generation method is not available and the auto-id keyword is defined under the def-sub-id hierarchy, the sub-id name is generated by concatenating fields defined in this command separated by a "|” character.
The maximum length of the auto-generated sub-id name is 64 characters while the concatenation of subscriber identification fields can exceed 64 characters. Subscriber host instantiation fails if the sub-id name is based on subscriber identification fields whose concatenated length exceeds 64 characters. Failing the host creation rather than truncating the sub-id name on a 64 character boundary prevents collision of sub-ids (subscriber name duplication).
In case that a more specific sub-id name generation method is not available and the auto-id keyword is not defined under the def-sub-id hierarchy, the sub-id name is a random 10 character encoded string based on the fields defined under this command.
There is only one set of identification fields allowed per host type (IPoE or PPP) per chassis.
The no form of this command reverts to the default.
Default
ppp-sub-id-key mac sap-id session-id
Parameters
- sub-id-key
-
Specifies the auto-generated sub-id keys for PPP hosts.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-user-db
ppp-user-db
Syntax
ppp-user-db local-user-db-name
no ppp-user-db
Context
[Tree] (config>service>vpls ppp-user-db)
Full Context
configure service vpls ppp-user-db
Description
This command enabled access to LUDB for PPPoE and PPPoEoA v4and v6 hosts under the capture SAP. The name of this local user database must match the name of local user database configured under the config>service>vprn/ies>sub-if>grp-if>pppoe hierarchy.
The no form of this command reverts to the default.
Parameters
- local-user-db
-
Specifies the name of the local-user-database, up to 256 characters.
Platforms
All
ppp-user-name
ppp-user-name
Syntax
ppp-user-name append domain-name
ppp-user-name default-domain domain-name
ppp-user-name replace domain-name
ppp-user-name strip
no ppp-user-name
Context
[Tree] (config>subscr-mgmt>auth-plcy ppp-user-name)
Full Context
configure subscriber-mgmt authentication-policy ppp-user-name
Description
This command specifies the domain name manipulation action to perform on the PAP/CHAP user name prior to authentication.
The no form of this command reverts to the default.
Default
The PAP/CHAP user name is not changed.
Parameters
- append domain-name
-
Appends an "@” delimiter followed by the specified domain-name to the PAP/CHAP user name, independent if a domain name is already present.
- default-domain domain-name
-
Appends an "@” delimiter followed by the specified domain-name to the PAP/CHAP user name only if a domain name is not already present.
- replace domain-name
-
Replaces the string after the "@” delimiter in the PAP/CHAP user name with the specified domain-name.
- strip
-
Removes the "@” delimiter and all subsequent characters from the PAP/CHAP user name.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe
pppoe
Syntax
[no] pppoe
Context
[Tree] (config>service>ies>sub-if>grp-if pppoe)
[Tree] (config>service>vprn>sub-if>grp-if pppoe)
Full Context
configure service ies subscriber-interface group-interface pppoe
configure service vprn subscriber-interface group-interface pppoe
Description
Commands in this context configure PPPoE parameters.
The no form of this command reverts all PPPoE parameters from the PPPoE context to their defaults.
Default
pppoe
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe
Syntax
pppoe type direction {ingress | egress} script name
no pppoe type direction {ingress | egress}
Context
[Tree] (config>python>py-policy pppoe)
Full Context
configure python python-policy pppoe
Description
This command specifies the python-script for the specified PPPoE message type in the specified direction. Multiple pppoe command configuration are allowed in the same Python policy.
The no form of this command reverts to the default.
Parameters
- type
-
Specifies the message type.
- direction {ingress | egress}
-
Specifies whether the event is incoming or outgoing. The system only invokes the configured script for the specified packet type in the specified direction.
- script
-
Specifies the name of the Python script, up to 32 characters, that is used to handle the specified message.
Platforms
All
pppoe
Syntax
pppoe service-id
no pppoe
Context
[Tree] (config>service>vprn>if>sap>fwd-wholesale pppoe)
[Tree] (config>service>vprn>sub-if>grp-if>sap>fwd-wholesale pppoe)
Full Context
configure service vprn interface sap fwd-wholesale pppoe
configure service vprn subscriber-interface group-interface sap fwd-wholesale pppoe
Description
This command specifies that PPPoE packets on ingress on Ethertypes 0x8863 and 0x8864 are redirected to the specified service. The service referred to by svc-id must be an Epipe service. Redirection to VC-switching Epipe services is not supported.
The no form of this command removes the redirect.
Parameters
- service-id
-
Specifies the service ID of the Epipe to which packets are redirected.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe
Syntax
pppoe service-id
no pppoe
Context
[Tree] (config>service>ies>if>sap>fwd-wholesale pppoe)
[Tree] (config>service>ies>sub-if>grp-if>sap>fwd-wholesale pppoe)
Full Context
configure service ies interface sap fwd-wholesale pppoe
configure service ies subscriber-interface group-interface sap fwd-wholesale pppoe
Description
This command specifies that PPPoE packets on ingress on Ethertypes 0x8863 and 0x8864 will be redirected to the specified service. The service referred to by svc-id must be an Epipe service. Redirection to VC-switching Epipe services is not supported.
The no form of this command removes the redirect.
Parameters
- service-id
-
Specifies the service ID of the Epipe to which packets are redirected.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe
Syntax
pppoe origin
Context
[Tree] (config>li>x-interfaces>correlation-id pppoe)
Full Context
configure li x-interfaces correlation-id pppoe
Description
This command specifies the type of RADIUS accounting session ID to use for PPPoE subscriber correlation.
Default
host
Parameters
- origin
-
Specifies the correlation identifiers origin for PPPoE.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
pppoe
Syntax
[no] pppoe
Context
[Tree] (config>redundancy>multi-chassis>peer>sync>subscriber-mgmt pppoe)
Full Context
configure redundancy multi-chassis peer sync subscriber-mgmt pppoe
Description
This command configures the router to synchronize subscriber management PPPoE information with the multi-chassis peer.
The no form of this command disables the router from synchronizing subscriber management PPPoE information with the multi-chassis peer.
Default
no pppoe
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-access-method
pppoe-access-method
Syntax
pppoe-access-method {none | padi | pap-chap}
no pppoe-access-method
Context
[Tree] (config>subscr-mgmt>auth-plcy pppoe-access-method)
Full Context
configure subscriber-mgmt authentication-policy pppoe-access-method
Description
This command indicates the authentication method used towards the RADIUS server in case the policy is used for PPPoE.
The no form of this command reverts to the default.
Parameters
- none
-
Indicates that the client is authenticated by the local user database defined under the group interface and not through RADIUS.
- padi
-
Indicates that the client is authenticated by RADIUS as soon as the PADI packet comes in (there is no PPP authentication done in the session in this case).
- pap-chap
-
Indicates that the RADIUS authentication of the client is delayed until the authentication protocol phase in the PPP session (PAP or CHAP) and authentication is performed with the user name and PAP password / CHAP response supplied by the client.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-client
pppoe-client
Syntax
pppoe-client
Context
[Tree] (debug>subscr-mgmt>vrgw>brg pppoe-client)
Full Context
debug subscriber-mgmt vrgw brg pppoe-client
Description
Commands in this context debug pppoe-client information.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-client-policy
pppoe-client-policy
Syntax
pppoe-client-policy pppoe-client-policy-name [create]
no pppoe-client-policy pppoe-client-policy-name
Context
[Tree] (config>subscr-mgmt pppoe-client-policy)
Full Context
configure subscriber-mgmt pppoe-client-policy
Description
This command provisions a policy containing a set of parameters to be used to configure a PPPoE client.
The no form of this command removes the policy from the system. The policy can only be removed when it is not in use.
Parameters
- pppoe-client-policy-name
-
Specifies a unique name for the policy.
- create
-
Mandatory keyword when creating a new policy.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-lac
pppoe-lac
Syntax
pppoe-lac max-nr-of-sessions
no pppoe-lac
Context
[Tree] (config>subscr-mgmt>sla-profile>session-limits pppoe-lac)
[Tree] (config>subscr-mgmt>sub-profile>session-limits pppoe-lac)
Full Context
configure subscriber-mgmt sla-profile session-limits pppoe-lac
configure subscriber-mgmt sub-profile session-limits pppoe-lac
Description
This command configures the maximum number of PPPoE L2TP LAC sessions per SLA profile instance or per subscriber.
The no form of this command removes the maximum number of PPPoE L2TP LAC sessions limit.
Parameters
- max-nr-of-sessions
-
Specifies the maximum number of PPPoE L2TP LAC sessions.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-local
pppoe-local
Syntax
pppoe-local max-nr-of-sessions
no pppoe-local
Context
[Tree] (config>subscr-mgmt>sla-profile>session-limits pppoe-local)
[Tree] (config>subscr-mgmt>sub-profile>session-limits pppoe-local)
Full Context
configure subscriber-mgmt sla-profile session-limits pppoe-local
configure subscriber-mgmt sub-profile session-limits pppoe-local
Description
This command configures the maximum number of PPPoE local-terminated sessions (PTA) per SLA profile instance or per subscriber.
The no form of this command removes maximum number of PPPoE local-terminated sessions (PTA) limit.
Parameters
- max-nr-of-sessions
-
Specifies the maximum number of PPPoE local-terminated sessions (PTA).
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-overall
pppoe-overall
Syntax
pppoe-overall max-nr-of-sessions
no pppoe-overall
Context
[Tree] (config>subscr-mgmt>sla-profile>session-limits pppoe-overall)
[Tree] (config>subscr-mgmt>sub-profile>session-limits pppoe-overall)
Full Context
configure subscriber-mgmt sla-profile session-limits pppoe-overall
configure subscriber-mgmt sub-profile session-limits pppoe-overall
Description
This command configures the maximum number of PPPoE sessions per SLA profile instance or per subscriber.
The no form of this command removes the maximum number of PPPoE sessions limit.
Parameters
- max-nr-of-sessions
-
Specifies the maximum number of PPPoE sessions.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-policy
pppoe-policy
Syntax
pppoe-policy pppoe-policy-name
no pppoe-policy
Context
[Tree] (config>service>vpls>sap pppoe-policy)
Full Context
configure service vpls sap pppoe-policy
Description
This command references a pppoe-policy that defines session parameters (ppp-mtu, authentication options, and so on) during the session initiation phase. Normally, the PPPoE policy is referenced under the group-interface hierarchy. But with capture SAP is it not known at the session initiation phase to which group-interface the session belongs. This is why, with the capture SAP, the ppp-policy must be referenced directly under the capture SAP. The pppoe-policy referenced under the group-interface must be the same as the pppoe-policy referenced under the capture SAP. Otherwise the session will not come up.
The no form of this command reverts to the default.
Parameters
- pppoe-policy-name
-
Specifies the pppoe-policy name up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-python-policy
pppoe-python-policy
Syntax
pppoe-python-policy policy-name
no pppoe-python-policy
Context
[Tree] (config>service>vpls>sap pppoe-python-policy)
Full Context
configure service vpls sap pppoe-python-policy
Description
This command specified the Python policy for PPPoE packets sent/received on the capture SAP.
The no form of this command removes the policy name from the configuration.
Parameters
- policy-name
-
Specifies an existing Python policy name, up to 32 characters.
Platforms
All
pppoe-service-name
pppoe-service-name
Syntax
[no] pppoe-service-name
Context
[Tree] (config>subscr-mgmt>auth-policy>include-radius-attribute pppoe-service-name)
Full Context
configure subscriber-mgmt authentication-policy include-radius-attribute pppoe-service-name
Description
This command enables the generation of the pppoe-service-name RADIUS attribute.
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
pppoe-trace
pppoe-trace
Syntax
pppoe-trace [sap sap-id] [ mac ieee-address] circuit-id circuit-id [remote-id remote-id] [username user-name] [profile trace-profile-name] [trace-existing-sessions] [ max-jobs num] [name trace-name]
pppoe-trace [sap sap-id] mac ieee-address [circuit-id circuit-id] [remote-id remote-id] [username user-name] [profile trace-profile-name] [ trace-existing-sessions] [max-jobs num] [name trace-name]
pppoe-trace sap sap-id [mac ieee-address] [ circuit-id circuit-id] [remote-id remote-id] [username user-name] [profile trace-profile-name] [trace-existing-sessions] [max-jobs num] [name trace-name]
pppoe-trace [sap sap-id] [mac ieee-address] [circuit-id circuit-id] remote-id remote-id [username user-name] [ profile trace-profile-name] [trace-existing-sessions] [max-jobs num] [name trace-name]
pppoe-trace [sap sap-id] [ mac ieee-address] [circuit-id circuit-id] [remote-id remote-id] username user-name [profile trace-profile-name] [trace-existing-sessions] [max-jobs num] [name trace-name]
no pppoe-trace name trace-name
no pppoe-trace [sap sap-id] [ mac ieee-address] [circuit-id circuit-id] [remote-id remote-id] [username user-name]
Context
[Tree] (debug>call-trace>ppp pppoe-trace)
Full Context
debug call-trace ppp pppoe-trace
Description
This command enables tracing locally terminated or LAC PPPoE sessions specified by the configured parameters. At least one filter rule must be provisioned. This command can trace a single session or multiple sessions, and can use wildcard characters.
This command can be executed multiple times to start multiple traces. When rules overlap, such as for a wildcard SAP and a specific SAP, the rule that a specific trace is associated with cannot be guaranteed.
The no form of this command prevents new traces from being configured and terminates all trace jobs that were previously started using the trace command.
Parameters
- circuit-id
-
Specifies a circuit ID, up to 255 characters, that is used to filter sessions to trace.
- ieee-address
-
Specifies a MAC address that is used to identify a session to trace, in the format "ab:cd:ef:01:23:45”. A wildcard character can be used to match all remaining octets; for example, the format "ab:cd:ef:*” can be used to filter by OUI.
- user-name
-
Specifies a username, up to 32 characters, that is used to filter sessions to trace. A wildcard character (*) can be used at the beginning and at the end of the filter.
- num
-
Specifies the maximum number of jobs that may be started with this rule.
- remote-id
-
Specifies a remote ID, up to 255 characters, that is used to filter sessions to trace.
- sap-id
-
Specifies a SAP to trace. The following formats are accepted:
-
port/lag/pw-port:svlan.cvlan
-
port/lag/pw-port:vlan
-
port/lag/pw-port
-
port/lag/pw-port:vlan.*
-
port/lag/pw-port:* (also matches *.*)
-
- trace-existing-sessions
-
Specifies that existing PPPoE sessions are traced. If this parameter is not included, only new PPPoE sessions are traced.
- trace-name
-
Specifies the name, up to 32 characters, by which the trace is referenced.
- trace-profile-name
-
Specifies the name of the trace profile to be applied, up to 32 characters. The default parameters are used if a trace profile is not specified.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pppoe-user-db
pppoe-user-db
Syntax
pppoe-user-db local-user-db-name
no pppoe-user-db
Context
[Tree] (config>service>vpls pppoe-user-db)
Full Context
configure service vpls pppoe-user-db
Description
This command enabled access to LUDB for PPPoE and PPPoEoA v4and v6 hosts under the capture SAP. The name of this LUDB must match the name of the LUDB configured under the config>service>vprn/ies>sub-if>grp-if>pppoe hierarchy.
The no form of this command reverts to the default.
Parameters
- local-user-db
-
Specifies the name of the local user database, up to 256 characters.
Platforms
All
pppoe-user-db
Syntax
pppoe-user-db ludb-name
no pppoe-user-db
Context
[Tree] (config>service>vpls>sap pppoe-user-db)
Full Context
configure service vpls sap pppoe-user-db
Description
This command enables LUDB authentication on capture SAPs for PPPoE(oA) clients. If this command is configured along with the authentication-policy command (RADIUS authentication), then the authentication-policy command takes precedence.
The no form of this command reverts to the default.
Parameters
- ludb-name
-
Specifies the name of the local user database up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pptp
pptp
Syntax
[no] pptp
Context
[Tree] (config>service>nat>up-nat-policy>alg pptp)
[Tree] (config>service>nat>nat-policy>alg pptp)
Full Context
configure service nat up-nat-policy alg pptp
configure service nat nat-policy alg pptp
Description
This command enables PPTP ALG.
The call-id is captured in the outgoing call management messages and along with the source IP address and the source TCP, is translated by NAT. Once the PPTP call is established, the call-id in the associated GRE packet in the incoming direction (from outside to inside) is correspondingly translated so that it matches the call-id mapping established during the call establishment phase. The call IDs used in the mappings are selected randomly and they try to honor parity (odds/even).
A PPTP session can be initiated only from the inside of NAT.
GRE traffic is allowed through NAT only if the corresponding mapping exists. This mapping is created during the call negotiation phase.
There can be seven calls (GRE tunnels) per control session.
Default
no pptp
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
pre-auth-policy
pre-auth-policy
Syntax
pre-auth-policy policy-name
no pre-auth-policy
Context
[Tree] (config>subscr-mgmt>loc-user-db>ppp>host pre-auth-policy)
Full Context
configure subscriber-mgmt local-user-db ppp host pre-auth-policy
Description
This command configures the RADIUS pre-authentication policy to use to authenticate the PPP host.
The no form of this command reverts to the default.
Parameters
- policy-name
-
Specifies the pre-authentication policy of the host, up to 32 characters.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
pre-login-message
pre-login-message
Syntax
pre-login-message login-text-string [name]
no pre-login-message
Context
[Tree] (config>system>login-control pre-login-message)
Full Context
configure system login-control pre-login-message
Description
This command configures a message to display before logging in to the router using Telnet, SSH, or the console port.
Only one message can be configured. If a new pre-login message is configured, the new message overwrites the previous message.
The no form of this command removes the pre-login message.
Default
no pre-login-message
Parameters
- login-text-string
-
Specifies the pre-login message text, up to 900 characters. Any printable, 7-bit ASCII characters can be used. If the string contains special characters (#, ?, space), the entire string must be enclosed within double quotes. Some special characters can be used to format the message text. Use the newline (\n) character to create multiline messages. A newline (\n) character in the message moves to the beginning of the next line by sending ASCII/UTF-8 characters 0xA (LF) and 0xD (CR) to the client terminal. A carriage return (\r) character in the message sends the ASCII/UTF-8 character 0xD (CR) to the client terminal.
- name
-
Displays the configured system name before the pre-login message. To remove the system name from the pre-login message, remove the current message and configure a new message without using the name parameter.
Platforms
All
pre-shared-key
pre-shared-key
Syntax
pre-shared-key pre-shared-key-index [encryption-type encryption-type] [create]
no pre-shared-key pre-shared-key-index
Context
[Tree] (config>macsec>conn-assoc>static-cak pre-shared-key)
Full Context
configure macsec connectivity-association static-cak pre-shared-key
Description
This command specifies the pre-shared key used to enable MACsec using static connectivity association key (CAK) security mode. This command also specifies the encryption algorithm used for encrypting the SAK.
A pre-shared key includes a connectivity association key name (CKN) and a connectivity association key (CAK). The pre-shared key-the CKN and CAK-must match on both ends of a link.
A pre-shared key is configured on both devices at each end of point-to-point link to enable MACsec using static CAK security mode. The MACsec Key Agreement (MKA) protocol is enabled after the successful MKA liveliness negotiation.
The encryption-type is used for encrypting the SAK and authenticating the MKA packet. The symmetric encryption key SAK (Security Association Key) needs to be encrypted (wrapped) via the MKA protocols. The AES key is derived via pre-shared-key.
The no form of this command removes the index.
Parameters
- pre-shared-key-index
-
Specifies the index of this pre-shared-key.
- encryption-type
-
Specifies the type of encryption.
- create
-
Mandatory to create an entry.
Platforms
All
pre-shared-key
Syntax
pre-shared-key key [hash | hash2 | custom]
no pre-shared-key
Context
[Tree] (config>ipsec>client-db>client>credential pre-shared-key)
Full Context
configure ipsec client-db client credential pre-shared-key
Description
This command specifies a pre-shared key used to authenticate peers.
The no form of this command reverts to the default.
Default
no pre-shared-key
Parameters
- key
-
An ASCII string to use as the pre-shared key for dynamic keying. When the hash or hash2 parameters are not used, the key is a clear text key; otherwise, the key text is encrypted.
- hash
-
Specifies the key is entered in an encrypted form. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- hash2
-
Specifies the key is entered in a more complex encrypted form that involves more variables than the key value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- custom
-
Specifies the custom encryption to management interface.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
pre-shared-key
Syntax
pre-shared-key key [hash | hash2 | custom]
no pre-shared-key
Context
[Tree] (config>service>vprn>if>sap>ipsec-tunnel>dynamic-keying pre-shared-key)
[Tree] (config>service>ies>if>ipsec>ipsec-tunnel>dyn pre-shared-key)
[Tree] (config>service>ies>if>sap>ipsec-gw pre-shared-key)
[Tree] (config>service>vprn>if>sap>ipsec-gw pre-shared-key)
[Tree] (config>ipsec>trans-mode-prof>dyn pre-shared-key)
[Tree] (config>router>if>ipsec>ipsec-tunnel>dyn pre-shared-key)
[Tree] (config>service>vprn>if>ipsec>ipsec-tunnel>dyn pre-shared-key)
Full Context
configure service vprn interface sap ipsec-tunnel dynamic-keying pre-shared-key
configure service ies interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
configure service ies interface sap ipsec-gw pre-shared-key
configure service vprn interface sap ipsec-gw pre-shared-key
configure ipsec ipsec-transport-mode-profile dynamic-keying pre-shared-key
configure router interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
configure service vprn interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
Description
This command configures the pre-shared key for authentication.
The no form of this command reverts to the default.
Default
no pre-shared-key
Parameters
- key
-
Specifies an ASCII string to use as the pre-shared key for dynamic keying. When the hash or hash2 parameters are not used, the key is a clear text key; otherwise, the key text is encrypted.
- hash
-
Specifies the key is entered in an encrypted form. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- hash2
-
Specifies the key is entered in a more complex encrypted form that involves more variables than the key value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
- custom
-
Specifies the custom encryption to management interface.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure service vprn interface sap ipsec-tunnel dynamic-keying pre-shared-key
- configure service vprn interface sap ipsec-gw pre-shared-key
- configure service ies interface sap ipsec-gw pre-shared-key
- configure ipsec ipsec-transport-mode-profile dynamic-keying pre-shared-key
VSR
- configure service ies interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
- configure service vprn interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
- configure router interface ipsec ipsec-tunnel dynamic-keying pre-shared-key
pre-update-time
pre-update-time
Syntax
pre-update-time [days days] [ hrs hours] [min minutes] [sec seconds]
Context
[Tree] (config>system>security>pki>ca-prof>auto-crl-update pre-update-time)
Full Context
configure system security pki ca-profile auto-crl-update pre-update-time
Description
This command specifies the pre-download time for next-update-based update.
Default
pre-update-time hrs 1
Parameters
- days
-
Specifies the time period, in days, prior to the next update time of the current CRL.
- hours
-
Specifies the time period, in hours, prior to the next update time of the current CRL.
- minutes
-
Specifies the time period, in minutes, prior to the next update time of the current CRL.
- seconds
-
Specifies the time period, in seconds, prior to the next update time of the current CRL.
Platforms
All
prec
prec
Syntax
prec ip-prec-value [fc fc-name] [priority {high | low}]
no prec ip-prec-value
Context
[Tree] (config>qos>sap-ingress prec)
Full Context
configure qos sap-ingress prec
Description
This command explicitly sets the forwarding class or enqueuing priority when a packet is marked with an IP precedence value ( ip-prec-value). Adding an IP precedence rule on the policy forces packets that match the specified ip-prec-value to override the forwarding class and enqueuing priority based on the parameters included in the IP precedence rule.
When the forwarding class is not specified in the rule, a matching packet preserves (or inherits) the existing forwarding class derived from earlier matches in the classification hierarchy.
When the enqueuing priority is not specified in the rule, a matching packet preserves (or inherits) the existing enqueuing priority derived from earlier matches in the classification hierarchy.
The ip-prec-value is derived from the most significant three bits in the IP header ToS byte field (precedence bits). The three precedence bits define eight Class-of-Service (CoS) values commonly used to map packets to per-hop Quality of Service (QoS) behavior. The precedence bits are also part of the DiffServ Code Point (DSCP) method of mapping packets to QoS behavior. The DSCP uses the most significant six bits in the IP header ToS byte and so overlaps with the precedence bits. Both IP precedence and DSCP classification rules are supported. DSCP rules have a higher match priority than IP precedence rules and where a dscp-name DSCP value overlaps an ip-prec-value, the DSCP rule takes precedence.
The no form of this command removes the explicit IP precedence classification rule from the SAP ingress policy. Removing the rule on the policy immediately removes the rule on all ingress SAPs using the policy.
Parameters
- ip-prec-value
-
The ip-prec-value is a required parameter that specifies the unique IP header ToS byte precedence bits value that will match the IP precedence rule. If the command is executed more than once with the same ip-prec-value, the previous forwarding class and enqueuing priority is completely overridden by the new parameters or defined to be inherited when a forwarding class or enqueuing priority parameter is missing.
A maximum of eight IP precedence rules are allowed on a single policy.
The precedence is evaluated from the lowest to highest value.
- fc fc-name
-
The value given for the fc-name parameter must be one of the predefined forwarding classes in the system. Specifying the fc-name is optional. When a packet matches the rule, the forwarding class is only overridden when the fc fc-name parameter is defined on the rule. If the packet matches and the forwarding class is not explicitly defined in the rule, the forwarding class is inherited based on previous rule matches.
The subclass-name parameter is optional and used with the fc-name parameter to define a pre-existing subclass. The fc-name and subclass-name parameters must be separated by a period (.). If subclass-name does not exist in the context of fc-name, an error will occur. If subclass-name is removed using the no fc fc-name.subclass-name force command, the default-fc command will automatically drop the subclass-name and only use fc-name (the parent forwarding class for the subclass) as the forwarding class.
- priority
-
The priority parameter overrides the default enqueuing priority for all packets received on an ingress SAP using this policy that match this rule. Specifying the priority is optional. When a packet matches the rule, the enqueuing priority is only overridden when the priority parameter is defined on the rule. If the packet matches and priority is not explicitly defined in the rule, the enqueuing priority is inherited based on previous rule matches.
- high
-
This parameter is used in conjunction with the priority parameter. Setting the enqueuing parameter to high for a packet increases the likelihood of enqueuing the packet when the ingress queue is congested. Ingress enqueuing priority only affects ingress SAP queuing. When the packet is placed in a buffer on the ingress queue, the significance of the enqueuing priority is lost.
- low
-
This parameter is used in conjunction with the priority parameter. Setting the enqueuing parameter to low for a packet decreases the likelihood of enqueuing the packet when the ingress queue is congested. Ingress enqueuing priority only affects ingress SAP queuing. When the packet is placed in a buffer on the ingress queue, the significance of the enqueuing priority is lost.
Platforms
All
prec
Syntax
prec {ip-prec-value | in-profile ip-prec-value out-profile ip-prec-value [ exceed-profile ip-prec-value]}
no prec
Context
[Tree] (config>qos>sap-egress>fc prec)
Full Context
configure qos sap-egress fc prec
Description
This command defines a value to be used for remarking packets for the specified FC. If the optional in/out/exceed-profile is specified, the command will remark different IP precedence values depending on whether the packet was classified to be in, exceed, or out-of-profile. All inplus-profile traffic is marked with the same value as in-profile traffic.
Parameters
- ip-prec-value
-
This parameter specifies the IP precedence to be used to remark all traffic.
- exceed-profile ip-prec-value
-
This optional parameter specifies the IP precedence to be used to remark traffic that is exceed-profile. If not specified, this defaults to the same value configured for the out-profile parameter.
- in-profile ip-prec-value
-
This parameter specifies the IP precedence to be used to remark traffic that is in-profile.
- out-profile ip-prec-value
-
This parameter specifies the IP precedence to be used to remark traffic that is out-of-profile.
Platforms
All
prec
Syntax
prec ip-prec-value [fc fc-name] [profile {in | out | exceed | inplus}]
no prec ip-prec-value
Context
[Tree] (config>qos>sap-egress prec)
Full Context
configure qos sap-egress prec
Description
This command defines a specific IP precedence value that must be matched to perform the associated reclassification actions. If an egress packet on the SAP matches the specified IP precedence value, the forwarding class, or profile behavior may be overridden. By default, the forwarding class and profile of the packet is derived from ingress classification and profiling functions.
The IP precedence bits used to match against precedence reclassification rules come from the Type of Service (ToS) field within the IPv4 header. If the packet does not have an IPv4 header, precedence-based matching is not performed.
The reclassification actions from a precedence reclassification rule may be overridden by a DSCP or IP flow matching event.
The fc keyword is optional. When specified, the egress classification rule will overwrite the forwarding class derived from ingress. The new forwarding class is used for egress remarking and queue mapping decisions. If a DSCP, ipv6-criteria, or ip-criteria match occurs after the IP precedence match, the new forwarding class may be overridden by the higher priority match actions. If the higher priority match actions do not specify a new fc, the fc from the IP precedence match will be used.
The profile keyword is optional. When specified, the egress classification rule will overwrite the profile of the packet derived from ingress. The new profile value is used for egress remarking and queue congestion behavior. If a DSCP, IPv6 criteria, or IP criteria match occurs after the IP precedence match, the new profile may be overridden by the higher priority match actions. If the higher priority match actions do not specify a new profile, the profile from the IP precedence match will be used.
The no form of this command removes the reclassification rule from the SAP egress QoS policy.
Parameters
- fc fc-name
-
This keyword is optional. When specified, packets matching the IP precedence value will be explicitly reclassified to the forwarding class specified as fc-name regardless of the ingress classification decision. The explicit forwarding class reclassification may be overwritten by a higher priority DSCP, IPv6 criteria, or IP criteria reclassification match. The FC name defined must be one of the eight forwarding classes supported by the system. To remove the forwarding class reclassification action for the specified precedence value, the prec command must be re-executed without the fc parameter defined.
- profile {in | out | exceed | inplus}
-
This keyword is optional. When specified, packets matching the IP precedence value will be explicitly reclassified to the specified profile regardless of the ingress profiling decision. The explicit profile reclassification may be overwritten by a higher priority DSCP, IPv6 criteria, or IP criteria reclassification match. To remove the profile reclassification action for the specified precedence value, the prec command must be re-executed without the profile parameter defined.
- in
-
Specifies that any packets matching the reclassification rule will be treated as in-profile by the egress forwarding plane.
- out
-
Specifies that any packets matching the reclassification rule will be treated as out-of-profile by the egress forwarding plane.
- exceed
-
Specifies that any packets matching the reclassification rule will be treated as exceed-profile by the egress forwarding plane.
- inplus
-
Specifies that any packets matching the reclassification rule will be treated as inplus-profile by the egress forwarding plane.
Platforms
All
prec
Syntax
prec ip-prec-value fc fc-name profile {in | out | exceed | inplus}
no prec ip-prec-value
Context
[Tree] (config>qos>network>egress prec)
Full Context
configure qos network egress prec
Description
This command defines a specific IP precedence value that must be matched in order to perform the associated reclassification actions. If an egress packet on an IES/VPRN interface spoke SDP, on a CSC network interface in a VPRN, or network interface that the network QoS policy is applied to, matches the specified IP precedence value, the forwarding class and profile may be overridden.
By default, the forwarding class and profile of the packet is derived from ingress classification and profiling functions.
The IP precedence bits used to match against the reclassification rules come from the Type of Service (ToS) field within the IPv4 header or the Traffic Class field from the IPv6 header. If the packet does not have an IP header, IP precedence-based matching is not performed.
The configuration of egress prec classification and the configuration of an egress IP criteria or IPv6 criteria entry statement within a network QoS policy are mutually exclusive.
The IP precedence-based and DSCP-based reclassification are supported on a network interface, on a CSC network interface in a VPRN, and on a PW used in an IES or VPRN spoke interface.
This command will block the application of a network QoS policy with the egress reclassification commands to a spoke SDP part of a Layer 2 service. Conversely, this command will not allow the user to add the egress reclassification commands to a network QoS policy if it is being used by a Layer 2 spoke SDP.
The egress reclassification commands will only take effect if the redirection of the spoke SDP or CSC interface to use an egress port queue-group succeeds. For example, the following commands will succeed:
- config>service>vprn>if>
spoke-sdp>egress>qos network-policy-id port-redirect-group
queue-group-name instance instance-id
- config>service>ies>if>spoke-sdp>
egress>qos network-policy-id port-redirect-group queue-group-name
instance instance-id
- config>service>vprn>nw-if> qos network-policy-id port-redirect-group
queue-group-name instance instance-id
When the redirection command fails in CLI, the PW will use the network QoS policy assigned to the network IP interface; however, any reclassification in the network QoS policy applied to the network interface will be ignored.
The no form of this command removes the egress reclassification rule.
Parameters
- ip-prec-value
-
0 to 7
- fc fc-name
-
be, l2, af, l1, h2, ef, h1, nc
- profile {in | out | exceed | inplus}
-
The profile reclassification action is mandatory. When specified, packets matching the IP precedence value will be explicitly reclassified to the profile specified regardless of the ingress profiling decision. To remove the profile reclassification action for the specified IP precedence value, the no prec command must be executed.
This value may be overwritten by an explicit profile action in an DSCP reclassification match.
in - Specifies that any packets matching the reclassification rule will be treated as in-profile by the egress forwarding plane.
out - Specifies that any packets matching the reclassification rule will be treated as out-of-profile by the egress forwarding plane.
exceed - Specifies that any packets matching the reclassification rule will be treated as exceed-profile by the egress forwarding plane.
inplus - Specifies that any packets matching the reclassification rule will be treated as inplus-profile by the egress forwarding plane.
Platforms
All
precedence
precedence
Syntax
precedence {primary | secondary}
no precedence
Context
[Tree] (config>eth-tunnel>path precedence)
Full Context
configure eth-tunnel path precedence
Description
This command specifies the precedence to be used for the path. Only two precedence options are supported: primary and secondary.
The no form of this command sets the precedence to the default value.
Default
precedence secondary
Parameters
- primary | secondary
-
Specifies the path precedence as either primary or secondary.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
precedence
Syntax
precedence [precedence-value | primary]
no precedence
Context
[Tree] (config>service>epipe>spoke-sdp precedence)
[Tree] (config>service>ipipe>spoke-sdp precedence)
[Tree] (config>service>cpipe>spoke-sdp precedence)
Full Context
configure service epipe spoke-sdp precedence
configure service ipipe spoke-sdp precedence
configure service cpipe spoke-sdp precedence
Description
This command specifies the precedence of the SDP binding when there are multiple SDP bindings attached to one service endpoint. The value of zero can only be assigned to one SDP bind making it the primary SDP bind. When an SDP binding goes down, the next highest precedence SDP binding will begin to forward traffic.
The no form of this command returns the precedence value to the default.
Default
precedence 4
Parameters
- precedence-value
-
Specifies the spoke SDP precedence.
- primary
-
Assigns primary precedence to the spoke SDP.
Platforms
All
- configure service epipe spoke-sdp precedence
- configure service ipipe spoke-sdp precedence
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
- configure service cpipe spoke-sdp precedence
precedence
Syntax
precedence prec-value
precedence primary
no precedence
Context
[Tree] (config>service>epipe>spoke-sdp-fec precedence)
Full Context
configure service epipe spoke-sdp-fec precedence
Description
This command specifies the precedence of the SDP binding when there are multiple SDP bindings attached to one service endpoint. The value of zero can only be assigned to one SDP bind making it the primary SDP bind. When an SDP binding goes down, the next highest precedence SDP binding will begin to forward traffic.
The no form of this command returns the precedence value to the default.
Default
precedence 42
Parameters
- prec-value
-
Specifies the spoke SDP precedence.
- primary
-
Assigns primary precedence to this spoke SDP.
Platforms
All
precedence
Syntax
precedence [precedence-value | primary]
no precedence
Context
[Tree] (config>service>vpls>spoke-sdp precedence)
Full Context
configure service vpls spoke-sdp precedence
Description
This command configures the precedence of this SDP bind when there are multiple SDP binds attached to one service endpoint. When an SDP bind goes down, the next highest precedence SDP bind begins forwarding traffic.
Parameters
- precedence-value
-
Specifies the precedence of this SDP bind
- primary
-
Assigns this as the primary spoke-SDP
Platforms
All
precedence
Syntax
precedence {precedence-value | primary}
no precedence
Context
[Tree] (config>mirror>mirror-dest>spoke-sdp precedence)
Full Context
configure mirror mirror-dest spoke-sdp precedence
Description
This command indicates that the SDP is of type secondary with a specific precedence value or of type primary.
The mirror or LI service always uses the primary type as the active pseudowire and only switches to a secondary pseudowire when the primary is down. The mirror service switches the path back to the primary pseudowire when it is back up. The user can configure a timer to delay reverting back to primary or to never revert back.
If the active pseudowire goes down, the mirror service switches the path to a secondary sdp with the lowest precedence value. That is, secondary SDPs which are operationally up are considered in the order of their precedence value, 1 being the lowest value and 4 being the highest value. If the precedence value is the same, then the SDP with the lowest SDP ID is selected.
An explicitly named endpoint can have a maximum of one SAP and one ICB. Once a SAP is added to the endpoint, only one more object of type ICB SDP is allowed. An explicitly named endpoint, which does not have a SAP object, can have a maximum of four SDPs, which can include any of the following: a single primary SDP, one or many secondary SDPs with precedence, and a single ICB SDP.
An SDP is created with type secondary and with the lowest precedence value of 4.
Parameters
- precedence-value
-
Specifies the precedence of the SDP.
- primary
-
Specified that a special value of the precedence which assigns the SDP the lowest precedence and enables the revertive behavior.
Platforms
All
preempt
preempt
Syntax
[no] preempt
Context
[Tree] (config>service>ies>sub-if>grp-if>srrp preempt)
[Tree] (config>service>vprn>sub-if>grp-if>srrp preempt)
Full Context
configure service ies subscriber-interface group-interface srrp preempt
configure service vprn subscriber-interface group-interface srrp preempt
Description
When preempt is enabled, a newly initiated SRRP instance can overrides an existing Master SRRP instance if its priority value is higher than the priority of the current Master.
If preempt is disabled, an SRRP instance only becomes Master if the master down timer expires before an SRRP advertisement message is received from the adjacent SRRP enabled node.
The no form of this command reverts to the default.
Default
preempt
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preempt
Syntax
[no] preempt
Context
[Tree] (config>service>ies>if>ipv6>vrrp preempt)
Full Context
configure service ies interface ipv6 vrrp preempt
Description
The preempt mode value controls whether a specific backup virtual router preempts a lower priority master.
When preempt is enabled, the virtual router instance overrides any non-owner master with an "in use” message priority value less than the virtual router instance in-use priority value. If preempt is disabled, the virtual router only becomes master if the master down timer expires before a VRRP advertisement message is received from another virtual router.
The IP address owner will always become master when available. Preempt mode cannot be disabled on the owner virtual router.
The no form of this command disables preempt mode.
Default
preempt
Platforms
All
preempt
Syntax
[no] preempt
Context
[Tree] (config>service>ies>if>vrrp preempt)
Full Context
configure service ies interface vrrp preempt
Description
The preempt command provides the ability of overriding an existing non-owner master to the virtual router instance. Enabling preempt mode is almost required for proper operation of the base-priority and vrrp-policy-id definitions on the virtual router instance. If the virtual router cannot preempt an existing non-owner master, the effect of the dynamic changing of the in-use priority is greatly diminished.
The preempt command is only available in the non-owner vrrp virtual-router-id nodal context. The owner may not be preempted due to the fact that the priority of non-owners can never be higher than the owner. The owner will always preempt all other virtual routers when it is available.
Non-owner virtual router instances will only preempt when preempt is set and the current master has an in-use message priority value less than the virtual router instances in-use priority.
A master non-owner virtual router will only allow itself to be preempted when the incoming VRRP Advertisement message Priority field value is one of the following:
-
Greater than the virtual router in-use priority value
-
Equal to the in-use priority value and the source IP address (primary IP address) is greater than the virtual router instance primary IP address
The no form of this command prevents a non-owner virtual router instance from preempting another, less desirable virtual router. Use the preempt command to restore the default mode.
Default
preempt
Platforms
All
preempt
Syntax
[no] preempt
Context
[Tree] (config>service>vprn>if>ipv6>vrrp preempt)
[Tree] (config>service>vprn>if preempt)
Full Context
configure service vprn interface ipv6 vrrp preempt
configure service vprn interface preempt
Description
The preempt mode value controls whether a specific backup virtual router preempts a lower priority master.
When preempt is enabled, the virtual router instance overrides any non-owner master with an "in use” message priority value less than the virtual router instance in-use priority value. If preempt is disabled, the virtual router only becomes master if the master down timer expires before a VRRP advertisement message is received from another virtual router.
The IP address owner will always become master when available. Preempt mode cannot be disabled on the owner virtual router.
The default value for preempt mode is enabled.
Default
preempt
Platforms
All
preempt
Syntax
[no] preempt
Context
[Tree] (config>router>if>ipv6>vrrp preempt)
[Tree] (config>router>if>vrrp preempt)
Full Context
configure router interface ipv6 vrrp preempt
configure router interface vrrp preempt
Description
The preempt mode value controls whether a specific backup virtual router preempts a lower priority master.
When preempt is enabled, the virtual router instance overrides any non-owner master with an "in use” message priority value less than the virtual router instance in-use priority value. If preempt is disabled, the virtual router only becomes master if the master down timer expires before a VRRP advertisement message is received from another virtual router.
The IP address owner will always become master when available. Preempt mode cannot be disabled on the owner virtual router.
The default value for preempt mode is enabled.
Default
preempt
Platforms
All
preemption-timer
preemption-timer
Syntax
preemption-timer seconds
no preemption-timer
Context
[Tree] (config>router>rsvp preemption-timer)
Full Context
configure router rsvp preemption-timer
Description
This parameter configures the time in seconds a node holds to a reservation for which it triggered the soft preemption procedure.
The preempting node starts a separate preemption timer for each preempted LSP path. While this timer is on, the node should continue to refresh the Path and Resv for the preempted LSP paths. When the preemption timer expires, the node tears down the reservation if the head-end node has not already done so.
A value of zero means the LSP should be preempted immediately; hard preempted.
The no form of this command reverts to the default value.
Default
preemption-timer 300
Parameters
- seconds
-
Specifies the time (in s), of the preemption timer.
Platforms
All
prefer-failure
prefer-failure
Syntax
[no] prefer-failure
Context
[Tree] (config>service>nat>pcp-server-policy>option prefer-failure)
Full Context
configure service nat pcp-server-policy option prefer-failure
Description
This command enables/disables support for the prefer-failure option.
Default
no prefer-failure
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefer-local-time
prefer-local-time
Syntax
[no] prefer-local-time
Context
[Tree] (config>system>time prefer-local-time)
Full Context
configure system time prefer-local-time
Description
This command sets the preference to use local or UTC time in the system. This preference is applied to objects such as log file names, created and completed times reported in log files, NETCONF and gRPC date-and-time leafs, and rollback times displayed in show routines.
The operator may force the timezone used for show outputs during a CLI session using an environment variable in the environment>time-display {utc | local} command.
The preference for CLI output is set with the environment time-display command.
The format used for the date-time strings may change when the prefer-local-time option is enabled. For example, when enabled, all date-time strings include a suffix of three to five characters that indicates the timezone used for the presentation. This suffix may not be present if the option in not enabled.
The time format for timestamps on log events is controlled on a per-log basis using the config> log>log-id>time-format {utc | local} CLI command and not via prefer-local-time.
The no form of this command indicates preference for UTC time.
Default
no prefer-local-time
Platforms
All
prefer-mcast-tunnel-in-tunnel
prefer-mcast-tunnel-in-tunnel
Syntax
[no] prefer-mcast-tunnel-in-tunnel
Context
[Tree] (config>router>ldp prefer-mcast-tunnel-in-tunnel)
Full Context
configure router ldp prefer-mcast-tunnel-in-tunnel
Description
At a downstream router, this command specifies that for upstream FEC resolution a T-LDP session to the upstream peer is preferred over an I-LDP session.
At an upstream router, this command specifies that for downstream FEC resolution a T-LDP session to the downstream peer is preferred over an I-LDP session.
The no form of this command reverts to the default value.
Default
no prefer-mcast-tunnel-in-tunnel
Platforms
All
prefer-protocol-stitching
prefer-protocol-stitching
Syntax
[no] prefer-protocol-stitching
Context
[Tree] (config>router>ldp prefer-protocol-stitching)
Full Context
configure router ldp prefer-protocol-stitching
Description
This command stitches an LDP ILM to an SR NHLFE rather than to an LDP NHLFE when both LDP and SR NHLFEs exist.
The no form of this command stitches an LDP ILM to an LDP NHLFE by preference over an SR NHLFE.
Default
no prefer-protocol-stitching
Platforms
All
prefer-tunnel-in-tunnel
prefer-tunnel-in-tunnel
Syntax
[no] prefer-tunnel-in-tunnel
Context
[Tree] (config>router>ldp prefer-tunnel-in-tunnel)
Full Context
configure router ldp prefer-tunnel-in-tunnel
Description
This command specifies to use tunnel-in-tunnel over a simple LDP tunnel. Specifically, the user packets for LDP FECs learned over this targeted LDP session can be sent inside an RSVP LSP which terminates on the same egress router as the destination of the targeted LDP session. The user can specify an explicit list of RSVP LSP tunnels under the Targeted LDP session or LDP will perform a lookup in the Tunnel Table Manager (TTM) for the best RSVP LSP. In the former case, only the specified LSPs will be considered to tunnel LDP user packets. In the latter case, all LSPs available to the TTM and which terminate on the same egress router as this target ed LDP session will be considered. In both cases, the metric specified under the LSP configuration is used to control this selection.
The lookup in the TTM will prefer a LDP tunnel over an LDP-over-RSVP tunnel if both are available. Also, the tunneling operates on the dataplane only. Control packets of this targeted LDP session are sent over the IGP path.
Platforms
All
preference
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>l2tp>group>tunnel preference)
[Tree] (config>service>vprn>l2tp>group>tunnel preference)
Full Context
configure router l2tp group tunnel preference
configure service vprn l2tp group tunnel preference
Description
This command configures a preference number that indicates the relative preference assigned to a tunnel when using a weighted session assignment.
The no form of this command removes the preference value from the tunnel configuration.
Default
no preference
Parameters
- preference
-
Specifies the tunnel preference number with its group. The value 0 corresponds to the highest preference.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference preference-level
no preference
Context
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel preference)
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle>channel>source-override preference)
[Tree] (config>mcast-mgmt>mcast-info-plcy>bundle preference)
Full Context
configure mcast-management multicast-info-policy bundle channel preference
configure mcast-management multicast-info-policy bundle channel source-override preference
configure mcast-management multicast-info-policy bundle preference
Description
This command sets the relative preference level for multicast channels. The preference of a channel specifies its relative importance over other multicast channels. Eight levels of preference are supported; 0 through 7. Preference value 7 indicates the highest preference level.
When the multicast ingress path manager is congested on one or more of the switch fabric multicast paths, it uses the preference values associated with each multicast record to determine which records are allowed on the path and which records be placed in a black-hole state.
The preference value is also compared to the bundles cong-priority-threshold setting to determine the congestion priority of the channel. The result also dictates the channels multicast CAC class level (high or low). When the channels preference value is less than the congestion priority threshold, it is considered to have a congestion priority and CAC class value equal to low. When the channels preference value is equal to or greater than the threshold, it is considered to have a congestion priority and a CAC class value equal to high.
The preference value is also compared to the bundles ecmp-opt-threshold setting to determine whether the channel is eligible for ECMP path dynamic optimization. If the preference value is equal to or less than the threshold, the channel may be optimized. If the preference value is greater than the threshold, the channel will not be dynamically optimized.
The preference command may be executed in three contexts; bundle, channel and source-override. The bundle default preference value is 0. The channel and source-override preference settings are considered overrides to the bundle setting and have a default value of null (undefined).
The no form of this command restores the default preference value (0 or null depending on the context).
Parameters
- preference-level
-
The preference-level parameter is required and defines the preference value of the channel.
Platforms
All
preference
Syntax
[no] preference preference
Context
[Tree] (config>subscr-mgmt>bgp-prng-plcy preference)
Full Context
configure subscriber-mgmt bgp-peering-policy preference
Description
This command configures the route preference for routes learned from the configured peer.
The lower the preference the higher the chance of the route being the active route. The OS assigns BGP routes highest default preference compared to routes that are direct, static or learned via MPLS or OSPF.
The no form of this command used at the global level reverts to default value.
Default
preference 170
Parameters
- preference
-
The route preference, expressed as a decimal integer.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference preference
no preference
Context
[Tree] (config>aaa>diam>node>peer preference)
Full Context
configure aaa diameter node peer preference
Description
This command configures the Diameter routing preference for a peer. All open peers are installed in the Diameter realm routing table but only the one with the lowest numerical value for preference is used as next-hop for a given destination realm. If multiple peers with the same preference are configured for the same realm, the peer index with the lowest value is used to break the tie.
The no form of this command reverts to the default.
Default
preference 50
Parameters
- preference
-
Specifies the peer preference.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference preference
no preference
Context
[Tree] (config>aaa>diam>node>peer>route preference)
Full Context
configure aaa diameter node peer route preference
Description
This command configures the preference of the static route. The lower value is preferred during route selection.
The no form of this command reverts to the default.
Default
preference 50
Parameters
- preference
-
Specifies the static route preference.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference preference
no preference
Context
[Tree] (config>subscr-mgmt>sub-prof preference)
Full Context
configure subscriber-mgmt sub-profile preference
Description
This command sets the relative preference value for a subscriber profile. When multiple subscriber hosts/sessions of the same subscriber point to a different subscriber profile, the profile with the highest preference value is used. With equal preference, the subscriber profile of the last instantiated subscriber host/session is used.
Nokia recommends not to configure a subscriber profile preference value unless explicitly required for the targeted design.
The no form of this command reverts to the default value.
Default
preference 5
Parameters
- preference
-
Specifies the preference value. A lower number means a lower preference.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference [create] [non-revertive]
no preference
Context
[Tree] (config>service>system>bgp-evpn>eth-seg>service-carving>manual preference)
Full Context
configure service system bgp-evpn ethernet-segment service-carving manual preference
Description
This command creates the preference context for the Ethernet Segment (ES) and determines whether the DF election for the ES is revertive or not. Creation of the preference context ensures that the PE will run the preference-based DF election algorithm.
Parameters
- create
-
Mandatory keyword required to create the preference context in an ES.
- non-revertive
-
Configures a non-revertive ES, which ensures that when the Ethernet Segment comes back after a failure, it does not take over an existing active DF PE.
Platforms
All
preference
Syntax
[no] preference preference
Context
[Tree] (config>service>vprn>bgp>group preference)
[Tree] (config>service>vprn>bgp preference)
Full Context
configure service vprn bgp group preference
configure service vprn bgp preference
Description
This command configures the route preference for routes learned from the configured peer(s).
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 lower the preference the higher the chance of the route being the active route. The OS assigns BGP routes highest default preference compared to routes that are direct, static or learned via MPLS or OSPF.
The no form of this command, if used at the global level, reverts to default value.
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
preference 170
Parameters
- preference
-
Specifies the route preference, expressed as a decimal integer.
Platforms
All
preference
Syntax
preference preference-value
no preference
Context
[Tree] (config>service>vprn>static-route-entry>indirect preference)
[Tree] (config>service>vprn>static-route-entry>next-hop preference)
[Tree] (config>service>vprn>static-route-entry>ipsec-tunnel preference)
[Tree] (config>service>vprn>static-route-entry>black-hole preference)
[Tree] (config>service>vprn>static-route-entry>grt preference)
Full Context
configure service vprn static-route-entry indirect preference
configure service vprn static-route-entry next-hop preference
configure service vprn static-route-entry ipsec-tunnel preference
configure service vprn static-route-entry black-hole preference
configure service vprn static-route-entry grt preference
Description
This command specifies the route preference to be assigned to the associated static route. The lower the preference value the more preferred the route is considered.
Default Route Preference lists the default route preference based on the route source.
Label |
Preference |
Configurable |
---|---|---|
Direct attached |
0 |
No |
Static route |
5 |
Yes |
OSPF Internal routes |
10 |
Yes |
IS-IS level 1 internal |
15 |
Yes |
IS-IS level 2 internal |
18 |
Yes |
RIP |
100 |
Yes |
Aggregate |
130 |
No |
OSPF external |
150 |
Yes |
IS-IS level 1 external |
160 |
Yes |
IS-IS level 2 external |
165 |
Yes |
BGP |
170 |
Yes |
The no form of this command returns the returns the associated static route preference to its default value.
Default
preference 5
Parameters
- preference-value
-
Specifies the route preference value.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>service>vprn>isis>level preference)
Full Context
configure service vprn isis level preference
Description
This command configures the preference level of either IS-IS Level 1 or IS-IS Level 2 internal routes. By default, the preferences are listed in the table below.
A route can be learned by the router by different protocols, in which case, the costs are not comparable. When this occurs, the preference is used to decide to which route will be used.
Different protocols should not be configured with the same preference, if this occurs the tiebreaker is per the default preference table as defined in the table below. If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used. If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, then the decision what route to use is determined by the configuration of the ecmp in the config>router context.
Default
Default preferences are listed in Default Preferences.
Route Type |
Preference |
Configurable |
---|---|---|
Direct attached |
0 |
No |
Static route |
5 |
Yes |
MPLS |
7 |
— |
OSPF internal routes |
10 |
No |
IS-IS level 1 internal |
15 |
Yes |
IS-IS level 2 internal |
18 |
Yes |
OSPF external |
150 |
Yes |
IS-IS level 1 external |
160 |
Yes1 |
IS-IS level 2 external |
165 |
Yes1 |
BGP |
170 |
Yes |
Parameters
- preference
-
The preference for external routes at this level expressed as a decimal integer.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>service>vprn>ospf preference)
[Tree] (config>service>vprn>ospf3 preference)
Full Context
configure service vprn ospf preference
configure service vprn ospf3 preference
Description
This command configures the preference for OSPF internal routes.
A route can be learned by the router from different protocols in which case the costs are not comparable, when this occurs the preference is used to decide to which route will be used.
Different protocols should not be configured with the same preference. If the same preference is configured, the tiebreaker is per the default preference table as defined in Default Route Preferences . If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used.
If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, then the decision of what route to use is determined by the configuration of the ecmp in the config>router context.
The no form of this command reverts to the default value.
Route Type |
Preference |
Configurable |
---|---|---|
Direct attached |
0 |
No |
Static routes |
5 |
Yes |
OSPF internal |
10 |
Yes2 |
IS-IS level 1 internal |
15 |
Yes |
IS-IS level 2 internal |
18 |
Yes |
RIP |
100 |
Yes |
OSPF external |
150 |
Yes |
IS-IS level 1 external |
160 |
Yes |
IS-IS level 2 external |
165 |
Yes |
Default
preference 10 — OSPF internal routes have a preference of 10.
Parameters
- preference
-
The preference for internal routes expressed as a decimal integer. Defaults for different route types are listed in the following table.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>service>vprn>rip>group preference)
[Tree] (config>service>vprn>ripng>group>neighbor preference)
[Tree] (config>service>vprn>ripng>group preference)
[Tree] (config>service>vprn>rip>group>neighbor preference)
[Tree] (config>service>vprn>rip preference)
[Tree] (config>service>vprn>ripng preference)
Full Context
configure service vprn rip group preference
configure service vprn ripng group neighbor preference
configure service vprn ripng group preference
configure service vprn rip group neighbor preference
configure service vprn rip preference
configure service vprn ripng preference
Description
This command sets the route preference assigned to RIP routes. This value can be overridden by route policies.
The no form of this command resets the preference to the default.
Default
no preference
Parameters
- preference
-
Specifies the preference value.
Platforms
All
preference
Syntax
preference preference-value
no preference
Context
[Tree] (config>router>mpls>fwd-policies>fwd-policy preference)
Full Context
configure router mpls forwarding-policies forwarding-policy preference
Description
This command configures the preference of an MPLS forwarding policy.
The no form of this command removes the preference parameter from the MPLS forwarding policy.
Default
preference 255
Parameters
- preference-value
-
Specifies the preference value.
The preference-value parameter allows the user to configure multiple label-binding forwarding policies with the same binding label or multiple endpoint policies with the same endpoint address. This provides the capability to achieve a 1:N backup strategy for the forwarding policy. Only the most preferred, lowest numerically preference value, policy is activated in data path.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>p2mp-sr-tree>p2mp-policy>candidate-path preference)
Full Context
configure router p2mp-sr-tree p2mp-policy candidate-path preference
Description
This command sets the candidate path preference for the P2MP SR tree. The candidate path with the highest preference is the active candidate path.
The no form of this command removes the candidate path preference.
Default
no preference
Parameters
- preference
-
Specifies the preference of the candidate path.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>static-route-entry>indirect preference)
[Tree] (config>router>static-route-entry>black-hole preference)
[Tree] (config>router>static-route-entry>next-hop preference)
Full Context
configure router static-route-entry indirect preference
configure router static-route-entry black-hole preference
configure router static-route-entry next-hop preference
Description
This command specifies the route preference to be assigned to the associated static route. The lower the preference value the more preferred the route is considered.
Default Route Preference shows the default route preference based on the route source.
Label |
Preference |
Configurable |
---|---|---|
Direct attached |
0 |
No |
Static route |
5 |
Yes |
OSPF Internal routes |
10 |
Yes |
IS-IS level 1 internal |
15 |
Yes |
IS-IS level 2 internal |
18 |
Yes |
RIP |
100 |
Yes |
Aggregate |
130 |
No |
OSPF external |
150 |
Yes |
IS-IS level 1 external |
160 |
Yes |
IS-IS level 2 external |
165 |
Yes |
BGP |
170 |
Yes |
The no form of this command returns the returns the associated static route preference to its default value.
Default
preference 5
Parameters
- preference
-
Specifies the route preference value.
Platforms
All
preference
Syntax
[no] preference preference
Context
[Tree] (config>router>bgp>group>neighbor preference)
[Tree] (config>router>bgp preference)
[Tree] (config>router>bgp>group preference)
Full Context
configure router bgp group neighbor preference
configure router bgp preference
configure router bgp group preference
Description
This command configures the route preference for routes learned from the configured peers.
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 lower the preference the higher the chance of the route being the active route. The router assigns BGP routes highest default preference compared to routes that are direct, static or learned via MPLS or OSPF.
The no form of this command used at the global level reverts to default value.
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
preference 170
Parameters
- preference
-
Specifies the route preference expressed as a decimal integer.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>isis>level preference)
Full Context
configure router isis level preference
Description
This command configures the preference level of either IS-IS Level 1 or IS-IS Level 2 internal routes. By default, the preferences are listed in the table below.
A route can be learned by the router by different protocols, in which case, the costs are not comparable. When this occurs, the preference is used to decide to which route will be used.
Different protocols should not be configured with the same preference, if this occurs the tiebreaker is per the default preference table as defined in the following table. If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used. If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, then the decision what route to use is determined by the configuration of the ecmp in the config>router context.
Default
preference (Level 1) — 15
preference (Level 2) — 18
Parameters
- preference
-
Specifies the preference for external routes at this level expressed as a decimal integer. The default preferences are listed in Default Internal Route Preferences .
Table 7. Default Internal Route Preferences Route Type
Preference
Configurable
Direct attached
0
—
Static-route
5
Yes
OSPF internal routes
10
—
IS-IS level 1 internal
15
Yes
IS-IS level 2 internal
18
Yes
OSPF external
150
Yes
IS-IS level 1 external
160
Yes3 IS-IS level 2 external
165
Yes3 BGP
170
Yes
1 External preferences are changed using the external-preference command in the config>router>isis>level level-number context.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>ospf preference)
[Tree] (config>router>ospf3 preference)
Full Context
configure router ospf preference
configure router ospf3 preference
Description
This command configures the preference for OSPF internal routes.
A route can be learned by the router from different protocols, in which case, the costs are not comparable. When this occurs, the preference is used to decide which route will be used.
Different protocols should not be configured with the same preference, if this occurs the tiebreaker is per the default preference table as defined in Route Preference Defaults by Route Type . If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used.
If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, then the decision of what route to use is determined by the configuration of the ecmp in the config>router context.
The no form of this command reverts to the default value.
Default
preference 10
Parameters
- preference
-
Specifies the preference for internal routes expressed as a decimal integer. Defaults for different route types are listed in Route Preference Defaults by Route Type .
Table 8. Route Preference Defaults by Route Type Route Type
Preference
Configurable
Direct attached
0
No
Static routes
5
Yes
OSPF internal
10
Yes4 IS-IS level 1 internal
15
Yes
IS-IS level 2 internal
18
Yes
RIP
100
Yes
OSPF external
150
Yes
IS-IS level 1 external
160
Yes
IS-IS level 2 external
165
Yes
BGP
170
Yes
1 Preference for OSPF internal routes is configured with the preference command.
Platforms
All
preference
Syntax
preference {none | all}
no preference
Context
[Tree] (config>router>isis>lfa>mhp preference)
[Tree] (config>router>ospf>lfa>mhp preference)
Full Context
configure router isis loopfree-alternates multi-homed-prefix preference
configure router ospf loopfree-alternates multi-homed-prefix preference
Description
This command configures the preference for the multihomed prefix LFA backup path. This knob can be enabled at a LFA computing node to force the programming of the multihomed prefix LFA backup path which, in some topologies, can avoid transiting using the best ABR or ASBR.
The no form of this command reverts to the default value.
Default
preference none
Parameters
- none
-
Specifies the preference for an LFA, TI-LFA, or RLFA backup path over the multihomed prefix LFA backup path. The multihomed prefix LFA is only programmed in cases where the prefix is not protected by LFA, RLFA, or TI-LFA.
- all
-
Specifies the forced programming of the multihomed prefix LFA backup path regardless of the outcome of the LFA, TI-LFA, or RLFA backup path computation.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>ripng>group>neighbor preference)
[Tree] (config>router>ripng>group preference)
[Tree] (config>router>rip preference)
[Tree] (config>router>ripng preference)
[Tree] (config>router>rip>group preference)
[Tree] (config>router>rip>group>neighbor preference)
Full Context
configure router ripng group neighbor preference
configure router ripng group preference
configure router rip preference
configure router ripng preference
configure router rip group preference
configure router rip group neighbor preference
Description
This command configures the preference for RIP routes.
A route can be learned by the router from different protocols in which case the costs are not comparable. When this occurs, the preference is used to decide which route will be used.
Different protocols should not be configured with the same preference, if this occurs the tiebreaker is per the default preference table as defined in Route Preference Defaults by Route Type . If multiple routes are learned with an identical preference using the same protocol, the lowest cost route is used.
If multiple routes are learned with an identical preference using the same protocol and the costs (metrics) are equal, then the decision of what route to use is determined by the configuration of the ecmp in the config>router context.
The no form of the command reverts to the default value.
Default
preference 100
Parameters
- preference
-
Specifies the preference for RIP routes expressed as a decimal integer. Defaults for different route types are listed in Route Preference Defaults by Route Type .
Table 9. Route Preference Defaults by Route Type Route Type
Preference
Configurable
Direct attached
0
—
Static routes
5
Yes
OSPF internal
10
Yes
IS-IS level 1 internal
15
Yes
IS-IS level 2 internal
18
Yes
RIP
100
Yes
OSPF external
150
Yes
IS-IS level 1 external
160
Yes
IS-IS level 2 external
165
Yes
BGP
170
Yes
Platforms
All
preference
Syntax
preference preference
Context
[Tree] (conf>router>segment-routing>sr-policies>policy preference)
Full Context
configure router segment-routing sr-policies static-policy preference
Description
This command associates a preference value with a statically defined-segment routing policy. This is an optional parameter.
When there are multiple policies for the same (color, endpoint) combination that are targeted for local installation, only one is selected as the active path for the (color, endpoint). In this selection process (which considers both static local policies and BGP signaled policies), the policy with the highest preference value is preferred over all policies with a lower preference value.
The no form of this command reverts to the default value.
Default
preference 100
Parameters
- preference
-
Specifies the preference ID.
Platforms
All
preference
Syntax
preference preference
no preference
Context
[Tree] (config>router>policy-options>policy-statement>name>default-action preference)
[Tree] (config>router>policy-options>policy-statement>entry>action preference)
Full Context
configure router policy-options policy-statement name default-action preference
configure router policy-options policy-statement entry action preference
Description
This command assigns a route preference to routes matching the route policy statement entry.
If no preference is specified, the default Route Table Manager (RTM) preference for the protocol is used.
The no form of this command disables setting an RTM preference in the route policy entry.
This command is supported with the following protocols: RIP import, BGP import, VPRN VRF import ( vrf-import), and VPRN GRT lookup export (export-grt).
Default
no preference
Parameters
- preference
-
Specifies the route preference expressed as a decimal integer.
Platforms
All
preference
Syntax
preference value
Context
[Tree] (config>service>vprn>sub-if>grp-if>sap>static-host>managed-routes>route-entry preference)
[Tree] (config>service>ies>sub-if>grp-if>sap>static-host>managed-routes>route-entry preference)
Full Context
configure service vprn subscriber-interface group-interface sap static-host managed-routes route-entry preference
configure service ies subscriber-interface group-interface sap static-host managed-routes route-entry preference
Description
This command associates a preference with the provisioned managed route.
Parameters
- value
-
Specifies the preference value.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preference
Syntax
preference
Context
[Tree] (config>ipsec>tnl-temp>rev-route preference)
Full Context
configure ipsec tunnel-template reverse-route preference
Description
This command configures the route preference assigned to the DL2L tunnel reverse routes. The system uses this preference when selecting a route to install in the route table.
Default
preference 0
Parameters
- preference
- Specifies the preference value for reverse routes.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
preference-option
preference-option
Syntax
[no] preference-option
Context
[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>relay>asel preference-option)
[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>relay>asel>clnt-mac preference-option)
[Tree] (config>service>vprn>sub-if>ipv6>dhcp6>relay>asel>srvr preference-option)
[Tree] (config>service>vprn>sub-if>ipv6>dhcp6>relay>asel>clnt-mac preference-option)
[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>relay>asel>srvr preference-option)
[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>relay>asel>srvr preference-option)
[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>relay>asel preference-option)
[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>relay>asel>clnt-mac preference-option)
[Tree] (config>service>vprn>sub-if>ipv6>dhcp6>relay>asel preference-option)
Full Context
configure service ies subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection preference-option
configure service ies subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection client-mac preference-option
configure service vprn subscriber-interface ipv6 dhcp6 relay advertise-selection server preference-option
configure service vprn subscriber-interface ipv6 dhcp6 relay advertise-selection client-mac preference-option
configure service ies subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection server preference-option
configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection server preference-option
configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection preference-option
configure service vprn subscriber-interface group-interface ipv6 dhcp6 relay advertise-selection client-mac preference-option
configure service vprn subscriber-interface ipv6 dhcp6 relay advertise-selection preference-option
Description
This command enables the DHCPv6 preference option that is inserted in the DHCPv6 advertise message.
The no form of this command removes the preference option.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preferred
preferred
Syntax
[no] preferred
Context
[Tree] (config>isa>nat-group>inter-chassis-redundancy preferred)
Full Context
configure isa nat-group inter-chassis-redundancy preferred
Description
This command sets the preference for activity of a nat-group in stateful inter-chassis redundancy configuration if both nodes have equal health. An example of where this can be useful is in a load balancing environment where the activity of NAT groups can be distributed between the two redundant nodes.
A nat-group with preferred command configured on a node that freshly became part of multi-chassis redundancy, takes over activity from an existing and traffic-serving node with equal health that does not have the preferred command configured. This causes a switchover and a brief interruption in traffic flow.
By default the preferred status is not set for the node.
The no form of this command reverts to the default.
Default
no preferred
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
preferred-lifetime
preferred-lifetime
Syntax
preferred-lifetime [days days] [hrs hours] [min minutes] [sec seconds]
preferred-lifetime infinite
no preferred-lifetime
Context
[Tree] (config>subscr-mgmt>loc-user-db>ipoe>host>ipv6-lease-times preferred-lifetime)
[Tree] (config>subscr-mgmt>loc-user-db>ppp>host>ipv6-lease-times preferred-lifetime)
Full Context
configure subscriber-mgmt local-user-db ipoe host ipv6-lease-times preferred-lifetime
configure subscriber-mgmt local-user-db ppp host ipv6-lease-times preferred-lifetime
Description
This command specifies the preferred lifetime for the lease times. When the preferred lifetime expires, then any derived addresses are deprecated.
The no form of this command reverts to the default.
Parameters
- infinite
-
Specifies that the valid lifetime is infinite.
- preferred-lifetime
-
Specifies the preferred lifetime.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preferred-lifetime
Syntax
preferred-lifetime [days days] [ hrs hours] [min minutes] [sec seconds]
no preferred-lifetime
Context
[Tree] (config>service>vprn>dhcp6>server>pool>prefix preferred-lifetime)
[Tree] (config>router>dhcp6>server>defaults preferred-lifetime)
[Tree] (config>router>dhcp6>server>pool>prefix preferred-lifetime)
[Tree] (config>service>vprn>dhcp6>server>defaults preferred-lifetime)
Full Context
configure service vprn dhcp6 local-dhcp-server pool prefix preferred-lifetime
configure router dhcp6 local-dhcp-server defaults preferred-lifetime
configure router dhcp6 local-dhcp-server pool prefix preferred-lifetime
configure service vprn dhcp6 local-dhcp-server defaults preferred-lifetime
Description
This command configures the preferred lifetime.
The no form of this command reverts to the default value.
Default
preferred-lifetime hrs 1
Parameters
- preferred-lifetime
-
Specifies the preferred time for a prefix.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
- configure router dhcp6 local-dhcp-server pool prefix preferred-lifetime
- configure service vprn dhcp6 local-dhcp-server pool prefix preferred-lifetime
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
- configure router dhcp6 local-dhcp-server defaults preferred-lifetime
- configure service vprn dhcp6 local-dhcp-server defaults preferred-lifetime
preferred-lifetime
Syntax
preferred-lifetime seconds
preferred-lifetime infinite
no preferred-lifetime
Context
[Tree] (config>service>vprn>if>ipv6>dhcp6>pfx-delegate>prefix preferred-lifetime)
[Tree] (config>service>ies>if>ipv6>dhcp6>pfx-delegate>prefix preferred-lifetime)
Full Context
configure service vprn interface ipv6 dhcp6-server prefix-delegation prefix preferred-lifetime
configure service ies interface ipv6 dhcp6-server prefix-delegation prefix preferred-lifetime
Description
This command configures the IPv6 prefix/mask preferred lifetime. The preferred-lifetime value cannot be bigger than the valid-lifetime value.
The no form of this command reverts to the default value.
Default
preferred-lifetime 604800 (7 days)
Parameters
- seconds
-
Specifies the time, in seconds, that this prefix remains preferred.
- infinite
-
Specifies that this prefix remains preferred infinitely.
Platforms
All
preferred-lifetime
Syntax
preferred-lifetime seconds
preferred-lifetime infinite
no preferred-lifetime
Context
[Tree] (config>service>vprn>sub-if>grp-if>ipv6>rtr-adv>pfx-opt preferred-lifetime)
[Tree] (config>service>ies>sub-if>ipv6>rtr-adv>pfx-opt preferred-lifetime)
[Tree] (config>service>vprn>sub-if>ipv6>rtr-adv>pfx-opt preferred-lifetime)
[Tree] (config>service>ies>sub-if>grp-if>ipv6>rtr-adv>pfx-opt preferred-lifetime)
Full Context
configure service vprn subscriber-interface group-interface ipv6 router-advertisements prefix-options preferred-lifetime
configure service ies subscriber-interface ipv6 router-advertisements prefix-options preferred-lifetime
configure service vprn subscriber-interface ipv6 router-advertisements prefix-options preferred-lifetime
configure service ies subscriber-interface group-interface ipv6 router-advertisements prefix-options preferred-lifetime
Description
This command specifies the remaining time for this prefix to be preferred, thus time until deprecation.
The no form of this command reverts to the default.
Default
preferred-lifetime 3600
Parameters
- seconds
-
Specifies the time for the prefix to remain preferred on this group-interface in seconds.
- infinite
-
Specifies that the remaining time will never expire. The value 4294967295 is interpreted as infinite.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preferred-lifetime
Syntax
preferred-lifetime seconds
preferred-lifetime infinite
no preferred-lifetime
Context
[Tree] (config>subscr-mgmt>rtr-adv>pfx-opt>stateful preferred-lifetime)
[Tree] (config>subscr-mgmt>rtr-adv>pfx-opt>stateless preferred-lifetime)
Full Context
configure subscriber-mgmt router-advertisement-policy prefix-options stateful preferred-lifetime
configure subscriber-mgmt router-advertisement-policy prefix-options stateless preferred-lifetime
Description
This command specifies the remaining time for this prefix to be preferred.
The no form of this command reverts to the default.
Default
preferred-lifetime 3600
Parameters
- seconds
-
Specifies the time, in seconds, for the prefix to remain preferred.
- infinite
-
Specifies that the remaining time never expires.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preferred-lifetime
Syntax
preferred-lifetime infinite
preferred-lifetime [days days] [hrs hours] [min minutes] [sec seconds]
no preferred-lifetime
Context
[Tree] (config>service>ies>sub-if>ipv6>dhcp6>proxy-server preferred-lifetime)
[Tree] (config>service>ies>sub-if>grp-if>ipv6>dhcp6>proxy-server preferred-lifetime)
[Tree] (config>service>vprn>sub-if>ipv6>dhcp6>proxy-server preferred-lifetime)
[Tree] (config>service>vprn>sub-if>grp-if>ipv6>dhcp6>proxy-server preferred-lifetime)
Full Context
configure service ies subscriber-interface ipv6 dhcp6 proxy-server preferred-lifetime
configure service ies subscriber-interface group-interface ipv6 dhcp6 proxy-server preferred-lifetime
configure service vprn subscriber-interface ipv6 dhcp6 proxy-server preferred-lifetime
configure service vprn subscriber-interface group-interface ipv6 dhcp6 proxy-server preferred-lifetime
Description
This command configures the preferred lifetime. When the preferred lifetime expires, any derived addresses are deprecated.
Default
preferred-lifetime hrs 1
Parameters
- infinite
-
Specifies that the preferred lifetime is infinite.
- days days
-
Specifies the number of days of a preferred lifetime.
- hrs hours
-
Specifies the number of hours of a preferred lifetime.
- min minutes
-
Specifies the number of minutes of a preferred lifetime.
- sec seconds
-
Specifies the number of seconds of a preferred lifetime.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
preferred-lifetime
Syntax
[no] preferred-lifetime {seconds | infinite}
Context
[Tree] (config>service>vprn>router-advert>if>prefix preferred-lifetime)
[Tree] (config>router>router-advert>if>prefix preferred-lifetime)
Full Context
configure service vprn router-advertisement interface prefix preferred-lifetime
configure router router-advertisement interface prefix preferred-lifetime
Description
This command configures the remaining length of time in seconds that this prefix will continue to be preferred, such as, time until deprecation. The address generated from a deprecated prefix should not be used as a source address in new communications, but packets received on such an interface are processed as expected.
Default
preferred-lifetime 604800
Parameters
- seconds
-
Specifies the remaining length of time in seconds that this prefix will continue to be preferred.
- infinite
-
Specifies that the prefix will always be preferred. A value of 4,294,967,295 represents infinity.
Platforms
All
prefix
prefix
Syntax
prefix ipv6-addr/prefix-length [failover {local | remote | access-driven}] [pd] [wan-host] [create]
no prefix ipv6-addr/prefix-length
Context
[Tree] (config>service>vprn>dhcp6>server>pool prefix)
[Tree] (config>router>dhcp6>server>pool prefix)
Full Context
configure service vprn dhcp6 local-dhcp-server pool prefix
configure router dhcp6 local-dhcp-server pool prefix
Description
This command allocates a prefix to a pool from which Prefix Delegation prefixes and or WAN addresses can be assigned for DHCP6.
The no form of this command removes the prefix parameters from the configuration.
Default
prefix failover local
Parameters
- prefix ipv6-addr/prefix-length
-
Specifies the prefix.
- failover {local | remote | access-driven}
-
This command designates a prefix as local, remote, or access-driven. This is used when multi-chassis synchronization is enabled.
- pd
-
Specifies that this aggregate is used by IPv6 ESM hosts for DHCPv6 prefix-delegation.
- wan-host
-
Specifies that this aggregate is used by IPv6 ESM hosts for local addressing or by a routing gateway’s WAN interface.
- create
-
Keyword used to create the prefix configuration. 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
prefix
Syntax
[no] prefix ipv6-address/prefix-length
Context
[Tree] (config>service>ies>if>ipv6>dhcp6-server>pfx-delegate prefix)
Full Context
configure service ies interface ipv6 dhcp6-server prefix-delegation prefix
Description
This command specifies the IPv6 prefix that is delegated by this system.
The no form of this command reverts to the default.
Parameters
- ipv6-address/prefix-length
-
Specifies the IPv6 address on the interface
Platforms
All
prefix
Syntax
prefix ipv6-address/prefix-length [pd] [wan-host]
no prefix ipv6-address/prefix-length
Context
[Tree] (config>service>vprn>sub-if>ipv6>sub-pfx prefix)
[Tree] (config>service>ies>sub-if>ipv6>sub-pfx prefix)
Full Context
configure service vprn subscriber-interface ipv6 subscriber-prefixes prefix
configure service ies subscriber-interface ipv6 subscriber-prefixes prefix
Description
This command allows a list of prefixes (using the prefix command multiple times) to be routed to hosts associated with this subscriber interface. Each prefix is represented in the associated FDB with a reference to the subscriber interface. Prefixes are defined as being for prefix delegation (pd) or use on a WAN interface or host (wan-host).
The no form of this command reverts to the default.
Parameters
- ipv6-address
-
Specifies the 128-bit IPv6 address.
- prefix-length
-
Specifies the length of any associated aggregate prefix.
- pd
-
Specifies that this aggregate is used by IPv6 ESM hosts for DHCPv6 prefix-delegation.
- wan-host
-
Specifies that this aggregate is used by IPv6 ESM hosts for local addressing or by a routing gateway’s WAN interface.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix low-order-vsi-id
no prefix
Context
[Tree] (config>service>vpls>bgp-ad>vsi-id prefix)
Full Context
configure service vpls bgp-ad vsi-id prefix
Description
This command specifies the low-order 4 bytes used to compose the Virtual Switch Instance Identifier (VSI-ID) to use for NLRI in BGP auto-discovery in this VPLS service.
If no value is set, the system IP address will be used.
Default
no prefix
Parameters
- low-order-vsi-id
-
Specifies a unique VSI ID
Platforms
All
prefix
Syntax
[no] prefix ip-prefix/prefix-length
Context
[Tree] (config>service>vprn>bgp>group>dynamic-neighbor>match prefix)
Full Context
configure service vprn bgp group dynamic-neighbor match prefix
Description
This command configures a prefix to accept dynamic BGP sessions (sessions from source IP addresses not matching any configured neighbor addresses). A dynamic session is associated with the group having the longest match prefix entry for the source IP address of the peer. The group association determines local parameters that apply to the session, including the local AS, the local IP address, the MP-BGP families, the import and export policies, and so on.
The no form of this command removes a prefix entry.
Parameters
- ip-prefix/prefix-length
-
Specifies a prefix from which to accept dynamic BGP sessions.
Platforms
All
prefix
Syntax
[no] prefix ipv6-prefix/prefix-length
Context
[Tree] (config>service>vprn>router-advert>if prefix)
Full Context
configure service vprn router-advertisement interface prefix
Description
This command configures an IPv6 prefix in the router advertisement messages. To support multiple IPv6 prefixes, use multiple prefix statements. No prefix is advertised until explicitly configured using prefix statements.
Parameters
- ipv6-prefix
-
Specifies the IP prefix for prefix list entry in dotted decimal notation.
- prefix-length
-
Specifies a route must match the most significant bits and have a prefix length.
Platforms
All
prefix
Syntax
prefix prefix-string
no prefix
Context
[Tree] (config>app-assure>group>cflowd>export-override prefix)
Full Context
configure application-assurance group cflowd export-override prefix
Description
This command specifies the prefix-string associated with the export-override.
Parameters
- prefix-string
-
Specifies a prefix string,up to eight characters. If the eight-character prefix is "ABCDEFG_" for a particular node, the cflowd export override would generate IPv4 interface names such as ABCDEFG_255.255.255.255 or IPv6 as ABCDEFG_2001:DB8:EF01:2345::/64. By default the prefix will be left blank.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix ip-prefix/ip-prefix-length [name prefix-name]
no prefix ip-prefix/ip-prefix-length
Context
[Tree] (config>app-assure>group>ip-prefix-list prefix)
Full Context
configure application-assurance group ip-prefix-list prefix
Description
This command configures an IP prefix within the list.
The no form of this command removes the IP prefix from the configuration.
Parameters
- ip-prefix/ip-prefix-length
-
The IP address in dotted decimal notation.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix ipv6-prefix/prefix-length
no prefix
Context
[Tree] (config>service>vprn>nat>inside>nat64 prefix)
[Tree] (config>router>nat>inside>nat64 prefix)
Full Context
configure service vprn nat inside nat64 prefix
configure router nat inside nat64 prefix
Description
This command configures the IPv6 prefix used to derive the IPv6 address from the IPv4 address, and is same as the prefix used by DNS64 to generate AAAA record returned for IPv4 endpoint resolution. NAT64 node announces this prefix in routing to attract traffic from IPv6 hosts. If the prefix is not configured, then a well-known prefix, 64:FF9B::/96, is used.
The no form of the command removes the prefix from the NAT64 configuration.
Parameters
- ipv6-prefix/prefix-length
-
Specifies the NAT64 destination prefix.
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix ip-prefix/length [nat-policy nat-policy-name]
no prefix ip-prefix/length
Context
[Tree] (config>service>nat>nat-prefix-list prefix)
Full Context
configure service nat nat-prefix-list prefix
Description
This command creates a prefix entry in the nat-prefix-list.
This prefix can be used to identify traffic with specific destination IP that needs to be associated with corresponding nat-policy (and implicitly the NAT pool) for L2-aware subscribers. In this fashion, a single L2-aware subscriber can direct traffic to multiple NAT pools, depending on the traffic destination.
Another use for a prefix is in DNAT-only application (DNAT without SNAPT). In this case the prefix identifies the inside source IP range that will be explicitly configured to ensure proper downstream routing in dNAT-only case.
The nat-prefix-list cannot reference the default nat-policy (the one that is referenced in the subscriber-profile).
The no form of the command reverts to the default.
Parameters
- ip-prefix/length
-
Specifies the IP prefix for nat prefix list entry in dotted decimal notation.
- nat-policy nat-policy-name
-
Specifies the NAT policy name. Allowed values are any string up to 32 characters composed of printable,7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes..
Platforms
7450 ESS, 7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix prefix/prefix-length [ create]
no prefix prefix/prefix-length
Context
[Tree] (config>service>vprn>firewall>domain prefix)
[Tree] (config>router>firewall>domain prefix)
Full Context
configure service vprn firewall domain prefix
configure router firewall domain prefix
Description
This command specifies a prefix for which firewall functionality will apply within the domain. Prefixes cannot be shared or duplicated across multiple domains in the same routing context. A domain can contain multiple prefixes.
The no form of the command removes the prefix from the domain.
Parameters
- create
-
Mandatory keyword used when creating a prefix entry.
- prefix/prefix-length
-
Specifies the prefix.
Platforms
7750 SR, 7750 SR-e, 7750 SR-s, VSR
prefix
Syntax
prefix ip-address
no prefix
Context
[Tree] (config>router>bier>template>sub-domain prefix)
Full Context
configure router bier template sub-domain prefix
Description
This command specifies the prefix used for BFR. The prefix should be an IPv4 /32 address. The prefix can be a loopback interface or system IP address.
The no form of this command removes the prefix.
Parameters
- ip-address
-
Specifies the IP address to be used as the BFR prefix in dotted decimal format.
Platforms
All
prefix
Syntax
prefix ip-prefix/prefix-length [create]
no prefix ip-prefix/prefix-length
Context
[Tree] (config>test-oam>twamp>server prefix)
Full Context
configure test-oam twamp server prefix
Description
This command configures an IP address prefix containing one or more TWAMP clients. For a TWAMP client to connect to the TWAMP server (and subsequently conduct tests) it must establish the control connection using an IP address that is part of a configured prefix.
Parameters
- ip-prefix/prefix-length
-
Specifies an IPv4 or IPv6 address prefix.
- prefix length
-
Specifies the prefix length.
- create
-
Creates a prefix instance. 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, 7950 XRS
prefix
Syntax
prefix ip-prefix/prefix-length [create]
no prefix ip-prefix/prefix-length
Context
[Tree] (config>router>twamp-light>reflector prefix)
[Tree] (config>service>vprn>twamp-light>reflector prefix)
Full Context
configure router twamp-light reflector prefix
configure service vprn twamp-light reflector prefix
Description
This command defines which TWAMP Light packet prefixes the reflector processes.
The no form of this command with the specific prefix removes the accepted source.
Parameters
- ip-prefix/prefix-length
-
Specifies the IPv4 or IPv6 address and length.
- create
-
Creates a prefix instance. 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, 7950 XRS
prefix
Syntax
[no] prefix ip-prefix/prefix-length
Context
[Tree] (config>qos>match-list>ip-prefix-list prefix)
Full Context
configure qos match-list ip-prefix-list prefix
Description
This command adds an IPv4 address prefix to an existing IPv4 address prefix match list.
To add a set of unique prefixes, execute the command with all unique prefixes. The prefixes are allowed to overlap IPv4 address space.
An IPv4 prefix addition will be blocked, if resource exhaustion is detected anywhere in the system because of QoS Policies that use this IPv4 address prefix list.
The no form of this command deletes the specified prefix from the list.
Parameters
- ip-prefix
-
A valid IPv4 address prefix in dotted decimal notation.
- prefix-length
-
Length of the entered IP prefix
Platforms
All
prefix
Syntax
[no] prefix ipv6-prefix/prefix-length
Context
[Tree] (config>qos>match-list>ipv6-prefix-list prefix)
Full Context
configure qos match-list ipv6-prefix-list prefix
Description
This command adds an IPv6 address prefix to an existing IPv6 address prefix match list.
To add set of unique prefixes, execute the command with all unique prefixes. The prefixes are allowed to overlap IPv6 address space.
An IPv6 prefix addition will be blocked if resource exhaustion is detected anywhere in the system because of QoS Policies that use this IPv6 address prefix list.
The no form of this command deletes the specified prefix from the list.
Parameters
- ipv6-prefix
-
Specifies the IPv6 prefix for the IP match criterion in hex digits.
- prefix-length
-
Specifies the IPv6 prefix length for the IPv6 address expressed as a decimal integer.
Platforms
All
prefix
Syntax
[no] prefix ip-prefix/prefix-length
Context
[Tree] (config>filter>match-list>ip-prefix-list prefix)
Full Context
configure filter match-list ip-prefix-list prefix
Description
This command adds an IPv4 address prefix to an existing IPv4 address prefix match list.
The no form of this command deletes the specified prefix from the list.
Operational Notes:
To add set of unique prefixes, execute the command with all unique prefixes. The prefixes are allowed to overlap IPv4 address space.
An IPv4 prefix addition will be blocked, if resource exhaustion is detected anywhere in the system because of filter policies that use this IPv4 address prefix list.
Parameters
- ip-prefix
-
Specifies a valid IPv4 address prefix in dotted decimal notation.
- prefix-length
-
Specifies the length of the entered IPv4 prefix.
Platforms
All
prefix
Syntax
[no] prefix ipv6-prefix/prefix-length
Context
[Tree] (config>filter>match-list>ipv6-prefix-list prefix)
Full Context
configure filter match-list ipv6-prefix-list prefix
Description
This command adds an IPv6 address prefix to an existing IPv6 address prefix match list.
The no form of this command deletes the specified prefix from the list.
Operational Notes:
To add set of different prefixes, execute the command with all unique prefixes. The prefixes are allowed to overlap IPv6 address space.
An IPv6 prefix addition will be blocked, if resource exhaustion is detected anywhere in the system because of filter policies that use this IPv6 address prefix list.
Parameters
- ipv6-prefix/prefix-length
-
Specifies an IPv6 address prefix written as hexadecimal numbers separated by colons with host bits set to 0. One string of zeros can be omitted, so 2001:db8::700:0:217A is equivalent to 2001:db8:0:0:0:700:0:217A.
- prefix-length
-
Specifies the length of the entered IPv6 prefix.
Platforms
All
prefix
Syntax
[no] prefix ipv6-prefix/prefix-length
Context
[Tree] (config>router>router-advert>if prefix)
Full Context
configure router router-advertisement interface prefix
Description
This command configures an IPv6 prefix in the router advertisement messages. To support multiple IPv6 prefixes, use multiple prefix statements. No prefix is advertised until explicitly configured using prefix statements.
Parameters
- ipv6-prefix
-
The IP prefix for prefix list entry in dotted decimal notation.
- prefix-length
-
Specifies a route must match the most significant bits and have a prefix length.
Platforms
All
prefix
Syntax
[no] prefix ip-prefix/ip-prefix-length
Context
[Tree] (config>router>bgp>group>dynamic-neighbor>match prefix)
Full Context
configure router bgp group dynamic-neighbor match prefix
Description
This command configures a prefix to accept dynamic BGP sessions (sessions from source IP addresses not matching any configured neighbor addresses). A dynamic session is associated with the group having the longest match prefix entry for the source IP address of the peer. The group association determines local parameters that apply to the session, including the local AS, the local IP address, the MP-BGP families, the import and export policies, and so on.
The no form of this command removes a prefix entry.
Parameters
- ip-prefix/ip-prefix-length
-
Specifies a prefix from which to accept dynamic BGP sessions.
Platforms
All
prefix
Syntax
[no] prefix ip-prefix/prefix-length [exact | longer | through length | prefix-length-range length1-length2 | to ip-prefix/prefix-length | address-mask mask-pattern]
Context
[Tree] (config>router>policy-options>prefix-list prefix)
Full Context
configure router policy-options prefix-list prefix
Description
This command creates a prefix entry in the route policy prefix list.
The no form of this command deletes the prefix entry from the prefix list.
Parameters
- ip-prefix/prefix-length
-
Specifies the IP prefix and length for the prefix list entry in dotted decimal notation.
- exact
-
Specifies the prefix list entry only matches the route with the specified ip-prefix and prefix mask (length) values.
- longer
-
Specifies the prefix list entry matches any route that matches the specified ip-prefix and prefix mask length values equal to or greater than the specified mask.
- through length
-
Specifies the prefix list entry matches any route that matches the specified ip-prefix and has a prefix length between the specified length values inclusive.
- prefix-length-range length1 - length2
-
Specifies a route must match the most significant bits and have a prefix length with the given range. The range is inclusive of start and end values.
- to ip-prefix/prefix-length
-
Specifies a second IP prefix and length used in route policy prefix lists. A route matches prefix1 to prefix2 if it matches prefix1 and prefix2 according to their respective prefix lengths and if the route’s own prefix length is between the prefix lengths of prefix1 and prefix2. It could take many individual 'exact’ match prefix entries to reproduce the same logic.
- mask-pattern
-
Specifies the address mask to use for matching entries to this prefix entry. A route matches a prefix and address mask combination if the bitwise logical AND of this prefix and the mask equals the bitwise logical AND of the route’s address and the same mask and, additionally, the prefix length of the route matches the prefix length of the prefix entry.
Platforms
All
prefix
Syntax
prefix
Context
[Tree] (config>router>segment-routing>srv6>locator prefix)
Full Context
configure router segment-routing segment-routing-v6 locator prefix
Description
Commands in this context configure IPv6 prefix parameters for an SRv6 locator.
Platforms
7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR
prefix
Syntax
prefix
Context
[Tree] (conf>router>sr>srv6>ms>block prefix)
Full Context
configure router segment-routing segment-routing-v6 micro-segment block prefix
Description
Commands in this context configure IPv6 prefix parameters for an SRv6 micro-segment locator.
Platforms
7450 ESS, 7750 SR, 7750 SR-s, 7950 XRS, VSR
prefix
Syntax
prefix ip-prefix/prefix-length
no prefix
Context
[Tree] (config>oam-pm>session>ip>tunnel>mpls>sr-ospf3 prefix)
[Tree] (config>oam-pm>session>ip>tunnel>mpls>sr-ospf prefix)
[Tree] (config>oam-pm>session>ip>tunnel>mpls>sr-isis prefix)
Full Context
configure oam-pm session ip tunnel mpls sr-ospf3 prefix
configure oam-pm session ip tunnel mpls sr-ospf prefix
configure oam-pm session ip tunnel mpls sr-isis prefix
Description
This command configures the IP prefix used with the IGP instance to tunnel IP packets for the session tests.
The no form of this command deletes the prefix from the configuration.
Default
no prefix
Parameters
- ip-prefix/prefix-length
-
Specifies an IPv4 or IPv6 address prefix.
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS