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

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

Junos リリース 21.2R1 へのアップグレード時には、このリリースは FreeBSD 12 で動作し、アップグレードされた FreeBSD を含む以前のリリースでは FreeBSD 10 または 11 が動作するため、 validate オプションを使用できません。

直接検証を使用できないリリース間でアップグレードする場合は、アップグレード時の operational mode コマンドで 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 Release 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/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 、ルートディレクトリではなく、リモートシステム上のユーザーのホームディレクトリへの相対パスです。

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

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マトリクス ルーター(またはスイッチカード シャーシ)のルーティング エンジンにソフトウェア パッケージまたはバンドルをインストールします。

sfc number

(TX Matrix Plusルーターのみ)(オプション)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 Series、MXシリーズ、T Seriesルーターのみ)(オプション)複数のパッケージを同時にインストールします。

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

  • M Series、MXシリーズ、Tシリーズ ルーターの場合、複数(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 を設定するために必要)サテライトソフトウェアイメージをサテライトソフトウェアアップグレードグループに関連付けます。サテライト ソフトウェア パッケージは、 を使用して、または all キーワードが指定されている場合、Junos Fusion 内のすべてのサテライト ソフトウェア アップグレード グループに対して、指定されたサテライト ソフトウェア アップグレード グループに upgrade-group-name関連付けられます。

サテライトソフトウェアアップグレードグループは、同じサテライトソフトウェアパッケージを使用して同じサテライトソフトウェアバージョンにアップグレードするように指定された、Junos Fusion内のサテライトデバイスのグループです。見る Junos Fusion プロバイダ エッジのソフトウェアについてJunos Fusion エンタープライズのソフトウェアについておよび 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、(GRES)が有効になっていない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 を最初に追加し、ルーティングソフトウェアパッケージ jroute を最後に追加します。すべてのパッケージを一度にアップグレードする場合は、次の順序で削除して追加します。

デフォルトでは、TXマトリクス プライマリ ルーティング エンジンで コマンドを発行 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-validation

システムソフトウェアにコピーなしの追加検証なしの再起動を要求する

システムソフトウェアにホストで検証を追加するリクエスト

システムソフトウェアの追加依頼(EX4200とEX4500の混在バーチャルシャーシ)

システムソフトウェアの追加をリクエストする すべて(QFabricシステム)

システムソフトウェア追加アップグレードグループのリクエスト(Junos Fusion)

システムソフトウェアの追加をリクエストしない(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-configupgrade-with-config-format format M シリーズ ルーター、MX シリーズ ルーター、T シリーズ ルーター、EX シリーズ イーサネット スイッチ、QFX シリーズ デバイス向けに Junos OS リリース 12.3 で追加された オプション。

device-alias、 、 、satelliteupgrade-groupversionおよび オプションは、Junos Fusion の Junos OS リリース 14.2R3 で導入されました。

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

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