1 構成ファイルおよびディレクトリの概要

Oracle Traffic Directorの構成および動作は、一連の構成ファイルによって決定されます。Oracle Fusion Middleware ControlおよびWebLogic Scripting Tool (WLST)を使用して、構成ファイル設定を変更できます。これらのファイルは手動で編集することもできます。

注意:

12.2.1.4.0で、Oracle Traffic Directorは非推奨になりました。将来、同等の機能を実現するには、Oracle HTTP Server、Microsoft IIS Web ServerまたはApache HTTP Serverプラグインか、TraefikなどのネイティブKubernetesロード・バランサを使用してください。

この章の内容は次のとおりです。

• 構成ファイル

• ディレクトリ構造

• 動的再構成

構成ファイル

各サーバー・インスタンスには独自のディレクトリがあり、このドキュメントではそれをINSTANCE_HOMEと呼びます。INSTANCE_HOME/configディレクトリには、Oracle Traffic Directorコンポーネントの構成ファイルが含まれます。構成ファイルの正確な数と名前は、有効化されているか、またはサーバーにロードされているコンポーネントに応じて異なります。INSTANCE_HOMEのデフォルトの場所は、デフォルト・パスを参照してください。

次の項では、Oracle Traffic Directorの構成ファイルと関連情報について説明します。

• server.xmlファイル

• obj.confファイル

• NZウォレット・ファイル

• デフォルト・パス

server.xmlファイル

server.xmlファイルには、Oracle Traffic Director構成が含まれます。server.xmlファイルの詳細は、server.xmlの構文および使用を参照してください。

obj.confファイル

obj.confファイルには、HTTPリクエスト処理のディレクティブが含まれます。obj.confファイルの詳細は、obj.confの構文および使用を参照してください。

NZウォレット・ファイル

ウォレット・ファイルは、INSTANCE_HOME/configディレクトリに格納されます。

• ewallet.p12 - PINを持つ編集可能なウォレット

• cwallet.sso - 難読化したパスワードを持つ単一のサインオン・ウォレット(PINは不要)

NZウォレットには3つの操作モードがあります。3つのモードはすべてOTDコア・サーバーでサポートされますが、adminはすべてをサポートしていません。次に、各モードを示します。

• ewallet.p12のみ - OTDがウォレットに読取り専用モードでアクセスする、またはadminが読取り書込みモードでウォレットにアクセスする、いずれの場合でも、PINが常に必要です。OTDにより、起動時にPINが求められます。PINは、server.xmlに格納されません。

• cwallet.ssoのみ - orapkiでは、"自動ログインのみ"モードと呼ばれます。OTDがウォレットに読取り専用モードでアクセスする、またはadminが読取り書込みモードでウォレットにアクセスする、いずれの場合でも、PINは不要です。

• ewallet.p12およびcwallet.sso - orapkiでは"自動ログイン"モードと呼ばれます。OTDが読取り専用モードでウォレットにアクセスするためにPINは不要ですが、adminが読取り書込みモードでウォレットにアクセスするためにはPINが必要です。ewallet.p12が編集されます。それぞれの編集の後、ewallet.p12はcwallet.ssoに変換されます。

Oracle orapkiコマンドライン・ユーティリティを使用して、ウォレットなどの公開キー・インフラストラクチャ(PKI)要素を管理します。詳細は、『Oracle Databaseセキュリティ・ガイド』の付録のorapkiユーティリティを使用したPKI要素の管理に関する項を参照してください

デフォルト・パス

次に、Oracle Traffic Directorで使用されるデフォルト・パスを示します。表1-1に、デフォルト・パスおよびファイル名を示します。

表1-1 デフォルト・パス

プレースホルダ	説明
ORACLE_HOME	Oracle Traffic Directorがインストールされているディレクトリ。
INSTANCE_HOME	Oracle Traffic Director管理サーバーおよびOracle Traffic Directorインスタンスに関連するファイルを含むディレクトリ。

ディレクトリ構造

この項では、Oracle Traffic Directorを最初にインストールしたときに作成されるディレクトリ構造について説明します。通常のOTDインストール環境では、admin-serverディレクトリとnet-server-idインスタンス・サブディレクトリを除き、すべてのディレクトリはORACLE_HOMEディレクトリに配置されます。admin-serverディレクトリとnet-server-idサブディレクトリは、INSTANCE_HOMEディレクトリに配置されます。管理サーバーまたは管理ノードを作成するには、configure-serverコマンドを実行する必要があります。OTDで管理ノードを作成する場合、管理サーバーが起動して実行されていることを確認してください。新しく作成された管理ノードは、管理サーバーに登録されます。インスタンスを作成する前に、configure-serverコマンドを実行して管理サーバーを作成します。その後、create-instanceコマンドを実行してOTDでインスタンスを作成します。CLIコマンドの詳細は、『Oracle Traffic Directorコマンドライン・リファレンス』を参照してください。これらのディレクトリに対応するデフォルトの場所の詳細は、デフォルト・パスを参照してください。次のディレクトリは、Oracle Traffic Directorのインストール・ディレクトリであるORACLE_HOMEの下にあります。

• bin

• Legal

• lib

• admin-server

• net-server-id

bin

binディレクトリには、WebLogic Scripting Tool CommandインタフェースのWLSTなど、Oracle Traffic Directorを管理するためのコマンドが含まれます。

Legal

Legalディレクトリには、Oracle Traffic Directorソフトウェアに関連するサード・パーティ情報が含まれます。

lib

libディレクトリには、内部バイナリ、スクリプト、ライブラリおよびバンドル・プラグインが含まれます。これらはプライベート・ファイルであり、内部でのみ使用されます。

admin-serverディレクトリとnet-server-idサブディレクトリに関する詳細は、次を参照してください。

• admin-server

• net-server-id

admin-server

admin-serverディレクトリには次のサブディレクトリがあります。

• bin - Oracle® Fusion Middlewareを起動、停止および再起動するために使用するバイナリ・ファイルが含まれます。UNIXシステムでは、このディレクトリにログのローテーションに必要なファイルも含まれます。

• config - 管理サーバーのプライベート構成ファイルが含まれます。これらのファイルは内部で使用されます。

• config-store - 管理サーバーがサーバー構成情報を追跡するために使用するファイルが含まれます。

注意:

このディレクトリのファイルは、Oracle Traffic Directorによって内部使用目的で作成されます。編集、スクリプト実行またはその他の方法でconfig-storeディレクトリのファイルにアクセスしないでください。

• generated - JavaServer Pages (JSP)に対応するJavaクラス・ファイルなど、インスタンスによって生成されたファイルが含まれます。

• logs - サーバー・インスタンスによって生成されたエラー・メッセージまたはアクセス・ログ・ファイルが含まれます。

net-server-id

A net-server-idディレクトリは、OTDでインスタンスを作成するたびに作成されます。このディレクトリには、次のサブディレクトリとファイルが含まれます。

• bin - サーバーを起動、停止、再起動および再構成するためのコマンドが含まれます。また、ログ・ファイルをローテーションするためのコマンドも含まれます。

• config - 次のインスタンス固有の構成ファイルが含まれます。

  • <C1>-obj.conf - 仮想サーバー固有のディレクトリ。

  • obj.conf - クライアントからのHTTPリクエストを処理するOracle® Fusion Middlewareディレクティブ。

  • pkcs11.txt - NSS PKCS #11モジュール・データベース。

  • server.xml - サーバー構成設定の大部分。

• logs - このサーバー・インスタンスによって生成されたログ・ファイルが含まれます。

動的再構成

動的再構成によって、変更内容を有効化するために停止および再起動せずに、実行中のOracle Traffic Directorの構成を変更できます。

動的な構成は、次の場合に発生します。

• 管理コンソールまたはCLIを通じて構成をデプロイする場合

• サーバー・インスタンスのbinディレクトリに含まれるreconfigスクリプトを実行する場合

サーバーを再起動せずにobj.confファイルの構成設定を動的に変更できます。また、server.xmlファイルのほとんどの設定もサーバーを再起動せずに変更できます。サーバーを再起動する必要がある場合は、構成をデプロイするかreconfigコマンドを実行する際に、サーバー・ログに警告メッセージが出現します。

server.xmlの次の構成パラメータは、動的に再構成できません。

• user

• temp-path

• log (ログ・レベルを除く)

• thread-pool

• pkcs11

• stats

• dns

• dns-cache

• ssl-session-cache

• access-log-buffer

reconfigコマンドを実行すると、新しい構成オブジェクトが作成され、その新しい構成オブジェクトに基づいてすべての新しい着信リクエストが処理されます。現在の構成オブジェクトは、そのオブジェクトを使用しているHTTPリクエストが存在しない場合、削除されます。

動的再構成中に間違った構成が行われると、サーバーにエラー・メッセージが表示されます。サーバーは、正常な最後の構成によって指定されているログ・ファイルにエラー・メッセージを記録します。

一部の間違った構成では、警告メッセージが表示されますが、その構成はサーバーに拒否されません。それ以外の間違ったな構成は、エラー・メッセージをトリガーし、その構成はサーバーに拒否されます。構成がサーバーの起動時に拒否されると、サーバーは起動しません。構成がサーバーの動的再構成時に拒否されると、サーバーは正常な最後の構成に戻ります。