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> ingress-rate <50-100>

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. The GigaVUE‑HC1 has one GigaSMART engine port.

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.
ingress-rate	Allows to configure the traffic ingress rate limit to GigaSMART group. The range of this ingress rate field is from 50%- 100%. By default the rate would be 100%. Note:  This is applicable only for SMT-HC3-C08, SMT-HC1-S, SMT-HC1A-R GigaSMART cards.
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. This is applicable only for Gen2 cards. 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 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