# atmf working-set

モード
  特権EXECモード
カテゴリー
  AMF / コマンド

## 構文

コマンド構文

`# [no] atmf working-set {NODELIST | group GROUPLIST}`

## コマンド説明

指定したノードを操作対象とするワーキングセットプロンプトに移動する。
本コマンドはマスターでのみ有効。
no形式で実行した場合は、指定したノードをワーキングセットから削除する。

## パラメーター

`NODELIST`
  ノード名。カンマ区切りで複数指定が可能（カンマの前後にスペースを入れないこと）。大文字小文字を区別しない
`group GROUPLIST`
  グループ名。カンマ区切りで複数指定が可能（カンマの前後にスペースを入れないこと）。atmf groupコマンドで定義したグループ名に加え、下記の予約済みグループ名も指定可能。all, current, local以外は大文字小文字を区別する
  `all`
    すべてのノード
  `current`
    現在の操作対象ノード
  `local`
    ローカルノード（自ノード）
  `master`
    すべてのマスター
  `poe`
    すべてのPoE対応機種
  `dc2500`
    AT-DC2552XS
  `vaa`
    AMF Cloud、AMF Cloud（AT-VST-APL版）、AMF Cloud（AT-VST-VRT版）
  `x8100`
    すべてのSwitchBlade x8100
  `x950`
    すべてのx950シリーズ
  `x930`
    すべてのx930シリーズ
  `x900`
    すべてのSwitchBlade x908とx900シリーズ
  `sbx908ng`
    すべてのSwitchBlade x908 GEN2
  `sbx90xgen3`
    すべてのSwitchBlade x908 GEN3
  `x610`
    すべてのx610シリーズ
  `x560`
    すべてのx560シリーズ
  `x550`
    すべてのx550シリーズ
  `x540L`
    すべてのx540Lシリーズ
  `x530`
    すべてのx530シリーズ
  `x530L`
    すべてのx530Lシリーズ
  `x510`
    すべてのx510シリーズとx510LシリーズとAT-IX5-28GPX
  `x330`
    すべてのx330シリーズ
  `x320`
    すべてのx320シリーズ
  `x310`
    すべてのx310シリーズ
  `x250`
    すべてのx250シリーズ
  `x240`
    すべてのx240シリーズ
  `x230`
    すべてのx230シリーズ（52ポート版を含む）とx230Lシリーズ
  `x220`
    すべてのx220シリーズ
  `x210`
    すべてのx210シリーズ
  `x200`
    すべてのx200シリーズ
  `ie220`
    すべてのIE220シリーズ
  `IE210`
    すべてのIE210Lシリーズ
  `ie200`
    すべてのIE200シリーズ
  `arx200`
    AT-ARX200S-GTXとAT-ARX200S-GT
  `ar4050`
    AT-AR4050SとAT-AR4050S-5G
  `ar3050`
    AT-AR3050S
  `ar2050`
    AT-AR2050V
  `ar2010`
    AT-AR2010V
  `ar1050`
    AT-AR1050V
  `tq7400r`
    AT-TQ7403-R
  `tq6700gen2r`
    AT-TQ6702 GEN2-R
  `tq6700egen2r`
    AT-TQ6702e GEN2-R
  `vfw`
    vFirewall（AT-NFV-APL）とAT-AR4000S-Cloud
  `sh510`
    すべてのSH510シリーズ
  `sh310`
    すべてのSH310シリーズ
  `sh230`
    すべてのSH230シリーズ
  `sh210`
    すべてのSH210シリーズ
  `se240`
    すべてのSE240シリーズ
  `se250`
    すべてのSE250シリーズ
  `se540l`
    すべてのSE540Lシリーズ
  `xs900`
    すべてのXS900MXシリーズ
  `gs970emx`
    すべてのGS970EMXシリーズ
  `gs980mx`
    すべてのGS980MXシリーズ
  `gs980m`
    すべてのGS980Mシリーズ
  `gs900`
    すべてのGS900MX/GS900MPXシリーズ
  `fs980`
    すべてのFS980Mシリーズ

## 使用例

AMFノードFSW241とFSW242を操作対象とするワーキングセットプロンプトに移行する。

    SBx81# atmf working-set FSW241,FSW242
    ===============
    FSW241, FSW242:
    ===============

    Working set join

    AMF001[2]#

すべてのノードを操作対象とするワーキングセットプロンプトに移行する。予約済みグループ「all」は、AMFネットワーク上のすべてのノードを含む。

    SBx81# atmf working-set group all
    ==============================================
    ESW231, FSW241, FSW242, FSW243, FSW244, SBx81:
    ==============================================

    Working set join

    AMF001[6]#

本コマンド実行時に表示される項目の意味は次のとおり。

- ワーキングセットに含まれるノード名の一覧

      ==============================================
      ESW231, FSW241, FSW242, FSW243, FSW244, SBx81:
      ==============================================

- ワーキングセットを対象とした場合のプロンプト（ワーキングセットプロンプト）。
  AMF001の部分はatmf network-nameコマンドで設定したAMFネットワーク名、[6]はワーキングセットに含まれるノードの数を示す。

      AMF001[6]#

  なお、ワーキングセットプロンプトでモード移動をともなうコマンドを実行したところ、一部のノードで該当コマンドがエラーとなった場合は、ノード数の表示が次のように変化する。ここで[6:1]は、ワーキングセットには6台のノードが含まれるが、現在のコマンドモードではそのうちの1台にしかコマンドが発行されないことを意味する。

      AMF001[6]# configure terminal
      Enter configuration commands, one per line.  End with CNTL/Z.
      AMF001[6](config)# interface port1.1.1-1.1.8
      // これら5台のノードには
      =======================================
      ESW231, FSW241, FSW242, FSW243, FSW244:
      =======================================

      // port1.1.1（～1.1.8）が存在しない
      % Can't find interface port1.1.1

      // よって、これ以降のコマンドは6台中1台（SBx81）にしか適用されない
      AMF001[6:1](config-if)#

  この場合も、該当コマンドモードを抜ければ、ワーキングセットプロンプトのノード数表示が元に戻り、ワーキングセットの全ノードにコマンドが発行されるようになる。

      AMF001[6:1](config-if)# exit
      AMF001[6](config)#

操作対象をローカルノードだけに戻す。
自ノードを表す予約済みグループ名「local」を指定した場合は、ワーキングセットのプロンプトから通常のプロンプト（ローカルプロンプト）に戻る。
また、自ノード名だけを指定した場合や、自ノードだけが含まれるグループを指定した場合、すなわち、ワーキングセットの対象ノードが自ノードだけになる場合もローカルプロンプトに戻る。

    AMF001[6]# atmf working-set group local
    ======
    SBx81:
    ======

    Working set join

    SBx81#

Note

ワーキングセットプロンプトのEXECモード（特権、非特権とも）でexitコマンドを実行すると、マスターのCLIからログアウトしてしまうため注意。ワーキングセットプロンプトからマスターCLI単機のプロンプト（ローカルプロンプト）に戻りたいときは、上の例のように本コマンドでgroup localを指定すること。

## 注意・補足事項

特権パスワードが必要なユーザー（権限1～14のユーザー）でマスターのCLIにログインしている場合、ワーキングセット経由でコマンドを実行するたびに特権パスワードの入力を求められる。これを回避するには、特権パスワードが不要なユーザーでマスターのCLIにログインすればよい。
（ワーキングセットの操作対象ノードにマスターと同じ名前のユーザーを登録しておく必要はない）
show tech-support、atmf distribute firmware、atmf reboot-rollingなど、AMFトラフィックを大量に生成する可能性のあるコマンドを実行する場合、ワーキングセットの対象ノードは42ノード以内にすることを推奨。
x530シリーズとx530Lシリーズのミックススタック構成時、該当VCSグループはVCSマスター機種の予約済みグループに所属する。すなわち、x530シリーズがVCSマスターのときは予約済みグループ「x530」、x530LシリーズがVCSマスターのときは予約済みグループ「x530L」に属する。不意のグループ変更による混乱を避けるため、ミックススタック構成ではatmf groupコマンドで任意のグループ名を設定して運用することを推奨。
x230シリーズは52ポート版とそれ以外の機種でサポートコマンドが異なるため、x230シリーズの52ポート版とそれ以外の機種が混在するAMFネットワークでは、atmf groupコマンドで任意のグループ名を設定して運用することを推奨。

## 関連コマンド