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 GigaVUE Visibility Platform 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 list selective forwarding - forward (formerly whitelist)ing 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.

# 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