2021-02-19 10:18 AM 2023-04-26 05:13 PM 更新
本ドキュメントでは IOS-XR の新しいソフトウェアアーキテクチャである XR7 に関して、そのインストールの概要と方法について紹介しています。
IOS-XR の eXR/cXR などの別のソフトウェアアーキテクチャについては本ドキュメントの対象外となります。
IOS-XR XR7 については下記ドキュメントもご参照下さい。
XR7 は Cisco 8000シリーズルータと一部のNCS-540シリーズルータでのみサポートされております (2021年2月の時点)。
XR7 アーキテクチャの確認方法は複数ありますが、その一つとして show version コマンドの出力により確認することができます。
RP/0/RP0/CPU0:8201-R1#show version Tue Feb 9 01:32:35.970 UTC Cisco IOS XR Software, Version 7.0.12 LNT Copyright (c) 2013-2020 by Cisco Systems, Inc. Build Information: Built By : ahoang Built On : Sat Mar 14 14:18:11 UTC 2020 Build Host : iox-ucs-033 Workspace : /auto/srcarchive17/prod/7.0.12/8000/ws Version : 7.0.12 Label : 7.0.12 cisco 8000 System uptime is 17 minutes
XR7 の場合は IOS XR Software Version の横に LNT (Lindt : XR7 のコードネーム) が表示されます。
また、プラットフォーム名が "8000", "NCS540L", "ncs540l" の場合が XR7 となりますが、プラットフォーム名が "NCS540", "ncs540" の場合は XR7 ではなく eXR となる点は注意をお願いします。
XR7 で動作する NCS540 については下記ドキュメントもご参照下さい。
XR7 のインストールでは新しい Install ID の概念が導入されています。eXR/cXR では Install ID は 1 から順番にシーケンシャルに割り振られる自然数となっておりましたが、XR7 の Install ID は例えば "3.1.1" のように以下の 3 つの識別子(ID) から構成されています。
<Transaction ID>.<Atomic Operation ID>.<Package Operation ID>
上記の 3 つの識別子(ID) の意味は以下のようになっています。
識別子 (ID) | 説明 |
Transaction ID |
新規インストールオペレーションが開始されてから install commit されるまでの一連のトランザクションを識別する ID。 |
Atomic Operation ID |
特定のトランザクション中に、install package コマンドによるパッケージの追加/アップグレード/ダウングレード/削除などのパッケージ変更準備を、実際に有効化 (Activate) する処理を識別する ID。 |
Package Operation ID |
特定の Atomic Operation 中に、パッケージの追加/アップデート/ダウングレード/削除などのパッケージ変更を準備する処理 (install package) を識別する ID。 |
以下が ISO ファイルを使用したシステムアップグレード方法のおおまかな流れになります。
RP/0/RP0/CPU0:8201-R1#scp taisasak@<A.B.C.D>:/tftpboot/ioxarchive/IOX7014/8000/8000-x64-7.0.14.iso harddisk:/ vrf MGMT Wed Feb 10 05:32:57.766 UTC Connecting to <A.B.C.D>... Password: RP/0/RP0/CPU0:Feb 10 05:33:01.763 UTC: ssh_xr[66948]: %SECURITY-SSHD-6-INFO_CLIENT_LOGIN : SSH Client successfully established session as taisasak to <A.B.C.D> Transferred 987228160 Bytes 987228160 bytes copied in 72 sec (13629912)bytes/sec RP/0/RP0/CPU0:Feb 10 05:34:14.691 UTC: ssh_xr[66948]: %SECURITY-SSHD-6-INFO_CLIENT_LOGOUT : SSH Client terminated session as taisasak to <A.B.C.D>
(*) システムアップグレード時の ISO ファイルは XR7 ルータの /harddisk: 配下に置く必要があります。
install package replace コマンドを実行して、ISO ファイルに含まれるパッケージへの変更処理の準備を行います。このコマンドはあくまでもパッケージ変更処理の準備をするもので、このコマンドを実行しても即座に新しいパッケージへの変更処理が有効化される訳ではありません。
RP/0/RP0/CPU0:8201-R1#install package replace /harddisk:/8000-x64-7.0.14.iso Wed Feb 10 05:37:02.805 UTC Install replace operation has started Install operation will continue in the background RP/0/RP0/CPU0:Feb 10 05:37:03.381 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 1.1.1 started - replace /harddisk:/8000-x64-7.0.14.iso
-- snip --
RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 10 05:47:08.184 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 1.1.1 complete. More packaging operations can be performed, or any current changes can be applied by reload
上記ログより、"install package replace" に対して Install ID "1.1.1" が割り当てられているのが確認できます。
install apply を実行して、実際のパッケージ変更処理を有効化します。
yes/no を聞かれるため "yes" と入力して Enter キーを押すシステムアップグレード処理が開始されます。
RP/0/RP0/CPU0:8201-R1#install apply Wed Feb 10 05:48:25.998 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'. Continue? [yes/no]:[yes] Install apply operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 10 05:48:30.936 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by reload 1.1 started RP/0/RP0/CPU0:Feb 10 05:48:41.862 UTC: instorch[384]: %INFRA-INSTALL-2-SYSTEM_RELOAD : As part of an install operation, a full system reload will take place in order to apply the installed software. RP/0/RP0/CPU0:Feb 10 05:48:42.953 UTC: shelfmgr[352]: %PLATFORM-SHELFMGR-6-INFO_LOG : Set grub mode: LATEST RP/0/RP0/CPU0:Feb 10 05:48:44.009 UTC: obflmgr[317]: %PLATFORM-OBFL-6-INFO : Unmounted OBFL directory for 0/RP0/CPU0 RP/0/RP0/CPU0:Feb 10 05:48:44.014 UTC: processmgr[51]: %OS-SYSMGR-6-INFO : Prepared RMF to reboot Preparing system for backup. This may take a few minutes especially for large configurations. Status report: node0_RP0_CPU0: START TO BACKUP Status report: node0_RP0_CPU0: BACKUP HAS COMPLETED SUCCESSFULLY [Done] RP/0/RP0/CPU0:Feb 10 05:48:46.063 UTC: processmgr[51]: %MGBL-SCONBKUP-6-INTERNAL_INFO : Reload debug script successfully spawned
上記ログより、install apply に対して Atomic Operation "1.1" が実施されているのがわかります。
最後に install commit コマンドを実行して、一連のアップグレード処理のトランザクションを終了させます。
(*) 上記ステップ (2) と (3) をまとめて install replace /harddisk:/8000-x64-7.0.14.iso と実施することも可能となっています。
ここではデフォルトの ISO イメージに含まれていない telnet パッケージのインストール方法を例に紹介します。
(*) この方法は、指定した harddisk:/ 配下のディレクトリを DNF ローカルレポジトリに内部的に設定 (createrepo) するため、基本的には後述の章で紹介する DNF ローカルレポジトリを使った方法とほぼ同じになります。
ここでは新規に harddisk:/rpms ディレクトリを作成し、このディレクトリ配下に必要な xr-telnet パッケージ RPM をコピーします。
RP/0/RP0/CPU0:8201-R1#mkdir harddisk:/rpms Tue Feb 9 07:15:19.012 UTC Created dir harddisk:/rpms
RP/0/RP0/CPU0:8201-R1#scp taisasak@<A.B.C.D>:/tftpboot/ioxarchive/IOX7012/8000/optional-rpms/telnet/xr-telnet*.rpm vrf MGMT harddisk:/rpms/ Tue Feb 9 07:15:42.043 UTC Connecting to <A.B.C.D>... Password: RP/0/RP0/CPU0:Feb 9 07:15:46.124 UTC: ssh_xr[67079]: %SECURITY-SSHD-6-INFO_CLIENT_LOGIN : SSH Client successfully established session as taisasak to <A.B.C.D> Transferred 5888 Bytes 5888 bytes copied in 0 sec (46362)bytes/sec Transferred 11083 Bytes 11083 bytes copied in 0 sec (86585)bytes/sec Transferred 5912 Bytes 5912 bytes copied in 0 sec (46920)bytes/sec Transferred 5912 Bytes 5912 bytes copied in 0 sec (46551)bytes/sec Transferred 5916 Bytes 5916 bytes copied in 0 sec (46218)bytes/sec Transferred 5916 Bytes 5916 bytes copied in 0 sec (46952)bytes/sec Transferred 5936 Bytes 5936 bytes copied in 0 sec (47111)bytes/sec Transferred 115097 Bytes 115097 bytes copied in 0 sec (295879)bytes/sec RP/0/RP0/CPU0:Feb 9 07:15:49.065 UTC: ssh_xr[67079]: %SECURITY-SSHD-6-INFO_CLIENT_LOGOUT : SSH Client terminated session as taisasak to <A.B.C.D>
RP/0/RP0/CPU0:8201-R1#dir harddisk:/rpms/ Tue Feb 9 07:15:53.362 UTC Directory of harddisk:/rpms/ 1703940 -rw-rw-r--. 1 5912 Feb 9 07:15 xr-telnet-8201-7.0.12v1.0.0-1.x86_64.rpm 1703938 -rw-rw-r--. 1 5888 Feb 9 07:15 xr-telnet-7.0.12v1.0.0-1.x86_64.rpm 1703943 -rw-rw-r--. 1 5916 Feb 9 07:15 xr-telnet-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm 1703945 -rw-rw-r--. 1 115097 Feb 9 07:15 xr-telnet-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm 1703942 -rw-rw-r--. 1 5916 Feb 9 07:15 xr-telnet-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm 1703944 -rw-rw-r--. 1 5936 Feb 9 07:15 xr-telnet-8800-rp-7.0.12v1.0.0-1.x86_64.rpm 1703941 -rw-rw-r--. 1 5912 Feb 9 07:15 xr-telnet-8202-7.0.12v1.0.0-1.x86_64.rpm 1703939 -rw-rw-r--. 1 11083 Feb 9 07:15 xr-telnet-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64.rpm 65908476 kbytes total (61504492 kbytes free)
install package add コマンドにて、これから追加するパッケージを選択します。
RP/0/RP0/CPU0:8201-R1#install package add source /harddisk:/rpms/ xr-telnet Tue Feb 9 07:23:02.524 UTC RP/0/RP0/CPU0:Feb 9 07:23:03.165 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 8.1.1 started - add xr-telnet Install add operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 9 07:24:01.577 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 8.1.1 complete. More packaging operations can be performed, or any current changes can be applied by restart
上記出力より、新規トランザクション "8" 及び 新規 Atomic Operation "8.1" が自動的に作成され、"install packge add" に対して Package Operation "8.1.1" が割り当てられているのが確認できます。
下記どちらかの show install history コマンドにて、install apply コマンドを実行した際に、どのような処理が行われるかを事前に確認することができます。
RP/0/RP0/CPU0:8201-R1#show install history id 8 verbose Tue Feb 9 09:20:21.227 UTC 2021-02-09 07:23:03 UTC Transaction 8 started 2021-02-09 07:23:03 UTC Atomic change 8.1 started 2021-02-09 07:23:03 UTC Packaging operation 8.1.1 started 2021-02-09 07:23:03 UTC Add 2021-02-09 07:23:03 UTC xr-telnet 2021-02-09 07:24:01 UTC Packaging operation 8.1.1 success Atomic change 8.1 Least impactful apply method: process restart Location 0/RP0/CPU0 Changeset: Changed files: Removed crypto/dnf-plugins/__pycache__/xrcert.cpython-35.pyc Added bin/telnet Added bin/telnetd Added configs/sh_ipv4_telnet_ns_cfg__api.configinfo Added lib/libtelnetmgmt_client.so Added parser/cfg_telnet.parser Added parser/telnet_cmds.parser Added parser/telnet_dscp.parser Added parser/telnet_mgmt_debug_cmds.parser Added parser/telnetd_cmds.parser Added partitions/sh_telnet_ns_cfg__api.partitioninfo Added schema/telnet_client_cfg.schema Added schema/telnet_client_cfg.xsd Added schema/telnet_mgmt_cfg.schema Added schema/telnet_mgmt_cfg.xsd Added schema/telnetd_cfg.schema Added schema/telnetd_cfg.xsd Added yang/Cisco-IOS-XR-ipv4-telnet-cfg.yang Added yang/Cisco-IOS-XR-ipv4-telnet-mgmt-cfg.yang Added yang/meta/Cisco-IOS-XR-ipv4-telnet-cfg.xml Added yang/meta/Cisco-IOS-XR-ipv4-telnet-mgmt-cfg.xml Packaging operation 8.1.1 Location 0/RP0/CPU0 Add xr-telnet-7.0.12v1.0.0-1.x86_64 Add xr-telnet-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64 Add xr-telnet-8201-7.0.12v1.0.0-1.x86_64 Add xr-telnet-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64
上記出力結果より、Atomic Operation 8.1 により、システム再起動されることなくプロセス再起動のみで xr-telnet パッケージが追加されることがわかります。
(*) 上記出力結果において、トップレベルパッケージである xr-telnet パッケージ RPM を install package add するだけで、xr-telnet パケージ RPM の依存関係のある下記パッケージ RPM も自動的にインストールされることが確認できます。
install apply コマンドにより、Atomic Operation 8.1 を開始して、実際のパッケージ追加処理を実施します。
RP/0/RP0/CPU0:8201-R1#install apply Tue Feb 9 09:25:24.317 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'. Continue? [yes/no]:[yes] Install apply operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 9 09:25:26.892 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by process restart 8.1 started RP/0/RP0/CPU0:Feb 9 09:25:32.750 UTC: schema_server[1170]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 9 09:25:32.752 UTC: bag_schema_svr[243]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 9 09:26:11.271 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_COMPLETE : Apply by process restart 8.1 complete
コマンド実行の可否を問われるので、[yes] のままリターンを押すと install apply 処理が実行されます。
install apply 後に現在 Active 状なオプションパッケージを確認すると xr-telnet が有効化されているのがわかります。
RP/0/RP0/CPU0:8201-R1#show install active summary Tue Feb 9 09:30:52.350 UTC Active Packages: XR: 167 All: 1184 Label: 7.0.12 Software Hash: cb35b4fa5ecea44ec4a76adf62d1e23d Optional Packages Version ---------------------------------------------------- --------------------------- xr-8000-mcast 7.0.12v1.0.0-1 xr-8000-netflow 7.0.12v1.0.0-1 xr-bgp 7.0.12v1.0.0-1 xr-ipsla 7.0.12v1.0.0-1 xr-is-is 7.0.12v1.0.0-1 xr-lldp 7.0.12v1.0.0-1 xr-mcast 7.0.12v1.0.0-1 xr-mpls-oam 7.0.12v1.0.0-1 xr-netflow 7.0.12v1.0.0-1 xr-ospf 7.0.12v1.0.0-1 xr-perfmgmt 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1
最後に install commit コマンドを実行して、一連のインストール処理のトランザクションを終了させます。
RP/0/RP0/CPU0:8201-R1#install commit Tue Feb 9 09:33:01.734 UTC Install commit operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 9 09:33:02.455 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_BEGIN : Commit 8 started RP/0/RP0/CPU0:Feb 9 09:33:12.745 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_COMPLETE : Commit 8 complete
オプションパッケージの削除は、install package コマンドの箇所を除いて、オプションパッケージの追加と同様な手順となります。
install package remove コマンドにて、これから削除するオプションパッケージを選択します。
RP/0/RP0/CPU0:8201-R1#install package remove xr-telnet Tue Feb 9 09:43:15.574 UTC RP/0/RP0/CPU0:Feb 9 09:43:16.248 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 9.1.1 started - remove xr-telnet Install remove operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 9 09:43:57.032 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 9.1.1 complete. More packaging operations can be performed, or any current changes can be applied by restart
上記出力より、新規トランザクション 9 及び Atomic Operation 9.1 が自動的に作成され、"install packge remove" に対して Package Operation "9.1.1" が割り当てられているのが確認できます。
install apply コマンドにより、Atomic Operation 9.1 を開始して、実際のパッケージ削除処理を実施します。
RP/0/RP0/CPU0:8201-R1#install apply Tue Feb 9 09:46:08.552 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'. Continue? [yes/no]:[yes] Install apply operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 9 09:46:10.955 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by process restart 9.1 started RP/0/RP0/CPU0:Feb 9 09:46:18.647 UTC: schema_server[1170]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 9 09:46:18.647 UTC: bag_schema_svr[243]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 9 09:46:59.390 UTC: instorch[314]: %INFRA-INSTALL-6-ACTION_COMPLETE : Apply by process restart 9.1 complete
コマンド実行の可否を問われるので、[yes] のままリターンを押すと install apply 処理が実行されます。
XR7 インストールアーキテクチャは DNF (Dandified Yum) ベースとなっているため、RPM 用の DNF (Yum) レポジトリを harddisk:/ 上、もしくはリモートサーバ上に作成しておくことで、XR7 ルータのインストール作業を効率的に管理及び実施することができるようになります。特にリモートレポジトリの利用は、複数 XR7 ルータを管理する際は効果を発揮するためリモートレポジトリの利用を推奨しております。
RP/0/RP0/CPU0:8201-R1#mkdir harddisk:/localrepo Wed Feb 10 06:49:27.227 UTC Created dir harddisk:/localrepo
install repository localrepo url file:///harddisk:/localrepo ! !
なお、存在しないディレクトリを指定した場合には下記 syslog が出力されるため、その場合はディレクトリを作成後に改めて install repository 設定の削除及び再設定を行ってください。
RP/0/RP0/CPU0:Feb 10 06:57:28.962 UTC: instorch[384]: %INFRA-INSTALL-3-REPO_INACCESSIBLE : Failed to access repository hoge with URL file:///harddisk:/hoge. Either the URL is inaccessible or it does not contain the required repository metadata.
ここでは CentOS7 のリモートサーバ上の /var/www/html/ioxarchive/IOX7012/8000/ ディレクトリ配下に DNF レポジトリを作成する例となります。
[taisasak@jtac-vxr-1 8000]$ pwd /var/www/html/ioxarchive/IOX7012/8000 [taisasak@jtac-vxr-1 8000]$ [taisasak@jtac-vxr-1 8000]$ tree . |-- 8000-optional-rpms.7.0.12.tar |-- 8000-usb_boot-7.0.12.zip |-- 8000-x64-7.0.12.iso
上記 iso, tar ファイルは Cisco ダウンロードからダウンロードしたファイルとなります。ここでは、上記ディレクトリ配下で 8000-optional-rpms.7.0.12.tar ファイルを展開し、作成される optional-rpms ディレクトリを DNF リポジトリとして設定する例となります。
[taisasak@jtac-vxr-1 8000]$ tar xvf 8000-optional-rpms.7.0.12.tar optional-rpms/cdp/ optional-rpms/cdp/xr-cdp-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-8800-rp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-fbaabb7554875ebc-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-8201-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/cdp/xr-cdp-8202-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/ optional-rpms/eigrp/xr-eigrp-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-8201-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-8202-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/eigrp/xr-eigrp-8800-rp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/ optional-rpms/healthcheck/xr-healthcheck-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-8800-rp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-8202-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/healthcheck/xr-healthcheck-8201-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/ optional-rpms/rip/xr-rip-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-8201-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-8202-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/rip/xr-rip-8800-rp-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/ optional-rpms/telnet/xr-telnet-8800-lc-36fh-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-8201-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-8800-lc-48h-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-8202-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-7.0.12v1.0.0-1.x86_64.rpm optional-rpms/telnet/xr-telnet-8800-rp-7.0.12v1.0.0-1.x86_64.rpm
ファイル展開後にこの optional-rpms ディレクトリを createrepo コマンドを使って DNF レポジトリとして設定します。
[taisasak@jtac-vxr-1 8000]$ sudo createrepo optional-rpms/
-- snip --
Workers Finished Saving Primary metadata Saving file lists metadata Saving other metadata Generating sqlite DBs Sqlite DBs complete
DNF レポジトリとして設定した後には、以下の repodata ディレクトリが作成されていることを確認して下さい。
[taisasak@jtac-vxr-1 8000]$ ls -ltr optional-rpms total 24 drwxr-sr-x. 2 taisasak tac 4096 Mar 14 2020 cdp/ drwxr-sr-x. 2 taisasak tac 4096 Mar 14 2020 eigrp/ drwxr-sr-x. 2 taisasak tac 4096 Mar 14 2020 healthcheck/ drwxr-sr-x. 2 taisasak tac 4096 Mar 14 2020 rip/ drwxr-sr-x. 2 taisasak tac 4096 Mar 14 2020 telnet/ drwxr-sr-x. 2 root tac 4096 Feb 15 18:19 repodata/
createrepo を実行した後に、上記リモートレポジトリ配下のファイルの追加・削除を行った際は、忘れずに DNF レポジトリの更新も実施して下さい。
[taisasak@jtac-vxr-1 8000]$ sudo createrepo --update optional-rpms/
XR7 ルータの Config 設定にて、作成したディレクトリの URL をリモートレポジトリとして登録します。
install repository remoterepo url http://<A.B.C.D>;MGMT/ioxarchive/IOX7012/8000/optional-rpms/ ! !
(*) 上記例では MgmtEth (vrf MGMT) を経由してリモートレポジトリを設定しています。
XR7 ルータでローカルもしくはリモートレポジトリを設定することで、show install available コマンドを使ってインストール可能なパッケージの確認、及びパッケージインストールを簡単に実施することが可能となります。
RP/0/RP0/CPU0:8201-R1#show install available Mon Feb 15 09:20:31.359 UTC Trying to access repositories... Package Architecture Version Repository Cached ---------------------------------------------------- ---------------- --------------------------- ----------------------------------- ------ xr-cdp x86_64 7.0.12v1.0.0-1 remoterepo xr-eigrp x86_64 7.0.12v1.0.0-1 remoterepo xr-healthcheck x86_64 7.0.12v1.0.0-1 remoterepo xr-rip x86_64 7.0.12v1.0.0-1 remoterepo xr-telnet x86_64 7.0.12v1.0.0-1 remoterepo
上記出力より、先程設定したリモートレポジトリ remoterepo 上の利用可能なパッケージ一覽を確認することができます。
なお、リモートサーバへの到達性がない、もしくはリモートサーバ上に正しくレポジトリが作成されていない場合は、下記 syslog メッセージが出力されるため、このメッセージが出力された場合はリモートサーバ側の設定確認も必要となります。
RP/0/RP0/CPU0:Feb 15 09:16:49.334 UTC: instorch[384]: %INFRA-INSTALL-3-REPO_INACCESSIBLE : Failed to access repository remoterepo with URL http://<A.B.C.D>/ioxarchive/IOX7012/8000/optional-rpms/. Either the URL is inaccessible or it does not contain the required repository metadata.
XR7 ルータにローカルもしくはリモートレポジトリを設定した後は、show install available コマンド出力の一覧から利用可能なパッケージを追加することができます。
RP/0/RP0/CPU0:8201-R1#install package add xr-telnet Mon Feb 15 09:28:04.621 UTC RP/0/RP0/CPU0:Feb 15 09:28:05.171 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 1.1.1 started - add xr-telnet Install add operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 15 09:29:10.084 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 1.1.1 complete. More packaging operations can be performed, or any current changes can be applied by restart
上記のように、XR7 ルータ上に install repository が設定済の場合は、source オプションによる場所指定をする必要なくパッケージインストールを行なうことができます。
RP/0/RP0/CPU0:8201-R1#install apply Mon Feb 15 09:34:46.065 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'. Continue? [yes/no]:[yes] Install apply operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 15 09:34:48.077 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by process restart 1.1 started RP/0/RP0/CPU0:Feb 15 09:34:58.277 UTC: bag_schema_svr[194]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 15 09:34:58.279 UTC: schema_server[1168]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 15 09:35:28.323 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Apply by process restart 1.1 complete
RP/0/RP0/CPU0:8201-R1#show install active summary Mon Feb 15 09:37:44.154 UTC Active Packages: XR: 167 All: 1184 Label: 7.0.12 Software Hash: cb35b4fa5ecea44ec4a76adf62d1e23d Optional Packages Version ---------------------------------------------------- --------------------------- xr-8000-mcast 7.0.12v1.0.0-1 xr-8000-netflow 7.0.12v1.0.0-1 xr-bgp 7.0.12v1.0.0-1 xr-ipsla 7.0.12v1.0.0-1 xr-is-is 7.0.12v1.0.0-1 xr-lldp 7.0.12v1.0.0-1 xr-mcast 7.0.12v1.0.0-1 xr-mpls-oam 7.0.12v1.0.0-1 xr-netflow 7.0.12v1.0.0-1 xr-ospf 7.0.12v1.0.0-1 xr-perfmgmt 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1
上記出力より、xr-telnet パッケージが有効化されているのを確認できます。
ここでは eXR の SMU インストールに該当する、Bugfix を適用する方法について紹介します。事前にローカルレポジトリもしくはリモートレポジトリを XR7 上に設定しておく必要があります。
show install fixes available コマンドにて、レポジトリ上の利用可能な Bugfix 一覧を確認します。
RP/0/RP0/CPU0:8201-R1#show install fixes available Wed Feb 17 05:14:57.263 UTC Available Fixes (count: 8): Bug Id Packages Repository Cached ----------- ----------------------------------------------------------- ---------------------------------------- ------ CSCvt24866 xr-spi-core-7.0.12v1.0.1-1 remoterepo CSCvt55079 xr-ip-core-7.0.12v1.0.3-1 remoterepo CSCvt80563 xr-8000-fib-ea-7.0.12v1.0.2-1 remoterepo CSCvu33136 xr-8000-fib-ea-7.0.12v1.0.1-1 remoterepo xr-8000-fib-ea-7.0.12v1.0.2-1 remoterepo xr-8000-leabaofa-7.0.12v1.0.1-1 remoterepo xr-8000-npu-7.0.12v1.0.1-1 remoterepo xr-8000-utapp-blaze-7.0.12v1.0.1-1 remoterepo xr-fib-7.0.12v1.0.1-1 remoterepo xr-ofa-7.0.12v1.0.1-1 remoterepo CSCvu53808 xr-cpa-driver-optics-7.0.12v1.0.1-1 remoterepo CSCvu83840 xr-8000-vether-7.0.12v1.0.2-1 remoterepo CSCvu94023 xr-8000-forwarder-7.0.12v1.0.1-1 remoterepo CSCvv37007 xr-8000-core-7.0.12v1.0.1-1 remoterepo xr-8000-cpa-npu-7.0.12v1.0.1-1 remoterepo
今回の例では、上記 CSCvt55079 の Bugfix を適用する手順について紹介します。
上記出力結果より、CSCvt55079 を適用するためには、xr-ip-core パッケージ RPM のバージョンを 7.0.12v1.0.3-1 へと Upgrade する必要があると確認できます。
show install fixes active 出力より、現時点では何の Bugfix も適用されていない状態であることが確認できます。
RP/0/RP0/CPU0:8201-R1#show install fixes active Wed Feb 17 05:15:10.002 UTC There are currently no fixes active.
install package add コマンドにて、xr-ip-core-7.0.12v1.0.3-1 パッケージ RPM を追加します。
RP/0/RP0/CPU0:8201-R1#install package add xr-ip-core-7.0.12v1.0.3-1 Wed Feb 17 05:15:38.035 UTC Install add operation has started Install operation will continue in the background RP/0/RP0/CPU0:Feb 17 05:15:38.613 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 2.1.1 started - add xr-ip-core-7.0.12v1.0.3-1 RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 05:16:31.301 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 2.1.1 complete. More packaging operations can be performed, or any current changes can be applied by restart
なお、上記 install packa add コマンドは下記のように DDTS 番号指定でも実施することができます。
RP/0/RP0/CPU0:8201-R1#install package add cisco-CSCvt55079 Wed Feb 17 06:26:56.335 UTC Install add operation has started Install operation will continue in the background RP/0/RP0/CPU0:Feb 17 06:26:56.883 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 3.2.1 started - add cisco-CSCvt55079 RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 06:27:42.013 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 3.2.1 complete. More packaging operations can be performed, or any current changes can be applied by restart
show install history id verbose コマンド、もしくは show install history last transaction verbose コマンドにて install apply を実施した場合の影響範囲を確認します。
RP/0/RP0/CPU0:8201-R1#show install history id 2 verbose Wed Feb 17 05:17:45.426 UTC 2021-02-17 05:15:38 UTC Transaction 2 started 2021-02-17 05:15:38 UTC Atomic change 2.1 started 2021-02-17 05:15:38 UTC Packaging operation 2.1.1 started 2021-02-17 05:15:38 UTC Add 2021-02-17 05:15:38 UTC xr-ip-core-7.0.12v1.0.3-1 2021-02-17 05:16:31 UTC Packaging operation 2.1.1 success Atomic change 2.1 Least impactful apply method: process restart Location 0/RP0/CPU0 Changeset: Changed files: Removed crypto/dnf-plugins/__pycache__/xrcert.cpython-35.pyc Removed opt/cisco/pam/monitor_cpu.pl.log Removed opt/cisco/pam/monitor_crash.pl.log Removed opt/cisco/pam/monitor_show_logging.pl.log Removed opt/cisco/pam/pam_cli_agent.log Removed opt/cisco/pam/pam_plugin.pl.log Modified bin/pfilter_ma Impacted processes: Modified bin/pfilter_ma (PID 7448) Modified bin/pam_cli_agent (PID 26299) Packaging operation 2.1.1 Location 0/RP0/CPU0 Add xr-ip-core-7.0.12v1.0.3-1.x86_64 Add xr-ip-core-7dee261fe41a15d8-7.0.12v1.0.3-1.x86_64 Add xr-ip-core-8201-7.0.12v1.0.3-1.x86_64 Add xr-ip-core-c1d82c6c34a39c33-7.0.12v1.0.3-1.x86_64 Add xr-ip-core-fbaabb7554875ebc-7.0.12v1.0.3-1.x86_64 Remove xr-ip-core-7.0.12v1.0.0-1.x86_64 Remove xr-ip-core-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64 Remove xr-ip-core-8201-7.0.12v1.0.0-1.x86_64 Remove xr-ip-core-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64 Remove xr-ip-core-fbaabb7554875ebc-7.0.12v1.0.0-1.x86_64
上記出力結果より、Atomic Operation 2.1 により、システム再起動されることなくプロセス再起動のみで xr-ip-core パッケージが Upgrade されることがわかります。
install apply コマンドにより、Atomic Operation 2.1 を開始して、実際のパッケージ Upgrade 処理を実施します。
RP/0/RP0/CPU0:8201-R1#install apply Wed Feb 17 05:18:31.466 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want more control of the operation, then explicitly use 'install apply restart' or 'install apply reload' as reported by 'show install request'. Continue? [yes/no]:[yes] Install apply operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 05:18:34.248 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by process restart 2.1 started RP/0/RP0/CPU0:Feb 17 05:18:44.607 UTC: bag_schema_svr[194]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 17 05:19:11.796 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Apply by process restart 2.1 complete
install apply 後に show install fixes active 確認すると、Bugfix CSCvt55079 が適用されているのを確認できます。
RP/0/RP0/CPU0:8201-R1#show install fixes active Wed Feb 17 05:20:03.381 UTC Active Fixes (count: 1): Bug Id Packages ----------- ----------------------------------------------------------- CSCvt55079 xr-ip-core-7.0.12v1.0.3-1
また、上記は show install active summary コマンドでも確認できます。
RP/0/RP0/CPU0:8201-R1#show install active summary Wed Feb 17 05:19:38.346 UTC Active Packages: XR: 167 All: 1184 Label: 7.0.12 Software Hash: f1e5fea355cb821bb21b3a19a4c307cb Optional Packages Version ---------------------------------------------------- --------------------------- xr-8000-mcast 7.0.12v1.0.0-1 xr-8000-netflow 7.0.12v1.0.0-1 xr-bgp 7.0.12v1.0.0-1 xr-ipsla 7.0.12v1.0.0-1 xr-is-is 7.0.12v1.0.0-1 xr-lldp 7.0.12v1.0.0-1 xr-mcast 7.0.12v1.0.0-1 xr-mpls-oam 7.0.12v1.0.0-1 xr-netflow 7.0.12v1.0.0-1 xr-ospf 7.0.12v1.0.0-1 xr-perfmgmt 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1 Mandatory Packages with Active Bugfixes Version ---------------------------------------------------- --------------------------- xr-ip-core 7.0.12v1.0.3-1 Active Fixes (count: 1): CSCvt55079: xr-ip-core
システム再起動後にも Bugfix を永続的に適用させるため、忘れずに install commit により Transaction を終了させます。
RP/0/RP0/CPU0:8201-R1#install commit Wed Feb 17 05:20:11.601 UTC Install commit operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 05:20:12.201 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Commit 2 started RP/0/RP0/CPU0:Feb 17 05:20:23.655 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Commit 2 complete
ここでは eXR の SMU アンインストールに該当する、Bugfix 適用を取り消す方法について紹介します。
XR7 において、Bugfix 適用とはある特定のパッケージ RPM を Upgrade することであるため、Bugfix 適用を取り消すとはある特定のパッケージ RPM を元のバージョンへ Downgrade することになります。
(*) install rollback は特定の NCS-540 シリーズルータではサポートされておりません。
(*) https://www.cisco.com/c/en/us/td/docs/iosxr/ncs5xx/system-setup/75x/b-system-setup-cg-75x-ncs540/understanding-software-modularity-and-installation.html#id_116963
ここでは最も簡単な install rollback を使った方法について紹介します。
show install rollback list-ids コマンドにより、インストール Rollback ポイントの一覧を確認します。
RP/0/RP0/CPU0:8201-R1#show install rollback list-ids Wed Feb 17 07:20:03.494 UTC It is possible to rollback to the following transaction IDs: # Pkgs to rollback Id Software Committed At: Add Mod Rem ---- ----------------------- ------- ------- ------- 3 2021-02-17 07:03:45 UTC 0 1 0 4 2021-02-17 07:11:12 UTC 0 0 0 For additional information, use the command 'show install rollback id N [changes]'
上記出力より、Rollback ID = 3, ID = 4 の 2 つの Rollback ポイントが確認できます。
show install rollback id <> changes コマンドにより、Rollback ポイントによるパッケージ変更内容を確認します。
RP/0/RP0/CPU0:8201-R1#show install rollback id 3 changes Wed Feb 17 07:20:57.618 UTC Rollback to transaction ID 3 will result in the following packages being added: Name Version Arch ------------------------------ -------------------- ---------- xr-ip-core 7.0.12v1.0.0-1 x86_64 Rollback to transaction ID 3 will result in the following packages being removed: Name Version Arch ------------------------------ -------------------- ---------- xr-ip-core 7.0.12v1.0.3-1 x86_64
上記出力より、Rollback ID=3 まで rollback することで、xr-ip-core パッケージ RPM バージョン 7.0.12v1.0.0-1 が追加され、xr-ip-core パッケージ RPM バージョン 7.0.12v1.0.3-1 が削除されることが確認できます。
install rollback コマンドにより、実際に Rollback ID=3 までのパッケージの Rollback を実施します。
RP/0/RP0/CPU0:8201-R1#install rollback 3 Wed Feb 17 07:43:12.852 UTC Once the packaging dependencies have been determined, the install operation may have to reload the system. If you want to control the timing of system reload, you must not continue, but use the 'install package' commands instead, followed by 'install apply reload'. Continue? [yes/no]:[yes] Install rollback operation has started Install operation will continue in the background RP/0/RP0/CPU0:Feb 17 07:43:14.457 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Compound software rollback operation 8.1 started RP/0/RP0/CPU0:Feb 17 07:43:14.462 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Packaging operation 8.1.1 started - software rollback to 3 RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 07:45:15.937 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Packaging operation 8.1.1 complete. More packaging operations can be performed, or any current changes can be applied by restart RP/0/RP0/CPU0:Feb 17 07:45:16.015 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Apply by process restart 8.1 started RP/0/RP0/CPU0:Feb 17 07:45:22.325 UTC: bag_schema_svr[194]: %INFRA-INSTALL-6-RESTART_DUE_TO_INSTALL : Process restarted due to install operation RP/0/RP0/CPU0:Feb 17 07:45:45.876 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Apply by process restart 8.1 complete RP/0/RP0/CPU0:Feb 17 07:45:45.922 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Compound software rollback operation 8.1 complete
(*) install rollback 実施時には、上記メッセージ出力にも記載があるように Rollback の内容によってはシステム再起動が発生する場合があります。
システム再起動後にも Bugfix 適用の取り消しを永続化させるために、install commit コマンドを実行して Transaction を終了させます。
RP/0/RP0/CPU0:8201-R1#install commit Wed Feb 17 07:50:02.279 UTC Install commit operation has started Install operation will continue in the background RP/0/RP0/CPU0:8201-R1#RP/0/RP0/CPU0:Feb 17 07:50:02.898 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_BEGIN : Commit 8 started RP/0/RP0/CPU0:Feb 17 07:50:14.488 UTC: instorch[384]: %INFRA-INSTALL-6-ACTION_COMPLETE : Commit 8 complete
本章ではいくつかのインストールに関する show コマンドを紹介します。
いくつかの show コマンドは eXR とコマンドシンタックスが同じものもありますが、出力結果が異なっておりコマンド出力の意味も異なる場合がある点はご注意お願いします。
番号 | コマンドシンタックス | コマンド出力 |
1 | show install active summary | install apply により有効化されている Optional パッケージ一覧の確認 |
2 | show install active | install apply により有効化されている XR パッケージ一覧の確認 |
3 | show install active all | install apply により有効化されている全てのパッケージ一覧の確認 |
4 | show install committed | install commit されている XR パッケージ一覧の確認 |
5 | show install committed all | install commit されている全てのパッケージ一覧の確認 |
6 | show install available | install package add 可能な XR パッケージ一覧の確認 |
7 | show install fixes available | install package add 可能な Bugfix 一覧の確認 |
8 | show install fixes active | install apply により有効化されている Bugfix 一覧の確認 |
9 | show install fixes committed | install commit されている Bugfix 一覧の確認 |
show install active summary コマンドにて、install apply により有効化されている Optional パッケージの一覧を確認できます。
RP/0/RP0/CPU0:8201-R1#show install active summary Tue Feb 16 06:23:25.662 UTC Active Packages: XR: 167 All: 1184 Label: 7.0.12 Software Hash: cb35b4fa5ecea44ec4a76adf62d1e23d Optional Packages Version ---------------------------------------------------- --------------------------- xr-8000-mcast 7.0.12v1.0.0-1 xr-8000-netflow 7.0.12v1.0.0-1 xr-bgp 7.0.12v1.0.0-1 xr-ipsla 7.0.12v1.0.0-1 xr-is-is 7.0.12v1.0.0-1 xr-lldp 7.0.12v1.0.0-1 xr-mcast 7.0.12v1.0.0-1 xr-mpls-oam 7.0.12v1.0.0-1 xr-netflow 7.0.12v1.0.0-1 xr-ospf 7.0.12v1.0.0-1 xr-perfmgmt 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1
show install active コマンドにて、install apply により有効化されている XR パッケージの一覧を確認できます。
RP/0/RP0/CPU0:8201-R1#show install active Tue Feb 16 06:31:16.199 UTC Software Hash: cb35b4fa5ecea44ec4a76adf62d1e23d Package Version ---------------------------------------------------- --------------------------- xr-8000-af-ea 7.0.12v1.0.0-1 xr-8000-aib 7.0.12v1.0.0-1 xr-8000-bfd 7.0.12v1.0.0-1 xr-8000-bmc 7.0.12v1.0.0-1 xr-8000-buffhdr-ea 7.0.12v1.0.0-1 xr-8000-bundles 7.0.12v1.0.0-1 xr-8000-card-support 7.0.12v1.0.0-1 xr-8000-core 7.0.12v1.0.0-1 xr-8000-cpa 7.0.12v1.0.0-1 xr-8000-cpa-npu 7.0.12v1.0.0-1 xr-8000-cpa-sb-data 7.0.12v1.0.0-1 xr-8000-encap-id 7.0.12v1.0.0-1 xr-8000-ether-ea 7.0.12v1.0.0-1 xr-8000-fabric 7.0.12v1.0.0-1 xr-8000-feat-mgr 7.0.12v1.0.0-1 xr-8000-fib-ea 7.0.12v1.0.0-1 xr-8000-forwarder 7.0.12v1.0.0-1 xr-8000-fpd 7.0.12v1.0.0-1 xr-8000-fwdlib 7.0.12v1.0.0-1 xr-8000-host-core 7.0.12v1.0.0-1 xr-8000-l2fib 7.0.12v1.0.0-1 xr-8000-leabaofa 7.0.12v1.0.0-1 xr-8000-libofaasync 7.0.12v1.0.0-1 xr-8000-lpts-ea 7.0.12v1.0.0-1 xr-8000-mcast 7.0.12v1.0.0-1 xr-8000-netflow 7.0.12v1.0.0-1 xr-8000-npu 7.0.12v1.0.0-1 xr-8000-optics 7.0.12v1.0.0-1 xr-8000-os 7.0.12v1.0.0-1 xr-8000-pbr 7.0.12v1.0.0-1 xr-8000-pfilter 7.0.12v1.0.0-1 xr-8000-pidb 7.0.12v1.0.0-1 xr-8000-pktio 7.0.12v1.0.0-1 xr-8000-port-mapper 7.0.12v1.0.0-1 xr-8000-ppinfo 7.0.12v1.0.0-1 xr-8000-qos-ea 7.0.12v1.0.0-1 xr-8000-secy-driver 7.0.12v1.0.0-1 xr-8000-span 7.0.12v1.0.0-1 xr-8000-spio 7.0.12v1.0.0-1 xr-8000-spitfire-syspro 7.0.12v1.0.0-1 xr-8000-spp-ea 7.0.12v1.0.0-1 xr-8000-tams 7.0.12v1.0.0-1 xr-8000-timing 7.0.12v1.0.0-1 xr-8000-tunnel-ip 7.0.12v1.0.0-1 xr-8000-utapp-blaze 7.0.12v1.0.0-1 xr-8000-vether 7.0.12v1.0.0-1 xr-8000-ztp-ea 7.0.12v1.0.0-1 xr-aaa 7.0.12v1.0.0-1 xr-acl 7.0.12v1.0.0-1 xr-apphosting 7.0.12v1.0.0-1 xr-bcdl 7.0.12v1.0.0-1 xr-bfd 7.0.12v1.0.0-1 xr-bgp 7.0.12v1.0.0-1 xr-bgputil 7.0.12v1.0.0-1 xr-bng-stubs 7.0.12v1.0.0-1 xr-bundles 7.0.12v1.0.0-1 xr-cal-pi 7.0.12v1.0.0-1 xr-cds 7.0.12v1.0.0-1 xr-cfgmgr 7.0.12v1.0.0-1 xr-cfm 7.0.12v1.0.0-1 xr-cofo 7.0.12v1.0.0-1 xr-core 7.0.12v1.0.0-1 xr-core-calv 7.0.12v1.0.0-1 xr-cpa-common 7.0.12v1.0.0-1 xr-cpa-common-optics 7.0.12v1.0.0-1 xr-cpa-common-psu 7.0.12v1.0.0-1 xr-cpa-driver-devobj-misc 7.0.12v1.0.0-1 xr-cpa-driver-devobj-npu 7.0.12v1.0.0-1 xr-cpa-driver-devobj-phy 7.0.12v1.0.0-1 xr-cpa-driver-devobj-sensors 7.0.12v1.0.0-1 xr-cpa-driver-devobj-storage 7.0.12v1.0.0-1 xr-cpa-driver-devobj-test 7.0.12v1.0.0-1 xr-cpa-driver-devobj-timing 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-access 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-common 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-infra 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-kmod 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-misc 7.0.12v1.0.0-1 xr-cpa-driver-fpgalib-optics 7.0.12v1.0.0-1 xr-cpa-driver-optics 7.0.12v1.0.0-1 xr-cpa-ethsw 7.0.12v1.0.0-1 xr-cpa-idprom 7.0.12v1.0.0-1 xr-cpa-tamlib 7.0.12v1.0.0-1 xr-ctc 7.0.12v1.0.0-1 xr-debug 7.0.12v1.0.0-1 xr-dhcp 7.0.12v1.0.0-1 xr-diskboot 7.0.12v1.0.0-1 xr-drivers 7.0.12v1.0.0-1 xr-eem 7.0.12v1.0.0-1 xr-ema 7.0.12v1.0.0-1 xr-enhancedmanageability 7.0.12v1.0.0-1 xr-fib 7.0.12v1.0.0-1 xr-foundation-8000 7.0.12v1.0.0-1 xr-fpd 7.0.12v1.0.0-1 xr-ha-infra 7.0.12v1.0.0-1 xr-host-core 7.0.12v1.0.0-1 xr-httpclient 7.0.12v1.0.0-1 xr-icpe-eth 7.0.12v1.0.0-1 xr-identifier 7.0.12v1.0.0-1 xr-infra-sla 7.0.12v1.0.0-1 xr-install 7.0.12v1.0.0-1 xr-ip-apps 7.0.12v1.0.0-1 xr-ip-core 7.0.12v1.0.0-1 xr-ip-infra-vrf 7.0.12v1.0.0-1 xr-ip-mibs 7.0.12v1.0.0-1 xr-ip-static 7.0.12v1.0.0-1 xr-ipc 7.0.12v1.0.0-1 xr-ipsla 7.0.12v1.0.0-1 xr-is-is 7.0.12v1.0.0-1 xr-l2snooptransport 7.0.12v1.0.0-1 xr-l2vpn 7.0.12v1.0.0-1 xr-ldp 7.0.12v1.0.0-1 xr-licensing 7.0.12v1.0.0-1 xr-link-oam 7.0.12v1.0.0-1 xr-linuxnetworking 7.0.12v1.0.0-1 xr-lldp 7.0.12v1.0.0-1 xr-lpts 7.0.12v1.0.0-1 xr-manageabilityxml 7.0.12v1.0.0-1 xr-mandatory 7.0.12v1.0.0-1 xr-mcast 7.0.12v1.0.0-1 xr-mda 7.0.12v1.0.0-1 xr-mpls 7.0.12v1.0.0-1 xr-mpls-oam 7.0.12v1.0.0-1 xr-mpls-oam-client 7.0.12v1.0.0-1 xr-mpls-static 7.0.12v1.0.0-1 xr-netflow 7.0.12v1.0.0-1 xr-networkboot 7.0.12v1.0.0-1 xr-ntp 7.0.12v1.0.0-1 xr-ofa 7.0.12v1.0.0-1 xr-optics 7.0.12v1.0.0-1 xr-orrspf 7.0.12v1.0.0-1 xr-os 7.0.12v1.0.0-1 xr-ospf 7.0.12v1.0.0-1 xr-perfmgmt 7.0.12v1.0.0-1 xr-pfi 7.0.12v1.0.0-1 xr-procmgr 7.0.12v1.0.0-1 xr-python 7.0.12v1.0.0-1 xr-qos 7.0.12v1.0.0-1 xr-rid-mgr 7.0.12v1.0.0-1 xr-routing 7.0.12v1.0.0-1 xr-rpl 7.0.12v1.0.0-1 xr-rsvp-te 7.0.12v1.0.0-1 xr-security 7.0.12v1.0.0-1 xr-servicelayer 7.0.12v1.0.0-1 xr-snmp 7.0.12v1.0.0-1 xr-span 7.0.12v1.0.0-1 xr-spi-core 7.0.12v1.0.0-1 xr-spp 7.0.12v1.0.0-1 xr-sr 7.0.12v1.0.0-1 xr-stats 7.0.12v1.0.0-1 xr-stubs 7.0.12v1.0.0-1 xr-sysdb 7.0.12v1.0.0-1 xr-syslog 7.0.12v1.0.0-1 xr-telemetry 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-timing 7.0.12v1.0.0-1 xr-tmpdir-cleanup 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1 xr-transports 7.0.12v1.0.0-1 xr-tty 7.0.12v1.0.0-1 xr-tunnel-ip 7.0.12v1.0.0-1 xr-utils 7.0.12v1.0.0-1 xr-vether 7.0.12v1.0.0-1 xr-vpnmib 7.0.12v1.0.0-1 xr-xmlinfra 7.0.12v1.0.0-1 xr-xrlibcurl 7.0.12v1.0.0-1 xr-ztp 7.0.12v1.0.0-1
show install active all コマンドにて、install apply により有効化されている全パッケージの一覧を確認できます。
RP/0/RP0/CPU0:8201-R1#show install active all Tue Feb 16 06:33:19.326 UTC Package Version ---------------------------------------------------- --------------------------- 8000-cpa-setup-nos-x86 7.0.12v1.0.0-r0 8000-cpa-setup-x86 7.0.12v1.0.0-r0 8201-cpa-sb-x86 7.0.12v1.0.0-r0 8800-lc-36fh-cpa-sb-x86 7.0.12v1.0.0-r0 8800-lc-48h-cpa-sb-x86 7.0.12v1.0.0-r0 8800-rp-cpa-sb-x86 7.0.12v1.0.0-r0 8808-data-cpa-sb-x86 7.0.12v1.0.0-r0 8812-data-cpa-sb-x86 7.0.12v1.0.0-r0 8818-data-cpa-sb-x86 7.0.12v1.0.0-r0 acl 2.2.52-r0.9 at 3.1.20-r0.9 attr 2.4.47-r0.9 audit 2.7-r0.10 auditd 2.7-r0.10 base-files 3.0.14-r89.7 base-passwd 3.5.29-r0.1.9 base-passwd-update 3.5.29-r0.1.9 bash 4.3.30-r0.9 bash-completion 2.4-r0.9 bash-completion-extra 2.4-r0.9 bind 9.11.6+P1-r0.3.3 binutils 2.24-r0.9 bridge-utils 1.5-r0.9 busybox 1.24.1-r0.1.10 bzip2 1.0.6-r5.9 -- snip -- xr-telemetry 7.0.12v1.0.0-1 xr-telnet 7.0.12v1.0.0-1 xr-timing 7.0.12v1.0.0-1 xr-tmpdir-cleanup 7.0.12v1.0.0-1 xr-track 7.0.12v1.0.0-1 xr-transports 7.0.12v1.0.0-1 xr-tty 7.0.12v1.0.0-1 xr-tunnel-ip 7.0.12v1.0.0-1 xr-utils 7.0.12v1.0.0-1 xr-vether 7.0.12v1.0.0-1 xr-vpnmib 7.0.12v1.0.0-1 xr-xmlinfra 7.0.12v1.0.0-1 xr-xrlibcurl 7.0.12v1.0.0-1 xr-ztp 7.0.12v1.0.0-1 xz 5.2.2-r0.9 zeromq 4.1.5-r0.9 zip 3.0-r2.9
show install available コマンドにて、install package add 可能な XR パッケージ一覧を確認できます。
RP/0/RP0/CPU0:8201-R1#show install available Tue Feb 16 06:40:58.851 UTC Trying to access repositories... Package Architecture Version Repository Cached ---------------------------------------------------- ---------------- --------------------------- ----------------------------------- ------ xr-8000-core x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-cpa-npu x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-fib-ea x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-fib-ea x86_64 7.0.12v1.0.2-1 remoterepo xr-8000-forwarder x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-leabaofa x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-npu x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-utapp-blaze x86_64 7.0.12v1.0.1-1 remoterepo xr-8000-vether x86_64 7.0.12v1.0.2-1 remoterepo xr-cdp x86_64 7.0.12v1.0.0-1 remoterepo xr-cpa-driver-optics x86_64 7.0.12v1.0.1-1 remoterepo xr-eigrp x86_64 7.0.12v1.0.0-1 remoterepo xr-fib x86_64 7.0.12v1.0.1-1 remoterepo xr-healthcheck x86_64 7.0.12v1.0.0-1 remoterepo xr-ip-core x86_64 7.0.12v1.0.3-1 remoterepo xr-k9sec x86_64 7.0.12v1.0.0-1 remoterepo xr-ofa x86_64 7.0.12v1.0.1-1 remoterepo xr-rip x86_64 7.0.12v1.0.0-1 remoterepo xr-spi-core x86_64 7.0.12v1.0.1-1 remoterepo
番号 | コマンドシンタックス | コマンド出力内容 |
1 | show install request | 直近の Install Operation の現在の状況を確認 |
2 | show install history table | 過去の Install Operation の履歴の一覧を確認 |
3 | show install history id <> verbose |
過去の Install Operation の履歴の詳細を確認 |
show install request コマンドにより、直近に実施した Install Operation の現在の状況を確認できます。
RP/0/RP0/CPU0:8201-R1#show install request Wed Feb 17 08:13:38.114 UTC User request: install package add xr-cdp Operation ID: 10.1.1 State: Success since 2021-02-17 08:13:14 UTC Current activity: Await user input Time started: 2021-02-17 08:13:14 The following actions are available: install package add install package remove install package upgrade install package downgrade install package replace install package rollback install package abort latest install package abort all-since-apply install apply restart install apply reload
上記出力結果より、現在は以下の状態であることがわかります。
また、ユーザが次に実施すべき Install Operation の候補も同時に提示してくれます。
show install history table コマンドにて、過去の Install Operation の履歴の一覧を確認することができます。
RP/0/RP0/CPU0:8201-R1#show install history table Wed Feb 17 08:21:23.198 UTC Transaction Atomic Change Packaging Operations -------------------------- --------------------------------- ------------------------------------------------ Id Status Id Method Status Id Operation Inputs Status --- ---------------------- --- ------- --------------------- --- --------------------- ------ --------------- 1 Success 1 Restart Success 1 Add 1 Success 2 Success 1 Restart Success 1 Add 1 Success 3 Success 1 Restart Success 1 Rollback Success 2 Restart Success 1 Add 1 Success 3 Restart Success 1 Add 1 Success 4 Success 1 Restart Success 1 Add 1 Success 5 Aborted 1 None Aborted 1 Downgrade 1 Aborted 2 Abort latest Success 6 Aborted 1 None Aborted 1 Add 1 Aborted 7 Aborted 1 None Aborted 1 Downgrade 1 Aborted 2 Abort latest Success 8 Success 1 Restart Success 1 Rollback Success 9 Aborted 1 None Aborted 1 Add 1 Aborted 2 Abort latest Success 10 In progress 1 None In progress 1 Add 1 Success
上記出力結果より、現在は以下の状態であることがわかります。
show install history id <> verbose コマンドにて、過去の特定の Install Operation の詳細な履歴を確認できます。
RP/0/RP0/CPU0:8201-R1#show install history id 1 verbose Wed Feb 17 08:26:17.301 UTC 2021-02-15 09:28:05 UTC Transaction 1 started 2021-02-15 09:28:05 UTC Atomic change 1.1 started 2021-02-15 09:28:05 UTC Packaging operation 1.1.1 started 2021-02-15 09:28:05 UTC Add 2021-02-15 09:28:05 UTC xr-telnet 2021-02-15 09:29:10 UTC Packaging operation 1.1.1 success 2021-02-15 09:34:48 UTC Apply by process restart started 2021-02-15 09:35:28 UTC Atomic change 1.1 successfully applied by process restart 2021-02-16 07:06:59 UTC Commit started 2021-02-16 07:07:09 UTC Transaction 1 committed, post transaction cleanup in progress 2021-02-16 07:07:09 UTC Transaction 1 complete Atomic change 1.1 Least impactful apply method: process restart (process restart requested) Install infra restarted: False Location 0/RP0/CPU0 Changeset: Changed files: Removed crypto/dnf-plugins/__pycache__/xrcert.cpython-35.pyc Removed opt/cisco/pam/monitor_cpu.pl.log Removed opt/cisco/pam/monitor_crash.pl.log Removed opt/cisco/pam/monitor_show_logging.pl.log Removed opt/cisco/pam/pam_cli_agent.log Removed opt/cisco/pam/pam_plugin.pl.log Removed opt/cisco/pam/vxr_lindt_start_pam.log Added bin/telnet Added bin/telnetd Added configs/sh_ipv4_telnet_ns_cfg__api.configinfo Added lib/libtelnetmgmt_client.so Added parser/cfg_telnet.parser Added parser/telnet_cmds.parser Added parser/telnet_dscp.parser Added parser/telnet_mgmt_debug_cmds.parser Added parser/telnetd_cmds.parser Added partitions/sh_telnet_ns_cfg__api.partitioninfo Added schema/telnet_client_cfg.schema Added schema/telnet_client_cfg.xsd Added schema/telnet_mgmt_cfg.schema Added schema/telnet_mgmt_cfg.xsd Added schema/telnetd_cfg.schema Added schema/telnetd_cfg.xsd Added yang/Cisco-IOS-XR-ipv4-telnet-cfg.yang Added yang/Cisco-IOS-XR-ipv4-telnet-mgmt-cfg.yang Added yang/meta/Cisco-IOS-XR-ipv4-telnet-cfg.xml Added yang/meta/Cisco-IOS-XR-ipv4-telnet-mgmt-cfg.xml Impacted processes: Modified bin/pam_cli_agent (PID 10198) Packaging operation 1.1.1 Location 0/RP0/CPU0 Add xr-telnet-7.0.12v1.0.0-1.x86_64 Add xr-telnet-7dee261fe41a15d8-7.0.12v1.0.0-1.x86_64 Add xr-telnet-8201-7.0.12v1.0.0-1.x86_64 Add xr-telnet-c1d82c6c34a39c33-7.0.12v1.0.0-1.x86_64
上記コマンドの Install ID には、Transaction ID だけではなく、"1.1.1" のような特定の Package Operation や、 "1.1" のような特定の Atomic Operation を指定することもできます。
XR7 インストールに関してトラブルシューティングする場合は必ず下記ログを取得して下さい。
検索バーにキーワード、フレーズ、または質問を入力し、お探しのものを見つけましょう
シスコ コミュニティをいち早く使いこなしていただけるよう役立つリンクをまとめました。みなさんのジャーニーがより良いものとなるようお手伝いします