port

Required Command-Line Mode = Configure

Use the port command to configure settings for ports on GigaVUE HC Series line cards and modules, including aliases, port filters, port parameters, and port types.

The port command has the following syntax:

port <port-id | port-alias | port-list>
   alarm
      buffer-threshold <0-100%> | [rx <0-100%> | tx <0-100%]>
      high-utilization-threshold <0-100%>
      low-utilization-threshold <0-100%>
   alias <alias string>
   assign role <user role> [level 1 | 2 | 3 | 4]
   buffer-index <<0-7> | low | default | high>
   comment <comment>
   egress-vlan strip
   filter rule
      add <drop <criteria>| pass <criteria>>
      delete <all | rule-id <rule ID>>
      edit rule-id <rule-ID> [drop <criteria> | pass <criteria>]

   header-strip <vxlan | mpls-l3 | mpls-advanced>
   ingress-vlan-tag <2-4000>
   lock [description <description>]
   lock-share <user <username>>
   mode <none | 4x10G | 4x25G | 2x40G>
   params
       admin <disable | enable>
       autoneg <disable | enable>

       brief [port-list <port list>]
       discovery <cdp | lldp | all | disable>
       duplex <full>
       fec <cl91|cl74|cl108 | off>
       forcelinkup <disable | enable>
       gdp <enable | disable>
       speed <10 | 100 | 1000 | 10000 | 25000 | 40000 | 100000>
       ude <enable | disable>
       taptx <active | passive>
   ptp <enable | disable>

vlan <value>
       announce-interval <value>
       delay-req-interval <value>
       sync-interval <value> 

tag-protocol-id <TPID value>
   timestamp <append-ingress | source-id <0-65535> | strip-egress>

threshold [rx | tx] [drop | error] [count | percent] [value <value>]

timestamp
       ingress insert
       ingress source-id <value>
       egress insert
       egress source-id <value>
       ingress disable
       egress disable
   tool-share role <user role>
   type <hybrid | inline-network | inline-tool | network | stack | tool | circuit>

   l2gre-id <L2GRE identifier>

   vxlan-id <VXLAN identifier>

   zr-optics <add-tx-opt-pow | app-code | grid-frequency | grid-spacing | part-number>

The following table describes the arguments for the port command.

Argument

Description

port-id | port-alias | port-list

Specifies the ports on which to configure settings. Use one of the following:

port-id, port-alias, port-list—Specifies ports using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.

alarm buffer-threshold <0-100%> | [rx <0-100%> | tx <0-100%]>

Specifies buffer alarm thresholds on a port, as a percentage from 1 to 100.

You can specify the alarm buffer threshold in the rx and tx directions for network and stack type ports and in the tx direction for tool type ports.

The default is 0, which disables the threshold.

For example:

(config) # port 2/1/x1 alarm buffer-threshold 50

(config) # port 2/1/x1 alarm buffer-threshold rx 60

high-utilization-threshold <0-100%>low-utilization-threshold <0-100%>

Specifies high and low utilization thresholds on a port as a percentage from 1 to 100.

The utilization thresholds specify the value at which a utilization alarm will be generated for a port, either rising or falling. Alarms are reported to all configured SNMP trap destinations and recorded in the log file.

The default is 0, which disables the threshold.

For example:

Specifying high and low utilization thresholds for front-end ports:

(config) # port 1/1/x1 alarm high-utilization-threshold 70

(config) # port 1/1/x1 alarm low-utilization-threshold 20

Specifying high and low utilization thresholds for GigaSMART engine port:

(config) # port 1/1/e1 alarm high-utilization-threshold 70

(config) # port 1/1/e1 alarm low-utilization-threshold 20

alias <alias string>

Specifies an alias for a particular port. Aliases can be used in place of the numerical bid/sid/pid identifier required in many packet distribution commands in the GigaVUE-OS CLI. For example, instead of configuring a map from 1/1/x1 to 1/2/x4, you could create a map from Gb_In to Stream-to-Disk.

For example:

(config) # port 24/1/x1 alias myPort

Note:  Aliases can only be applied to single ports. They cannot be applied to groups of ports.

To use an alias for a group of ports, use the tool-mirror feature.

assign role <user role> [level 1 | 2 | 3 | 4]

Specifies a required role that a user must be assigned in order to access the specified port. The access is granted at the specified permission level, as follows:

Level 1—Read-only access. Can view port configuration and statistics.
Level 2—Level 1 plus the capability to configure port-lock, lock-share, and all traffic objects except port-pair.
Level 3—Level 2 plus the capability to configure port params (such as administrative status of the port, speed, duplex, and auto-negotiation), as well as port-pair.
Level 4—Level 3 plus the capability to change the port type.

For example:

(config) # port 24/1/x1 assign role Default level 1

buffer-index <<0-7> | low | default | high>

Configures a buffer-index value that allocates shared buffer space (memory) on specified ports to reduce oversubscription or to handle bursty traffic as follows:

0-7—Specifies a value for the buffer index.
low—Specifies a low buffer index, which is the same as a value of 3.
default—Specifies a default buffer index, which is the same as a value of 5.
high—Specifies a high buffer index, which is the same as a value of 7.

Use this parameter on tool and hybrid ports to reduce drops when the specified ports are oversubscribed or when traffic on the ports is bursty.

Note:  Configuring the buffer-index value as low or default. Configuring a high buffer-index value causes packet drop in network ports (as there are no buffers for the incoming traffic).

Use the show buffer-index command to display the configuration of the buffer index on ports.

Examples:

(config) # port 1/1/x1 buffer-index low

(config) # port 1/1/x2..x5 buffer-index 2

comment <comment>

Specifies a unique text string that describes the port. Comments can be up to 128 characters. Comments longer than one word must be enclosed in double quotation marks.

For example:

(config) # port 24/1/x1 comment “My port”

egress-vlan strip

Enables outer VLAN stripping on specified egress ports. The egress port type must be a tool or hybrid.

Use the show egress-vlantag command to display the configuration of outer VLAN stripping on egress ports.

Examples:

(config) # port 1/2/x1 egress-vlan strip

(config) # port 1/2/x2..x3 egress-vlan strip

If a port is configured for egress VLAN stripping, the port type cannot be changed until egress VLAN stripping is disabled. To disable outer VLAN stripping on specified egress ports:

(config) # no port 1/2/x1 egress-vlan strip

Note:  Port level egress VLAN stripping is only supported if from/source ports are not on the same node as tool/hyrbid port with egress-vlan strip in double tag mode on GigaVUE‑HC1-Plus, GigaVUE‑TA25, and GigaVUE‑TA25E.

Refer to “Configuring Egress Port VLAN Stripping” section in the GigaVUE Fabric Management Guide for details.

filter rule
   add <drop <criteria> | pass <criteria>>
   delete <all | rule-id <rule ID>>
   edit rule-id <rule-ID> [drop <criteria> | pass <criteria>]

Manages filters on the specified Egress port. Note that the filter argument is supported for tool, hybrid, circuit, and inline network ports. Network ports use maps to direct traffic.

 

Note:  Port filters for inline network ports are not supported on GigaVUE TA Series devices.

Note:  In the case of inline network LAG, the port filters must be applied on each of the inline network ports that are part of the inline network LAG.

The criteria available for egress port filters is mostly the same as that used for filters—you can create pass or drop filters based on the same packet criteria available for maps. You can see the available criteria in the CLI by typing a command similar to the following:

(config) # port <egress port number> filter rule add pass ?

Refer to the Port-Filters section in the GigaVUE Fabric Management Guide for a description of the available filter criteria.

 

Note:  You can configure egress port filters on a single port simultaneously. The filter argument is blocked when using the port command with multiple egress ports or port groups.

Examples:

The following tool port filter drops all packets with a VLAN ID between 100..200 from tool port 14/2/g40:

(config) # port 14/2/g40 filter rule add drop vlan 100..200

The following command passes only IPv6 traffic on tool port 14/2/g44:

(config) # port 14/2/g44 filter rule add pass ipver 6

Use the # show filter-resource command to view the maximum filter resources available and the filter resources used for a device.

Note:  Egress port filters are supported on GigaVUE‑TA25, GigaVUE‑TA25E,GigaVUE-HCT, and GigaVUE‑HC1-Plus, except that a) VLAN rules are not supported with port filters and b) either IPv4 or IPv6 type port filter rules are supported only if L2 circuit encapsulation tunnels or GS maps are used else both IPv4 and IPv6 rules are supported.

ingress-vlan-tag <2-4000>

Configures an ingress port VLAN tag, which is a number from 2 to 4000 that is added to a packet. The port must be a network or inline-network, or hybrid type of port.

For example:

(config) # port 7/1/x1 ingress-vlan-tag 100

Note:  On GigaVUE-TA25 and GigaVUE‑TA25E, ingress VLAN tagging is not supported on network ports associated with GSOP maps, and GSOP maps are not supported on network ports configured with ingress VLAN tag. This limitation is not applicable to the E-tag mode.

lock [description <description>]

Restricts use of the specified port for only your user account as follows:

Users with the admin role can lock any port in the system. Users with the Default/Operator role assigned can only lock ports to which their account has been granted access.
Administrators can lock a port for another user by including the optional user <username> argument.
You can optionally share a locked port with the lock-share argument.

Refer to the Setting Locks and Lock-Shares section in the GigaVUE Administration Guide for details on how locks are used.

For example:

(config) # port 7/1/x1 lock

lock-share <user <username>>

Shares a locked port with another user account. For example:

(config) # port 7/1/x1 lock-share user operator

mode <none | 4x10G | 4x25G | 2x40G>

 

 

 

 

 

Configures the port breakout mode as follows:

none—Specifies no port breakout mode. This is the default mode for GigaVUE nodes.
4x10G—Specifies the 4x10Gb port breakout mode. This mode provides a 4 x 10Gb breakout option for 100Gb/40Gb ports. The 4x10G mode only applies to GigaVUE-TA100, GigaVUE‑TA200, GigaVUE‑TA25, the PRT-HC3-C08Q08, PRT-HC3-C16, SMT-HC3-C05, and BPS-HC3-C25F2G modules on GigaVUE‑HC3,

Note:   Starting in software version 5.5, GigaVUE-TA40 supports 4x10Gb breakout at port level. Port breakout mode in GigaVUE-TA40 is configured as follows:

o 24 out of the 32 ports provide 4x10Gb breakout support. The first 12 ports and the last 12 ports provide support for breakout functionality with 96 sub-ports operating as 10Gb ports
■   Ports q1 to q12 and q21 to q32 support breakout functionality
■   Ports q13 to q20 do not support breakout functionality
■   Ports are named as q1x1….q1x4, q2x1...q2x4 (similar to other hardware platforms) to support the breakout functionality
4x25G—Specifies the 4x25G port breakout mode. This mode provides a 4 x 25Gb breakout option for 100Gb QSFP28 SR ports. The 4x25G mode only applies to GigaVUE‑TA200 , GigaVUE‑TA25, and the PRT-HC3-C08Q08, PRT-HC3-C16, and SMT-HC3-C05 modules on GigaVUE‑HC3.
2x40G—Specifies the 2x40G port breakout mode. This mode provides a 2x40Gb breakout option for 100Gb/40Gb ports. The 2x40G mode only applies to the PRT-HC3-C08Q08 module on GigaVUE‑HC3.

For the BPS-HC3-C25F2G module on GigaVUE‑HC3, refer to the GigaVUE-HC3 Hardware Installation Guide.

Note:  When there is a port breakout mode, the port command for the breakout port cannot be used with a “.. “ notation.

For Example:

To admin enable the port breakout mode:

(config) # port 1/1/c4x1 params admin enable

(config) # port 1/1/c4x2 params admin enable

The 100Gb ports that support 4x10Gb mode can operate at 40Gb speed with QSFP+ SR or PLR4 transceivers. When a parent port is configured in 4x10Gb, it can be broken out into four 10Gb ports, called subports. The subports will all have the same speed (10Gb). Subports have x1 to x4 appended to their port ID, for example, 1/1/c2x1.

The 100Gb ports that support 4x25Gb mode can be broken out into four times 25Gb ports, called subports. The subports will all have the same speed (25Gb). Subports have x1 to x4 appended to their port ID, for example, 1/1/c2x1.

The 100Gb ports that support 2x40Gb mode can operate at 40Gb speed with QSFP+ SR and LR transceivers. When a parent port is configured in 2x40Gb mode, it can be broken out into two 40Gb ports, called subports. The subports will all have the same speed (40Gb). Subports will have q1 to q2 appended to their port ID, for example, 1/1/c1q1 and 1/1/c1q2. The subports in the PRT-HC3-C08Q08 module on GigaVUE‑HC3 Control Card version 1 (CCv1) that function as stack ports must be of the same port type.

In general, subports created from port breakout modes can function as network, tool, or hybrid ports, as well as GigaStream port members, but they cannot function as stack ports. However, 10Gb stacking is supported only on GigaVUE‑TA25GigaVUE-TA100, and PRT-HC3-C08Q08 on GigaVUE‑HC3 when ports are broken out into 4x10Gb mode.

Use breakout cables or breakout panels (PNL-M341 or PNL-M343). Refer to the respective Hardware Installation Guide.

The default mode is none.

Note:   On GigaVUE-TA25 all port types are supported by breakout subports. Only C1, C5 ports support 4x10Gb, 4x25Gb break-out modes.

Note:  Each port can only have one mode.

Examples of configuring parent ports and subports are listed on the next page.

mode <none | 4x10G | 4x25G | 2x40G> (continued)

 

The following is an example of 4x10Gb mode:

(config) # port 1/1/c2 mode 4x10Gb

In this example, the subports will be 1/1/c2x1, 1/1/c2x2, 1/1/c2x3, and 1/1/c2x4. Once the 1/1/c2 port (the parent port) is in the 4x10Gb mode, it is no longer available to be used in any configuration. For example if 1/1/c2 is used in a map, it will be rejected as an invalid port. Refer to the next page for rules for configuring parent ports and subports.

When a parent port, for example, 1/1/c2, is broken out, you cannot specify, for example, 1/1/c1..c4 in a port list, since 1/1/c2 will be rejected as an invalid port. To specify all the ports from 1/1/c1 to 1/1/c4 in a port list, including the subports, use the syntax as follows:

(config) # show port params port-list 1/1/c1,1/1/c2x1..c2x4,1/1/c3..c4

Below are examples of valid port lists when 1/1/c2 is broken out:

1/1/c2x1..c2x4 includes 1/1/c2x1, 1/1/c2x2, 1/1/c2x3, 1/1/c2x4,

1/1/c2x2..c4 includes 1/1/c2x2, 1/1/c2x3, 1/1/c2x4

1/1/c3, 1/1/c41/1/c1..c2x3 includes 1/1/c1, 1/1/c2x1, 1/1/c2x2, 1/1/c2x3

Below are examples of invalid port lists when 1/1/c2 is broken out:

1/1/c2..c2x3, 1/1/c1..c3

The output of show commands will also display invalid ports. For example, when 1/1/c2 is broken out, but 1/1/c1 and 1/1/c3 are not, the following is displayed:

(config) # show port params port-list 1/1/c1..c3 brief

Port      Type        Alias        Admin     ---------------------------------------------1/1/c2    network     -            disabled  ! Invalid port 1/1/c31/1/c4    network     -            disabled  

The following is a 2x40Gb mode example:

(config) # port 1/1/c3 mode 2x40Gb

In this example, the subports will be: 1/1/c3q1 and 1/1/c3q2.

(config) # show port params port-list 1/1/c3q1..c3q2 brief

Port      Type        Alias        Admin     ---------------------------------------------1/1/c3q1    network     -            disabled  1/1/c3q2    network     -            disabled  

To change the port mode back to none, either clear the mode or set it to none, as follows:

(config) # no port 1/1/c2 mode

or

(config) # port 1/1/c2 mode none

The mode can be changed from 2x40Gb to 4x10Gb or from 4x10Gb to 2x40Gb without switching to none.

Rules for configuring parent ports and subports are listed on the next page.

mode <none | 4x10G | 4x25G | 2x40G> (continued)

 

The following are rules for configuring parent ports and subports:

You can change the port mode from none to 4x10Gb or 2x40Gb if the parent port has port-level configuration (any of the parameters under the port command). However, you cannot change the port mode from none to 4x10Gb or 2x40Gb if there is an egress port filter configured on the parent port. Remove the filter first, then change the mode.
You can change the port mode from 4x10Gb or 2x40Gb to none if the subports have port-level configuration (any of the parameters under the port command). However, you cannot change the port mode from 4x10Gb or 2x40Gb to none if there is an egress port filter configured on the subport. Remove the filter first, then change the mode.
You cannot change the port mode from none to 4x10Gb or 2x40Gb if there is any traffic configuration on the parent port such as map, map-passall, map-scollector, port-pair, or tool-mirror. Remove the traffic configuration first, then change the mode.
You cannot change the port mode from 4x10Gb or 2x40Gb to none if there is any traffic configuration on the subport such as map, map-passall, map-scollector, port-pair, or tool-mirror. Remove the traffic configuration first, then change the mode.
You cannot configure any parameters on a parent port if the port is broken out into subports. For example, if you try to configure port 1/1/c1 when it has subports 1/1/c1x1..c1/x4, the following error message is displayed:

(config) # port 1/1/c1 type tool% Invalid port '1/1/c1'.

You cannot configure any parameters on a subport if the port is not broken out into subports. For example, if you try to configure port 1/1/c2x1 when 1/1/c2 is not broken out, the following error message is displayed:

(config) # port 1/1/c2x1 type tool% Invalid port '1/1/c2x1'.

In general, subports cannot be configured as stack ports. An error message is displayed as follows:

(config) # port 1/1/c1x4 type stack% Port 1/1/c1x4 is not parent port and does not support type stack

or

(config) # port 5/4/c3q1 type stack

% Port 5/4/c3q1 is not parent port and does not support type stack

QSFP+ LR transceivers do not support 4x10Gb port breakout. If you try to breakout a port with QSFP+ LR transceiver, an error message is displayed as follows:

% Port 1/1/c3 does not support breakout mode

For the BPS-HC3-C25F2G module on GigaVUE‑HC3, if the default inline network (default_inline_net) is modified, you cannot change the port mode from none to 4x10Gb or from 4x10Gb to none. An error message is displayed as follows:

(config) # port 2/2/c1 mode none% Port '2/2/c1x1' is being used by:1) inline-network default_inline_net_2_2_1_1 (not default values)

params

Configures port administration and physical parameters.

 

admin <disable | enable>

Administratively enables or disables ports. Use the show port params command to see the administrative status of ports.

For example:

(config) # port 7/1/x1 params admin enable

 

autoneg <disable | enable>

Enables or disables auto-negotiation for a port. When auto-negotiation is enabled, duplex and speed settings are ignored.

Autonegotiation Limitations:

o Autonegotiation is always disabled for for 10Gb, 25Gb, 40Gb, and 100Gb ports.
o Auto-negotiation must be enabled for 1Gb speeds over copper, per the IEEE 802.3 specification.
o Auto-negotiation is not supported for 1Gb fiber ports on Gigamon Platforms.

Examples:

(config) # port 7/1/x1 params autoneg disable

(config) # port 1/2/g7 params autoneg enable

 

discovery <cdp | lldp | all | disable>

Configures port discovery options on network, tool, or circuit type ports, as follows:

cpd—Enables CDP port discovery.
lldp—Enables LLDP port discovery.
all—Enables both CDP and LLDP port discovery protocols.
disable—Disables port discovery.

For example:

(config) # port 7/1/x1 params discovery cdp

Discovery is disabled by default. To enable discovery, configure one or more protocols.

Refer to the “Port Discovery with LLDP and CDP” section in the GigaVUE Fabric Management Guide.

 

duplex <full>

Specifies the port's duplex configuration. Only full-duplex is supported.

Half duplex support is removed from all GigaVUE nodes. If half duplex was configured in a previous software version, it will remain intact following the upgrade to 5.2 or higher release. Update to full duplex, if required.

For example:

(config) # port 7/1/x1 params duplex full

 

fec <cl91|cl74|cl108| off>

Configures forward error correction (FEC) on the port to ensure error-free traffic over long distances. The values are:

cl91—Enables FEC on the port.
cl74— Enables FEC on the port.
cl108 — Enables FEC on the port for GigaVUE‑TA25 and GigaVUE‑TA25E.
off—Disables FEC on the port.

Note:  This option is available only on 25Gb and 100Gb transceivers.

For example:

(config) # port 7/1/x1 params fec cl91

 

forcelinkup <disable | enable>

Forces connection on an optical port. Use this option when an optical tool port is connected to a legacy optical tool that does not transmit light.

Forcelinkup is available as follows:

Available for tool ports.
Available for optical 40/100/400Gb network ports.
Not available for 10Gb-capable ports with a 1Gb SFP installed. 10Gb-capable optical tool ports only support forcelinkup when a 10Gb SFP+ is installed.
Not available on 100Gb ports with CFP2 transceivers.

Use forcelinkup on a tool port and optical 40/100/400Gb network ports. The forcelinkup status will be on when:

the tool port and network port are administratively enabled.
forcelinkup is enabled, with or without a transceiver or cable for the tool port.
the tool port link is up.
forcelinkup is enabled, with a transceiver or cable for the network port.
the network port link is up for 40/100/400Gb links.

For example:

(config) # port 7/1/x1 params forcelinkup enable

 

gdp <enable | disable>

Enables or disables the Gigamon discovery (GDP) on the port.

enable—Enables Gigamon discovery (GDP) on the port.
disable—Disables Gigamon discovery (GDP) on the port.

Gigamondiscovery is disabled by default on the port.

Gigamon discovery cannot be enabled on inline-tool and inline-network type ports.

 

speed <10 | 100 | 1000 | 10000 | 25000 | 40000 | 100000>

Sets the line speed of a port as follows:

10—10Mbps
100—100Mbps
1000—1Gbps
10000—10Gbps
25000—25Gbps
40000—40Gbps
100000—100Gbps

Sets the port speed in Mbps if auto-negotiation is off.

Examples:

(config) # port 1/1/x1 params speed 10000

(config) # port 7/1/c1 params speed 40000

Use 40000 and 100000 to change the port speed of each inline network port pair (c1/c2 or c3/c4) on the BPS-HC3-C25F2G module on GigaVUE‑HC3. You only need to configure one port in each pair.

Use 25000 to change the port speed on GigaVUE‑TA25E, GigaVUE‑HC1-Plus, GigaVUE‑TA200 and on the following GigaVUE‑HC3 modules:

PRT-HC3-X24
BPS-HC3-C25F2G
BPS-HC3-Q35C2G
BPS-HC3-C35C2G
PRT-HC1P-Q04X08
HC1P-C04X08

Note:  When AOC dual rate optics are used, the Link is down after changing the port speed from 40Gb to 100Gb between GigaVUE-HC3V2, PRT-HC3-C08, and GigaVUE‑TA25, GigaVUE‑TA25Edevices. To resolve this problem, first enable 40Gb speed in the GigaVUE‑TA25 and GigaVUE‑TA25E devices, then configure speed in the GigaVUE‑HC3 device.

 

ude <enable | disable>

Indicates whether the port is enabled for unidirectional (Ude) or bidirectional traffic. Enabled means Ude; Disabled means bidirectional.

For example, you can enable the port and disable unidirectional ethernet in a single line or separately:

(config) # port 7/1/x1 params admin enable ude disable

-or-

(config) # port 7/1/x1 params admin enable

(config) # port 7/1/x1 params ude disable

 

taptx <active | passive>

Opens or closes the copper TAP port relay. Active closes the port relay. Passive opens the port relay.

For example:

(config) # port 7/1/x1 params taptx active

ptp

<enable | disable>

Enables or disables PTP configuration on a port.

For example:

(config) # port 1/1/c1 ptp enable

(config) # port 1/1/c1 ptp disable

vlan <value>

Configures the PTP Port VLAN wihin the range 2-4000.

For example:

(config) # port 1/1/x1 ptp vlan <35>

Use the command show vlan-resource to identify available VLAN resources. Refer to show section for more information.

 

announce-interval <value>

Configures the time interval between PTP announce messages in the port in seconds on a logarithmic scale.

For Domain 0, the valid range is between -2 and 4 log seconds. The default is 1.
For Domain 24-43, the valid range is between -3 and 4 log seconds. The default is -3.

For example:

(config) # port 1/1/c1 ptp announce-interval -3

 

delay-req-interval <value>

Configures the minimum interval allowed between PTP delay request messages. The valid range is between -7 and 0 log seconds.

For Domain 0, the default is -5.
For Domain 24-43, the default is -4.

For example:

(config) # port 1/1/c1 ptp delay-req-interval -4

 

sync-interval <value>

Configures the time interval between PTP synchronization messages on the port. The valid range is between -7 and 0 log seconds.

For Domain 0, the default is -5.
For Domain 24-43, the default is -4.

For example:

(config) # port 1/1/c1 ptp sync-interval -4

threshold

 

<rx> [drop | error] [count | percent ] value <value>

Configures drop or error threshold parameters in the rx direction.

<tx> [drop | error] [count | percent ] value <value>

Configures drop or error threshold parameters in the tx direction.

 

tag-protocol-id <TPID value>

Configures a TPID value for the ingress port VLAN tag. The default value of TPID is 0x8100, and other supported values are 0x9100 and 0x88a8.

  • If tag-protocol-id is configured without ingress-VLAN-tag on the port, the CLI displays the following error message.

    "Ingress Vlan Tagging is not enabled on Port <port>; Configure ingress-vlan-tag before configuring tag-protocol-id"

  • Upon unconfiguring ingress-vlan-tag on a port, the tag-protocol-id configured on the respective port would be unconfigured (set to the default value: 0x8100).

For example:

(config) # port 1/1/x3 tag-protocol-id 0x88a8

 

timestamp <append-ingress | source-id <0-65535> | strip-egress>

Configures timestamping options.

For example:

(config) # port 7/1/x1 timestamp append-ingress

(config) # port 7/1/x1 timestamp source-id 500

timestamp

ingress insert

Configures ingress timestamp on a port.

Note:  Use these arguments for GigaVUE‑TA200 devices.

Note:  Use the show timestamp brief command to display the PTP based timestamp information.

For example:

(config) # port 1/1/c3 timestamp ingress insert

 

ingress source-id <value>

Specifies a unique ID for the ingress timestamp. The packets that ingress the port will be timestamped with this unique source ID. The source ID enables you to identify the port on which the timestamp is applied.

For example:

(config) # port 1/1/c3 timestamp ingress source-id 113

 

egress insert

Configures egress timestamp on a port.

For example:

(config) # port 1/1/c2 timestamp egress insert

 

egress source-id <value>

Specifies a unique ID for the egress timestamp. The packets that egress the port will be timestamped with this unique source ID. The source ID enables you to identify the port on which the timestamp is applied.

For example:

(config) # port 1/1/c2 timestamp ingress source-id 112

 

ingress disable

Disables the ingress timestamp on the port.

For example:

(config) # port 1/1/c3 timestamp ingress disable

 

egress disable

Disables the egress timestamp on the port.

For example:

(config) # port 1/1/c2 timestamp egress disable

tool-share role <user role>

Designates a tool port as available for tool-to-tool pass-alls (tool-mirrors) with the specified roles. For example:

(config) # port 7/1/x1 tool-share role admin

type <hybrid | inline-network | inline-tool | network | stack | tool | circuit>

Specifies a port as a hybrid, inline-network (input), inline-tool (output), network (input), tool (output), stack, or circuit port. For example, the following command configures port g2 in slot 2 on box 1 as a tool port:

(config) # port 1/2/g2 type tool

All ports on GigaVUE HC Series line cards or modules are available as network and tool ports.

Stack ports are supported at speeds of 10Gb, 40Gb, and 100Gb. However, stack ports are not supported on SFP-531 optics (10GBASE-T) and SFP+ 531T optics.

A hybrid port is a physical port that has a dual function as a network port and as a tool port. Refer to the “Working with Hybrid Ports” section in the GigaVUE Fabric Management Guide.

The inline-network and inline-tool type of ports can only be configured on GigaVUE HC Series nodes. Refer to the “Configuring Inline Bypass Solutions” chapter in the GigaVUE Fabric Management Guide.

Circuit ports are used to send or receive traffic that is tagged with a circuit ID. For more information, refer to the “Circuit Ports” section in the GigaVUE Fabric Management Guide.

l2gre-id <L2GRE identifier>

Configures the L2GRE ID that is added to the L2GRE group created for a specific device . The ID configured for the network port overrides the ID configured at the chassis-level.

For details about the CLI command used to configure the L2GRE group, refer to Configure L2GRE Group.

For example:

(config) # port 7/1/x1 l2gre-id 400

Note:  You cannot specify both L2GRE ID and VXLAN ID for a network port.

vxlan-id <VXLAN identifier>

Configures the VXLAN ID that is added to the VXLAN group created for a specific device. The ID configured for the network port overrides the ID configured at the chassis level.

For details about the CLI command used to configure the VXLAN group, refer to Configure VXLAN Group.

For example:

(config) # port 7/1/x1 vxlan-id 300

Note:  You cannot specify L2GRE ID and VXLAN ID for a network port.

header-strip <vxlan | mpls-l3| mpls-advanced>

 

Enables the Header Stripping functionality on the specified network or hybrid port.

For example:

(config) # port 1/1/c1 header-strip vxlan

(config) # port 1/1/c1 header-strip mpls-l3

 

Note:  You cannot enable VXLAN and MPLS Header Stripping on the same port. For more information, refer to the "VXLAN Header Stripping – Rules and Notes" and "MPLS Header Stripping – Rules and Notes" sections in the GigaVUE‑FM User's Guide.

Note:  The command mpls-l3 enables the L2 and L3 MPLS Header Stripping functionality on the GigaVUE‑TA400 device. For proper functioning of the L2 MPLS Header Stripping feature, a 4-byte control word field is required between the MPLS label stack and the Layer 2 data. This information is needed to correctly identify the Layer 2 protocol across the MPLS network.

header-strip

vxlan

Configure the port to strip the VXLAN header from incoming packets.

For example:

(config) # port 1/1/c1 header-strip vxlan

 

mpls-l3

Configure the port to strip the MPLS Layer 3 header from incoming packets.

For example:

(config) # port 1/1/c1 header-strip mpls-l3

mpls-advanced <ip4-wo-options | ip4-options | ipv6 | l2-wo-cw-ach | l2-cw-ach>

Configure the port for advanced MPLS Header Stripping, which supports more complex packet formats. This feature is exclusively available for the GigaVUE-TA400 device.

Refer to the Advanced MPLS Header Stripping for GigaVUE-TA400 section in the GigaVUE Fabric Management Guide for a description of the advanced MPLS Header Stripping.

 

ip4-wo-options

Configure the port to strip the MPLS Header from the L3 MPLS IPv4 (without options) packets. IPv4 without options has a standard 20-byte header for efficient routing.

For example:

(config) # port 1/1/d1 header-strip mpls-advanced ip4-wo-options

 

ip4-options

Configure the port to strip MPLS Header from the L3 MPLS IPv4 (with options) packets. IPv4 with options includes additional fields (up to 60 bytes) for advanced functions like time stamping.

For example:

(config) # port 1/1/d1 header-strip mpls-advanced ip4-options

 

ipv6

Configure the port to strip the MPLS header from the L3 MPLS IPv6 packets. The standard IPv6 header (40 bytes) follows the MPLS label stack and contains source and destination IPv6 addresses, flow label, and other fields.

For example:

(config) # port 1/1/d1 header-strip mpls-advanced ip6

 

l2-wo-cw-ach

Configure the port to strip the outer Ethernet and MPLS headers from the incoming L2 MPLS without Control Word(CW) or Associated Channel Header(ACH) packets. L2 MPLS without CW or ACH provides a basic MPLS label-switched path for transporting Layer 2 packets without the extra control, sequencing, or signaling functionalities provided by the CW and ACH headers.

For example:

(config) # port 1/1/d1 header-strip mpls-advanced l2-wo-cw-ach

 

l2-cw-ach

Configure the port to strip the outer Ethernet and MPLS headers along with Control Word (CW) or Associated Channel Header(ACH) from the incoming L2 MPLS with CW or ACH packets. L2 MPLS with CW ensures packet sequencing and integrity for Layer 2 frames, while ACH enables Operations, Administration, and Maintenance (OAM) transport for network monitoring and management, especially in MPLS traffic.

For example:

(config) # port 1/1/d1 header-strip mpls-advanced l2-cw-ach

zr-optics <add-tx-opt-pow | app-code | grid-frequency | grid-spacing | part-number>

The zr-optics command configures the interoperability between Innolight 400Gb and Cisco ZR/ZR+ optics when connected to a GigaVUE-TA400 and paired with Cisco ZR/ZR+ optics in a Cisco Router under OpenZR compliance. It manages the necessary low-level parameter tuning required for connection stability and performance.

Note:  Avoid hot-swapping, reloading, or power cycling while executing configuration commands, as this may interrupt the firmware update process.

For example:

(config) # port 1/1/d1 zr-optics zr-grid-spacing 6250 zr-grid-frequency 192000 zr-add-tx-opt-pow -2.5 zr-app-code 5 part-number DP04QSDD-HE0-19

zr-optics

add-tx-opt-pow

Configures the ZR+ optics transmit power offset in increments of 0.5 dBm. ZR+ optics transmit power ranges from -5 to +5 dBm in increments of 0.5.

For example:

(config) # port 1/1/d1 params zr-add-tx-opt-pwr 2.5

app-code

Configure the ZR+ application select code, with options ranging from 1 to 8. ZR+ application select code ranges from 1 to 8. It is applicable only for Cisco ZR/ZR+ optics.

For example:

(config) # port 1/1/d1 params zr-appselcode 1

grid-frequency

Configures the ZR+ grid frequency in GHz, ensuring alignment between devices. ZR+ grid frequency ranges from 191300 to 196200 GHz in increments of 100. The default value is 193100 GHz.

For example:

(config) # port 1/1/d1 params zr-frequency 192000

grid-spacing

Configure the ZR+ grid spacing in MHz, which must match between interconnected optics. ZR+ grid spacing ranges from 3125, 6250, 12500, 25000, 33000, 50000, 75000, and 100000 MHz. The 33,000 MHz ZR+ grid spacing is supported only on Innolight optical transceivers. The default value is 100000 MHz.

For example:

(config) # port 1/1/d1 params zr-grid-spacing 6250

part-number

Configure the part number for ZR/ZR+ optics, which is required for offline provisioning. The part numbers of the ZR/ZR+ optics are listed below.

  • Cisco ZR/ZR+ Optics: DP04QSDD-HE0-19

  • Innolight ZR+ Optics: DP04QSDD-HE0-19

  • Innolight ZR Optics: GMONDS400SZRTA0

For example:

(config) # port 1/1/d1 zr-optics part-number DP04QSDD-HE0-19

Related Commands

The following table summarizes other commands related to the port command:

Task

Command

Displays all port parameters in table format.

# show port

Displays all port access.

# show port access all

Displays port access for a specified box.

# show port access box-id 2

Displays port access for a specified box in table format.

# show port access box-id 2 brief

Displays port access for a specified port list.

# show port access port-list 2/1/x1..x2

Displays port access for a specified port list in table format.

# show port access port-list 2/1/x1..x4 brief

Displays port access for a specified slot.

# show port access slot 1

Displays port access for a specified slot in table format.

# show port access slot 1 brief

Displays all port aliases.

# show port alias

Displays all port assignments.

# show port assignment all

Displays port assignments for a specified box.

# show port assignment box-id 3

Displays port assignments for a specified box in table format.

# show port assignment box-id 3 brief

Displays port assignments for a specified port list.

# show port assignment port-list 3/8x1

Displays port assignments for a specified port list in table format.

# show port assignment port-list 3/8x1 brief

Displays port assignments for a specified slot.

# show port assignment slot 3/8

Displays port assignments for a specified slot in table format.

# show port assignment slot 3/8 brief

Displays all port comments.

# show port comment

Displays port discovery information.

# show port discovery

Displays port discovery information for a specified box.

# show port discovery box-id 2

Displays port discovery information for a specified box in table format.

# show port discovery box-id 2 brief

Displays port discovery information in table format.

# show port discovery brief

Displays port discovery information in table format for a specified port list.

# show port discovery brief port-list 2/1/x1

Displays port discovery information for specified port lists.

# show port discovery port-list 2/1/x1..x4

Displays port discovery information for specified port lists in table format.

# show port discovery port-list 2/1/x1..x4 brief

Displays port discovery information for the specified slot.

# show port discovery slot 4

Displays port discovery information for the specified slot in table format.

# show port discovery slot 4 brief

Displays faceplate port number mapping to GigaVUE‑OS port number.

# show port faceplate-number-mapping

Displays faceplate port number mapping to GigaVUE‑OS port number for a specified port list.

# show port faceplate-number-mapping port-list 2/1/x1

Displays all port filters.

# show port filter

Displays port filters for a specified port list.

# show port filter port-list 2/1/x1

Displays port filter statistics for all line cards

# show port filter stats all

Displays port filter statistics for a line card placed inside the specified box.

# show port filter stats box-id 1

Displays port filter statistics for the specified list of ports.

# show port filter stats port-list 1/1/x1..x6

Displays port filter statistics for a line card placed at the specified slot.

# show port filter stats slot 1

Displays all ports that are in use by any maps (first-level, second-level maps) in table format.

# show port in-use

Displays all ports that are in use by any maps for the specified port type: network, tool, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port in-use type hybrid

Displays the port mode on all ports of GigaVUE nodes that support port mode.

# show port mode

Displays the port mode for the specified box.

# show port mode box-id 1

Displays the port mode for the specified slot.

# show port mode slot 1

Displays all port parameters.

# show port params

Displays all port parameters.

# show port params all

Displays port parameters for a specified box.

# show port params box-id 2

Displays port parameters for a specified box in table format.

# show port params box-id 2 brief

Displays brief port parameter information on the specified box ID for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 brief type stack

Displays all port parameters that are in use by any maps for the specified box.

# show port params box-id 2 in-use

Displays all port parameters that are in use by any maps for the specified box, in table format.

# show port params box-id 2 in-use brief

Displays all port parameters that are in use by any maps for the specified box, in table format, and for the specified port type: network, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 in-use brief type tool

Displays all port parameters that are in use by any maps for the specified box and for the specified port type: network, tool, hybrid, circuit, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 in-use type tool

Displays port parameter information on the specified box ID for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 type stack

Displays all port parameters that are not in use by any maps for the specified box.

# show port params box-id 2 unused

Displays all port parameters that are not in use by any maps for the specified box, in table format.

# show port params box-id 2 unused brief

Displays all port parameters that are not in use by any maps for the specified box, in table format, and for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 unused brief type hybrid

Displays all port parameters that are not in use by any maps for the specified box and for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params box-id 2 unused type hybrid

Displays all port parameters in table format.

# show port params brief

Displays port parameters in table format for a specified port list.

# show port params brief port-list 2/1/x1..x2

Displays all port parameters that are in use by any maps.

# show port params in-use

Displays all port parameters that are in use by any maps for the specified port type: network, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params in-use type inline-network

Displays all port parameters for a specified port list. It also displays the ports and sub-ports in the specified range.

# show port params port-list 2/1/x1..x4

Displays all port parameters for a specified port list in table format. It also displays the ports and sub-ports in the specified range.

# show port params port-list 2/1/x1..x4 brief

Displays all port parameters for a specified slot.

# show port params slot 3

Displays all port parameters for a specified slot in table format.

# show port params slot 3 brief

Displays brief port parameter information on the specified slot ID for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 brief type gs

Displays all port parameters that are in use by any maps for the specified slot.

# show port params slot 3 in-use

Displays all port parameters that are in use by any maps for the specified slot, in table format.

# show port params slot 3 in-use brief

Displays all port parameters that are in use by any maps for the specified slot, in table format, and for the specified port type: network, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 in-use brief type network

Displays all port parameters that are in use by any maps for the specified slot and for the specified port type: network, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 in-use type network

Displays port parameter information on the specified slot ID for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 type gs

Displays all port parameters that are not in use by any maps for the specified slot.

# show port params slot 3 unused

Displays all port parameters that are not in use by any maps for the specified slot, in table format.

# show port params slot 3 unused brief

Displays all port parameters that are not in use by any maps for the specified slot, in table format, and for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 unused brief type network

Displays all port parameters that are not in use by any maps for the specified slot and for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params slot 3 unused type stack

Displays port parameter information for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params type tool

Displays all port parameters that are not in use by any maps.

# show port params unused

Displays all port parameters that are not in use by any maps for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port params unused type inline-tool

Displays GigaVUE‑OS port number mapping to faceplate port number.

# show port port-number-mapping

Displays GigaVUE‑OS port number mapping to faceplate port number for a specified port list.

# show port port-number-mapping port-list 2/1/x1

Displays all port statistics.

# show port stats all

Displays port statistics for a specified box.

# show port stats box-id 2

Displays port statistics for a specified port list.

# show port stats port-list inNet1

Displays port statistics for a specified slot.

# show port stats slot 1

Displays share-tool-mirror roles for all ports.

# show port tool-share all

Displays share-tool-mirror roles for a specified box.

# show port tool-share box-id 2

Displays share-tool-mirror roles for a specified port list.

# show port tool-share port-list 2/1/x1..x4

Displays share-tool-mirror roles for a specified slot.

# show port tool-share slot 1

Displays port information for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port type network

Displays all ports that are not in use by any maps (first-level, second-level maps), in table format.

# show port unused

Displays all ports that are not in use by any maps for the specified port type: network, stack, tool, circuit, hybrid, inline-network, inline-tool, or gs for GigaSMART engine port.

# show port unused type tool

Displays port utilization for all line cards or modules.

# show port utilization all

Displays port utilization for a specified box.

# show port utilization box-id 2

Displays port utilization for a specified port list.

# show port utilization port-list 2/1/x1..x4

Displays port utilization for a specified slot.

# show port utilization slot 3

Displays the L2GRE ID configured for the network port.

# show port l2gre

Displays the VXLAN ID configured for the network port.

# show port vxlan

Displays buffer profile current information.

# show profile current buffer all

Displays a minute of buffer profile history information.

# show profile history buffer 2/1/x1 min

Displays ports with modified buffer index.

# show buffer-index

Displays buffer usage by box ID.

# show buffer box-id 2

Displays buffer usage by port ID.

# show buffer port 2/1/x1

Displays buffer usage by port ID and direction.

# show buffer port 2/1/x1 rx

Displays buffer usage by slot.

# show buffer slot 1

Displays all ingress port VLAN tags.

# show ingress-vlan-tag

Displays the list of ports on which the Header Stripping protocol is enabled for a box ID.

# show port header-strip box-id 1

Displays the details of the Header Stripping protocol that is enabled for the specified port.

# show port header-strip port-list 1/1/c1

Displays the list of ports on which the Header Stripping protocol is enabled for all the box IDs.

# show port header-strip box-id all

Displays the list of ports on which the specified Header Stripping protocol is enabled for all the box IDs.

# show port header-strip box-id all type <mpls-l3|vxlan| mpls-advanced>

Displays the VLAN resources that are available.

#show vlan-resource

Deletes the utilization alarm threshold for a specified port.

(config) # no port 1/1/x1 alarm buffer-threshold

Deletes the utilization alarm threshold for a specified port in a specified direction.

(config) # no port 1/1/x1 alarm buffer-threshold rx

Deletes the port alias for a specified port.

(config) # no port 1/1/x1 alias

Deletes all assigned roles.

(config) # no port 1/1/x1 assign all

Deletes a specified assigned role for a specified port.

(config) # no port 1/1/x1 assign role admin

Deletes a comment for a specified port.

(config) # no port 1/1/x1 comment

Disables outer VLAN stripping on specified egress ports.

(config) # no port 1/2/x1 egress-vlan strip

Deletes VLAN tagging for a specified port.

(config) # no port 1/1/x1 ingress-vlan-tag

Unlocks a specified port.

(config) # no port 1/1/x1 lock

Does not allow any user to share lock privileges.

(config) # no port 1/1/x1 lock-share all

Does not allow a specified user to share lock privilege.

(config) # no port 1/1/x1 lock-share user operator

Clears the port breakout mode.

(config) # no port 1/1/c1 mode

or

(config) # port 1/1/c1 mode none

Deletes all timestamp bytes appended to a specified port in the ingress direction.

(config) # no port 1/1/x1 timestamp append-ingress

Deletes all timestamp bytes stripped from a specified port in the egress direction.

(config) # no port 1/1/x1 timestamp strip-egress

Deletes all roles from a specified port’s share-tool-mirror list.

(config) # no port 1/1/x1 tool-share all

Deletes a specified role from a specified port’s share-tool-mirror list.

(config) # no port 1/1/x1 tool-share role monitor

Disables the PTP configurations on a particular port. However, the PTP VLAN ID for the port will be displayed in the “show running config” output.

(config) # no port 1/1/c1 ptp enable

Removes the L2GRE ID configured for the specified network port.

(config) # no port 1/1/x1 l2gre-id

Removes the VXLAN ID configured for the specified network port.

(config) # no port 1/1/x1 vxlan-id

Displays the ingress or egress timestamp details in a table format.

(config) #show timestamp brief

Disables the Header Stripping protocol on the specified port.

(config) # no port 1/3/x16 header-strip

Disables the Header Stripping protocol on all the ports.

(config) # no port all header-strip

Clears the port filter statistics for all the line cards.

(config) # clear port filter stats all

Clears the port filter statistics for a line card placed inside the specified box.

(config) # clear port filter stats box-id 2

Clears the port filter statistics for the specified list of ports.

(config) # clear port filter stats port-list 2/1/x1..x4

Clears the port filter statistics for a line card placed at the specified slot.

(config) # clear port filter stats slot 1

Displays configuration, part numbers, App code, grid frequency, grid spacing, and Transmit (Tx) optics power for each port

(config) # show port zr-optics