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:

port-id, port-alias—Sends matching traffic from one or more network ports specified using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.
inline-network-alias—Sends matching traffic from the specified inline network alias.
inline-network-group-alias—Sends matching traffic from the specified inline network group alias.

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:

tool-port-list—Sends matching traffic to one or more tool ports specified using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.
gigastream-alias, gigastream-alias-list—Sends matching traffic to the specified tool GigaStream. Refer to the GigaStream section in the GigaVUE Fabric Management Guide for details on GigaStream.
inline-tool-alias—Sends matching traffic to the specified inline tool alias.
inline-tool-group-alias—Sends matching traffic to the specified inline tool group alias.
inline-serial-alias—Sends matching traffic to the specified inline tool series alias.
bypass—Sends matching traffic to the specified inline bypass.

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