IOS eXRでのSMUおよび機能パッケージのインストールとトラブルシューティング

Updated: 2024 年 2 月 2 日
Document ID:221601

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

    はじめに

    このドキュメントでは、eXRバージョンのCisco IOS® XRソフトウェアが稼働するルータのソフトウェアメンテナンスアップデート(SMU)とパッケージのインストールについて説明します。

    前提条件

    要件

    次の項目に関する知識があることが推奨されます。

    • Cisco IOS XR ソフトウェア
    • Cisco IOS XR ソフトウェアのインストールおよびアップグレード手順

    使用するコンポーネント

    このドキュメントは、特定のハードウェアバージョンに限定されるものではありません。IOS XR 64ビットを実行するすべてのルータに適用されます。

    このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

    関連製品

    このドキュメントは、次のバージョンのハードウェアにも使用できます。

    • Cisco 9000 シリーズ ルータ
    • Cisco 8000 シリーズ ルータ
    • Cisco NCS 5700 シリーズ ルータ
    • Cisco NCS 5500 シリーズ ルータ
    • NCS 540および560ルータ

    機能のアップグレード

    機能のアップグレードとは、ルータに新しい機能とソフトウェアパッチを導入するプロセスです。

    • パッケージをインストールして機能のアップグレードを実行します。
    • Software Maintenance Upgrade(SMU)ファイルをインストールして、ソフトウェアパッチインストールを実行します。

    ルータにパッケージをインストールすると、そのパッケージに含まれる特定の機能がインストールされます。Cisco IOS XRソフトウェアは、さまざまなソフトウェアパッケージに分割されています。これにより、ルータで実行する機能を選択できます。各パッケージには、ルーティングやセキュリティなどのルータ機能の特定のセットを実行するコンポーネントが含まれています。

    たとえば、ルーティングパッケージのコンポーネントは、BGPやOSPFなどの個々のRPMに分割されます。BGPは基本ソフトウェアバージョンの一部であり、必須RPMであるため、削除できません。ただし、必要に応じてOSPFなどのオプションのRPMを追加および削除できます。

    Cisco IOS XR SMUの概要

    SMUは、Cisco IOS XRデバイスにインストールされるソフトウェアパッチです。SMUの概念はすべてのCisco IOS XRハードウェアプラットフォームに適用されます。

    Cisco IOS XR SMUは緊急ポイント修正であり、迅速な配信を目的とし、ダウンしているネットワークや収益に影響を与える問題に対処します。

    システムで不具合が発生した場合、シスコは現在のCisco IOS XRベースリリースで特定の問題の修正を提供できます。

    準備

    必要なパッケージとその理由を最初に確認する必要があります。一般的な問題のほとんどは、ルータのディスクスペースを使用した不要なインストールに関連しています。

    • ルータに何をインストールする必要があるかを理解したら、公式サイトからパッケージをダウンロードする必要があります。

    Ciscoソフトウェアのダウンロード

    このドキュメントの例では、7.5.2のASR9Kの次の2つのSMUを含みます

    SMUs in Cisco Software Download siteシスコソフトウェアダウンロードサイトのSMU

    • 次に、簡単なコピー操作でこれらのファイルをハードディスクにコピーします。
    note-icon

    注：必要に応じて、Cisco IOS XRソフトウェアのファイルシステムコマンドを確認してください

    ファイルシステムコマンド

    これらのファイルのコピー操作dir harddiskは、ファイルがハードディスクにあることを確認するコマンドです。

    RP/0/RSP0/CPU0:ASR-9006#copy ftp: harddisk: 
Wed Jan 31 00:48:00.784 UTC
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
1730560 bytes copied in      9 sec (   192284)bytes/sec

Copy operation success
RP/0/RSP0/CPU0:ASR-9006#copy ftp: harddisk: 
Wed Jan 31 00:49:10.754 UTC
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
5980160 bytes copied in     30 sec (   199338)bytes/sec

Copy operation success
RP/0/RSP0/CPU0:ASR-9006#dir harddisk:
Wed Jan 31 00:50:01.732 UTC

Directory of harddisk:
 783363 drwxr-xr-x. 6      4096 Jan 24 10:32 showtech
     15 drwxr-xr-x. 2      4096 Oct 19 05:31 dumper
     31 -rwxr--r--. 1   5980160 Jan 31 00:49 asr9k-sysadmin-7.5.2.CSCwf39757                .tar
     30 -rwxr--r--. 1   1730560 Jan 31 00:48 asr9k-x64-7.5.2.CSCwd75868                .tar
      
    
    
      23099260 kbytes total (21328112 kbytes free) RP/0/RSP0/CPU0:ASR-9006#

    インストールに進む前に、はXRおよびAdminで現在アクティブなパッケージの基本チェックを行うことを推奨します。

    RP/0/RSP0/CPU0:ASR-9006#sh install active summary 
Wed Jan 31 03:21:02.213 UTC
Label : 7.5.2

    Active Packages: 16
        asr9k-xr-7.5.2 version=7.5.2 [Boot image]
        asr9k-k9sec-x64-2.2-r752
---------------------- Truncated for Brevity -------------------------

RP/0/RSP0/CPU0:ASR-9006#admin show install active summary
Wed Jan 31 03:21:14.778 UTC
     Active Packages: 1
        asr9k-sysadmin-7.5.2 version=7.5.2 [Boot image]

RP/0/RSP0/CPU0:ASR-9006#

    設置

    この例では、2つのパッケージがあります。1つはsysadmin用、2つ目はXR VM用です。

    SMUはXR VMおよびSystem Admin VMと区別できます。ファイル名で識別できます。

    たとえば、asr9k-px-7.9.1.CSCvu599**.pieはXR VMのパッケージの例です。asr9k-sysadmin-7.9.1.pieはシステム管理VMに関連付けられています。

    XRパッケージまたはSMUはXR VMからアクティブ化されますが、System AdminパッケージまたはSMUはSystem Admin VMからアクティブ化されます。

    または、XRからSystem AdminパッケージとSMUをアクティブ化または非アクティブ化して、VM間の操作を実行することもできます。

    次に、eXRでのインストールの利点を示します。すべてが3つのコマンドを正しく入力した結果になります。

    1. install add source package path filename（ソースパッケージパスの追加ファイル名のインストール）
    2. install activateパッケージ名
    3. install commit
    • install add操作の例ハードディスクに必要なパッケージが入ったら、拡張子.tarを問題なく使用できます。
    RP/0/RSP0/CPU0:ASR-9006#install add source harddisk:/ asr9k-x64-7.5.2.CSCwd758**.tar asr9k-sysadmin-7.5.2.CSCwf397**.tar
    note-icon

    注：このコマンドは、追加操作の操作IDとそのステータスを表示します。操作IDは、後でactivateコマンドの実行に使用できます。

    • パッケージが追加されましたが、アクティベーションが必要です。前の手順でルータが作成した動作IDを使用できます（VPIを使用している場合）。
    RP/0/RSP0/CPU0:ASR-9006#install activate id #
Wed Jan 31 04:00:27.299 UTC
2024-01-31 04:00:29 Install operation # started by *:
  install activate id 172 
2024-01-31 04:00:29 Package list:
2024-01-31 04:00:29     asr9k-iosxr-ce-64-1.1.0.1-r752.CSCwd75868            .x86_64
2024-01-31 04:00:29     asr9k-sysadmin-asr9k-7.5.2.8-r752.CSCwf39757            .x86_64

    常に次のいずれかを実行できます。

    install activate package_name（アクティブ化パッケージ名のインストール）

    アクティブ化idのインストールoperation_id

    • SMUまたはパッケージのインストールでは、インストールの完了に必要なすべてのシナリオにおいてルータのリロードが必要install commitな場合がありますを参照。

    確認

    XRおよびAdmin VMのコマンドをshow install active再実行します。この例では、アクティブにするパッケージが2つ（各VMに1つ）追加されています。

    RP/0/RSP0/CPU0:ASR-9006#sh install active summary 
Wed Jan 31 04:20:44.061 UTC
Label : 7.5.2

    Active Packages: 17
        asr9k-xr-7.5.2 version=7.5.2 [Boot image]
        asr9k-k9sec-x64-2.2-r752
---------------------- Truncated for Brevity -------------------------
        asr9k-iosxr-ce-64-1.1.0.1-r752.CSCwd75868            <<<<<

RP/0/RSP0/CPU0:ASR-9006#admin show install active summary
Wed Jan 31 04:20:53.609 UTC
     Active Packages: 2
        asr9k-sysadmin-7.5.2 version=7.5.2 [Boot image]
        asr9k-sysadmin-asr9k-7.5.2.8-r752.CSCwf39757           .x86_64 <<<<

RP/0/RSP0/CPU0:ASR-9006#

    トラブルシュート

    インストール操作が失敗している間のログと失敗の理由を確認するのに役立つコマンドがいくつかあります。

    コマンド 目的
    show log インストール操作中の一般的なログを表示します。操作中のルータのイメージの作成に役立ちます。
    インストールログの表示 インストールプロセスのログ情報を表示します。この情報は、インストールに失敗した場合のトラブルシューティングに使用できます。
    インストールパッケージの表示 リポジトリに追加されたパッケージの詳細が表示されます。パッケージの個々のコンポーネントを識別するには、このコマンドを使用します。
    検証パッケージのインストール
    		 保存されているパッケージの内容の整合性を確認する（システムのアップグレード後に使用）
    クリーンなインストール準備 準備操作をクリアし、準備状態からすべてのパッケージを削除します。

    ハードディスクの空き領域が不足しています：

    LC/0/0/CPU0:Jan 26 18:51:03.152 MET: resmon[228]: %HA-HA_WD-3-DISK_ALARM_ALERT : A monitored device /misc/disk1 ( harddisk: ) is over 80% utilization. Current utilization = 80. Please remove unwanted user files and configuration rollback points.

    最も一般的なシナリオは、インストールをコピーして処理するための十分なスペースがルータにない場合です。これは通常、大規模なインストールで発生します。大規模な個別パッケージや複数のパッケージを同時にインストールする場合に発生します。

    回避策：

    harddisk:/dumperの内容を削除しています

    harddisk:/showtechの内容を削除しています

    NCS5500ルート：使用率が80 %を超える。

    LC/0/1/CPU0:Jan 26 18:46:02.245 MET: resmon[218]: %HA-HA_WD-3-DISK_ALARM_ALERT : A monitored device / ( rootfs:/ ) is over 80% utilization. Current utilization = 80. Please remove unwanted user files and configuration rollback points.

    いくつかのSMUがサイズで肥大化し（各RPMのサイズが非常に大きい）、「root-fs」メモリ制限が原因でインストールが失敗します。

    サイズが大きいため、ルータでSMUをアクティブ化できません(NCS5500)

    この問題は、次の場合に発生します。

    • パッケージコンポーネントのファンアウトが大きすぎるため、SMUサイズが100 MBを超えています
    • 依存関係（前提条件）リストに大きなパッケージが多数含まれている

    その結果、「root-fs」制限(500MB)に達したため、SMUのインストールが失敗します。

    回避策：

    次のコマンドを使用して、使用率を確認します。

    show media


    このルータにインストールされている不要な優先パケットを削除します。

    これらのコマンドを使用して、管理プレーンから削除できます。サービスに影響を与えない項目は次のとおりです。

    admin

    無効の無効化のインストール

    install commit

    install remove inactive all（インストール時に非アクティブな全て削除）

    すべての非アクティブなパッケージを削除した後もログが表示され、rootfsで同じ使用率が示される場合は、次のしきい値を設定して、rootfsの使用率が80 %に達したときに多くのアラームが表示されないようにします。

    rootfsを使用してウォッチドッグメモリのしきい値を調整します。これも影響しません。

    config

    watchdog threshold disk minor 90 severe 95 critical 98

    commit

    更新履歴

    改定 発行日 コメント
    1.0
    02-Feb-2024
    初版
    TAC Authored

    シスコ エンジニア提供

    • ホセ・マヌエル・パディーヤ
      テクニカルコンサルティングエンジニア

    このドキュメントは役に立ちましたか?

    Feedbackフィードバック

    シスコに問い合わせ

    このドキュメントは次の製品に対応しています