[index] CentreCOM x240シリーズ コマンドリファレンス 5.5.5

# 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) 5.5.5 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メンバーは実行できない。

### 関連コマンド

atmf backup（グローバルコンフィグモード）
atmf backup enable（グローバルコンフィグモード）
atmf backup now（特権EXECモード）
atmf recover led-off（特権EXECモード）
atmf remote-login（特権EXECモード）
hostname（グローバルコンフィグモード）
show atmf backup（特権EXECモード）

(C) 2023 - 2025 アライドテレシスホールディングス株式会社

PN: 613-003248 Rev.L