map-passall
Required Command-Line Mode = Configure
Use the map-passall command to send all packets on a network port to one or more tool ports or tool GigaStream irrespective of the maps already in place for the ports. Refer to the section “Working with Map-Passalls and Port Mirroring” in the GigaVUE Fabric Management Guide for a discussion of use cases for map-passalls.
Note: You can only use map-passall connections between ports/GigaStream on the same node. Cross-node map-passall connections are not supported.
The map-passall command has the following syntax:
map-passall alias <alias>
comment <comment>
from <port-id | port-alias | inline-network-alias | inline-network-group-alias>
roles <assign | replace> <role> [to <role list>]
to <tool port list | gigastream-alias | gigastream-alias-list | inline-tool-alias | inline-tool-group-alias |
inline-serial-alias | bypass>
The following table describes the arguments for the map-passall command:
Argument |
Description |
||||||||||||||||||
alias <alias> |
Specifies the name of the map passall. The alias must be unique and can contain up to 128 characters. Aliases are case-sensitive. For example: (config) # map-passall alias map2 (config map-passall alias map2) # |
||||||||||||||||||
comment <comment> |
Supplies an optional comment for this map-passall. The comment will appear in show map-passall output. For example: (config) # map-passall alias map2 comment “Map from A to B” |
||||||||||||||||||
from <port-id | port-alias | inline-network-alias | inline-network-group-alias> |
Specifies the source(s) for packets matching this map-passall. Use one of the following:
Refer to the “Associating Inline Networks with Inline Tools Using Inline Maps” section in the GigaVUE Fabric Management Guide for details on inline-network-alias and inline-network-group-alias. For example: (config) # map-passall alias map2 from port1 |
||||||||||||||||||
roles <assign | replace> <role> [to <role list>] |
Assigns a user role to a map access list or replaces a map access list. For example: (config) # map-passall alias map2 roles replace monitor to view_roles |
||||||||||||||||||
to <tool port list | gigastream-alias | gigastream-alias-list | inline-tool-alias | inline-tool-group-alias | inline-serial-alias | bypass> |
Specifies the destination(s) for packets matching this map-passall. Use one of the following:
Refer to the “Associating Inline Networks with Inline Tools Using Inline Maps” section in the GigaVUE Fabric Management Guide for details on inline-tool-alias, inline-tool-group-alias, inline-serial-alias, and bypass. For example: (config) # map-passall alias map2 to inTool |
The following table shows some examples of configuring map-passalls:
Command |
Comments |
Map Prefix Mode Technique(config) # map-passall alias mypass (config map-passall alias mypass) # from 1/1/x1..x4 (config map-passall alias mypass) # to 1/1/x5 (config map-passall alias mypass)# exit Separate Commands Technique(config) # map-passall alias mypass from 1/1/x1..x4 (config) # map-passall alias mypass to 1/1/x5 |
Configures a map-passall from 1/1/x1, 1/1/x2, 1/1/x3, and 1/1/x4 to tool port 1/1/x5. |
Map Prefix Mode Technique(config) # map-passall alias mypass2 (config map-passall alias mypass2) # from 1/2x1 (config map-passall alias mypass2) # to 1/2/x2..x5 (config map-passall alias mypass2) # exit Separate Commands Technique(config) # map-passall alias mypass from 1/2/x1 (config) # map-passall alias mypass to 1/2/x2..x5 |
Configures a map passall from 1/2/x1 to 1/2/x2, 1/2/x3, 1/2/x4, and 1/2/x5. |
Map Prefix Mode Technique(config) # map-passall alias gigapass (config map-passall alias gigapass) # from 1/3/x1 (config map-passall alias gigapass) # to mygigastream (config map-passall alias gigapass) # exit Separate Commands Technique(config) # map-passall alias mypass from 1/3/x1 (config) # map-passall alias mypass to mygigastream |
Configures a map passall from 1/3/x1 to the GigaStream with the alias mygigastream. |
Related Commands
The following table summarizes other commands related to the map-passall command:
Task |
Command |
Displays all map-passalls. |
# show map-passall |
Displays information for a specified map-passall. |
# show map-passall alias mymap |
Displays all map-passalls. |
# show map-passall all |
Display all map-passalls in table format. |
# show map-passall brief |
Deletes a specified map-passall. |
(config) # no map-passall alias mymap |
Deletes the comments for a specified map-passall. |
(config) # no map-passall alias mymap comment |
Deletes all sources configured for a specified map-passall. |
(config) # no map-passall alias mymap from |
Deletes an assigned role from a specified map-passall. |
(config) # no map-passall alias mymap roles assign monitor |
Deletes all assigned roles from a specified map-passall. |
(config) # no map-passall alias mymap roles assign all |
Deletes all destinations configured for a specified map-passall. |
(config) # no map-passall alias mymap to |