# atmf recover

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

## 構文

コマンド構文

`# atmf recover [NODENAME [master ATMF_NODE | controller ATMF_NODE]]`

## コマンド説明

対象ノードの内蔵フラッシュメモリーを、指定した名前のノードとして復元（リカバリー）する。
より具体的には、対象ノードのフラッシュメモリーの内容を、指定した名前のノードの最新バックアップデータと同一にする。
本コマンドは、コントローラーやマスター機器を交換する場合や、メンバー機器交換時のオートリカバリーに失敗した場合に使用する。

## パラメーター

`NODENAME`
  復元対象のノード名。大文字小文字を区別しない。本コマンドを実行したノードは、本パラメーターで指定した名前のノードとして復元される
`master ATMF_NODE`
  バックアップデータを持つマスターのノード名
`controller ATMF_NODE`
  バックアップデータを持つコントローラーのノード名。本パラメーターを指定した場合、復元対象のノード名（NODENAME）にはローカルマスターを指定すること

## 使用例

オートリカバリーに失敗した新規ノード（host_eccd_6d7e_1897）をFSW241として復元する。
何らかの原因によりオートリカバリーに失敗した場合でも、AMF自動検出機能によってAMFネットワークに参加できていれば、自動生成されたノード名を指定することでマスターのCLIから該当ノードにアクセスできる。
ただし、ワーキングセットプロンプトではリカバリーの進捗状況を示すconsoleログが表示されないため、手動リカバリー時はatmf remote-loginコマンドでリモートログインしたほうがよい。
また、ワーキングセット使用時はマスターのCLIにログインしたときのユーザー名、パスワードで操作対象ノードにログインできる必要があるが、新規ノードはユーザー情報が初期状態（管理者ユーザーmanagerのみ存在。パスワードは初期値のfriend）なので、ワーキングセットプロンプトからは操作できない可能性が高い。atmf remote-loginコマンドでは、userパラメーターでログインユーザー名を指定することでパスワードの入力も可能となるので、その意味でもリモートログインを使うほうがよい。

    16:56:34 SBx81 ATMF[1958]: host_eccd_6d7e_1897 has joined. 2 members in total.

    SBx81# atmf remote-login user manager host_eccd_6d7e_1897
    Type 'exit' to return to SBx81.
    manager@172.31.0.5's password:

    AlliedWare Plus (TM) X.X.X xx/xx/xx xx:xx:xx

    awplus> enable
    awplus# atmf recover FSW241
    This command will erase ALL flash contents.  Continue node recovery? (y/n) y ↓

    Manual node recovery successfully initiated

    16:56:00 awplus ATMFFSR[4283]: Retrieving recovery data from master node SBx81
    16:57:47 awplus ATMFFSR[4283]: Manual node recovery completed

なお、本コマンドによるリカバリーが完了したら、手動で再起動すること。
AMFエリアマスター「SBx908a」を、AMFコントローラー「SBx81」のバックアップから復元する。

    SBx908a> enable
    SBx908a# atmf recover SBx908a controller SBx81
    This command will erase ALL flash contents.  Continue node recovery? (y/n) y ↓

    Manual node recovery successfully initiated

    17:39:12 SBx908a ATMFFSR[5594]: Retrieving recovery data from master node SBx81
    17:39:32 SBx908a ATMFFSR[5594]: Manual node recovery completed
    17:39:32 SBx908a ATMFFSR[5594]: Node needs to be restarted for the configu
    ration to take effect. Make sure the configuration is appropriate for the node
    before restart.

なお、本コマンドによるリカバリーが完了したら、手動で再起動すること。

## 注意・補足事項

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は本コマンドによるリカバリーに未対応。
リカバリー対象の機種、および、使用する拡張モジュールによっては、ポートLEDの表示によってリカバリー実行中、および、リカバリー失敗が示される。詳細はatmf recover led-offコマンドのページを参照。
controllerオプションを選択した復元は、ローカルマスターのみ正しく実行できる。通常のAMFメンバーは実行できない。

## 関連コマンド