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:
|
|||||||||
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:
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 |