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