Junos XML プロトコルを使用した設定の交換
Junos OS Junos が実行されているデバイスと Junos XML プロトコル セッションを行う場合、クライアント アプリケーションは、新しいデータまたは以前の設定またはレスキュー設定にロール バックして、受験者の設定全体またはプライベート コピーを置き換えられます。また、Junos OS リリース 18.1R1、一時的な設定データベース インスタンス内のすべての設定データを新しいデータに置き換える必要があります。
Junos OS一時的な設定データベースのインスタンスにコミットされた設定をロール バックするサポートは行されません。
次のセクションでは、受験者の構成データベースまたはオープン構成データベース内のすべての構成データを置き換える方法について説明します。クライアント アプリケーションは、データを置き換えた後でデバイスのアクティブな設定にした後で設定をコミットする必要があります。個々の構成要素を変更する手順については、「 XML プロトコルを使用した構成要素の作成、変更、削除Junos 参照してください。
受験者の構成を新しいデータに置き換える
受験者の構成データベースまたはオープン設定データベース内のすべての設定データを破棄し、新しい設定データと置き換える場合、クライアント アプリケーションは操作を実行 <load-configuration> し、属性を含 action="override" します。運用を実行する前にクライアント アプリケーションからその操作を実行するために特定の設定データベースを開く場合、サーバーは設定データをオープンな設定データベース <open-configuration> <load-configuration> にロードします。そうしないと、サーバーは設定データを受験者の設定にロードします。
<rpc>
<!-- For a file -->
<load-configuration action="override" url="file" [format="format"]/>
<!-- For a data stream -->
<load-configuration action="override" [format="format"]>
<!-- configuration data -->
</load-configuration>
</rpc>
新しい設定データの属性と構文の詳細については、「 XML プロトコル セッションでのアップロードとフォーマット設定データ 」 url format をJunos参照してください。
次の例は、ファイル /tmp/new.conf の内容が受験者の設定全体に置き換わる方法を指定する方法を示しています。ファイルには XML Junos要素が含まれている(デフォルト)、属性 format は除外されます。
クライアント アプリケーション
<rpc> <load-configuration action="override" url="/tmp/new.conf"/> </rpc>
Junos XML プロトコル サーバー
<rpc-reply xmlns:junos="URL">
<load-configuration-results>
<load-success/>
</load-configuration-results/>
</rpc-reply>
過去にコミットされた設定への受験者の設定のロール バック
実行されているJunos OS、最も最近コミットされた設定のコピーと最大 49 の以前の設定が、プラットフォームに応じて保存されます。保存されている任意の設定にロール バックできます。この機能は、設定の変更によって望ましくない結果が発生し、既知の作業構成に戻したい場合に便利です。設定のロール バックは、デバイスで構成変更を行うプロセスと似ていますが、設定データを読み込む代わりに、ロールバックを実行します。ロールバックを実行すると、受験者の構成全体が過去にコミットした設定に置き換わります。
設定を正常にコミットすると、その設定Junos OS一意の設定変更識別子を割り当てる必要があります。設定はロールバック インデックスにも関連付けされ、直近のコミットされた設定はロールバック インデックス 0 を持っています。コミット済み設定のロールバック インデックスはコミットごとに増加しますが、設定履歴識別子は、同じ設定で静的なままです。以前にコミットされた設定にロール バックする場合、現在のロールバック インデックスまたは設定の履歴識別子によって設定を参照できます。
受験者の設定(またはオープン設定データベース)を以前にコミットした設定に置き換える場合、xml プロトコル クライアントJunos次のいずれかの方法を使用できます。
指定された
<load-configuration/>ロールバック インデックスを使用rollback="index"して、属性を使用して設定にロール バックする操作を実行します。指定された
<load-configuration/>設定の改訂識別子を持つ設定にロール バックする属性configuration-revision="revision-id"を使用して操作を実行します。ロールバック インデックス
<rollback-config>を定義<index>する子要素を使用して RPC を実行します。この RPC は、Junos OS Release 18.1R1 で使用可能で、XML 属性を含む RPC の実行をサポートしていないアプリケーションに役立ちます。
Junos OS一時的な設定データベースのインスタンスにコミットされた設定をロール バックするサポートは行されません。したがって、一時的なデータベースは、 または 属性のいずれかによる RPC または <rollback-config> <load-configuration> 操作 rollback の使用をサポート configuration-revision していません。
この操作を使用して、受験者の設定またはオープン設定データベースを以前にコミットした設定に置き換える場合、クライアント アプリケーションは操作を実行し、 <load-configuration> <load-configuration/> または rollback 属性を含 configuration-revision します。値 rollback は、適切な前の設定の数値ロールバック インデックスです。有効な値は0(直近のコミットされた設定ではゼロ)で、保存されている前の設定数よりも 1 つ減ります(最大は 49)。この値は、ロードする設定の設定履歴識別子 configuration-revision (re0-1605228066-332など)です。
<rpc>
<load-configuration rollback="index">
</rpc>
<rpc>
<load-configuration configuration-revision="revision-id">
</rpc>
XML プロトコル Junosは、RPC 応答内の要素を返してロード操作が正常 <load-configuration-results> <load-success/> に完了したと示します。
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos">
<load-configuration-results>
<load-success/>
</load-configuration-results>
</rpc-reply>
RPC を使用して、以前にコミットされた設定を読み込むには、クライアント アプリケーションが <rollback-config> <rollback-config> RPC を要素とともに実行 <index> します。要素 <index> は、ロードする設定のロールバック インデックスを指定します。
<rpc>
<rollback-config>
<index>1</index>
</rollback-config>
</rpc>
XML プロトコル Junosは、RPC 応答内の要素を返してロード操作が正常 <rollback-config-results> <load-success/> に完了したと示します。
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos">
<rollback-config-results>
<load-success/>
</rollback-config-results>
</rpc-reply>
ロード操作が正常に完了した場合、クライアント アプリケーションは設定をコミットして、デバイスでアクティブな設定にする必要があります。サーバーは、ロールバック設定のロード中にエラーが発生した場合、エラーに関する情報を持つ <xnm:error> 要素を返します。
受験者の設定をレスキュー設定に置き換える
レスキュー設定を使用すると、既知のワーキング設定や、既知の状態を使用した設定を定義して、いつでも復元できます。レスキュー設定は、デバイス設定とバックアップ設定ファイルが修復の範囲を越えて損傷した場合に、既知の設定に戻す必要がある場合、または最後のリゾートとして行う必要がある場合に使用します。レスキュー設定を作成すると、デバイスは直近でコミットされた設定をレスキュー設定として保存します。
受験者の設定やオープン設定データベースをデバイスのレスキュー設定に置き換える場合、Junos XML プロトコル アプリケーションは以下のいずれかの方法を使用できます。レスキュー設定をロードする前に、デバイスにレスキュー設定を設定する必要があります。
属性を
<load-configuration/>使用して操作をrescue="rescue"実行します。子要素
<rollback-config>を使用して RPC<rescue/>を実行します。この RPC は、Junos OS Release 18.1R1 で使用可能で、XML 属性を含む RPC の実行をサポートしていないアプリケーションに役立ちます。
この操作を <load-configuration/> 使用して、受験者の設定をレスキュー設定に置き換える場合は、属性 rescue="rescue" をタグに含 <load-configuration/> める必要があります。
<rpc>
<load-configuration rescue="rescue"/>
</rpc>
XML プロトコル Junosは、RPC 応答内の要素を返してロード操作が正常 <load-configuration-results> <load-success/> に完了したと示します。
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos">
<load-configuration-results>
<load-success/>
</load-configuration-results>
</rpc-reply>
RPC を <rollback-config> 使用してレスキュー設定をロードするには、クライアント アプリケーションが要素と子 <rollback-config> タグを <rescue/> 送信します。
<rpc>
<rollback-config>
<rescue/>
</rollback-config>
</rpc>
XML プロトコル Junosは、RPC 応答内の要素を返してロード操作が正常 <rollback-config-results> <load-success/> に完了したと示します。
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos">
<rollback-config-results>
<load-success/>
</rollback-config-results>
</rpc-reply>
ロード操作が正常に完了した場合、クライアント アプリケーションは設定をコミットして、デバイスでアクティブな設定にする必要があります。レスキュー設定が存在しない場合、または設定データのロード中にサーバーが別のエラーを検出した場合、エラーに関する情報を持つ要素 <xnm:error> を返します。