inline-tool-group
Required Command-Line Mode = Admin
Use the inline-tool-group command to configure an inline tool group. An inline tool group is an arrangement of multiple inline tools to which traffic is distributed to the inline tools based on hardware-calculated hash values. For example, if one tool goes down, traffic is redistributed to other tools in the group using hashing.
You also use the inline-tool-group command to configure redundancy, such as 1+1 and N+1.
The inline tool ports that make up the inline tools participating in the inline tool group are always in pairs, running at the same speed, on the same medium (fiber or copper). All inline tool ports of the inline tool group must be on the same GigaVUE‑HC3 or GigaVUE‑HC2 node, but can be on different modules on the node. On the GigaVUE‑HC1, all the inline tool ports of the inline group must be on either the base module or the bypass combo module. The inline tool ports must also be on the same GigaVUE‑HC3, GigaVUE‑HC2, or GigaVUE‑HC1 node as the inline network ports.
This command is only applied to GigaVUE HC Series nodes. In a cluster environment, this command is only applied to GigaVUE HC Series nodes through the cluster leader. The inline constructs must all be configured on one GigaVUE‑HC3, GigaVUE‑HC2, or GigaVUE‑HC1 node, not across nodes, even if the nodes are in a cluster.
This command is used in the inline bypass solutions described in the “Configuring Inline Bypass Solutions” section and in the flexible inline arrangements described in the “Working with Flexible Inline Arrangements” section in the GigaVUE Fabric Management Guide.
The inline-tool-group command has the following syntax:
inline-tool-group alias <alias>
comment <comment>
enable
failover-action <tool-bypass | tool-drop | network-bypass | network-drop | network-port-forced-down>
failover-mode spread
flex-traffic-path <to-inline-tool | bypass | monitoring | drop>
hash <advanced | a-srcip-b-dstip | b-srcip-a-dstip>
minimum-group-healthy-size <number>
release-spare-if-possible
spare-inline-tool <spare inline tool alias>
tool-list <inline-tool list>
hash-weights <inline-tool weights>
The following table describes the arguments for the inline-tool-group command.
Argument |
Description |
|||||||||||||||
alias <alias> |
Specifies the name of the inline tool group. The alias must be unique and can contain up to 128 characters. Aliases are case-sensitive. For example: (config) # inline-tool-group alias inToolGroup (config inline-tool-group alias inToolGroup) # |
|||||||||||||||
comment <comment> |
Specifies a unique text string that describes the inline tool group. Comments can be up to 128 characters. Comments longer than one word must be enclosed in double quotation marks. For example: (config inline-tool-group alias inToolGroup) # comment “Inline tool group inToolGroup” |
|||||||||||||||
enable |
Enables or disables the inline tool group. Use enable to put the inline tool group into service. Disable the inline tool group to simulate a failure or to take the inline tool group offline for maintenance purposes. The default is disabled. For example, to enable: (config inline-tool-group alias inToolGroup) # enable For example, to disable: (config inline-tool-group alias inToolGroup) # no enable |
|||||||||||||||
failover-action <tool-bypass | tool-drop | network-bypass | network-drop | network-port-forced-down> |
Specifies the failover action taken in response to a failure of an inline tool group, when the number of healthy inline tools in the inline tool group (including the spare inline tool, if configured) falls below the configured minimum. The values are as follows:
The default is tool-bypass. The failover actions of the individual inline tools belonging to an inline tool group are ignored when the individual inline tools encounter failure conditions. Instead, the failover mechanism of the inline tool group is used to distribute traffic among the set of healthy inline tools and declare the group to be in a failure condition when the number of healthy inline tools falls below a configured minimum. For example: (config inline-tool-group alias inToolGroup) # failover-action tool-drop Note: Before changing the failover action, enable the inline tool group using the enable command. |
|||||||||||||||
failover-mode spread |
Specifies the failover mode of the inline tool group. The mode specifies how to handle a failure of an individual member of the inline tool list when a spare inline tool is either not configured or has failed. The only value is spread, which redistributes all the traffic coming from the inline network (or inline network group) to the reduced set of inline tools, excluding the failed inline tool or tools. Note: If there is only one inline tool in the tool list, this parameter is not used. For example: (config inline-tool-group alias inToolGroup) # failover-mode spread |
|||||||||||||||
flex-traffic-path <to-inline-tool | bypass | monitoring | drop> |
For flexible inline arrangements, provides per-tool traffic path options. Each inline tool or inline tool group involved in a flexible inline map can specify its own traffic path. The options are as follows, however the behavior of the traffic will depend on a variety of factors including the inline tools in the sequence, their individual flex-traffic-path settings, the operational state of the inline tools, and the direction of traffic:
The default is to-inline-tool. For example: (config inline-tool-group alias inToolGroup) # flex-traffic-path drop |
|||||||||||||||
hash <advanced | a-srcip-b-dstip | b-srcip-a-dstip> |
Specifies the type of hashing for distributing packets across a number of inline tools belonging to an inline tool group. The values are as follows:
The default is advanced. For flexible inline arrangements, asymmetrical hashing (using a-srcip-b-dstip and b-srcip-a-dstip) is not supported. Note: If there is only one inline tool in the tool list, the hash parameter is not used. Examples: (config inline-tool-group alias inToolGroup) # hash a-srcip-b-dstip (config inline-tool-group alias inToolGroup) # hash advanced Refer to the “Symmetrical and Asymmetrical Hashing” section in the GigaVUE Fabric Management Guide for details. Restrictions are included under “Asymmetrical Hashing Restrictions” section in the GigaVUE Fabric Management Guide. |
|||||||||||||||
minimum-group-healthy-size <number> |
Specifies the minimum number of inline tools that must be up so that the entire inline tool group is considered to be up. The minimum number includes the inline tools in the inline tool list plus the spare inline tool, if one is configured. The range is 1 to 16. The default is 1. Note: If there is only one inline tool in the tool list, this parameter is not used. For example: (config inline-tool-group alias inToolGroup) # minimum-group-healthy-size 3 |
|||||||||||||||
release-spare-if-possible |
Determines the behavior of the spare inline tool after it has replaced an original inline tool in the inline tool group following an inline tool failure. The values are as follows:
The default is disabled. Note: If a spare inline tool is not configured, this parameter is not used. For example: (config inline-tool-group alias inToolGroup) # release-spare-if-possible |
|||||||||||||||
spare-inline-tool <spare inline tool alias> |
Specifies the alias of an inline tool to which traffic is forwarded when the first failure occurs in the set of primary inline tools. The default is blank (not specified). If a spare inline tool is configured, the inline tool group becomes a redundant arrangement of inline tools. For example: (config inline-tool-group alias inToolGroup) # spare-inline-tool IT_004 |
|||||||||||||||
tool-list <inline-tool list> |
When a spare inline tool is not configured, specifies the list of inline tool aliases participating in hash-based traffic distribution. The number of inline tool aliases in the list is between 1 and 16. When a spare inline tool is configured, specifies the list of aliases of primary inline tools to which traffic is forwarded as long as they are all healthy. The number of inline tools in the list is between 2 and 16. Separate each inline tool alias in the list with a comma. For example: (config inline-tool-group alias inToolGroup) # tool-list IT_001,IT_002,IT_003 |
|||||||||||||||
hash-weights <inline-tool weights> |
Specifies the relative weight or default weight for the inline tools based on which traffic is directed to the inline tools in the inline tool group. If you assign a default weight, the traffic is distributed equally to all the inline tools in a group. If an inline tool in a group goes down and the group maintains the minimum-group-healthy-size defined for the group, the traffic is redistributed to the remaining inline tools based on the default weight or the relative weight assigned to the inline tools. If the inline tool group does not meet the minimum-group-healthy-size defined for the group, the traffic is redistributed based on the failover-action defined for the group. The valid range is 1–256. Note: Resilient hashing is not supported for classic inline maps. You cannot add a spare-inline-tool, if you have assigned hash weights to the inline tools in a group. Separate each inline tool weight in the list with a comma. For example:
(config inline-tool-group alias inToolGroup) # tool-list IT_001,IT_002,IT_003 hash-weights 2,3,2
(config inline-tool-group alias inToolGroup) # tool-list IT_001,IT_002,IT_003 hash-weights default |
Related Commands
The following table summarizes other commands related to the inline-tool-group command:
Task |
Command |
Displays inline tool groups. |
# show inline-tool-group |
Displays a specified inline tool group. |
# show inline-tool-group alias inToolGroup |
Displays all inline tool groups. |
# show inline-tool-group all |
Displays the Rx and Tx statistics for all the inline tool groups that are part of the inline flow deployment. |
# show inline-tool-group traffic-rate all |
Displays the Rx and Tx statistics for the specified inline tool group alias that is part of the inline flow deployment. |
# show inline-tool-group traffic-rate alias <alias_name> |
Deletes a specified inline tool group. |
(config) # no inline-tool-group alias inToolGroup |
Deletes the comment for this inline tool group. |
(config) # no inline-tool-group alias inToolGroup comment |
Disables an inline tool group. |
(config) # no inline-tool-group alias inToolGroup enable |
Disables release-spare-if-possible for this inline tool group. |
(config) # no inline-tool-group alias inToolGroup release-spare-if-possible |
Deletes the spare tool for this inline tool group. |
(config) # no inline-tool-group alias inToolGroup spare-inline-tool |
Deletes the inline tool list for the specified inline tool group. |
(config) # no inline-tool-group alias inToolGroup tool-list |
Deletes all inline tool groups. |
(config) # no inline-tool-group all |