# atmf reboot-rolling

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

## 構文

コマンド構文

`# atmf reboot-rolling [force] [URL]`

## コマンド説明

リブートローリング機能により、操作対象のAMFノードを1台ずつ順番に再起動する。
オプションのURLパラメーターでファームウェアイメージファイルの場所を指定した場合は、操作対象AMFノードのファームウェアを1台ずつ順番に更新して再起動する。
リブートローリング機能では、通信断の時間を最小限にするため、1台のノードが再起動してスタートアップコンフィグを読み込み、ポートがリンクアップしてAMFネットワークに復帰するまで待機し、その後次のノードの再起動に移る。
何らかの理由により、再起動したノードが一定時間内にAMFネットワークに復帰できなかったときは処理を中止し、それ以降のノードの再起動は行わないが、forceオプションを指定した場合は、AMFネットワークに復帰できないノードがあっても処理を続ける。

## パラメーター

`force`
  再起動後AMFネットワークへの復帰に失敗したノードがあっても処理を続けるよう指示する。本オプション未指定時は復帰に失敗したノードがあるとその時点で処理を中止する
`URL`
  ファームウェアイメージファイルのURL。完全パス表記による単一ファイルの指定、ワイルドカードを用いた複数ファイルの指定、および、ディレクトリーの指定が可能

## 使用例

AMFノードFSW241とFSW243をバージョンアップする。
ここでは、各機種用のファームウェアイメージファイルが、マスターSBx81に装着されているUSBメモリーの/fwディレクトリーに格納されているものとする。

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

    Working set join

    AMF001[2]# atmf reboot-rolling usb:/fw/
    Retrieving data from FSW241
    Retrieving data from FSW243

    ATMF Rolling Reboot Nodes:

                        Timeout
    Node Name           (Minutes)  New Release File           Status
    --------------------------------------------------------------------------------
    FSW243              60         x550-5.5.6-1.9.rel         Release ready
    FSW241              60         x530-5.5.6-1.9.rel         Release ready
    Continue upgrading releases ? (y/n): y

この例ではURLをディレクトリー指定しているため、指定したディレクトリーにあるイメージファイルの中から、各ノードの機種に適合する最新のファームウェアが自動選択され、表示した内容で続行してよいかの確認プロンプトが出ている。
Note

5.5.6-1.9は説明用の架空バージョンであり、実際には存在しない可能性があります。

Status欄の表示は次のとおり。

Release Ready | New Release File欄に表示されているイメージファイルへの更新準備完了
Incompatible | 該当ノードに適合するイメージファイルが存在しない
Insufficient space | 内蔵フラッシュメモリーの空き容量が不足しているため該当ファームウェアへの更新ができない
Not Supported | リブートローリングによるファームウェア更新をサポートしていない
Release already exists | すでに最新版なので更新する必要がない

「Continue upgrading releases ?」に対して「y」で回答すると、バージョンアップが実行される。
実行中は次のように進捗が表示される。

    ================================================================================
    Copying Release    : x550-5.5.6-1.9.rel to FSW243
    Updating Release   : x550-5.5.6-1.9.rel information on FSW243
    ================================================================================
    ATMF Rolling Reboot: Rebooting FSW243
    ================================================================================
    16:07:59 SBx81 ATMF[1946]: FSW243 has left. 4 members in total.

    % FSW243 has left the working-set
    16:09:29 SBx81 ATMF[1946]: FSW243 has joined. 5 members in total.
    Reboot of FSW243 has completed
    ================================================================================
    Copying Release    : x530-5.5.6-1.9.rel to FSW241
    Updating Release   : x530-5.5.6-1.9.rel information on FSW241
    ================================================================================
    ATMF Rolling Reboot: Rebooting FSW241
    ================================================================================
    16:10:12 SBx81 ATMF[1946]: FSW241 has left. 4 members in total.

    % FSW241 has left the working-set
    16:11:46 SBx81 ATMF[1946]: FSW241 has joined. 5 members in total.
    Reboot of FSW241 has completed

すべてのノードのバージョンアップが完了すると、次のように結果が表示される。

    ================================================================================
    ATMF Rolling Reboot Complete
    Node Name           Reboot Status    Release Name                Release Status
    -------------------------------------------------------------------------------
    FSW243              Rebooted         x550-5.5.6-1.9.rel          Upgraded
    FSW241              Rebooted         x530-5.5.6-1.9.rel          Upgraded
    ================================================================================

## 注意・補足事項

このコマンドは1台ずつ順番に処理を行うため、対象ノードが多い場合はすべての処理が完了するまでかなり長い時間がかかる。
本コマンドの実行対象ノードは80台までにすること。
再起動を行わずに、ファームウェアの転送と起動ファームウェアの設定だけを行いたい場合は、本コマンドの代わりにatmf distribute firmwareコマンドを使うこと。
URLパラメーターの指定方法には次の3とおりがある。

- ファイルの完全パス指定
  usb, flash, tftp, http, scp のいずれでも使える。
  指定したファイルが対象機種に適合するならばそのファイルに更新。非適合の場合はコマンド失敗となる。
- ワイルドカードによるファイル指定
  usb, card, flash でのみ使える。
  ワイルドカードにマッチしたファイルの中から対象機種に適合する最新のファームウェアが自動選択され、OKかどうかの確認を経て更新される。適合するものがない場合はコマンド失敗となる。
- ディレクトリー指定
  usb, card, flash でのみ使える。
  指定ディレクトリー内のファイルの中から対象機種に適合する最新のファームウェアが自動選択され、OKかどうかの確認を経て更新される。適合するものがない場合はコマンド失敗となる。

URLパラメーターにディレクトリーを指定する場合、該当ディレクトリーに置くファームウェアイメージファイルの数は20個以内にすること。
URLパラメーターを指定した場合、ファームウェアイメージファイルは対象ノードのフラッシュメモリーにコピーされ、起動時ファームウェアに設定される。それまで使用していたファームウェアは、バックアップファームウェアに設定される。
AMFリモートログイン時（atmf remote-loginコマンド使用時）に本コマンドを実行する場合は、下記の制限がある。

- usb、flash上のファイルを指定する場合は、<NODENAME>.atmf/<ABSOLUTEPATH>形式の特殊記法で指定する必要がある。特殊記法の詳細は応用編を参照。
- usb、card, flash上のファイルであっても、ディレクトリー指定やワイルドカード指定はできない（すなわち、ファームウェアの自動選択はできない）。必ず完全なファイルパスを指定すること。

AMF Cloud、AMF Cloud（AT-VST-APL版）、AMF Cloud（AT-VST-VRT版）の場合、本コマンドによるAMF Cloud、AMF Cloud（AT-VST-APL版）、AMF Cloud（AT-VST-VRT版）自身のファームウェアバージョンアップは不可。メンバーに対しては実行可能。
vFirewall（AT-NFV-APL）、AT-AR4000S-Cloud、x200シリーズはリブートローリングによるファームウェアバージョンアップに対応していない。
AMFマスターがバージョン 5.4.7-0.x で動作しているAMFネットワーク内に、バージョン 5.4.7-1.x 以降のメンバーが存在する場合、atmf distribute firmwareコマンド または atmf reboot-rollingコマンドによるファームウェアバージョンアップは、次のいずれかの手順で実行すること。

- （方法1）最初にAMFマスターを 5.4.7-1.x 以降にバージョンアップし、その後 atmf distribute firmwareコマンド または atmf reboot-rollingコマンドでAMFメンバーのバージョンアップを実行する。
- （方法2）最初にバージョン 5.4.7-1.x で動作しているAMFメンバーを、atmf distribute firmwareコマンドや atmf reboot-rollingコマンドを使わずにバージョンアップし、その後 AMFマスターと残りのAMFメンバーのバージョンアップを atmf distribute firmwareコマンド または atmf reboot-rollingコマンドを使って実行する。

同系列機種のSHシリーズとxシリーズが混在する下記いずれかのAMFネットワークの組み合わせにおいて、atmf distribute firmwareコマンドまたはatmf reboot-rollingコマンドでAMFノードのファームウェアを更新する場合、SHシリーズとxシリーズは、他の機種と同時に更新しないこと。　例えば、510系列機種（SH510シリーズとx510/x510Lシリーズ）の場合は、「SH510シリーズだけ」、「x510/x510Lだけ」というように個別にワーキングセットを指定して更新すること。　詳しくは、「AMF」/「運用」の「ファームウェアバージョンアップ」を参照。

- SH510シリーズとx510/x510Lシリーズ
- SH310シリーズとx310シリーズ
- SH230シリーズとx230/x230Lシリーズ
- SH210シリーズとx210シリーズ

リブートローリング実行中は対象となるすべてのノードに一時的なAMFグループが作成され、リブートローリング完了後に自動的に削除される。

## 関連コマンド