ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Serverドメイン構成の理解
11gリリース1 (10.3.6)
B55525-04
  目次へ移動
目次
前
前 		 次
次		  

3 ドメイン構成ファイル

次の節では、Oracle WebLogic Serverにおいて、ドメインの構成を永続化するために使用するファイルについて説明します。

ドメイン構成ファイルの概要

各ドメインの構成は、ドメインの構成ディレクトリに格納されているXMLドキュメントに記述されます。実行時には、ドメイン内の各Oracle WebLogic Serverインスタンスが、このドキュメントに記述された構成のインメモリー表現を作成します。


注意:

ドメイン・ディレクトリでは、作成後に構成の変更がなくても、ドメインの適切な動作のために書込み権限と読取り権限が必要です。これは、Weblogic Serverが固有の内部デプロイメントを実行し、サーバーの再起動時に構成ファイルが書きなおされる可能性があるためです。

ドメインの中心的な構成ファイルはDOMAIN_NAME/config/config.xmlです。このファイルには、ドメインの名前と、ドメイン内の各サーバー・インスタンス、クラスタ、リソース、およびサービスの構成が指定されています。ファイルには、DOMAIN_NAME/configディレクトリのサブディレクトリに格納されている追加のXMLファイルへの参照も含まれています。これらの含まれるファイルは、Oracle WebLogic Serverの主要なサブシステムを記述するために使用されます。

Oracle WebLogic Serverのデフォルト値のほとんどは、パフォーマンスを最適化するため、ドメインの構成ファイルには保持されていません。そのため、状況によっては、XML要素が構成ファイルに記述されていない場合もあります。たとえば、ドメインがアクティブな間にドメインのデフォルトのロギング重大度を変更したことがない場合、config.xmlファイルにはドメインのロギングを構成するXML要素は含まれていません。

さらにパフォーマンスを最適化するため、各管理対象サーバーはドメインの構成ファイルのコピーを保持しています。このコピーは読取り専用で、変更管理プロセスの一部としてのみ更新できます(第4章「構成の変更の管理」を参照)。

構成ドキュメントの編集

ドメインの構成ドキュメントは、ほとんどの状況ではテキスト・エディタなどの非Oracleツールでは編集しないようにしてください。かわりに、管理コンソール、WebLogic Scripting Tool (WLST)など、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の「WebLogic Serverシステム管理の概要」で説明されているいずれかのツールを使用してください。

ただし、Oracle WebLogic Serverの構成ドキュメントはスキーマに準拠したXMLファイルであるため、XSLTまたはXMLパーサー(Apache Xerces、JDOMなど)を使用して編集することも可能です。作成したスクリプトは徹底的にテストし、変更を行う前に必ず各構成ファイルのバックアップ・コピーを作成するようにしてください。

ドメインの構成ドキュメントを定義するスキーマは、次の場所に格納されています。

  • http://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd

  • http://xmlns.oracle.com/weblogic/security/1.0/security.xsd

  • http://xmlns.oracle.com/weblogic/weblogic-diagnostics/1.0/weblogic-diagnostics.xsd

  • WL_HOME/server/lib/schema内のJARファイル。WL_HOMEはOracle WebLogic Serverのインストール・ディレクトリです。このディレクトリ内では:

  • domain.xsdドキュメントは、パス名META-INF/schemas/schema-0.xsdのweblogic-domain-binding.jarで表現されます。

  • security.xsdドキュメントは、パス名META-INF/schemas/schema-1.xsdのweblogic-domain-binding.jarで表現されます。

  • weblogic-diagnostics.xsdドキュメントは、パス名META-INF/schemas/schema-0.xsdのdiagnostics-binding.jarで表現されます。


    警告:

    実行中のドメインの構成ファイルは編集しないでください。Oracle WebLogic Serverでは、構成ファイルを定期的に書き換えているため、変更した内容は消失します。プラットフォームによっては、Oracle WebLogic Serverの障害の原因となる可能性もあります。

構成ファイル内のセキュリティ資格

ドメイン・セキュリティと組込みLDAPサーバーのセキュリティ資格は、暗号化された状態でconfig.xmlファイルに格納されます。config.xmlファイルをテキスト・エディタなどの非Oracleツールで作成した場合は、セキュリティ資格を見つけて暗号化し、作成済のconfig.xmlファイルに、暗号化した資格をコピーする必要があります。

Oracle WebLogic Serverの暗号化ユーティリティの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンス』の「encrypt」を参照してください。資格を暗号化したら、config.xmlファイル内の要素(例3-1)に、暗号化された値を指定します。

例3-1 暗号化された資格の構成

<security-configuration>
   <credential-encrypted>{3DES}encypted-value-here</credential-encrypted>
</security-configuration>
<embedded-ldap>
   <credential-encrypted>{3DES}encypted-value-here</credential-encrypted>
</embedded-ldap>

構成ファイルのアーカイブ

構成ファイルのバックアップ・コピーを作成するようにOracle WebLogic Serverを構成できます。そうすることで、構成の変更を元に戻す必要がある場合や、万一構成ファイルが破損した場合に、回復しやすくなります。管理サーバーは起動時に、構成ファイルを含むconfig-booted.jarというJARファイルを保存します。構成ファイルを変更すると、古いファイルはドメイン・ディレクトリの下のconfigArchiveディレクトリ内で、連続番号の付いた名前のJARファイル(config-1.jarなど)に保存されます。

構成ファイルのアーカイブについては、Oracle Fusion Middleware Oracle WebLogic Serverの管理コンソール・オンライン・ヘルプの「構成ファイルのアーカイブ化」を参照してください。WLSTを使用してバックアップ・コピーが作成されるように構成する場合は、例3-2に示すように、DomainMBeanのConfigBackupEnabled属性をtrueに設定し、保持する構成アーカイブ・ファイルの数をArchiveConfigurationCount属性に指定します。

例3-2 アーカイブ・ファイルの構成

connect()
edit()
startEdit()
cmo.setArchiveConfigurationCount(5)
cmo.setConfigBackupEnabled(true)
activate()

ドメイン・ディレクトリの内容

デフォルトで、Oracle WebLogic Serverは、Oracle Middleware MW_HOME/user_projects/domainsディレクトリの下にドメイン・ディレクトリを作成します。この節では、ドメイン・ディレクトリとサブフォルダの内容について説明します。なお以下では、ユーザーがドメイン作成時に定義する名前を、domain-name、deployment-name、server-nameのように表記します。

ドメイン・ディレクトリには、ドメイン内の個別のアプリケーションによって作成されたファイルやディレクトリが格納される場合もあります。

まだドメインを作成していない場合は、サンプルとして既存のドメイン・ディレクトリWL_HOME/examples/domains/wl_serverを参照してください。WL_HOMEはOracle WebLogic Serverのインストール・ディレクトリです。

domain-name

このディレクトリの名前はドメインの名前です。

autodeploy

このディレクトリは、開発サーバーでアプリケーションを素早くデプロイする方法を提供します。Oracle WebLogic Serverインスタンスが開発モードで実行中の場合、このディレクトリに配置したアプリケーションまたはモジュールはWebLogic Serverインスタンスによって自動的にデプロイされます。

このディレクトリに配置するファイルは、次のようなJava EEアプリケーションです。

  • EARファイル

  • WAR、EJB JAR、RAR、またはCARアーカイブ・モジュール

  • アプリケーションまたはモジュールの展開されたアーカイブ・ディレクトリ

bin

このディレクトリには、ドメインの管理サーバーと管理対象サーバーの起動および停止処理に使用されるスクリプトが含まれています。通常、これらのスクリプトは、UNIX用に.shファイルが、Windows用に.cmdファイルが用意されています。binディレクトリは、データベース管理システム、フルテキスト検索エンジン・プロセスなどを起動および停止するスクリプトなどのドメイン全体を対象とする他のスクリプトをオプションで含むことができます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverサーバーの起動と停止の管理』を参照してください。

config

このディレクトリには、ドメインの現在の構成とデプロイメントの状態が含まれています。中心的なドメイン構成ファイルのconfig.xmlはこのディレクトリに格納されます。

config/configCache

ドメインの構成ドキュメントへの変更を検証する際に、パフォーマンスの最適化に使用するデータが格納されます。これらはOracle WebLogic Serverの内部データであるため、バックアップする必要はありません。

config/diagnostics

このディレクトリには、WebLogic診断フレームワークのインストゥルメンテーションのシステム・モジュールがあります。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使い方』を参照してください。

config/jdbc

このディレクトリには、JDBCのシステム・モジュール、つまり、(JSR-88とは異なり) JMXから直接構成できる、グローバルなJDBCモジュールが含まれます。詳細は、Oracle WebLogic Serverのデータベース接続に関する説明を参照してください。

config/jms

このディレクトリには、JMSのシステム・モジュール、つまり、(JSR-88とは異なり) JMXから直接構成できる、グローバルなJMSモジュールが含まれます。詳細は、Oracle WebLogic Serverのメッセージングに関する説明を参照してください。

config/lib

このディレクトリは、現在のリリースのOracle WebLogic Serverでは使用されていません。

config/nodemanager

このディレクトリには、ノード・マネージャとの接続に関する構成情報が保持されます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイド』の「ノード・マネージャの構成ファイルとログ・ファイル」を参照してください。

config/security

このディレクトリには、セキュリティ・フレームワークのシステム・モジュールが含まれます。ドメインの現在のレルムにある、セキュリティ・プロバイダの各種類ごとに1つの、セキュリティ・プロバイダの構成拡張が格納されます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Securityについて』を参照してください。

configArchive

このディレクトリには、ドメインの構成の状態を保存したJARファイルのセットが格納されます。構成の保留中の変更内容がアクティブ化される直前に、config.xmlファイルと他の関連する構成ファイルから成るドメインの既存の構成の状態が、config.jar#1、config.jar#2のような名前のバージョン付きのJARファイルに保存されます。

保存するバージョン付きJARファイルの最大数は、DomainMBeanのarchiveConfigurationCount属性で指定します。この最大数に達すると、新しいアーカイブが作成される前に、最も古い変換アーカイブが削除されます。

console-ext

このディレクトリには、管理コンソールの拡張が格納されています。これらの拡張を使用すると、Oracle WebLogic Serverにインストールされているファイルを修正することなく、Oracle WebLogic Server管理コンソールのコンテンツを追加または置換したり、ロゴ、スタイル、色を変更したりできます。たとえば、カスタマイズされたアプリケーション・モニター機能や管理機能を備えたコンテンツを追加できます。『Oracle Fusion Middleware Oracle WebLogic Server管理コンソールの拡張』を参照してください。

init-info

このディレクトリには、WebLogicドメインのプロビジョニングに使用されるファイルがあります。このディレクトリのファイルは変更しないでください。

lib

このディレクトリに配置されているJARファイルは、ドメイン内のWebLogic Serverインスタンスで実行しているすべてのJava EEアプリケーションで(別のシステム・レベル・クラスローダー内で)使用できるようになります。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』のドメイン/libディレクトリへのJARの追加に関する項を参照してください。

pending

このディレクトリには、要求されてまだアクティブ化されていない構成の変更を表すドメイン構成ファイルが格納されます。構成の変更がアクティブ化されると、構成ファイルはこのディレクトリから削除されます。詳細は、第4章「構成の変更の管理」を参照してください。

security

このディレクトリには、ドメイン内のどのOracle WebLogic Serverインスタンスの場合でも、以下のセキュリティ関連のファイルが格納されます。

  • SerializedSystemIni.dat

また、ドメインの管理サーバーだけで必要になる、以下のセキュリティ関連ファイルも格納されます。

  • DefaultAuthorizerInit.ldift

  • DefaultAuthenticatorInit.ldift

  • DefaultRoleMapperInit.ldift

  • XACMLRoleMapperInit.ldift

詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Securityについて』を参照してください。

servers

このディレクトリには、ドメイン内の各Oracle WebLogic Serverインスタンスごとに1つのサブディレクトリが含まれます。サブディレクトリには、各サーバー・インスタンスに固有のデータが格納されます。

servers/server-name

このディレクトリは、ディレクトリと同じ名前のOracle WebLogic Serverインスタンスのサーバー・ディレクトリです。

servers/server-name/cache

このディレクトリには、キャッシュされたデータを格納するディレクトリとファイルがあります。「キャッシュされた」というのは、データが他のデータのコピーであり、場合によっては処理済の形式(コンパイル済、変換済、または再フォーマット済)のコピーであることを意味します。

servers/server-name/cache/EJBCompilerCache

このディレクトリはコンパイル済EJB用のキャッシュです。

servers/server-name/data

このディレクトリには、一時的なキャッシュや履歴情報とは対照的に、Oracle WebLogic Serverインスタンスの実行に使用される、永続的なサーバーごとの状態(セキュリティの状態を除く)を保持するファイルが格納されます。このディレクトリのファイルは、Oracle WebLogic Serverインスタンスの起動、停止、クラッシュ、再起動、新しいバージョンへのアップグレードなどの際に保持する必要のある、重要な情報です。

servers/server-name/data/ldap

このディレクトリには組込みLDAPデータベースがあります。Oracle WebLogic Serverインスタンスの実行時のセキュリティの状態はこのディレクトリに永続化されます。

servers/server-name/data/store

このディレクトリにはWebLogic永続ストアが格納されます。各永続ストアごとに、永続ストアを表すファイルを格納するサブディレクトリがあります。サブディレクトリの名前は永続ストアの名前です。通常、defaultという名前のストアが1つあります。

servers/server-name/logs

このディレクトリにはログと診断情報が保持されます。この情報は事実上、履歴情報です。サーバーの処理に不可欠なものではなく、(少なくとも、Oracle WebLogic Serverインスタンスが停止している間に)削除しても、通常の処理には影響を与えません。ただし、この情報はデバッグや監査の目的には非常に役立つものなので、特に理由がない場合は削除しないでください。

servers/server-name/logs/diagnostic_images

このディレクトリには、WebLogic診断フレームワークのサーバー・イメージ・キャプチャ・コンポーネントによって作成される情報が格納されます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使い方』を参照してください。

servers/server-name/logs/jmsServers

このディレクトリには、Oracle WebLogic Serverインスタンス内の各JMSサーバーごとに1つのサブディレクトリが含まれます。各サブディレクトリには、そのJMSサーバーのログが保存されます。サブディレクトリの名前はJMSサーバーの名前です。

servers/server-name/security

このディレクトリには、Oracle WebLogic Serverインスタンスごとに内容が異なる場合のある、セキュリティ関連のファイルが格納されます。boot.propertiesファイルはここに置かれるファイルの例です。このファイルの内容はサーバーごとに異なるからです。このディレクトリには、SSLキーに関連するファイルも格納されます。

servers/server-name/tmp

このディレクトリには、サーバー・インスタンスの実行中に作成される一時ディレクトリおよびファイルが格納されます。たとえば、JMSページング・ディレクトリは、他の場所を指定しない限り、自動的にここに作成されます。このディレクトリのファイルは、サーバーの実行中はそのままにしておく必要がありますが、サーバー・インスタンスを停止しているときは、自由に削除できます。

tmp

このディレクトリには、変更管理プロセスで使用される一時ファイルが保存されます。このディレクトリのファイルは変更しないでください。

サーバーのルート・ディレクトリ

Oracle WebLogic Serverのすべてのインスタンスは、ルート・ディレクトリを使用して、ドメインの構成ファイルの作業用コピーを格納したり、実行時データを格納したり、サーバーの構成内での相対パス名のコンテキストを提供したりします。管理サーバーの場合は、常にドメイン・ディレクトリがルート・ディレクトリとして使用されます。管理対象サーバーの場合は、ドメイン・ディレクトリも使用できますが、ユーザーが定義した他のどのディレクトリでも使用できます。

たとえば、管理サーバーをホストするコンピュータとファイル・システムを共有していない管理対象サーバーを起動した場合は、その管理対象サーバーによって独自のルート・ディレクトリが作成されます。サーバーは、ドメイン・ディレクトリのデータをこのルート・ディレクトリにコピーし、実行時データをこのディレクトリに書き込みます。

サーバー・インスタンスごとにサーバー・ルート・ディレクトリのパスと名前を指定できます。1つのコンピュータ上にホストされる複数のサーバー・インスタンスで共通のサーバー・ルート・ディレクトリを指定することも、サーバーごとに異なるサーバー・ルート・ディレクトリを指定することもできます。ドメインには、1つまたは複数のサーバー・ルート・ディレクトリが存在できます。

サーバー・ルート・ディレクトリの指定

サーバー・ルート・ディレクトリのパスは、以下のいずれかの手段で指定できます。

  • コマンド・ラインからOracle WebLogic Serverインスタンスを起動する場合は、-Dweblogic.RootDirectory=pathオプションを使用します。たとえば、次のコマンドはOracle WebLogic Serverインスタンスを起動し、サーバーのルート・ディレクトリとしてc:\MyServerRootDirectoryを使用します。

    java -Dweblogic.RootDirectory=c:\MyServerRootDirectory weblogic.Server

  • ノード・マネージャを使用してOracle WebLogic Serverインスタンスを起動する場合は、管理コンソールの「環境」、「サーバー」、server_name、「構成」、「サーバーの起動」ページの「ルート・ディレクトリ」属性で、サーバー・ルート・ディレクトリを指定できます。

上記の手段でサーバー・ルート・ディレクトリを指定しない場合、サーバー・ルート・ディレクトリのパスと名前は、サーバー・インスタンスが管理対象サーバーと管理サーバーのどちらであるか、サーバー・インスタンスの起動にノード・マネージャを使用するかどうかによって異なります。以降の節で、それらのバリエーションについて説明します。

管理サーバーのサーバー・ルート・ディレクトリ

管理サーバーは、サーバー・ルート・ディレクトリを、ドメインの構成データ(config.xmlなど)とセキュリティ・リソース(デフォルトの組込みLDAPサーバーなど)のリポジトリとして使用します。

管理サーバーのルート・ディレクトリの判別は以下の手順で行われます。

  • サーバーの起動コマンドに-Dweblogic.RootDirectory=pathオプションが含まれている場合は、pathの値がサーバー・ルート・ディレクトリになる。

  • -Dweblogic.RootDirectory=pathが指定されていない場合は、作業ディレクトリがサーバー・ルート・ディレクトリになる。

config.xmlファイルが見つからない場合は、新たにディレクトリを作成するかどうかを尋ねるメッセージが表示されます。この方法では、新しいドメインを作成できます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンス』の「weblogic.Serverコマンド・ラインを使用したドメインの作成」を参照してください。

ノード・マネージャで起動した管理対象サーバーのサーバー・ルート・ディレクトリ

ノード・マネージャを使用して管理対象サーバーを起動した場合、ルート・ディレクトリはノード・マネージャ・プロセスをホストするコンピュータ上に置かれます。サーバーのルート・ディレクトリの位置を判断するために、Oracle WebLogic Serverは以下を行います。

  • 管理コンソールの「環境」>「サーバー」>「server-name」>「構成」>「サーバーの起動」ページでルート・ディレクトリを指定した場合、指定したディレクトリがサーバー・ルート・ディレクトリになる。

  • 管理コンソールでルート・ディレクトリを指定していない場合、サーバー・ルート・ディレクトリは次のようになる。

    MW_HOME\user_projects\domains\domain-name\servers\managed-server-name

    MW_HOMEは、ノード・マネージャのホスト・コンピュータでのOracle WebLogic Serverのインストール・ディレクトリです。

ノード・マネージャで起動されていない管理対象サーバーのサーバー・ルート・ディレクトリ

ノード・マネージャを使用せず、java weblogic.Serverコマンドまたはそのコマンドを呼び出すスクリプトを使用して管理対象サーバーを起動した場合、Oracle WebLogic Serverは次のようにルート・ディレクトリを判断します。

  • サーバーの起動コマンドに-Dweblogic.RootDirectory=pathオプションが含まれている場合は、pathの値がサーバー・ルート・ディレクトリになる。

  • -Dweblogic.RootDirectory=pathが指定されていない場合は、作業(カレント)ディレクトリがルート・ディレクトリになる。たとえば、c:\config\MyManagedServerからweblogic.Serverコマンドを実行した場合は、c:\config\MyManagedServerがルート・ディレクトリになります。

Oracle WebLogic Serverソフトウェアがアップグレードされてもドメイン構成とアプリケーションを簡単に維持できるようにするには、サーバー・ルート・ディレクトリをOracle WebLogic Serverソフトウェアのインストール・ディレクトリとは別のディレクトリにします。

  前
前 		 次
次
  目次へ移動
目次