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 Matrix Plusルーター)

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

構文(QFXシリーズ)

構文(OCXシリーズ)

形容

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

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

MXシリーズルーターのJunos OS リリース23.4R1以降、階層レベルでステート メントを [edit system] 設定 dual-phase-bootup できるようになりました。この機能は、デバイスのアップグレードまたはダウングレード中に、2段階の再起動プロセスを有効にします。 dual-phase-bootup ステートメントがすでに設定され、コミットされている場合、デバイスはアップグレードまたはダウングレード中に rescue.conf ファイルを取得します。その後、 rescue.conf ファイルと juniper.conf ファイルの両方に対してイメージが検証されます。内部コミットは再起動後に実行され、最後に実行された最新のユーザー設定がコミットされます。この設定がコミットされている間は、設定を変更することはできません。

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

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

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

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

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

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

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

request system software add コマンドを入力した後に実行された設定変更は、アップグレードされたバージョンの Junos OS でシステムを再起動した後も残ります。

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

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

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

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

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

オプション

package-name

ソフトウェア パッケージまたはバンドルのインストール元の場所。

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

例えば:

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

  • protocol://hostname/pathname/package-name:遠隔地からダウンロードおよびインストールするソフトウェア パッケージまたはバンドル。以下のいずれか protocol 置き換えます。

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

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

    • scp:セキュアコピー(限定版では使用できません)。scp://hostname/pathname/package-nameを使用してください。認証資格情報を指定するには、scp://<username>:<password>@hostname/pathname/package-nameを使用します。

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

  • request system software add コマンドで scp プロトコルを使用して、リモートの場所からソフトウェア パッケージまたはバンドルをダウンロードしてインストールしないでください。前述のステートメントは、QFabric スイッチには適用されません。ソフトウェアのアップグレードは、scp.をサポートしない管理プロセス(mgd)によって処理されますfile copyコマンドを使用して、リモートの場所からハードディスクの/var/tmpディレクトリにソフトウェアパッケージまたはバンドルをコピーします:file copy scp://source/package-name /var/tmp次に、request system software addコマンドを使用してソフトウェアパッケージまたはバンドルをインストールします:request system software add /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 マトリクス ルーターに接続されている場合)。

  • 0 から 3 は、T1600 ルーターがルーティング マトリクスで TX マトリクス プラス ルーターに接続されている場合です。

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

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

member member-id

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

partition

(QFX3500スイッチのみ)(オプション)インストールの前に、メディアのフォーマットと再パーティション化を行ってください。

satellite slot-id

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

scc

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

sfc number

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

no-copy

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

no-validate

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

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

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

身元不明のプロバイダからのソフトウェア パッケージを読み込むことはできません。プロバイダーを承認するには、[edit system extensions provider]階層レベルでprovider-idステートメントを含めます。

re0 | re1

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

reboot

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

set [package-name1package-name2]

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

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

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

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

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

unlink

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

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

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

サテライト ソフトウェア アップグレード グループとは、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

validate オプションは、graceful-switchover (GRES) が有効になっていないシステムでのみ機能します。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 システムではサポートされていません。また、1 つの QFabric システムに複数のパッケージを追加またはインストールすることもできません。

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

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

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

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

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

必要な権限レベル

メンテナンス

出力フィールド

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

サンプル出力

request system software add validate

request system software add /var/tmp/ no-validate

request system software add no-copy no-validate reboot

request system software add validate-on-host

request system software add(EX4200とEX4500の混在バーチャルシャーシ)

request system software add component all(QFabricシステム)

request system software add upgrade-group(Junos Fusion)

request system software add no-validate(SRXシリーズファイアウォール)

request system software add(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 Junos OS リリース 12.3 で追加された および upgrade-with-config-format format オプションは、M Series ルーター、MXシリーズ ルーター、T Series ルーター、EXシリーズ イーサネット スイッチ、QFXシリーズ デバイスに対応します。

device-aliassatelliteupgrade-groupversion Junos OS リリース 14.2R3 で導入された Junos Fusion オプション。

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

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