Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
このページで
 

<load-configuration>

使用

説明

NETCONF または Junos XML プロトコル サーバーの構成データを候補の構成データベースまたはオープン構成データベースに読み込んでもらう必要があります。

クライアント アプリケーションが Junos XML プロトコル <open-configuration> 操作を発行して、操作を実行する前に特定の構成データベースを <load-configuration> 開くと、サーバーは構成データをオープンな構成データベースに読み込みます。それ以外の場合、サーバーはコンフィギュレーション・データを候補コンフィギュレーションに読み込みます。

次のいずれかの方法で読み込むデータを提供します。

  • <load-configuration/> のタグの configuration-revision 属性を、以前にコミットされた設定の設定リビジョン識別子に設定します。指定された設定は、候補コンフィギュレーションを完全に置き換えます。

  • <load-configuration/> のタグの rescue 属性を 値 rescueに設定します。レスキュー設定は、候補コンフィギュレーションを完全に置き換えます。

  • <load-configuration/> のタグの rollback 属性を、以前にコミットした設定のロールバックインデックスに設定します。デバイスは、直近にコミットされた設定と、最大 49 個の過去の設定のコピーを保存します。指定された設定は、候補コンフィギュレーションを完全に置き換えます。

  • <load-configuration/>のタグのurl属性を、読み込む設定データを含むファイルのパス名に設定します。属性を format 、 、textまたは xmljson設定すると、対応する形式の JavaScript Object Notation(JSON)、書式設定された ASCII テキスト、または Junos XML タグ要素(デフォルト)で設定が読み込まれます。設定モードコマンドとして設定データを提供するには、 属性をaction="set"含め、属性をformat省略するか、 に値textを設定します。

    次の例では、 属性はurl、設定データを/tmp/add.confファイルから読み込む必要があることを識別します。

  • 設定データを、開始<load-configuration>タグと終了タグ内でデータストリームとして囲</load-configuration>みます。設定データをフォーマットされたASCIIテキストとして提供する場合は、データをタグ要素で<configuration-text>囲み、 に属性textformat設定します。設定データを Junos XML タグ要素として提供する場合は、データを<configuration>タグ要素で囲み、属性をformat省略するか、 に値xmlを設定します。設定データを設定モードコマンドとして提供する場合は、データをタグ要素で<configuration-set>囲み、属性を actionset設定し、属性をformat省略するか、 を にtext設定します。設定データを JSON で提供する場合は、そのデータを<configuration-json>タグ要素で囲み、属性を formatjson設定します。

属性

action

特に、ターゲットの設定データベースと読み込まれた設定に矛盾するステートメントが含まれている場合に、設定データを読み込む方法を指定します。

一時的な設定データベースは、指定されたリリースでサポートされているデバイスで以下 action の属性値をサポートします。

  • merge および set—Junos OS リリース 16.2R2 以降でサポートされています。

  • override および replace—Junos OS リリース 18.1R1 以降でサポート

  • updateJunos OSリリース21.1R1以降でサポートされています

許容される値は次の通りです。

  • merge—読み込まれたコンフィギュレーションのデータとターゲットコンフィギュレーションのデータを組み合わせます。ロードされたコンフィギュレーションのステートメントがターゲット・コンフィギュレーションのステートメントと競合する場合、ロードされたステートメントはターゲット・コンフィギュレーションのステートメントを置き換えます。これは、属性が省略された場合のデフォルトの action 動作です。

  • override-候補となるコンフィギュレーション全体を破棄し、読み込まれたコンフィギュレーションに置き換えます。設定が後でコミットされると、すべてのシステム プロセスが新しい設定を解析します。

  • replace読み込まれたコンフィギュレーションで定義された各階層レベルまたは設定オブジェクトを、候補コンフィギュレーションの対応するレベルまたはオブジェクトに置き換えます。

    設定データをフォーマットされたASCIIテキストとして提供する場合(属性で url 名前が付けられたファイル、またはタグ要素で <configuration-text> 囲まれているファイル)、置き換える階層レベルまたはオブジェクトを表すステートメントの直前にステートメントを行に配置 replace: します。詳細については、 CLIユーザーガイドの設定データのファイルの読み込みの説明を参照してください。

    構成データを Junos XML タグ要素として提供する場合は、置き換える階層レベルまたはオブジェクトを表す要素の開始タグに 属性を含 replace="replace" めます。

  • set— Junos OS 設定モード コマンドとしてフォーマットされた設定データを読み込みます。このオプションは、 属性で指定urlされたファイルに格納されるか、タグ要素で囲まれたファイルに格納されるため、設定命令を<configuration-set>1行ずつ実行します。インストラクションには、 、 deleteedit、 、または deactivateなどのset任意の設定モード コマンドを含めることができます。一連のコマンドとして設定データを提供する場合、属性に許容できる値formatは「テキスト」のみです。属性値がaction「設定」で、属性がformat省略された場合、属性はformat自動的に ではなくxml「テキスト」になります。

  • update-読み込まれたコンフィギュレーションを候補コンフィギュレーションと比較します。2 つの設定で異なる階層レベルまたは設定オブジェクトごとに、読み込まれた設定のバージョンが候補コンフィギュレーションのバージョンに置き換えられます。後で設定がコミットされると、変更された構成要素の影響を受けるシステム プロセスのみが新しい設定を解析します。

configuration-revision

設定リビジョン識別子を参照して、以前にコミットされた設定を読み込みます。指定された設定は、候補コンフィギュレーションを完全に置き換えます。

format

設定データに使用する形式を指定します。許容される値は次のとおりです。

  • json設定データが JSON(JavaScript Object Notation)を使用してフォーマットされていることを示します。

  • text—設定データが ASCII テキストまたは設定モード コマンドのセットとしてフォーマットされていることを示します。

    ASCIIテキスト形式では、改行文字、タブ、その他の空白、中括弧、大括弧を使用して、ステートメント間の階層関係を示します。これは、ルーティング プラットフォームに格納されている設定ファイルで使用される形式で、CLI show configuration コマンドで表示される形式です。コマンド形式は set 、一連のJunos OS設定モードコマンドで構成されており、CLIコマンドで show configuration | display set 表示されます。一連の設定モードコマンドを読み込むには、属性を action 「set」に設定する必要があります。

  • xml— 構成データが Junos XML タグ要素を使用してフォーマットされていることを示します。属性を format 省略した場合、「xml」は"set"を除く属性のすべての値の action デフォルト形式で、デフォルトの形式は「テキスト」になります。

rescue

レスキュー設定が現在の候補コンフィギュレーションを置き換えることを指定します。有効な値は「レスキュー」のみです。

メモ:

Junos OS リリース 18.1R1 以降では、RPC を使用 <rollback-config> して以前にコミットされた設定を読み込めることもできます。これは、XML 属性を含む RPC の実行をサポートしていないアプリケーションに役立ちます。

rollback

数値ロールバック インデックスを参照して、以前にコミットされた設定を読み込みます。有効な値は、0(直近にコミットされたコンフィギュレーションではゼロ)から、保存された以前のコンフィギュレーションの数より1少ない値(最大49)。です。

メモ:

Junos OS リリース 18.1R1 以降では、RPC を使用 <rollback-config> して以前にコミットされた設定を読み込めることもできます。これは、XML 属性を含む RPC の実行をサポートしていないアプリケーションに役立ちます。

url

読み込む設定データを含むファイルのフルパス名を指定します。値には、ローカル ファイル パス、FTP の場所、またはハイパーテキスト転送プロトコル(HTTP)URL を指定できます。

  • ローカルファイル名には、次のいずれかの形式を使用できます。

    • /path/filename— マウントされたファイル システム上のファイル(ローカル フラッシュ ディスクまたはハード ディスク上)。

    • A:filename または a:path/filename—ローカル ドライブ上のファイル。デフォルトのパスは / (ルートレベルディレクトリ) です。リムーバブル メディアは、MS-DOS または UNIX(UFS)形式で指定できます。

  • FTP サーバー上のファイル名の形式は次のとおりです。

  • HTTPサーバー上のファイル名の形式は次のとおりです。

いずれの場合も、変数の既定値pathはユーザー名のホーム ディレクトリです。絶対パスを指定するために、アプリケーションはパスを文字 %2F で開始します。例えば、ftp://username:password@hostname/%2Fpath/filename

リリース情報

これは、Junos XML 管理プロトコルの操作です。Junos XML プロトコル セッションでサポートされ、機能交換で http://xml.juniper.net/netconf/junos/1.0 URI を識別する Junos OS を実行するデバイス上の NETCONF セッションで、ジュニパーネットワークス独自の拡張機能としてサポートされています。

action Junos OS リリース 11.4 で追加された属性値 set

format Junos OS リリース 16.1 で追加された属性値 json

configuration-revision Junos OSリリース20.4R1およびリリース20.4R1 Junos OS Evolved追加された属性。