map-scollector

Required Command-Line Mode = Configure

Use the map-scollector command to configure shared collector maps and parameters. Use a shared collector to send any packets that do not match the map rules to a destination.

The map-scollector command has the following syntax:

map-scollector alias <alias>
   collector <port-id | port-alias | port-list | gigastream-alias | gigastream-alias-list | inline-tool-alias |
      inline-tool-group-alias | inline-serial-alias | bypass>
   comment <comment>
   from <port-id | port-alias | port-list | inline-network-alias | inline-network-group-alias>

rewrite-dstmac <value> | rewrite-<value>

rewrite-dstip <value> | rewrite-srcip <value>

   roles <assign | replace> <role> [to <role list>]

The following table describes the arguments for the map-scollector command:

Argument

Description

alias <alias>

Specifies the name of the shared collector map. The alias must be unique and can contain up to 128 characters. Aliases are case-sensitive.

For example:

(config) # map-scollector alias scoll

<port-id | port-alias | 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 shared collector map. Use one of the following:

port-id, port-alias, port-list—Sends 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 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 traffic to the specified inline tool alias.
inline-tool-group-alias—Sends traffic to the specified inline tool group alias.
inline-serial-alias—Sends traffic to the specified inline tool series alias.
bypass—Sends 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-scollector alias scoll 2/1/x1

comment <comment>

Specifies a unique text string that describes the shared collector map. Comments can be up to 128 characters. Comments longer than one word must be enclosed in double quotation marks.For example:

(config) # map-scollector alias scoll comment “Shared collector”

from <port-id | port-alias | port-list | inline-network-alias | inline-network-group-alias>

Specifies the source(s) for packets matching this shared collector map. Use one of the following:

port-id, port-alias, port-list—Sends 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 traffic from the specified inline network alias.
inline-network-group-alias—Sends traffic from the specified inline network group alias.

Refer to the “Associating Inline Networks with Inline Tools Using Inline Maps” in the GigaVUE Fabric Management Guide for details on inline-network-alias and inline-network-group-alias.

For example:

(config) # map-scollector alias scoll from inNet

rewrite-dstmac <value> | rewrite-src mac <value>

For MAC Address rewrite ,configure the destination and Source fields as follows:

rewrite-dstmac xx:xx:xx:xx:xx:xx — Configure destination MAC rewrite for all the pass rules associated with the map.
rewrite-srcmac xx:xx:xx:xx:xx:xx— Configure source MAC rewrite for all the pass rules associated with the map.

rewrite-dstip <value> | rewrite-srcip <value>

For IP Address rewrite, configure the destination and Source fields as follows:

rewrite-dstip x.x.x.x — Configure destination IP rewrite for all the pass rules associated with the map.
rewrite-srcip x.x.x.x— Configure source IP rewrite for all the pass rules associated with the map.

roles <assign | replace> <role> [to <role list>]

Assigns a user role to a map access list or replaces a user role for a shared collector map. For example:

(config) # map-scollector alias scoll roles assign monitor to listen_roles

Related Commands

The following table summarizes other commands related to the map-scollector command:

Task

Command

Displays all shared collector maps.

# show map-scollector

Displays information for a specified shared collector map.

# show map-scollector alias mycoll

Displays all shared collector maps.

# show map-scollector all

Displays all shared collector maps in table format.

# show map-scollector brief

Deletes a specified shared collector map.

(config) # no map-scollector alias mycoll

Deletes all destinations configured for a specified shared collector map.

(config) # no map-scollector alias mycoll collector

Deletes the comments for a specified shared collector map.

(config) # no map-scollector alias mycoll comment

Deletes all sources configured for a specified shared collector map.

(config) # no map-scollector alias mycoll from

Deletes an assigned role from a specified shared collector map.

(config) # no map-scollector alias mycoll roles assign monitor

Deletes all assigned roles from a specified shared collector map.

(config) # no map-scollector alias mycoll roles assign all

Deletes the configured destination and source MAC Address.

(config)# no rewrite-dstmac | no rewrite-srcmac

Deletes the configured destination and source IP Address.

(config)# no rewrite-dstip | no rewrite-srcip