Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

request system software add (Junos OS)

構文

構文(EXシリーズスイッチ)

構文(TXマトリクス ルーター)

構文(TXマトリクス プラス ルーター)

構文(MXシリーズルーター)

構文(QFXシリーズ)

構文(OCXシリーズ)

説明

デバイスにソフトウェア パッケージまたはバンドルをインストールします。

ソフトウェアイメージは常に /var/tmp にのみダウンロードすることをお勧めします。EX シリーズおよび QFX シリーズ スイッチでは、 /var/tmp ディレクトリを使用する必要があります。その他のディレクトリーはサポートされていません。

Junos OS の別のリリースにアップグレードする場合、通常、このコマンドの オプションを validate 使用します。オプションは validate 、候補ソフトウェアをデバイスの現在の設定と照合して、互換性を確認します。(追加するソフトウェア パッケージが別のリリースの場合、Validate はデフォルトの動作です)。ただし、この方法では実行中の設定を検証できない状況があります。そのような状況の 1 つは、FreeBSD 6.1 に基づいて Junos OS からアップグレードされた FreeBSD を Junos OS にアップグレードする場合です。もう 1 つの状況は、アップグレードされた FreeBSD を使用して Junos OS の異なるリリース間で更新する場合であり、最新バージョンの FreeBSD は以前のバージョンの FreeBSD では利用できないシステム コールを使用します。

そのため、Junos リリース 21.2R1 にアップグレードする場合、このオプションは使用 validate できません。このリリースは FreeBSD 12 で実行され、アップグレードされた FreeBSD の以前のリリースでは FreeBSD 10 または 11 が実行されるためです。

直接検証を使用できないリリース間でアップグレードする場合は、アップグレード時に動作モードコマンドで request system software add 以下のいずれかを指定する必要があります。

  • no-validateオプション — このオプションは、現在の設定に対してソフトウェア パッケージを検証しません。したがって、システムをアップグレードすると、現在の設定が失敗することがあります。システムを新しいバージョンに初めてアップグレードする場合は、このオプションを選択します。

  • オプション—このオプションは validate-on-host 、リモートのJunos OSホストで実行されている設定と比較することで、ソフトウェアパッケージを検証します。新しいバージョンのソフトウェアにアップグレード済みのホストを選択してください。

  • オプション—(冗長REを持つシステムの場合)このオプションは validate-on-routing-engine 、同じシャーシ内のルーティングエンジンで実行中の設定と比較することで、ソフトウェアパッケージを検証します。他のルーティング エンジンを新しいバージョンにアップグレード済みの場合は、このオプションを使用します。

有効なファイル名とURLの形式については、 Junos OS CLIコマンドでファイル名とURLを指定するためのフォーマットを参照してください。

システムがJunos OSのアップグレードバージョンで再起動すると、コマンド入力 request system software add 後に実行された設定変更はすべて失われます。

Junos OS リリース 17.2R1 以降、PTX10008 ルーターは コマンドを request system software add サポートしていません。Junos OS リリース 17.4R1 以降、PTX10016 ルーターは コマンドを request system software add サポートしていません。 request vmhost software add PTX10008およびPTX10016ルーターの コマンドの request system software add 代わりに コマンドを使用して、ルーターにJunos OSソフトウェアパッケージまたはバンドルをインストールまたはアップグレードします。 リクエストvmhostソフトウェアの追加を参照してください。

デバイス上でグレースフル ルーティング エンジン スイッチオーバー(GRES)が有効になっている場合、ISSU(統合型インサービス ソフトウェア アップグレード)操作を実行して、デバイス上で実行されているソフトウェアを更新する必要があります。GRES を有効にすると、 コマンドを入力してソフトウェア アップグレードを request system software add package-name 実行しようとすると、GRES が設定されている場合、インサービス ソフトウェア アップグレードのみがサポートされていることを示すエラー メッセージが表示されます。この場合、アップグレードを試みる前に GRES 構成を削除するか、統合型 ISSU を実行する必要があります。

Junos OSリリース15.1F3以降、 ステートメント request system software add は、RE-DUO-C2600-16Gを搭載したPTX5000ルーターと、RE-S-1800X4-32G-Sを搭載したMX240、MX480、MX960ルーターに対してのみ、ゲストOSのソフトウェアパッケージをインストールします。

Junos OS リリース 15.1F5 以降、 ステートメント request system software add は、REMX2K-1800-32G-S を搭載した MX2010 および MX2020 ルーターに対してのみ、ゲスト OS のソフトウェア パッケージをインストールします。

これらのルーターでは、Junos ソフトウェアとホスト ソフトウェア パッケージの両方をインストールするには、 コマンドを request vmhost software add 使用します。

オプション

package-name

ソフトウェア パッケージまたはバンドルがインストールされる場所。

Junos OS では、 package-name リモートロケーションの URL またはローカル パッケージのパス名を指定できます。ただし、Junos OS Evolvedはアップグレード用のリモートisoをサポートしていないため、CLIのヘルプ文字列から「URL」が削除されます。

例えば:

  • /var/tmp/package-name—ルーターまたはスイッチ上のローカル ディレクトリからインストールされているソフトウェア パッケージまたはバンドル。

  • protocol://hostname/pathnamepackage-name— 遠隔地からダウンロードしてインストールするソフトウェア パッケージまたはバンドル。次のいずれかに置き換えますprotocol

    • ftp — ファイル転送プロトコル。ftp://hostname//pathnamepackage-name を使用します。認証資格情報を指定するには、ftp://<username>:<password>@hostname//pathname を使用しますpackage-name。システム プロンプトでパスワードを入力するには、パスワードの代わりに を指定promptします。パスワードが必要で、パスワードまたは promptを指定しない場合は、エラー・メッセージが表示されます。

    • http—ハイパーテキスト転送プロトコル。http://hostname//pathnamepackage-name を使用します。認証資格情報を指定するには、http://<username>:<password>@hostname//pathname を使用しますpackage-name。パスワードが必要で、省略した場合は、パスワードの入力を求められます。

    • scp -セキュアコピー(限定されたエディションでは利用できません)。scp://hostname//pathnamepackage-nameを使用します。認証資格情報を指定するには、scp://<username>:<password>@hostname//pathname を使用しますpackage-name

  • pathnameプロトコル内のは、ルートディレクトリではなく、リモートシステム上のユーザーのホームディレクトリへの相対パスです。

  • コマンドでrequest system software addscpプロトコルを使用して、リモートからソフトウェアパッケージやバンドルをダウンロードしてインストールしないでください。前述のステートメントは、QFabric スイッチには適用されません。ソフトウェアアップグレードは、scpをサポートしない管理プロセス(mgd)によって処理されます。コマンドをfile copy使用して、ソフトウェアパッケージまたはバンドルを遠隔地からハードディスクの/var/tmpディレクトリにコピーします:ファイルコピー scp://source/package-name /var/tmpコマンドを使用してソフトウェアパッケージまたはバンドルをrequest system software addインストールします。command:requestシステムソフトウェア追加/var/tmp/package-name

best-effort-load

(オプション)部分読み込みを有効にし、解析エラーをエラーではなく警告として扱います。

component all

(QFabric システムのみ)(オプション)すべての QFabric コンポーネントにソフトウェア パッケージをインストールします。

delay-restart

(オプション)ソフトウェア パッケージまたはバンドルをインストールしますが、ソフトウェア プロセスは再起動しません。

device-alias alias-name

(Junos Fusion のみ)(オプション)サテライト デバイスのエイリアス名を使用して、指定されたサテライト デバイスにサテライト ソフトウェア パッケージをインストールします。

force

(オプション)ソフトウェア パッケージまたはバンドルの追加を強制する(警告を無視)。

force-host

(オプション)QFX5100 デバイスでのホスト ソフトウェア パッケージまたはバンドルの強制的な追加(警告を無視)。

lcc number

(TX Matrix ルーターと TX Matrix Plus ルーターのみ)(オプション)TX Matrix ルーターに基づくルーティング マトリクスでは、TX Matrix ルーターに接続された T640 ルーターにソフトウェア パッケージまたはバンドルをインストールします。TX Matrix Plus ルーターに基づくルーティング マトリクスで、TX Matrix Plus ルーターに接続されたルーターにソフトウェア パッケージまたはバンドルをインストールします。

LCC設定に応じて、以下の値に置き換えます number

  • 0~3(T640 ルーターがルーティング マトリクス内の TX Matrix ルーターに接続されている場合)。

  • 0~3(T1600 ルーターがルーティング マトリクス内の TX Matrix Plus ルーターに接続されている場合)。

  • 0~7(T1600 ルーターがルーティング マトリクス内に 3D SIB を持つ TX Matrix Plus ルーターに接続された場合)。

  • 0、2、4、または 6(T4000 ルーターがルーティング マトリクス内に 3D SIB を持つ TX Matrix Plus ルーターに接続された場合)。

member member-id

(MXシリーズルーターのみ)(オプション)指定されたバーチャル シャーシ メンバーにソフトウェア パッケージをインストールします。0 または 1 の値に置き換えます member-id

partition

(QFX3500スイッチのみ)(オプション)インストール前にメディアのフォーマットと再パーティションを行います。

satellite slot-id

(Junos Fusion のみ)(オプション)サテライトデバイスFPCスロット識別子を使用して、指定されたサテライトデバイスにサテライトソフトウェアパッケージをインストールします。

scc

(TX マトリクス ルーターのみ)(オプション)ソフトウェア パッケージまたはバンドルを TX Matrix ルーター(またはスイッチカード シャーシ)のルーティング エンジンにインストールします。

sfc number

(TX マトリクス プラス ルーターのみ)(オプション)TX Matrix Plus ルーター上のルーティング エンジンにソフトウェア パッケージまたはバンドルをインストールします。0 に置き換えます number

no-copy

(オプション)ソフトウェア パッケージまたはバンドルをインストールしますが、パッケージ ファイルやバンドル ファイルのコピーは保存しません。

no-validate

(オプション)ソフトウェア パッケージまたは異なるリリースのバンドルを読み込む場合は、 オプションのデフォルト動作を validate 抑制します。

Junos OS リリース 21.2R1 にアップグレードするには、 オプションを validate 使用できません。代わりに、次のいずれかのオプションを選択します。

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

識別されていないプロバイダからのソフトウェア パッケージは読み込むことができません。プロバイダを許可するには、 階層レベルで provider-id ステートメントを [edit system extensions provider] 含めます。

re0 | re1

(オプション)デュアルまたは冗長ルーティングエンジンをサポートするルーターまたはスイッチでは、ソフトウェアパッケージをロードするか、スロット0(re0)のルーティングエンジンまたはスロット1(re1)のルーティングエンジンにバンドルします。

reboot

(オプション)ソフトウェア パッケージまたはバンドルを追加した後、システムを再起動します。QFabric スイッチでは、ソフトウェアをインストールしたコンポーネントを再起動するまで、ソフトウェアのインストールは完了しません。

set [package-name1package-name2]

(EX4200 と EX4500 の混合バーチャル シャーシ、M シリーズ、MX シリーズ、T シリーズ ルーターのみ)(オプション)複数のパッケージを同時にインストールします。

  • EX4200とEX4500のバーチャルシャーシが混在する場合、2つのソフトウェアパッケージ(EX4200スイッチ用パッケージとEX4500スイッチ用パッケージ)をインストールし、混合EX4200とEX4500バーチャルシャーシ内のすべてのメンバースイッチをアップグレードします。

  • M Series、MXシリーズ、およびT Seriesルーターの場合、複数の(2つ以上の)ソフトウェアパッケージとソフトウェアアドオンパッケージを同時にインストールします。この変数 package-name は、インストール・パッケージのリスト、それぞれ空白スペースで区切るか、インストール・パッケージのリストを含むディレクトリーまたは tar ファイルへの完全な URL を指定できます。

いずれの場合も、 installation-package インストール パッケージのリスト、空白スペースで区切るか、インストール パッケージのリストを含むディレクトリまたは tar ファイルへの完全な URL を指定できます。

コマンドを request system software add set 使用して、コア Junos OS インストール パッケージと共に SDK アドオン パッケージをインストールすることで、SDK 設定を保持します。

unlink

(オプション)M Series、T Series、およびMXシリーズルーターでは、アップグレードが正常に完了した後、 unlinkオプションを使用して、このディレクトリからソフトウェアパッケージを削除します。

upgrade-group [ all |upgrade-group-name]

(Junos Fusion のみ)(自動変換または手動変換を使用して Junos Fusion を設定する場合に必要)サテライト ソフトウェア イメージをサテライト ソフトウェア アップグレード グループに関連付けます。すべてのキーワードが指定されている場合、サテライト ソフトウェア パッケージは、 、または Junos Fusion 内のすべてのサテライト ソフトウェア アップグレード グループを使用して upgrade-group-name、指定されたサテライト ソフトウェア アップグレード グループに関連付けられます。

サテライト ソフトウェア アップグレード グループとは、Junos Fusion 内のサテライト デバイスのグループで、同じサテライト ソフトウェア パッケージを使用して同じサテライト ソフトウェア バージョンにアップグレードすることが指定されています。見る Junos Fusion プロバイダ エッジのソフトウェアについてJunos Fusion Enterprise のソフトウェアについてをクリックし 、Junos Fusion のサテライト ソフトウェア アップグレード グループの管理を行います。

upgrade-with-config

(オプション)1 つ以上の設定ファイルをインストールします。

このオプションで指定された構成ファイルは、拡張子 が .text または .xml で、拡張子が指定されている必要があります。拡張子 .txt を 使用すると機能しません。

validate

(オプション)ソフトウェア パッケージまたはバンドルを追加する前提条件として、現在の設定に対してソフトウェア パッケージまたはバンドルを検証します。これは、追加されるソフトウェア パッケージまたはバンドルが別のリリースである場合のデフォルトの動作です。

Junos OS リリース 21.2R1 にアップグレードするには、 オプションを validate 使用できません。代わりに、次のいずれかのオプションを選択します。

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

オプションはvalidateGRES()が有効になっていないgraceful-switchoverシステムでのみ機能します。GRES があるシステムで オプションをvalidate使用するには、インストール期間中 GRES を無効にするか、 コマンドを使用してインストールします。この コマンド request system software in-service-upgrade を使用するには、GRES を使用する際にノンストップ アクティブ ルーティング(NSR)を有効にする必要があります。

validate-on-host hostname

(オプション)リモート Junos OS ホストで実行中の設定と比較して、ソフトウェア パッケージを検証します。ホストを指定し、リモートホスト名に置き換えます hostname 。オプションで、 形式 user@hostnameでホスト名を指定することで、リモートホストへのログインに使用するユーザー名を指定できます。

validate-on-routing-engine routing-engine

(オプション)同じシャーシ上の Junos OS ルーティング エンジンで実行中の設定と比較して、ソフトウェア バンドルまたはパッケージを検証します。ルーティングエンジンを指定し、ルーティングエンジン名に置き換えます routing-engine

その他の情報

ルーターまたはスイッチ上のソフトウェアをアップグレードする前に、既知の安定したシステムがある場合、 コマンドを request system snapshot 発行して、設定を含むソフトウェアを /altroot および /altconfig ファイルシステムにバックアップします。ルーターまたはスイッチ上でソフトウェアをアップグレードし、新しいパッケージまたはバンドルが正常にインストールおよび実行されていることを確認した後、 request system snapshot コマンドを発行して、新しいソフトウェアを /altroot および /altconfig ファイル システムにバックアップします。

コマンド request system snapshot は現在、QFabric システムではサポートされていません。また、QFabric システムに複数のパッケージを追加またはインストールすることもできません。

コマンドを request system snapshot 実行した後は、実行中のソフトウェアとバックアップのコピーが同一であるため、以前のバージョンに戻すことはできません。

複数のパッケージを同時にアップグレードする場合は、オペレーティング システム パッケージ jkernel(最後)を削除します。オペレーティング システム パッケージ jkernel、first、ルーティング ソフトウェア パッケージ、jroute、last を追加します。すべてのパッケージを一度にアップグレードする場合は、以下の順序で削除して追加してください。

デフォルトでは、TX Matrix プライマリ ルーティング エンジンで コマンドを発行 request system software add package-name すると、それに接続されたすべての T640 プライマリ ルーティング エンジンが同じバージョンのソフトウェアにアップグレードされます。TX Matrix バックアップ ルーティング エンジンで同じコマンドを発行した場合、接続されているすべての T640 バックアップ ルーティング エンジンが同じバージョンのソフトウェアにアップグレードされます。

同様に、TX Matrix Plus プライマリ ルーティング エンジンで コマンドを発行 request system software add package-name すると、それに接続されているすべての T1600 または T4000 プライマリ ルーティング エンジンが同じバージョンのソフトウェアにアップグレードされます。TX Matrix Plus バックアップ ルーティング エンジンで同じコマンドを発行した場合、それに接続されているすべての T1600 または T4000 バックアップ ルーティング エンジンが同じバージョンのソフトウェアにアップグレードされます。

1つ以上のカスタムYANGデータモデルが追加されたデバイスにソフトウェアをインストールする前に、アクティブな設定からカスタムYANGデータモデルに対応する設定データをバックアップして削除します。詳細については、 ソフトウェアのアップグレードまたはダウングレード中のYANGパッケージと設定の管理を参照してください。

必要な権限レベル

メンテナンス

出力フィールド

このコマンドを入力すると、リクエストのステータスに関するフィードバックが提供されます。

サンプル出力

リクエストシステムソフトウェア追加検証

リクエストシステムソフトウェア追加/var/tmp/no-validate

要求システム ソフトウェア追加ノーコピー no-validate リブート

リクエストシステムソフトウェア追加 validate-on-host

リクエスト システム ソフトウェア 追加(EX4200 と EX4500 バーチャル シャーシが混在)

リクエストシステムソフトウェア追加コンポーネントすべて(QFabricシステム)

リクエスト システム ソフトウェア add upgrade-group(Junos Fusion)

リクエスト システム ソフトウェア add no-validate(SRX シリーズ デバイス)

リクエストシステムソフトウェア追加(SRXシリーズデバイス)

リリース情報

Junos OS リリース 7.4 より前に導入されたコマンド。

best-effort-load および unlink Junos OS リリース 7.4 で追加されたオプション。

sfc TX Matrix Plus ルーターの Junos OS リリース 9.6 で導入されたオプション。

set [package-name1package-name2] EX シリーズ スイッチの Junos OS リリース 11.1 で追加されたオプション。M Series、MXシリーズ、およびT Seriesルーター向けJunos OSリリース12.2で追加されています。

EX シリーズ スイッチでは、 オプションにより set [package-name1package-name2] 、混合 EX4200 および EX4500 バーチャル シャーシに 2 つのソフトウェア パッケージのみをインストールできます。一方、M Series、MXシリーズ、およびT Seriesルーターでは、 オプションを使用すると、 set [package-name1package-name2package-name3] 複数のソフトウェアパッケージとソフトウェアアドオンパッケージを同時にインストールできます。

upgrade-with-config および upgrade-with-config-format format 、Mシリーズルーター、MXシリーズルーター、Tシリーズルーター、EXシリーズイーサネットスイッチ、QFXシリーズデバイスのJunos OSリリース12.3で追加されたオプション。

device-aliassatelliteupgrade-group、および version Junos Fusion の Junos OS リリース 14.2R3 で導入されたオプション。

validate-on-host と、PTX5000ルーターおよび validate-on-routing-engine MX240、MX480、MX960ルーターのJunos OSリリース15.1F3で追加されたオプション。

upgrade-with-config-format format M シリーズ ルーター、MX シリーズ ルーター、T シリーズ ルーター、EX シリーズ イーサネット スイッチ、QFX シリーズ デバイスの Junos OS リリース 16.1 で削除されたオプション。