# mirror interface

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

## 構文

コマンド構文

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

`(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`
    送信パケット
`none`
  ソースポートおよびトラフィックの向きを指定しない。ハードウェアアクセスリストでミラーリング対象トラフィックを指定する場合に使用する。本オプションを指定した場合は、copy-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

ハードウェアパケットフィルターの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

## 注意・補足事項

ミラーポートはシステム内で1つしか設定できないので、本コマンドを入力するためにインターフェースモードに入るときは、interfaceコマンドでスイッチポートを1つだけ指定すること。複数ポートを指定してインターフェースモードに入った場合、本コマンドは失敗する。

    awplus(config)# interface port1.1.3-1.1.4
    awplus(config-if)# mirror interface port1.1.1 direction both
    %Cannot mirror to an interface range

また同様の理由により、すでに他のポートがミラーポートに設定されている場合も本コマンドは失敗する。その場合は、現行ミラーポートの設定を解除してから本コマンドを再実行すること。

    awplus(config)# interface port1.1.4
    awplus(config-if)# mirror interface port1.1.1 direction both
    awplus(config-if)# exit
    awplus(config)# interface port1.1.3
    awplus(config-if)# mirror interface port1.1.2 direction both
    %port mirror already enabled on interface port1.1.4

トランクグループ（LACPチャンネルグループ、スタティックチャンネルグループ）、および、トランクグループの所属ポートをミラーポートに設定することはできない。
複数のポートをミラーリングしたいときは、ソースポートを「port1.1.1-port1.1.3」のように複数指定するか、同一ミラーポートに対して本コマンドを複数回実行すればよい。ただし、ソースポートを増やす場合、ミラーポートの帯域を超えてしまう可能性があるため注意が必要。ミラーリングのソースポートは8ポートまでに制限されるが、4ポート以上設定した場合、Warning メッセージが出力される。
トランクグループ（LACPチャンネルグループ、スタティックチャンネルグループ）をソースポートに指定するときは、「saX」、「poX」ではなく、該当グループの全所属ポートを「port1.1.1-port1.1.2」のように一括指定すること。インターフェース名「saX」や「poX」をソースポートに指定することはできない。
ソースポートを指定する通常のポートミラーリングを使用するときは、ハードウェアパケットフィルターやQoSポリシーマップのcopy-to-mirrorアクションを使用しないこと。
ハードウェアパケットフィルターやQoSポリシーマップのcopy-to-mirrorアクションを使用する場合、mirror interfaceコマンドではnoneを指定すること。copy-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フレームはミラーリングできない。
ミラーポートを設定する場合は、デフォルト状態のポートに設定すること（ミラーポートに他のスイッチポート関連機能を設定しないこと）。

## コマンドツリー

## 関連コマンド