tool-mirror

Required Command-Line Mode = Configure

Use the tool-mirror command to configure a pass-all between two tool ports or a tool port and a tool GigaStream on the same node irrespective of the maps already in place for the ports. Refer to the “Working with Map-Passalls and Port Mirroring” section in the GigaVUE Fabric Management Guide for a discussion of use cases for tool-mirrors.

Keep in mind the following rules and notes when you configure tool-mirrors:

  • You can only use tool-mirror connections between tool ports/GigaStream on the same node. Cross-node tool-mirror connections are not supported.
  • Tool-mirrors are not supported on tool ports with copper SFPs installed or on 100Gb ports with CFP2 transceivers.
  • In a cluster, tool-mirror is supported only on the leader.

The tool-mirror command has the following syntax:

tool-mirror <alias <alias>>
   from <port-id | port-alias | port-list | inline-network-alias | inline-network-group-alias>
   to <port-id | port-alias | port-list | gigastream-alias | gigastream-alias-list | inline-tool-alias |
      inline-tool-group-alias | inline-serial-alias | bypass> [comment <comment>]

The following table describes the arguments for the tool-mirror command:

Argument

Description

alias <alias>

Specifies the alias by which this tool-mirror will be known.

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

Specifies the source tool port(s) for the tool-mirror. Use one of the following:

port-id, port-alias, port-list—Specifies the source tool ports using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.
inline-network-alias—Specifies the source tool ports using the specified inline network alias.
inline-network-group-alias—Specifies the source tool ports using the specified inline network group alias.

to <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 tool port(s) for the tool-mirror. Use one of the following:

port-id, port-alias, port-list—Specifies the destination tool ports using the standard conventions described in Port Lists Definition in the GigaVUE‑OS.
gigastream-alias, gigastream-alias-list—Specifies the destination tool ports using the specified tool GigaStream. Refer to the GigaStreamsection in the GigaVUE Fabric Management Guide for details on GigaStream.
inline-tool-alias—Specifies the destination tool ports using the specified inline tool alias.
inline-tool-group-alias—Specifies the destination tool ports using the specified inline tool group alias.
inline-serial-alias—Specifies the destination tool ports using the specified inline tool series alias.
bypass—Specifies the destination tool ports using the specified inline bypass.

comment <comment>

Specifies a comment in up to 128 characters. Comments longer than one word must be enclosed in double quotation marks.

The following table shows some examples using the tool-mirror command:

Command

Comments

(config) # tool-mirror alias toolpass from 1/3/x1 to 1/3/x12

Configures a tool-mirror between tool port 1/3/x1 and tool port 1/3/x12. The tool-mirror has an alias of toolpass.

(config) # tool-mirror alias streampass from 14/2/q1 to mygigastream

Configures a tool-mirror from 14/2/q1 to the GigaStream with the alias mygigastream. The tool-mirror has an alias of streampass.

Related Commands

The following table summarizes other commands related to the tool-mirror command:

Task

Command

Displays all tool-mirror connections.

# show tool-mirror

Displays a specified tool-mirror connection.

# show tool-mirror alias Tmirr

Displays all tool-mirrors.

# show tool-mirror all

Displays all tool-mirrors in table format.

# show tool-mirror brief

Deletes a specified tool-mirror.

(config) # no tool-mirror alias Tmirr

Deletes all tool-mirrors.

(config) # no tool-mirror all