# mirror interface

モード
  インターフェースモード
カテゴリー
  インターフェース / スイッチポート

## 構文

コマンド構文

`(config-if)# mirror interface SRCIFRANGE direction SNOOPDIRECTION`

`(config-if)# [no] mirror interface SRCIFNAME vlan <2-4094>`

`(config-if)# mirror interface none`

`(config-if)# no mirror interface {SRCIFRANGE|none}`

## コマンド説明

対象スイッチポート（単一ポート）をポートミラーリングのミラーポートに設定する。また、同時にソースポートとコピーするトラフィックの向きも指定する。
no形式で実行した場合は、ミラーポートとしての設定を解除する。
ミラーポートに設定されたポートは、いずれのVLANにも所属していない状態となり、通常のスイッチポートとしては機能しなくなる。
ミラーポートの設定を解除されたポートは、vlan1のタグなしポート（アクセスポート）になる。

## パラメーター

`SRCIFRANGE`
  ソースポートのインターフェース名。ハイフン、カンマを使った複数指定も可能。トランクグループをソースポートに設定するときは、「saX」、「poX」ではなく、「port1.1.1-1.1.3」のように全所属ポートを一括指定すること（「saX」、「poX」の指定は不可）
`direction SNOOPDIRECTION`
  ミラーリングするトラフィックの向き。以下から選択する
  `both`
    送受信パケット
  `receive`
    受信パケット
  `transmit`
    送信パケット
`SRCIFNAME vlan <2-4094>`
  対象トラフィックのソースポート（単一ポート）とVLAN ID。指定したソースポートで受信したトラフィックのうち、指定したVLAN所属のものだけをミラーリングしたいときに使用する。なお、vlanパラメーターを指定する場合、ソースポートは複数指定できない。また、トランクグループの所属ポートをソースポートに指定することもできない
`none`
  ソースポートおよびトラフィックの向きを指定しない。ハードウェアアクセスリストでミラーリング対象トラフィックを指定する場合に使用する。本オプションを指定した場合は、copy-to-mirror/send-to-mirrorアクションを持つハードウェアアクセスリストにマッチしたパケットがミラーリングされる

## 使用例

ポート1.1.4をミラーポートに設定し、ポート1.1.1から送受信されるトラフィックがミラーポートにコピーされるよう設定する。以下の設定をすると、ポート1.1.4はどのVLANにも所属しない状態となり、通常のスイッチポートとしては機能しなくなる。

    awplus(config)# interface port1.1.4
    awplus(config-if)# mirror interface port1.1.1 direction both

先の設定にソースポートを追加する例。ポート1.1.2と1.1.3から送受信されるトラフィックもポート1.1.4にコピーされるよう設定する。

    awplus(config)# interface port1.1.4
    awplus(config-if)# mirror interface port1.1.2,port1.1.3 direction both

ポート1.1.1のトラフィックをミラーリングしないよう設定する。

    awplus(config)# interface port1.1.4
    awplus(config-if)# no mirror interface port1.1.1

ポート1.1.4のミラーポート設定を解除する。以下の設定をすると、ポート1.1.4はvlan1のタグなしポート（アクセスポート）になる。必ずしもミラーポート設定前のVLANには戻らないので注意。

    awplus(config)# interface port1.1.4
    awplus(config-if)# no mirror interface port1.1.2-port1.1.3

ポート1.1.4をミラーポートに設定し、ポート1.1.1で受信したvlan10のトラフィックだけがミラーポートにコピーされるよう設定する。

    awplus(config)# interface port1.1.4
    awplus(config-if)# mirror interface port1.1.1 vlan 10

ポート1.1.1で受信したvlan10トラフィックをミラーリング対象から削除する。

    awplus(config)# interface port1.1.4
    awplus(config-if)# no mirror interface port1.1.1 vlan 10

ハードウェアパケットフィルターのcopy-to-mirrorアクションを利用して、ポート1.1.3で受信したTCPパケットだけがミラーポート1.1.1にコピーされるよう設定する。この場合、mirror interfaceコマンドではnoneを指定すること。また、通常のソースポートを追加してはならない。

    awplus(config)# access-list 3000 copy-to-mirror tcp any any
    awplus(config)# interface port1.1.3
    awplus(config-if)# access-group 3000
    awplus(config-if)# exit
    awplus(config)# interface port1.1.1
    awplus(config-if)# mirror interface none

## 注意・補足事項

トランクグループ（LACPチャンネルグループ、スタティックチャンネルグループ）をミラーポートに設定する場合はLAGインターフェース（poX、saX）を指定すること。ただし、トランクグループのメンバーポートをミラーポートに設定することはできない。
複数のポートをミラーリングしたいときは、ソースポートを「port1.0.1-port1.0.3」のように複数指定するか、同一ミラーポートに対して本コマンドを複数回実行すればよい。ただし、ソースポートを増やす場合、ミラーポートの帯域やVCSのスタックケーブルの帯域を超えてしまうと輻輳によるパケットドロップ等が発生する可能性があるため注意が必要。
なお、vlanパラメーターを指定する場合、ソースポートは単一ポートのみ指定可能のため、複数のポートでVLAN指定のミラーリングを行いたいときは、vlanパラメーター付きで本コマンドをソースポートの数だけ実行する必要がある。
トランクグループ（LACPチャンネルグループ、スタティックチャンネルグループ）をソースポートに指定するときは、「saX」、「poX」ではなく、該当グループの全所属ポートを「port1.1.1-port1.1.2」のように一括指定すること。インターフェース名「saX」や「poX」をソースポートに指定することはできない。
ただし、vlanパラメーターを指定する場合、トランクグループの所属ポートをソースポートに指定することはできない。
ソースポートを指定する通常のポートミラーリングを使用するときは、ハードウェアパケットフィルターやQoSポリシーマップのcopy-to-mirrorアクションを使用しないこと。
ハードウェアパケットフィルターやQoSポリシーマップのcopy-to-mirror/send-to-mirrorアクションを使用する場合、mirror interfaceコマンドではnoneを指定すること。copy-to-mirror/send-to-mirrorアクションは、以下の各コマンドで設定する。

- access-list(hardware ip)コマンド
- access-list(hardware mac)コマンド
- access-list hardware(seq entry)コマンド
- ipv6 access-list(seq entry)コマンド
- default-actionコマンド

トラフィックの向きをbothに設定した後、receiveまたはtransmitに変更したい場合、対象ミラーポートをno形式で無効にしてから、再度ミラーリングの設定を行う必要がある。
PAUSEフレームはミラーリングできない。
ミラーポートを設定する場合は、デフォルト状態のポートに設定すること（ミラーポートに他のスイッチポート関連機能を設定しないこと）。
vlanパラメーターを指定した場合は内部的に以下のハードウェアアクセスリスト（ACL）が作成される。
このハードウェアアクセスリストに対する手動操作（変更、削除など）はサポート対象外。

- 「copy-to-mirror-<VLAN名>-<ポート名>-4d4952524f52」形式の名前を持つ（ポート名のピリオドはハイフンに置換）。
- CLIのshow access-listコマンドとshow access-list countersコマンドでは表示されるが、ランニングコンフィグには表示されない。
- Web GUIのセキュリティー > アクセスリスト画面に表示される。

## コマンドツリー

## 関連コマンド