ソフトウェア メンテナンス アップグレード(SMU)パッケージをインストールするには、特権 EXEC モードで install コマンドを使用します。
install {abort | activate | file {bootflash: | flash: | harddisk: | webui:} [auto-abort-timer timer timer prompt-level {all | none}] | add file {bootflash: | flash: | ftp: | harddisk: | http: | https: | rcp: | scp: | tftp: | webui:} [activate [auto-abort-timer timerprompt-level {all | none}commit]] | commit | auto-abort-timer stop | deactivate file {bootflash: | flash: | harddisk: | webui:} | label id {description description | label-name name} | remove {file {bootflash: | flash: | harddisk: | webui:} | inactive } | | rollback to {base | committed | id {install-ID } | label {label-name}}}
Syntax Description
abort
|
現在のインストール操作を終了します。
|
activate
|
install add コマンドを通じて SMU が追加されているかどうかを検証します。
このキーワードは、互換性チェックを実行し、パッケージステータスを更新します。パッケージを再起動できる場合はポストインストール スクリプトをトリガーして必要なプロセスを再起動するか、または再起動できないパッケージの場合はリロードをトリガーします。
|
file
|
アクティブにするパッケージを指定します。
|
{bootflash: | flash: | harddisk: | webui:}
|
インストールしたパッケージのロケーションを指定します。
|
auto-abort-timer timer
|
(任意)自動アボートタイマーをインストールします。
|
prompt-level {all | none}
|
(任意)インストールアクティビティについてのプロンプトをユーザに表示します。
たとえば、activate キーワードはリロードが必要なパッケージに対してリロードを自動的にトリガーします。パッケージをアクティブにする前に、続行するかどうかについてユーザに確認するプロンプトが表示されます。
all キーワードを使用するとプロンプトをイネーブルにすることができます。none キーワードはプロンプトをディセーブルにします。
|
add
|
ファイルをリモートロケーション(FTP または TFTP)からデバイスにコピーし、プラットフォームとイメージのバージョンの SMU 互換性チェックを実行します。
このキーワードは、指定したパッケージがプラットフォームで必ずサポートされるように基本の互換性チェックを実行します。
|
{ bootflash: | flash: |ftp: |harddisk: |http: |https: | rcp: | scp: | tftp: |webui:} |
追加するパッケージを指定します。
|
commit
|
リロード後も SMU の変更が持続されるようにします。
パッケージをアクティブにした後、システムがアップ状態にある間、または最初のリロード後にコミットを実行できます。パッケージがアクティブになっていてもコミットされていない場合は、最初のリロード後はアクティブの状態を保ちますが、2 回目のリロード後はアクティブ状態を保ちません。
|
auto-abort-timer stop
|
自動アボートタイマーを停止します。
|
deactivate
|
インストールしたパッケージを非アクティブにします。
Note
|
パッケージを非アクティブにすると、パッケージステータスも更新され、プロセスが再起動またはリロードされることがあります。
|
|
label id
|
ラベルを付けるインストールポイントの ID を指定します。
|
description
|
指定したインストールポイントに説明を追加します。
|
label-name name
|
指定されたインストールポイントにラベル名を追加します。
|
remove |
インストールしたパッケージを削除します。
remove キーワードは、現在非アクティブ状態のパッケージでのみ使用できます。
|
inactive |
非アクティブ状態のすべてのパケージをデバイスから削除します。
|
rollback |
データ モデル インターフェイス(DMI)パッケージ SMU をベースバージョン、最後にコミットされたバージョン、または既知のコミット ID にロールバックします。
|
to base |
ベース イメージに戻します。
|
committed |
最後のコミット操作が実行されたときのインストール状態に戻します。
|
id install-ID |
特定のインストールポイント ID に戻します。有効な値は、1 ~ 4294967295 です。
|
Command Default
パッケージはインストールされません。
Command History
リリース |
変更内容 |
Cisco IOS XE Everest 16.6.3
|
このコマンドが導入されました。
|
Cisco IOS XE Fuji 16.9.1
|
ホットパッチのサポートが導入されました。出力例がホット SMU の出力に更新されました。
|
Usage Guidelines
SMU は、システムにインストールしてパッチ修正やセキュリティ解決をリリースされたイメージに提供ができるパッケージです。このパッケージには、パッケージの内容を記述するいくつかのメタデータとともに、リリースにパッチを適用するための最小限の一連のファイルが含まれています。
SMU をアクティブ化する前にパッケージを追加する必要があります。
パッケージは、フラッシュから削除する前に非アクティブにする必要があります。削除したパッケージは、もう一度追加する必要があります。
Examples
次に、インストールパッケージをデバイスに追加する例を示します。
Device# install add file flash:cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin
install_add: START Mon Mar 5 21:48:51 PST 2018
install_add: Adding SMU
--- Starting initial file syncing ---
Info: Finished copying flash:cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin to the selected switch(es)
Finished initial file syncing
Executing pre scripts....
Executing pre scripts done.
--- Starting SMU Add operation ---
Performing SMU_ADD on all members
[1] SMU_ADD package(s) on switch 1
[1] Finished SMU_ADD on switch 1
Checking status of SMU_ADD on [1]
SMU_ADD: Passed on [1]
Finished SMU Add operation
SUCCESS: install_add /flash/cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin Mon Mar 5 21:49:00 PST 2018
次に、インストールパッケージをアクティブにする例を示します。
Device# install activate file flash:cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin
install_activate: START Mon Mar 5 21:49:22 PST 2018
install_activate: Activating SMU
Executing pre scripts....
Executing pre sripts done.
--- Starting SMU Activate operation ---
Performing SMU_ACTIVATE on all members
[1] SMU_ACTIVATE package(s) on switch 1
[1] Finished SMU_ACTIVATE on switch 1
Checking status of SMU_ACTIVATE on [1]
SMU_ACTIVATE: Passed on [1]
Finished SMU Activate operation
SUCCESS: install_activate /flash/cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin Mon Mar 5 21:49:34 PST 2018
次に、インストールしたパッケージをコミットする例を示します。
Device# install commit
install_commit: START Mon Mar 5 21:50:52 PST 2018
install_commit: Committing SMU
Executing pre scripts....
Executing pre sripts done.
--- Starting SMU Commit operation ---
Performing SMU_COMMIT on all members
[1] SMU_COMMIT package(s) on switch 1
[1] Finished SMU_COMMIT on switch 1
Checking status of SMU_COMMIT on [1]
SMU_COMMIT: Passed on [1]
Finished SMU Commit operation
SUCCESS: install_commit /flash/cat9k_iosxe.BLD_SMU_20180302_085005_TWIG_LATEST_20180306_013805.3.SSA.smu.bin Mon Mar 5 21:51:01 PST 2018
Examples
次に、バンドルブートモードで実行中のデバイスをインストールモードに変更する例を示します。
Device# install add file boot flash:cat9k_iosxe.17.04.01.SSA.bin activate commit
install_add_activate_commit: START Sun Jun 14 22:31:41 PDT 2020
install_add_activate_commit: Adding PACKAGE
install_add_activate_commit: Checking whether new add is allowed ....
--- Starting initial file syncing ---
[1]: Copying flash:cat9k_iosxe.17.04.01.SSA.bin from switch 1 to switch 2
[2]: Finished copying to switch 2
Info: Finished copying flash:cat9k_iosxe.17.04.01.SSA.bin to the selected switch(es)
Finished initial file syncing
--- Starting Add ---
Performing Add on all members
[1] Add package(s) on switch 1
[1] Finished Add on switch 1
[2] Add package(s) on switch 2
[2] Finished Add on switch 2
Checking status of Add on [1 2]
Add: Passed on [1 2]
Finished Add
Image added. Version: 17.4.01.0.87954
install_add_activate_commit: Activating PACKAGE
Following packages shall be activated:
/flash/cat9k-wlc.17.04.01.SSA.pkg
/flash/cat9k-webui.17.04.01.SSA.pkg
/flash/cat9k-srdriver.17.04.01.SSA.pkg
/flash/cat9k-sipspa.17.04.01.SSA.pkg
/flash/cat9k-sipbase.17.04.01.SSA.pkg
/flash/cat9k-rpboot.17.04.01.SSA.pkg
/flash/cat9k-rpbase.17.04.01.SSA.pkg
/flash/cat9k-lni.17.04.01.SSA.pkg
/flash/cat9k-guestshell.17.04.01.SSA.pkg
/flash/cat9k-espbase.17.04.01.SSA.pkg
/flash/cat9k-cc_srdriver.17.04.01.SSA.pkg
This operation may require a reload of the system. Do you want to proceed? [y/n]y
--- Starting Activate ---
Performing Activate on all members
[1] Activate package(s) on switch 1
[1] Finished Activate on switch 1
[2] Activate package(s) on switch 2
[2] Finished Activate on switch 2
Checking status of Activate on [1 2]
Activate: Passed on [1 2]
Finished Activate
Building configuration...
[OK]--- Starting Commit ---
Performing Commit on all members
[1] Commit package(s) on switch 1
[1] Finished Commit on switch 1
[2] Commit package(s) on switch 2
[2] Finished Commit on switch 2
Checking status of Commit on [1 2]
Commit: Passed on [1 2]
Finished Commit
Send model notification for install_add_activate_commit before reload
[1 2]: Performing Upgrade_Service
300+0 records in
300+0 records out
307200 bytes (307 kB, 300 KiB) copied, 0.194027 s, 1.6 MB/s
AppGigabitEthernet port has the latest Firmware
mount: /tmp/microcode_update/boot_pkg: WARNING: device write-protected, mounted read-only.
SUCCESS: Upgrade_Service finished
Install will reload the system now!
SUCCESS: install_add_activate_commit Sun Jun 14 22:40:55 PDT 2020
次に、リブートプロセス中のプロンプトを回避する例を示します。
Device# install add file boot flash:cat9k_iosxe.17.04.01.SSA.bin activate commit prompt-level none
install_add_activate_commit: START Wed Jun 17 03:57:53 PDT 2020
install_add_activate_commit: Adding PACKAGE
install_add_activate_commit: Checking whether new add is allowed ....
--- Starting initial file syncing ---
[1]: Copying flash:cat9k_iosxe.17.04.01.SSA.bin from switch 1 to switch 2 3
[2 3]: Finished copying to switch 2 switch 3
Info: Finished copying flash:cat9k_iosxe.17.04.01.SSA.bin to the selected switch(es)
Finished initial file syncing
--- Starting Add ---
Performing Add on all members
[1] Add package(s) on switch 1
[1] Finished Add on switch 1
[2] Add package(s) on switch 2
[2] Finished Add on switch 2
[3] Add package(s) on switch 3
[3] Finished Add on switch 3
Checking status of Add on [1 2 3]
Add: Passed on [1 2 3]
Finished Add
Image added. Version: 17.4.01.0.115072
install_add_activate_commit: Activating PACKAGE
Following packages shall be activated:
/flash/cat9k-wlc.17.04.01.SSA.pkg
/flash/cat9k-webui.17.04.01.SSA.pkg
/flash/cat9k-srdriver.17.04.01.SSA.pkg
/flash/cat9k-sipspa.17.04.01.SSA.pkg
/flash/cat9k-sipbase.17.04.01.SSA.pkg
/flash/cat9k-rpboot.17.04.01.SSA.pkg
/flash/cat9k-rpbase.17.04.01.SSA.pkg
/flash/cat9k-lni.17.04.01.SSA.pkg
/flash/cat9k-guestshell.17.04.01.SSA.pkg
/flash/cat9k-espbase.17.04.01.SSA.pkg
/flash/cat9k-cc_srdriver.17.04.01.SSA.pkg
--- Starting Activate ---
Performing Activate on all members
[1] Activate package(s) on switch 1
[1] Finished Activate on switch 1
[2] Activate package(s) on switch 2
[2] Finished Activate on switch 2
[3] Activate package(s) on switch 3
[3] Finished Activate on switch 3
Checking status of Activate on [1 2 3]
Activate: Passed on [1 2 3]
Finished Activate
Building configuration...
[OK]--- Starting Commit ---
Performing Commit on all members
[1] Commit package(s) on switch 1
[1] Finished Commit on switch 1
[2] Commit package(s) on switch 2
[2] Finished Commit on switch 2
[3] Commit package(s) on switch 3
[3] Finished Commit on switch 3
Checking status of Commit on [1 2 3]
Commit: Passed on [1 2 3]
Finished Commit
Send model notification for install_add_activate_commit before reload
[1 2 3]: Performing Upgrade_Service
300+0 records in
300+0 records out
307200 bytes (307 kB, 300 KiB) copied, 0.194692 s, 1.6 MB/s
AppGigabitEthernet port has the latest Firmware
mount: /tmp/microcode_update/boot_pkg: WARNING: device write-protected, mounted read-only.
SUCCESS: Upgrade_Service finished
Install will reload the system now!
SUCCESS: install_add_activate_commit Wed Jun 17 04:05:25 PDT 2020
次に、インストールプロセスで使用されるファイルの削除を回避する例を示します。
Device# install remove inactive
install_remove: START Wed Jun 17 06:23:26 PDT 2020
Cleaning up unnecessary package files
No path specified, will use booted path flash:packages.conf
Cleaning flash:
Scanning boot directory for packages ... done.
Preparing packages list to delete ...
cat9k-cc_srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-cc_srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-espbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-espbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-guestshell.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-guestshell.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-lni.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpboot.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipspa.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipspa.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-webui.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-webui.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-wlc.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-wlc.17.04.01.SSA.pkg
File is in use, will not delete.
packages.conf
File is in use, will not delete.
done.
Cleaning up unnecessary package files
No path specified, will use booted path flash:packages.conf
Cleaning flash:
Scanning boot directory for packages ... done.
Preparing packages list to delete ...
cat9k-cc_srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-espbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-guestshell.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-lni.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpboot.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipspa.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-webui.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-wlc.17.04.01.SSA.pkg
File is in use, will not delete.
packages.conf
File is in use, will not delete.
done.
Cleaning up unnecessary package files
No path specified, will use booted path flash:packages.conf
Cleaning flash:
Scanning boot directory for packages ... done.
Preparing packages list to delete ...
cat9k-cc_srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-espbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-guestshell.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-lni.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-rpboot.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipbase.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-sipspa.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-srdriver.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-webui.17.04.01.SSA.pkg
File is in use, will not delete.
cat9k-wlc.17.04.01.SSA.pkg
File is in use, will not delete.
packages.conf
File is in use, will not delete.
done.
The following files will be deleted:
[switch 1]:
/flash/cat9k-lni.17.04.01.SSA.pkg
/flash/cat9k-rpboot.17.04.01.SSA.pkg
/flash/cat9k_iosxe.17.04.01.SSA.bin
/flash/cat9k_iosxe.17.04.01.SSA.conf
/flash/cat9k_iosxe.17.04.01.SSA.conf
[switch 2]:
/flash/cat9k-cc_srdriver.17.04.01.SSA.pkg
/flash/cat9k-espbase.17.04.01.SSA.pkg
/flash/cat9k-guestshell.17.04.01.SSA.pkg
/flash/cat9k-lni.17.04.01.SSA.pkg
/flash/cat9k-rpbase.17.04.01.SSA.pkg
/flash/cat9k-rpboot.17.04.01.SSA.pkg
/flash/cat9k-sipbase.17.04.01.SSA.pkg
/flash/cat9k-sipspa.17.04.01.SSA.pkg
/flash/cat9k-srdriver.17.04.01.SSA.pkg
/flash/cat9k-webui.17.04.01.SSA.pkg
/flash/cat9k-wlc.17.04.01.SSA.pkg
/flash/cat9k_iosxe.17.04.01.SSA.bin
/flash/cat9k_iosxe.17.04.01.SSA.conf
/flash/cat9k_iosxe.17.04.01.SSA.conf
[switch 3]:
/flash/cat9k-cc_srdriver.17.04.01.SSA.pkg
/flash/cat9k-espbase.17.04.01.SSA.pkg
/flash/cat9k-guestshell.17.04.01.SSA.pkg
/flash/cat9k-lni.17.04.01.SSA.pkg
/flash/cat9k-rpbase.17.04.01.SSA.pkg
/flash/cat9k-rpboot.17.04.01.SSA.pkg
/flash/cat9k-sipbase.17.04.01.SSA.pkg
/flash/cat9k-sipspa.17.04.01.SSA.pkg
/flash/cat9k-srdriver.17.04.01.SSA.pkg
/flash/cat9k-webui.17.04.01.SSA.pkg
/flash/cat9k-wlc.17.04.01.SSA.pkg
/flash/cat9k_iosxe.17.04.01.SSA.bin
/flash/cat9k_iosxe.17.04.01.SSA.conf
/flash/cat9k_iosxe.17.04.01.SSA.conf
Do you want to remove the above files? [y/n]y
[switch 1]:
Deleting file flash:cat9k-lni.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-rpboot.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.bin ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
SUCCESS: Files deleted.
[switch 2]:
Deleting file flash:cat9k-cc_srdriver.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-espbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-guestshell.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-lni.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-rpbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-rpboot.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-sipbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-sipspa.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-srdriver.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-webui.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-wlc.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.bin ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
SUCCESS: Files deleted.
[switch 3]:
Deleting file flash:cat9k-cc_srdriver.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-espbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-guestshell.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-lni.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-rpbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-rpboot.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-sipbase.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-sipspa.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-srdriver.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-webui.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k-wlc.17.04.01.SSA.pkg ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.bin ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
Deleting file flash:cat9k_iosxe.17.04.01.SSA.conf ... done.
SUCCESS: Files deleted.
--- Starting Post_Remove_Cleanup ---
Performing Post_Remove_Cleanup on all members
[1] Post_Remove_Cleanup package(s) on switch 1
[1] Finished Post_Remove_Cleanup on switch 1
[2] Post_Remove_Cleanup package(s) on switch 2
[2] Finished Post_Remove_Cleanup on switch 2
[3] Post_Remove_Cleanup package(s) on switch 3
[3] Finished Post_Remove_Cleanup on switch 3
Checking status of Post_Remove_Cleanup on [1 2 3]
Post_Remove_Cleanup: Passed on [1 2 3]
Finished Post_Remove_Cleanup
SUCCESS: install_remove Wed Jun 17 06:24:59 PDT 2020