archive download-sw
TFTP サーバからスイッチまたはスイッチスタックに新しいイメージをダウンロードし、既存のイメージを上書きするか、または保持するには、特権 EXEC モードで archive download-sw コマンドを使用します。
archive download-sw { /directory | /force-reload | /imageonly | /leave-old-sw | /no-set-boot | /no-version-check | /overwrite | /reload | /safe} source-url
構文の説明
/directory |
イメージのディレクトリを指定します。 |
/force-reload |
ソフトウェア イメージのダウンロードが成功した後で無条件にシステムのリロードを強制します。 |
/imageonly |
ソフトウェア イメージのみをダウンロードし、組み込みデバイス マネージャに関連する HTML ファイルはダウンロードしません。既存のバージョンの HTML ファイルは、既存のバージョンが上書きまたは削除されている場合にだけ削除されます。 |
/leave-old-sw |
ダウンロードに成功した後で古いソフトウェア バージョンを保持します。 |
/no-set-boot |
新しいソフトウェア イメージが正常にダウンロードされた後に、そのイメージをポイントするように BOOT 環境変数の設定が変更されることを防ぎます。 |
/no-version-check |
ソフトウェア イメージをダウンロードする際に、スイッチ上で動作中のイメージとのバージョンの互換性を確認しません。スイッチ スタックでは、イメージ上およびスタック上のスタック プロトコル バージョンの互換性を確認せずに、ソフトウェア イメージがダウンロードされます。 |
/overwrite |
ダウンロードされたイメージで、フラッシュ メモリのソフトウェア イメージに優先します。 |
/reload |
設定が変更され保存されていない場合を除き、イメージのダウンロードに成功した後でシステムをリロードします。 |
/safe |
現在のソフトウェア イメージを保持します。新しいイメージがダウンロードされるまでは、新しいソフトウェア イメージ用の領域を確保する目的で現在のソフトウェア イメージが削除されることはありません。ダウンロード終了後に現在のイメージが削除されます。 |
source-url |
ローカルまたはネットワーク ファイル システム用の送信元 URL エイリアスを指定します。次のオプションがサポートされています。
image-name.tar は、スイッチにダウンロードし、インストールするソフトウェアイメージです。 |
コマンド デフォルト
現行のソフトウェア イメージは、ダウンロードされたイメージで上書きされません。ソフトウェア イメージと HTML ファイルの両方がダウンロードされます。新しいイメージは flash: ファイル システムにダウンロードされます。
BOOT 環境変数は、flash: ファイル システムの新しいソフトウェア イメージを示すよう変更されます。イメージ ファイルでは大文字と小文字が区別されます。イメージ ファイルは TAR フォーマットで提供されます。
ダウンロードするイメージのスタック プロトコル バージョンの互換性は、スタック上のバージョンと検査されます。
コマンド モード
特権 EXEC
コマンド履歴
リリース | 変更内容 |
---|---|
Cisco IOS Release 15.2(7)E3k |
このコマンドが導入されました。 |
使用上のガイドライン
/imageonly オプションは、既存のイメージが削除されているか置き換えられている場合に、既存のイメージの HTML ファイルを削除します。
(HTML ファイルのない)Cisco IOS イメージだけがダウンロードされます。
/safe または /leave-old-sw オプションを指定すると、十分なフラッシュメモリがない場合に、新しいイメージのダウンロードが失敗することがあります。
ソフトウェアを残すことで、領域の制約により新しいイメージ用に十分なフラッシュ メモリがない場合は、エラー メッセージが表示されます。
/leave-old-sw オプションを使用し、新しいイメージをダウンロードしたときに古いイメージが上書きされなかった場合、delete 特権 EXEC コマンドを使用して古いイメージを削除することができます。
スタックに存在しているバージョンとは異なるスタック プロトコル バージョンのイメージをダウンロードする場合は、 /no-version-check オプションを使用します。
(注) |
/no-version-check オプションの使用には注意が必要です。同一のスタックにするためには、アクティブ スイッチを含め、すべてのメンバでスタック プロトコル バージョンが同一である必要があります。 このオプションを指定すると、最初にスタック プロトコルのバージョンと、スタックのバージョンの互換性を確認することなく、イメージをダウンロードできます。 |
フラッシュデバイス上のイメージを、ダウンロードしたイメージで上書きする場合は、 /overwrite オプションを使用します。
/overwrite オプションなしでこのコマンドを指定する場合、ダウンロードアルゴリズムは、新しいイメージが、スイッチフラッシュデバイスのイメージやスタックメンバで実行中のイメージと同じであるかどうかを確認します。
イメージが同じである場合は、ダウンロードは行われません。イメージが異なっている場合、古いイメージは削除され、新しいイメージがダウンロードされます。
新しいイメージをダウンロードした後で、/reload 特権 EXEC コマンドを入力して新しいイメージの使用を開始するか、または archive download-sw コマンドの /reload または /force-reload オプションを指定してください。
例
次の例では、172.20.129.10 の TFTP サーバから新しいイメージをダウンロードし、スイッチでイメージを上書きする方法を示します。
Device# archive download-sw /overwrite tftp://172.20.129.10/test-image.tar
次の例では、172.20.129.10 の TFTP サーバからソフトウェア イメージだけをスイッチにダウンロードする方法を示します。
Device# archive download-sw /imageonly tftp://172.20.129.10/test-image.tar
次の例では、ダウンロードに成功した後で古いソフトウェア バージョンを保存する方法を示します。
Device# archive download-sw /leave-old-sw tftp://172.20.129.10/test-image.tar