gigastream

Required Command-Line Mode = Configure

Use the gigastream command to group multiple ports into a logical bundle called a GigaStream.

Starting in software version 4.8, there are two types of GigaStream: regular GigaStream and controlled GigaStream. Controlled GigaStream has GigaStream controlled traffic distribution.

Note:  Regular GigaStream and controlled GigaStream are not interchangeable. You cannot change the type of GigaStream from regular to controlled on the fly.

All participating ports in any type of GigaStream must be running the same speed and must use the same port type.

Refer to the “GigaStreamsection in the GigaVUE Fabric Management Guide for details on configuring GigaStream.

Weighted GigaStream provides you the ability to distribute traffic to the ports by assigning either an equal weight or a custom weight to the ports. For more information about the Weighted GigaStream, refer to the "Weighted GigaStream" section in the GigaVUE-FM User's Guide.

The gigastream command is also used as part of the configuration of the leaf and spine architecture with multiple paths for achieving high availability in a cluster environment. Refer to the “Multi-Path Leaf and Spine” section in the GigaVUE Fabric Management Guide for details.

The gigastream command has the following syntax:

gigastream   
  advanced-hash   
alias <alias>       
comment <comment>   
   hash-bucket-id <ID/range> <port <port ID/port range>> 
   hash-size <1-256>
  port-list <port-list> [params hash advanced]
  hash-weight <weight-list>
  drop-weight <weight>
  rehash

The following table describes the arguments for the gigastream command:

Argument

Description

advanced-hash

Refer to gigastream advanced-hash.

alias <alias>

Specifies an alias for the GigaStream. The maximum number of characters supported in an alias is 128. Each GigaStream name should be unique across the configured GigaStreams.

For example:

(config) # gigastream alias stream1

comment <comment>

Specifies a unique text string that describes the GigaStream. Comments can be up to 128 characters. Comments longer than one word must be enclosed in double quotation marks.

For example:

(config) # gigastream alias stream1 comment “first GigaStream

hash-bucket-id <ID/range> <port <port ID/port range>>

Specifies the mapping of hash bucket IDs to tool ports. Use this command to add tool ports to the GigaStream and to map the port to a specified hash bucket ID.

The number of hash bucket IDs have the same range as the hash size, from 1 to 256. A port ID or range cannot exceed the size specified by the hash-size parameter.

Ports are specified by their port ID or range of port IDs, so the port ID or range can take a specific hash bucket ID or a range of IDs to be mapped to a port.

Examples:

(config) # gigastream alias stream1

(config gigastream alias stream1) # hash-size 5

(config gigastream alias stream1) # hash-bucket-id 1..5 port 1/1/x1..x5

or

(config) # gigastream alias stream2

(config gigastream alias stream1) # hash-size 10

(config gigastream alias stream2) # hash-bucket-id 1 port 1/2/x1

(config gigastream alias stream2) # hash-bucket-id 2 port 1/2/x2

(config gigastream alias stream2) # hash-bucket-id 3 port 1/2/x3

(config gigastream alias stream2) # hash-bucket-id 4 port 1/2/x4

This parameter applies to controlled GigaStream only.

If a hash bucket ID is already configured to a port, for example port x1, if you change it to port x2, then port x2 replaces port x1.

At least one hash bucket ID should be mapped to a port before a GigaStream can be attached to a map.

hash-size <1-256>

Specifies the size of the hash bucket for the trunk required. The values are from 1 to 256. This will create a controlled GigaStream of the hash size specified.

For example:

(config) # gigastream alias stream1

(config gigastream alias stream1) # hash-size 5

This parameter applies to controlled GigaStream only.

The hash size can be increased or decreased. Refer to the “Editing Controlled GigaStreamsection in the GigaVUE Fabric Management Guide.

port-list <port-list>

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

o port-id—<bid/sid/pid>
o port-alias—<port-alias>
o port-list—<bid/sid/pid_x..pid_y> (range) | <bid/sid/pid_x,bid/sid/pid_y,bid/sid/pid_z> (list)

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

For GigaVUE TA Series, GigaVUE‑OS on a white box, and GigaVUE-HB1, the slot ID (sid) is always designated as 1 as there is only a single slot.

When creating a cross-module GigaStream on a GigaVUE‑HC2 or GigaVUE‑HC3, use the same syntax, while identifying the correct slot ID (sid) for each port.

Note:  All of the ports in the GigaStream must be running at the same speed—1Gb, 10Gb, 40Gb, or 100Gb and must use the same port types (all g, x, q, or c). All of the ports in the Gigastream must be in the same slot.

A stack GigaStream must consist of ports with 10Gb speed or higher.

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.

This parameter does not apply to controlled GigaStream.

params hash advanced

Specifies how traffic should be hashed across member ports in the GigaStream. There is only one option—advanced. Use the gigastream advanced-hash command to select the criteria for the advanced-hash. Refer to gigastream advanced-hash for details.

Refer to the “Regular GigaStream Failover Protection” section in the GigaVUE Fabric Management Guide for details on how traffic hashing changes depending on the number of ports in the GigaStream.

hash-weight <weight>

Specifies the custom weight for the ports based on which traffic is directed in the GigaStream. You can assign the custom weight in ratio or percentage.

Separate each weight in the list with a comma. For example:

Custom weight in ratio:

(config gigastream alias stream1) # port-list 1/1/x1..x4 hash-weight 3,3,2,2

Custom weight in percentage:

(config gigastream alias stream1) # port-list 1/1/x1..x4 hash-weight 30,30,20,20

To convert the weighted GigaStream to a GigaStream with equal weight, use the following command:

(config) # gigastream alias gs

(config gigastream alias gs) port-list 1/1/x1..x4

(config gigastream alias gs) exit

drop-weight <weight>

Specifies the relative weight for the GigaStream to drop the traffic. For example:

(config gigastream alias stream1) # drop-weight 2

rehash

Redistributes the hash buckets of the ports in the GigaStream. Use this argument when the weights assigned to the ports do not match the incoming traffic distribution. For example:

(config gigastream alias stream1) # rehash