ドメインのコンフィグレーションについて
|
 |
 |
|
この節では、ファイル システムでドメインがどのように表現されているかについて説明します。内容は以下のとおりです。
WebLogic Server の管理およびコンフィグレーション サービスへは Java Management Extensions (JMX) API を使用してアクセスします。ドメインのコンフィグレーションは、ドメイン ディレクトリの下のコンフィグレーション ディレクトリにある XML ファイルに格納されます。コンフィグレーション ディレクトリ内のファイルは、WebLogic Server が実行中に JMX API を使用して作成および変更した管理対象オブジェクトの永続ストアとして機能します。コンフィグレーション ファイルの目的は、WebLogic Server が再起動されたときに利用できるように、管理対象コンフィグレーション オブジェクトの変更内容を格納することです。
ドメインの中心的なコンフィグレーション ファイルは DOMAIN_NAME/config/config.xml です。このファイルには、ドメインの名前と、ドメイン内の各サーバ インスタンス、クラスタ、リソース、およびサービスのコンフィグレーション パラメータ設定が指定されています。ドメインの一部の主要なサブシステムのコンフィグレーションは、DOMAIN_NAME/config ディレクトリのサブディレクトリにある、別のコンフィグレーション ファイルに格納されます。それらのファイルは、中心的な config.xml ファイルに参照として組み込まれています。
ドメイン ディレクトリには、startWebLogic.cmd や startWebLogic.sh などのデフォルトのスクリプト ファイルもあります。これらのファイルを使用して、ドメインの管理サーバや管理対象サーバを起動できます。コンフィグレーション ファイルとスクリプト ファイルの詳細については、「ドメイン ディレクトリの内容」を参照してください。
ドメインの中心的なコンフィグレーション ファイルは /domains/DOMAIN_NAME/config/config.xml です。このファイルには、ドメインの名前と、ドメイン内の各サーバ インスタンス、クラスタ、リソース、およびサービスのコンフィグレーション パラメータ設定が指定されています。
config.xml ファイルは、URL が http://www.bea.com/ns/weblogic/90/domain の XML スキーマに準拠しています。このスキーマはファイル システム上の JAR ファイル (BEA_HOME/weblogic90/server/lib/schema/weblogic-domain-binding.jar) にも格納されています。JAR ファイル内のスキーマのパス名は META-INF/schemas/schema-0.xsd です。XML スキーマを利用すると、XML 編集ツールで config.xml ファイルを変更して検証することができます。
ドメイン コンフィグレーションの XML スキーマのリファレンス ガイドについては、『WebLogic Server Domain Configuration Schema Reference』を参照してください。
通常は、config.xml ファイルや他のコンフィグレーション ファイルを直接変更しないでください。代わりに、Administration Console または「WebLogic Server システム管理の概要」の「システム管理ツールおよび API の概要」で説明されている他のツールのいずれかを使用して、ドメインのコンフィグレーションを変更してください。コンフィグレーションの変更はその後でコンフィグレーション ファイルに反映されます。
コンフィグレーション ファイルと他のコンポーネントをソース管理の対象とし、WLST を使用してそれらを管理する場合は、コンフィグレーション ファイルを直接変更するのが適切な場合もあります。
警告 : WebLogic Server の実行中は、WebLogic Server が定期的にコンフィグレーション ファイルを書き換えているため、コンフィグレーション ファイルを編集することはできません。実行時に編集を行うと、その変更は失われ、プラットフォームによっては WebLogic Server に障害が発生します。
WebLogic Server のコンフィグレーション ファイルは整形式の XML ファイルなので、XSLT を使用して変更したり、Apache Xerces や JDOM などの XML パーサ アプリケーションを使用して、特定の変更の繰り返しをスクリプト化することができます。作成したスクリプトは徹底的にテストし、変更を行う前に必ず各コンフィグレーション ファイルのバックアップ コピーを作成するようにしてください。
ドメイン セキュリティと組み込み LDAP サーバのセキュリティ資格は、暗号化された状態で config.xml ファイルに格納されます。config.xml ファイルを手動で作成した場合は、セキュリティ資格を見つけて暗号化し、作成済みの config.xml ファイルに、暗号化した資格をコピーする必要があります。
WebLogic Server の暗号化ユーティリティの詳細については、『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>
以前のリリースでは、config.xml ファイルはすべてのコンフィグレーション情報のリポジトリでした。このリリースでは、いくつかの WebLogic Server サブシステムのコンフィグレーションが、中心的な config.xml ファイルによって参照される補助コンフィグレーション ファイルに格納されます。これらの補助コンフィグレーション ファイルは /domains/DOMAIN_NAME/config ディレクトリのサブディレクトリにあります。補助コンフィグレーション ファイルの詳細については、「ドメイン ディレクトリの概要」と「ドメイン ディレクトリの内容」を参照してください。
コンフィグレーション ファイルのバックアップ コピーを作成するように WebLogic Server をコンフィグレーションできます。そうすることで、コンフィグレーションの変更を元に戻す必要がある場合や、万一コンフィグレーション ファイルが破損した場合に、回復しやすくなります。管理サーバは起動時に、コンフィグレーション ファイルを含む config-booted.jar という JAR ファイルを保存します。コンフィグレーション ファイルを変更すると、古いファイルはドメイン ディレクトリの下の configArchive ディレクトリ内で、連続番号の付いた名前の JAR ファイル (config-1.jar など) に保存されます。
コンフィグレーション ファイルをバックアップするかどうかは、DomainMBean.ConfigBackupEnabled 属性で指定します。この属性のデフォルト値は false です。保存するコンフィグレーション アーカイブ ファイルの数は DomainMBean.ArchiveConfigurationCount 属性で指定します。この属性のデフォルト値は 0 です。
WebLogic Server では、デフォルトで、ドメイン ディレクトリが BEA_HOME/user_projects/domains ディレクトリ内にインストールされます。図 3-1 は、domains ディレクトリ内の、ドメイン ディレクトリのツリー階層の概要です。domain-name、deployment-name、および server-name ディレクトリ名は文字通りの名前ではなく、実際には適切な特定の名前に置き換えられます。他のディレクトリ名はそのまま使用されます。この概要には、ディレクトリだけでなく、ディレクトリ内のファイルも示されています。実際の特定のドメイン ディレクトリ ツリーでは、この階層の全部が揃っていない場合もあります。
この節では、ドメイン ディレクトリとサブフォルダの内容について説明します。domain-name、server-name、および deployment-name ディレクトリ名は文字通りの名前ではなく、適切な特定の名前に置き換えられます。他のディレクトリ名はそのまま使用されます。
このディレクトリは、開発サーバでアプリケーションを素早くデプロイする方法を提供します。WebLogic Server インスタンスがデプロイメント モードで実行中の場合、このディレクトリに配置したアプリケーションまたはモジュールは WebLogic Server インスタンスによって自動的にデプロイされます。
このディレクトリに配置するファイルは、次のような J2EE アプリケーションです。
このディレクトリには、ドメインの管理サーバと管理対象サーバの起動および停止処理に使用されるスクリプトが含まれています。通常、これらのスクリプトは、UNIX 用 に .sh ファイルが、Windows 用 に.cmd ファイルが用意されています。bin ディレクトリには、データベース管理システムを起動および停止するためのスクリプトや、全文検索エンジンの処理など、ドメイン全体に関与する他のスクリプトを含めることもできます。詳細については、『サーバの起動と停止の管理』を参照してください。
このディレクトリには、ドメインの現在のコンフィグレーションとデプロイメントの状態が含まれています。中心的なドメイン コンフィグレーション ファイルの config.xml はこのディレクトリに格納されます。
このディレクトリには、ドメインのデプロイ済みアプリケーションが、アーカイブ ファイル、または展開されたアーカイブ ディレクトリ形式で格納されます。
このディレクトリにはライブラリ モジュールが格納されます。つまり、このディレクトリで見つかったものは、ライブラリ モジュールとして自動的に登録されます。
このディレクトリには、1 つのアプリケーションまたはデプロイ可能モジュールが含まれています。アーカイブ ファイル (EAR または WAR)、デプロイメント プラン ファイル、外部の記述子などを含む、下位の階層があります。このディレクトリの名前はモジュールの名前から取られます。
このディレクトリには、WebLogic 診断フレームワークのインスツルメンテーションのシステム モジュールがあります。詳細については、『WebLogic 診断フレームワークについて』を参照してください。
このディレクトリには、JDBC のシステム モジュール、つまり、(JSR-88 とは異なり) JMX から直接コンフィグレーションできる、グローバルな JDBC モジュールが含まれます。詳細については、「BEA WebLogic Server 9.0 Database Connectivity (JDBC)」を参照してください。
このディレクトリには、JMS のシステム モジュール、つまり、(JSR-88 とは異なり) JMX から直接コンフィグレーションできる、グローバルな JMS モジュールが含まれます。詳細については、「Messaging (JMS) for BEA WebLogic Server 9.0」を参照してください。
このディレクトリには、ノード マネージャとの接続に関するコンフィグレーション情報が保持されます。詳細については、『サーバの起動と停止の管理』の「Using Node Manager to Control Servers」を参照してください。
このディレクトリには、セキュリティ フレームワークのシステム モジュールが含まれます。ドメインの現在のレルムにある、セキュリティ プロバイダの各種類ごとに 1 つの、セキュリティ プロバイダのコンフィグレーション拡張が格納されます。詳細については、『WebLogic Security について』を参照してください。
このディレクトリには、起動プランを含むシステム モジュールが格納されます。起動プランは、サーバの起動中に使用できるシェル スクリプトの生成に使用されます。
このディレクトリには、ドメインのコンフィグレーションの状態を保存した JAR ファイルのセットが格納されます。コンフィグレーションの保留中の変更内容がアクティブ化される直前に、config.xml ファイルと他の関連するコンフィグレーション ファイルから成るドメインの既存のコンフィグレーションの状態が、config.jar#1、config.jar#2 のような名前のバージョン付きの JAR ファイルに保存されます。
保存するバージョン付き JAR ファイルの数は、DomainMBean の archiveConfigurationCount 属性で指定します。この最大数に達すると、新しいアーカイブが作成される前に、最も古い変換アーカイブが削除されます。
このディレクトリには、WebLogic ドメインのプロビジョニングに使用されるファイルがあります。このディレクトリのファイルは変更しないでください。
このディレクトリに置いた JAR ファイルは、サーバの Java 仮想マシンの起動時に、ドメイン内の各サーバ インスタンスのシステム クラスパスに追加されます。
このディレクトリには、要求されてまだアクティブ化されていないコンフィグレーションの変更を表すドメイン コンフィグレーション ファイルが格納されます。コンフィグレーションの変更がアクティブ化されると、コンフィグレーション ファイルはこのディレクトリから削除されます。詳細については、「コンフィグレーションの変更の管理」を参照してください。
このディレクトリには、ドメイン内のどの WebLogic Server インスタンスの場合でも、以下のセキュリティ関連のファイルが格納されます。
また、ドメインの管理サーバだけで必要になる、以下のセキュリティ関連ファイルも格納されます。
詳細については、『WebLogic Security について』を参照してください。
このディレクトリには、ドメイン内の各 WebLogic Server インスタンスごとに 1 つのサブディレクトリが含まれます。詳細については、「サーバのルート ディレクトリ」を参照してください。
このディレクトリは、ディレクトリと同じ名前の WebLogic Server インスタンスのサーバ ディレクトリです。
このディレクトリには、サーバごとに内容が異なる場合のある実行可能ファイルやシェル ファイルが格納されます。サーバ環境スクリプト (setServerEnv.sh または setServerEnv.cmd) は、ここに置かれるファイルの例です。このファイルは、たとえば、サーバ インスタンスが独自の起動プランを持つかどうかによって、WebLogic Server インスタンスごとに異なるからです。
このディレクトリには、キャッシュされたデータを格納するディレクトリとファイルがあります。ここに「キャッシュされた」というのは、データが他のデータのコピーであり、場合によっては処理済みの形式 (コンパイル済み、変換済み、または再フォーマット済み) のコピーであることを意味します。
このディレクトリはコンパイル済み EJB 用のキャッシュです。
このディレクトリには、一時的なキャッシュや履歴情報とは対照的に、WebLogic Server インスタンスの実行に使用される、永続的なサーバごとの状態 (セキュリティの状態を除く) を保持するファイルが格納されます。このディレクトリのファイルは、WebLogic Server インスタンスの起動、停止、再起動、新しいバージョンへのアップグレードなどを行う際に保持する必要のある、重要な情報です。
このディレクトリには組み込み LDAP データベースがあります。WebLogic Server インスタンスの実行時のセキュリティの状態はこのディレクトリに永続化されます。
このディレクトリには WebLogic 永続ストアが格納されます。各永続ストアごとに、永続ストアを表すファイルを格納するサブディレクトリがあります。サブディレクトリの名前は永続ストアの名前です。通常、default という名前のストアが 1 つあります。
このディレクトリにはログと診断情報が保持されます。この情報は事実上、履歴情報です。サーバの処理に不可欠なものではなく、(少なくとも、WebLogic Server インスタンスが停止している間に) 削除しても、通常の処理には影響を与えません。ただし、この情報はデバッグや監査の目的には非常に役立つものなので、特に理由がない場合は削除しないでください。
このディレクトリには、WebLogic 診断フレームワークのサーバ イメージ キャプチャ コンポーネントによって作成される情報が格納されます。詳細については、『WebLogic 診断フレームワークについて』を参照してください。
このディレクトリには、WebLogic Server インスタンス内の各 JMS サーバごとに 1 つのサブディレクトリが含まれます。各サブディレクトリには、その JMS サーバのログが保存されます。サブディレクトリの名前は JMS サーバの名前です。
このディレクトリは、コネクタ モジュール (JCA ResourceAdapter) ログ用の、デフォルトのベース ディレクトリです。
このディレクトリには、WebLogic Server インスタンスごとに内容が異なる場合のある、セキュリティ関連のファイルが格納されます。boot.properties ファイルはここに置かれるファイルの例です。このファイルの内容はサーバごとに異なるからです。このディレクトリには、SSL キーに関連するファイルも格納されます。
このディレクトリには、サーバ インスタンスの実行中に作成される一時ディレクトリおよびファイルが格納されます。たとえば、JMS ページング ディレクトリは、他の場所を指定しない限り、自動的にここに作成されます。このディレクトリのファイルは、サーバの実行中はそのままにしておく必要がありますが、サーバ インスタンスを停止しているときは、自由に削除できます。
このディレクトには、変更管理プロセスで使用される一時ファイルが保存されます。このディレクトリのファイルは変更しないでください。
デフォルトでは、コンフィグレーション情報は管理サーバから管理対象サーバに自動的にコピーされます。代わりに、コンフィグレーションの変更を手動でステージングする場合は、このディレクトリを config ディレクトリの代わりとして使用できます。
WebLogic Server のすべてのインスタンスは、サーバ ルート ディレクトリを使用して、実行時データを格納したり、サーバのコンフィグレーション内での相対パス名のコンテキストを提供したりします。サーバ インスタンスごとにサーバ ルート ディレクトリのパスと名前を指定できます。1 つのコンピュータ上にホストされる複数のサーバ インスタンスで共通のサーバ ルート ディレクトリを指定することも、サーバごとに異なるサーバ ルート ディレクトリを指定することもできます。ドメインには、1 つまたは複数のサーバ ルート ディレクトリが存在できます。
サーバ ルート ディレクトリのパスは、以下のいずれかの手段で指定できます。
-Dweblogic.RootDirectory=path オプションを使用します。たとえば次のコマンドでは、java -Dweblogic.RootDirectory=c:\MyServerRootDirectory weblogic.Server
上記の手段でサーバ ルート ディレクトリを指定しない場合、サーバ ルート ディレクトリのパスと名前は、サーバ インスタンスが管理対象サーバと管理サーバのどちらであるか、サーバ インスタンスの起動にノード マネージャを使用するかどうかによって異なります。以降の節で、それらのバリエーションについて説明します。
管理サーバは、サーバ ルート ディレクトリを、ドメインのコンフィグレーション データ (config.xml など) とセキュリティ リソース (デフォルトの組み込み LDAP サーバなど) のリポジトリとして使用します。
管理サーバのルート ディレクトリの判別は以下の手順で行われます。
-Dweblogic.RootDirectory=path オプションが含まれている場合は、path の値がサーバ ルート ディレクトリになります。-Dweblogic.RootDirectory=path が指定されていない場合は、作業ディレクトリがサーバ ルート ディレクトリになります。ただし、WebLogic Server 6.x で作成されたドメインをアップグレードした場合、サーバ ルート ディレクトリは作業ディレクトリの親ディレクトリになります。config.xml ファイルが見つからない場合は、新たにディレクトリを作成するかどうかを尋ねるメッセージが表示されます。この方法では、新しいドメインを作成できます。詳細については、『WebLogic Server コマンド リファレンス』の「weblogic.Server コマンドラインを使用したドメインの作成」を参照してください。
ノード マネージャを使用して管理対象サーバを起動した場合、ルート ディレクトリはノード マネージャ プロセスをホストするコンピュータ上に置かれます。サーバのルート ディレクトリの位置を判断するために、WebLogic Server は以下のことを行います。
BEA_HOME\WL_HOME\common\nodemanager になります。各要素の説明は次のとおりです。ノード マネージャで起動した管理対象サーバのサーバ ルート ディレクトリには、各管理対象サーバ インスタンスのサブディレクトリが格納されます。そのサブディレクトリの名前は、ドメインのコンフィグレーションで定義されているサーバの名前です。
ノード マネージャを使用せず、java weblogic.Server コマンドまたはそのコマンドを呼び出すスクリプトを使用して管理対象サーバを起動した場合、WebLogic Server は次のようにルート ディレクトリを判断します。
-Dweblogic.RootDirectory=path オプションが含まれている場合は、path の値がサーバのルート ディレクトリになります。-Dweblogic.RootDirectory=path が指定されていない場合は、作業 (カレント) ディレクトリがルート ディレクトリになります。たとえば、c:\config\MyManagedServer から weblogic.Server コマンドを実行した場合は、c:\config\MyManagedServer がルート ディレクトリになります。 WebLogic Server ソフトウェアがアップグレードされてもドメイン コンフィグレーションとアプリケーションを簡単に維持できるようにするには、サーバ ルート ディレクトリを WebLogic Server ソフトウェアのインストール ディレクトリとは別のディレクトリにします。
|
|
|