port-group

Required Command-Line Mode = Configure

Use the port-group command to create groups of network or tool ports. Ports can belong to multiple groups. However, you cannot mix port types in a single group, and the ports within a port group must be on the same chassis.

Starting in software version 4.8, port groups used in GTP overlapping maps support GigaStream.

Starting in software version 5.1, port groups support a list of tunnel endpoints.

Port groups are used to simplify administration of Deep Observability Pipeline ports, allowing you to group ports with a similar purpose for convenience in identification.

Note:  Keep in mind the following points when using port groups together with role-based access:

■   To access any port in a port group, a user must have roles assigned that grant access to all ports in the port group.
■   If a user has different permissions on different ports in a port group, the system will assign the user the lowest of those assigned permissions for all ports in the port group.

The port-group command has the following syntax:

port-group alias <alias>
  comment <comment>
   gigastream-list <list of GigaStream aliases>
   port-list <port-id | port-alias | port-list | inline-network-alias | inline-network-group-alias>
   smart-lb <disable | enable>
   te-list <list of tunnel endpoints> or <range of tunnel endpoints>
   weight <port ID | te-id> <1-100>

The following table describes the arguments for the port-group command:

Argument

Description

alias <alias>

Specifies a name for the port group.

For example:

(config) # port-group alias pg1

comment <comment>

Optionally, you can supply a comment for the port group.

For example:

(config) # port-group alias pg1 port-list 2/1/x1..x2 comment “Port Group 1”

gigastream-list <list of GigaStream aliases>

Specifies a list of GigaStreams to include in this port group. This parameter is only supported for GTP forward listing and GTP flow sampling, in which port groups are used in overlapping maps.

For example:

(config) # port-group alias pg1 gigastream-list GTP-sample1

Refer to the GigaSMART GTP Whitelisting and GTP Flow Sampling” section in the GigaVUE Fabric Management Guide.

port-list <port-id | port-alias | port-list |    inline-network-alias |    inline-network-group-alias>

Specifies the ports to include in this port group. Use one of the following:

port-id, port-alias, port-list—Specifies a port using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.
inline-network-alias—Specifies an inline network alias.
inline-network-group-alias—Specifies an inline network group alias.

smart-lb <disable | enable>

Enables or disables GigaSMART load balancing. The default is disabled.

For example:

(config) # port-group alias pg1 smart-lb enable

To use the te-list parameter of the port-group command for tunnel load balancing for L2GRE tunnel encapsulation, smart-lb must be enabled.

<list of tunnel endpoints> or <range of tunnel endpoints>

Specifies the list of destinations to which to send from the tunnel to the tunnel endpoints. This parameter is only supported for Layer 2 GRE encapsulation.

Specify the tunnel endpoint identifiers or aliases, or a range of tunnel endpoint identifiers using the following syntax:

Tunnel endpoint identifiers and/or aliases in a comma separated list. The maximum number supported in the list is 16.
Tunnel endpoint identifiers as a range. Only tunnel endpoint identifiers are supported in the range.

Examples:

(config) # port-group alias pg1 te-list te1,te2,te3

(config) # port-group alias pg1 te-list teAlias1,teAlias2

(config) # port-group alias pg1 te-list teAlias1,te2

(config) # port-group alias pg1 te-list te1..te20

Note:  A mix of tunnel endpoints with port-list or gigastream-list is not supported in a port group.

weight <port ID | te-id> <1-100>

Specifies load balancing weights for the ports in the port list or the tunnel endpoints in the tunnel endpoint list.

Weights apply to Weighted Round Robin (wt-round-robin), Weighted Least Bandwidth (wt-lt-bw), Weighted Least Packet Rate (wt-lt-pkt-rate), Weighted Least Connection (wt-lt-conn), and Weighted Least Cumulative Traffic (wt-lt-tt-traffic) load balancing metrics. Weighted Least Bandwidth (wt-lt-bw) is not support for tunnel.

The value of weight is from 1 to 100. The default is 1.

Weight is optional for tunnel endpoints. Weight is specified on one tunnel endpoint at a time.

Examples:

(config) # port-group alias pg2 weight 2/1/x1 30

(config) # port-group alias pg2 weight te1 50

Related Commands

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

Task

Command

Displays port groups.

# show port-group

Displays detailed information for a specified port group.

# show port-group alias pg1

Displays all port groups.

# show port-group all

Displays all port groups in table format.

# show port-group brief

Displays load balancing statistics for a specified port group.

# show load-balance port-group stats alias portgrp1

Displays load balancing statistics for all port groups.

 

NOTE:

After the delete request and response, the Active Sessions count stats in the output of "show load-balance port-group stats all" command will be cleared only after 4 minutes approximately.

 

In Standalone UPN, the LB Active Sessions count may display incorrect values in case of engine grouping.

# show load-balance port-group stats all

Deletes a specified port group.

(config) # no port-group alias pg1

Deletes a GigaStream list from a specified port group.

(config) # no port-group alias pg1 gigastream-list

Deletes a port list from a specified port group.

(config) # no port-group alias pg1 port-list

Deletes a tunnel endpoint list from a specified port group.

(config) # no port-group alias pg1 te-list

Deletes all port groups.

(config) # no port-group all