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 Seriesnodes.

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> nomenclature1/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 chassisup 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

Note:  You can group The front and rear GigaSMART cards in GigaVUE‑HC1-Plus by enabling the ipsrc-ipdst hash settings.

gtp-persistence pause <time interval in mins> This command creates an immediate backup as soon as the pause interval is configured. Immediate backup happens within 1 minute of the pause interval configuration.
gtp-persistence pause <time interval in mins> skip back-up This command is used to skip immediate backup.

 

gsgroup alias <GSGROUP-ALIAS> gtp-persistence ?

Argument

Description

download

Download persistence data base file from the remote server

pause

Pause GTP Persistence data base sync up

resume

Resume GTP Persistence data base sync up

upload Upload persistence data base file to the remote server

 

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download ?

<URL for the GTP Persistence data base file download> http, scp and sftp are supported. e.g. scp://username[:password]@hostname/path/filename

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename ?

all Upload the data base file for all the Engines

slot GigaSMART Card Slot Number for which file needs to be uploaded

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename all ?

<cr>

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename slot ?

<Slot Number of the GigaSmartCard> Specifiy GigaSMART card Slot Number

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename slot 3 ?

engine GigaSMART Card Engine Number for which file needs to be uploaded

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename slot 3 engine ?

<Engine Number of the GigaSMART Card> Specify GigaSMART card Engine Number

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence download scp://username[:password]@hostname/path/filename slot 3 engine 2 ?

<cr>

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence pause ?

<Pause Parameter> Specify time (number of mins) for which Persistence data base will be paused

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence pause 120 ?

<cr>

skip-backup Pause GTP Persistence Data Base sync up without immediate backup

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence pause 120 skip-backup ?

<cr>

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence resume ?

<cr>

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload ?

<URL for the GTP Persistence data base file upload> http, scp and sftp are supported. e.g. scp://username[:password]@hostname/path/filename

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ ?

all Upload the data base file for all the Engines

slot GigaSMART Card Slot Number for which file needs to be uploaded

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ all ?

<cr>

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ slot ?

<Slot Number of the GigaSmartCard> Specifiy GigaSMART card Slot Number

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ slot 3 ?

engine GigaSMART Card Engine Number for which file needs to be uploaded

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ slot 3 engine ?

<Engine Number of the GigaSMART Card> Specify GigaSMART card Engine Number

hc3-01 [clusterId: normal] (config) # gsgroup alias <GSGROUP-ALIAS> gtp-persistence upload scp://username[:password]@hostname/path/ slot 3 engine 2 ?

<cr>

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