Junos XML プロトコルの使用を確認した後にのみ、受験者の設定をコミットする
Junos OS を実行するデバイスで候補の設定をコミットすると、ルーティング、スイッチング、またはセキュリティ プラットフォーム上のアクティブな設定になります。コミット操作の詳細については、操作のさまざまなバリエーション間のやり取りの議論を含め、CLIユーザーガイドを参照してください。
候補の設定をコミットする際、コミットを恒久的なものにするための明示的な確認を要求できます。確認されたコミット操作は、設定変更が正しく機能し、デバイスへの管理アクセスを妨げないことを確認するのに役立ちます。変更によってアクセスが妨がったり、他のエラーが発生したりする場合、ロールバック期限が過ぎた後、以前の設定への自動ロールバックはアクセスを復元します。指定された時間(10 分)内にコミットが確認されない場合、デバイスは、以前にコミットされた設定を自動的に読み込み、コミット(ロールバック)します。
Junos OSを実行しているデバイスとのJunos XMLプロトコルセッションでは、候補の設定をコミットしますが、コミットが恒久的なものになるために明示的な確認を必要とします。クライアントアプリケーションは、 および <rpc>
タグ要素で空<confirmed/>
のタグを<commit-configuration>
囲みます。
<rpc> <commit-configuration> <confirmed/> </commit-configuration> </rpc>
ロールバック期限の分数をデフォルト値である10分と指定するには、アプリケーションにはタグ要素が含まれており <confirm-timeout>
、遅延の分数を1~65,535分の範囲で指定します。
<rpc> <commit-configuration> <confirmed/> <confirm-timeout>rollback-delay</confirm-timeout> </commit-configuration> </rpc>
設定のプライベートコピーや一時的な設定データベースのインスタンスに対して、確認されたコミット操作を実行することはできません。
Junos XML プロトコル サーバーは、 、および <routing-engine>
タグ要素を返すことで、候補の設定が<output>
<rpc-reply>
<commit-results>
一時的にコミットされたことを確認します。最初のコミット操作が成功した場合、<routing-engine>
要素はタグと<name>
タグ要素を囲みます<commit-success/>
。要素は、コミット操作に成功したルーティングエンジンの名前(単一のルーティングエンジンを使用するデバイスではre0、2つのルーティングエンジンを搭載できるデバイスではre0またはre1)を報告します。
<rpc-reply xmlns:junos="URL"> <commit-results> <output>commit confirmed will be automatically rolled back in 10 minutes unless confirmed</output> <routing-engine> <name>(re0 | re1)</name> <commit-success/> </routing-engine> </commit-results> </rpc-reply>
Junos XMLプロトコルサーバーが候補の設定をコミットできない場合、要素は <rpc-reply>
代わりに失敗の原因を <xnm:error>
説明する要素を囲みます。最も一般的な原因は、候補構成のセマンティック エラーまたは構文エラーです。
現在のロールバック期限より後にロールバックを遅らせるよう、アプリケーションは期限が過ぎる前にタグ要素に<commit-configuration>
再度タグを発行<confirmed/>
します。オプションとして、次のロールバックを<confirm-timeout>
遅らせる時間を指定する要素を含めることができます。デフォルトの10分でロールバックを遅らせるタグ要素を省略します。クライアント アプリケーションは、この方法でタグを繰り返し発行することで、完全にロールバックを<confirmed/>
遅らせることができます。
設定を恒久的にコミットするために、クライアントアプリケーションは、ロールバック期限が過ぎる前に、以下のタグシーケンスのいずれかを発行します。
で
<check/>
囲まれた<commit-configuration>
タグと<rpc>
タグ要素。ロールバックはキャンセルされ、候補の設定は直ちにコミットされます。<rpc> <commit-configuration/> <check/> </commit-configuration/> </rpc>
タグ要素で囲まれた空
<commit-configuration/>
の<rpc>
タグ。Junos XML プロトコルを使用した受験者設定のコミットで説明されているように、ロールバックはキャンセルされ、 受験者の設定が直ちにコミットされます。候補の設定が一時的にコミットされた設定と同じ場合、一時的にコミットされた設定を効果的に再コミットします。
<rpc> <commit-configuration/> </rpc>
で
<synchronize/>
囲まれた<commit-configuration>
タグと<rpc>
タグ要素。<rpc> <commit-configuration> <synchronize/> </commit-configuration> </rpc>
Junos XML プロトコルを使用した冗長制御プレーンでの設定のコミットと同期で説明されているように、ロールバックはキャンセルされ、候補の設定が両方のルーティング エンジンで直ちにチェックおよびコミットされます。確認されたコミット操作が両方のルーティングエンジンで実行されている場合、タグを
<synchronize/>
発行すると、両方のロールバックがキャンセルされます。で
<at-time>
<commit-configuration>
囲まれたタグ要素と<rpc>
タグ 要素。<rpc> <commit-configuration> <at-time>time</at-time> </commit-configuration> </rpc>
ロールバックはキャンセルされ、 Junos XMLプロトコルを使用して指定された時間に設定をコミットするで説明されているように、構文が正しいかどうかすぐに設定が確認され、スケジュールされた時間にコミットされます。
および <confirm-timeout>
タグエレメントは<confirmed/>
、タグ、タグ要素、<log/>
またはその両方と<synchronize/>
組み合わせることができます。詳細については、Junos XML プロトコルを使用した冗長制御プレーンでの設定のコミットと同期および Junos XML プロトコルを使用したコミット操作に関するメッセージのロギングを参照してください。
確認されたコミットが保留されている間(このアプリケーションは変更をコミットしているが、まだ確認されていない)、別のアプリケーションがこのアプリケーションのセッションを終了するためにタ ッグ要素を使用 <kill-session/>
している場合、このセッションを提供している Junos XML プロトコル サーバーは、確認されたコミット 命令が発行される前に設定を状態に復元します。セッションの終了の詳細については、「 Junos XMLプロトコルセッションの終了」を参照してください。
次の例は、ロールバック期限が 20 分のルーティング エンジン 1 で候補設定をコミットする方法を示しています。
