gsgroup

Required Command-Line Mode = Configure

Use GigaSMART groups to manage and budget GigaSMART processing power.

Use the gsgroup command to create groups of GigaSMART engine ports in a given chassis. In turn, each GigaSMART operation you create must be assigned to a GigaSMART group.

This command does not apply to GigaVUE TA Series nodes.

The gsgroup command has the following syntax:

gsgroup alias <alias>    port-list <port-list>

GigaSMART engine ports (e ports) are numbered with an e prefix using <bid/sid/e1..e2> nomenclature—1/1/e1, for example or 3/2/e1..e2.

The number of GigaSMART engine ports available in a chassis depends on the number of GigaSMART line cards or modules in the chassis—up to four in the GigaVUE‑HC3, and up to five in the GigaVUE‑HC2 (four front GigaSMART modules with one GigaSMART engine port each, and one rear GigaSMART module with one GigaSMART engine). The GigaVUE‑HC1 has one GigaSMART engine port.

Notes: 
● You cannot combine different generations of GigaSMART cards in the same GigaSMART group.
● You should always allow a maximum of 3 minutes time gap when you delete and recreate a gsgroup.

The following table describes the arguments for the gsgroup command:

Argument

Description

alias <alias>

Specifies an alias for the GigaSMART group (gsgroup). The maximum number of characters supported in an alias is 128.

port-list <port-list>

Specifies engine ports. Use one or more of the following separated by commas—no spaces or tabs are allowed:

● port-id—<bid/sid/pid> where pid is e1 or e2
● port-list—<bid/sid/pid_x,bid/sid/pid_y,bid/sid/pid_z> (list) where pid is e1 or e2

The port-list argument lets you select multiple non-contiguous ports. To enter port IDs in a list, simply put a comma between each port ID in the list.

The <bid/sid/pid_x..pid_y> format lets you select a series of adjacent ports (for example, 1/5/x4..x6 selects port x4..x6 on slot 5).

For example:

(config) # gsgroup alias gsg1 port-list 1/1/e1

hash

Allows the GigaSMART group to hash based on the following options:

● advanced—Hashing based on the fabric advanced-hash fields (refer fabric advanced-hash)
● ipsrc-ipdst—Hashing based on the two tuple hashing

Related Commands

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

Task

Command

Displays all GigaSMART groups.

# show gsgroup

Displays a specified GigaSMART group.

# show gsgroup alias gsg1

Displays all GigaSMART groups.

# show gsgroup all

Displays a flow-ops report.

Refer to the “GigaSMART Group Flow Ops Report Statistics Definitions” section in the GigaVUE Fabric Management Guide.

# show gsgroup flow-ops-report alias gsg1 type <flow-sampling | ssl-decryption | flow-filtering | flow-sip | inline-ssl>

Displays a particular IMSI associated with the GigaSMART group.

# show gsgroup flow-whitelist alias gsg1 imsi 318260109318283

Displays GigaSMART resources for a specified GigaSMART group.

# show gsgroup gsapp-resource alias gsg1

Displays GigaSMART resources for all GigaSMART groups.

Note:  Occasionally, the GigaSMART line card or module will need to be reloaded for changes to take effect and to allocate resources accordingly. Reloading also provides applications with contiguous memory.

The following message displays at the bottom of the output of the show gsgroup gsapp-resource command when the GigaSMART line card or module needs to be reloaded:

*Resource allocation changes have been made that require GigaSMART card 2/1/1 to be reloaded in order for them to take effect.

When this message is displayed, you cannot change the configuration relating to that application until after the reload. For example, you cannot use the gsop, associated with the gsgroup, in a map.

Use the card slot command to reload a GigaSMART line card or module.

# show gsgroup gsapp-resource all

Displays GTP stateful session recovery information for a specified GigaSMART group.

# show gsgroup gtp-persistence alias gsg1

Displays GTP stateful session recovery information for all GigaSMART groups.

# show gsgroup gtp-persistence all

Displays a report of a SIP forward list for a specified GigaSMART group and caller ID.

# show gsgroup sip-whitelist alias gsg1 caller-id 302701237777777

Displays statistics for a specified GigaSMART group.

# show gsgroup stats alias gsg1

Displays statistics for all GigaSMART groups.

# show gsgroup stats all

Deletes a specified GigaSMART group.

(config) # no gsgroup alias gsg1

Deletes all GigaSMART groups.

(config) # no gsgroup all