コンフィグレーション ウィザードの使い方

サイレントモードのコンフィグレーション スクリプトの作成

コンフィグレーション ウィザードをサイレントモードで実行してドメインを作成または拡張するには、「サイレントモードでの開始」で説明したように、ドメインのコンフィグレーション設定を定義するスクリプトを作成しておく必要があります。WebLogic Platform ソフトウェアには、Basic WebLogic Server Domain テンプレートに基づいたサンプル スクリプトが、製品インストール ディレクトリ common¥templates¥silent_scripts に用意されています。このサンプル スクリプトおよび他のドメイン テンプレートに基づいたその他のスクリプトについては、「サイレントモード コンフィグレーションのサンプル コンフィグレーション スクリプト」で説明されています。

スクリプトを作成するには、次のいずれかを実行します。

• サンプル スクリプトのいずれかの内容をテキスト ファイルにコピーし、コンフィグレーションに合わせて編集する (推奨)
• テキスト エディタで新しいファイルを開き、ドメイン コンフィグレーション設定を手動で指定する (サンプル スクリプトに詳しいユーザ向け)

ドメインを作成または拡張するためのスクリプトを作成する手順については、以下の節を参照してください。

• サイレントモードで新しいドメインを作成するためのスクリプトの作成
• サイレントモードで既存のドメインを拡張するためのスクリプトの作成

 

---

サイレントモードで新しいドメインを作成するためのスクリプトの作成

スクリプトを作成する際には、スクリプトの実行時にコンフィグレーション ウィザードによって行われる処理を指定します。以下の節では、新しいドメインを作成するためにスクリプトで定義する必要がある処理を説明します。

• 手順 1 : コンフィグレーション テンプレートを選択する
• 手順 2 : コンフィグレーション情報を編集する
• 手順 3 : ドメインを作成する
• 手順 4 : コンフィグレーション テンプレートを閉じる

注意 : この節で説明する各処理のコードの末尾には、セミコロンを付ける必要があります。

手順 1 : コンフィグレーション テンプレートを選択する

作成およびコンフィグレーションするドメインの基準として使用するコンフィグレーション テンプレートを選択します。コンフィグレーション テンプレートを選択するには、read 処理を次のように使用します。

read template from "template_jar_name";

表 4-1 では、値を指定する必要がある唯一の read template 処理パラメータについて説明します。

表 4-1 read template 処理のパラメータ 

パラメータ	説明
template_jar_name	コンフィグレーション テンプレート ファイルの名前を含む、コンフィグレーション テンプレートの絶対パス名。パス名は、引用符で囲む必要がある。

 

次の例では、テンプレートの絶対パス名を使用して、Basic WebLogic Server Domain コンフィグレーション テンプレートが指定されています。

read template from "C:¥bea¥weblogic81¥common¥templates¥domains¥wls.jar";

手順 2 : コンフィグレーション情報を編集する

デフォルトのコンフィグレーション情報を編集して、新しいコンフィグレーション オブジェクトの作成、コンフィグレーション オブジェクト属性の既存の値の編集、またはコンフィグレーション オブジェクトの削除を行います。

注意 : 既存のドメイン コンフィグレーションに関する情報を取得するには、テンプレート JAR ファイル内の config.xml ファイルと security.xml ファイル、または作成されたドメイン内の config.xml ファイルを参照します。config.xml ファイルの詳細については、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照してください。

サイレントモードでは、カスタム セキュリティ オブジェクトを除く、有効なコンフィグレーション オブジェクトとその子要素を作成および編集します。有効なコンフィグレーション オブジェクトの詳細については、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照してください。

次の表は、この後の各節で説明する編集処理をまとめたものです。

表 4-2 新しいドメインを作成するための編集処理の概要 

処理の内容	参照先
コンフィグレーション オブジェクトの作成	コンフィグレーション オブジェクトを作成する
既存のコンフィグレーション オブジェクトの編集	変数に既存のコンフィグレーション オブジェクトを割り当てる 変数に既存の子要素を割り当てる コンフィグレーション オブジェクト属性を設定する 子要素の特定の属性を設定する 子要素のすべてのインスタンスの属性を設定する 名前のない子要素の属性を設定する クラスタの HTTP プロキシ サーバを設定する 新しいドメインを作成する際のコンフィグレーション オプションを設定する クラスタにサーバを割り当てる サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる サーバまたはクラスタに個々のアプリケーションを割り当てる サーバまたはクラスタに個々のサービスを割り当てる セキュリティ割り当てを生成する Unassign 処理を使用して割り当てを解除する
コンフィグレーション オブジェクトの削除	コンフィグレーション オブジェクトを削除する

 

コンフィグレーション オブジェクトを作成する

コンフィグレーション オブジェクトを作成するには、作成するオブジェクトのタイプを指定して変数に割り当て、Name 属性を定義します。その後、「コンフィグレーション オブジェクト属性を設定する」の説明に従い、残りの属性を設定 (または Name 属性を編集) できます。

コンフィグレーション オブジェクトを作成するには、create 処理を次のように使用します。

create object_type "name" as variable;

表 4-3 では、値を指定する必要がある create 処理パラメータについて説明します。

表 4-3 create 処理のパラメータ 

パラメータ	説明
object_type	『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) で定義されているコンフィグレーション オブジェクト タイプ。
name	Name 属性に割り当てる値。このパラメータ (name) は、引用符で囲む必要がある。
variable	コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。

 

次の例では、Server オブジェクトが作成されて変数 s2 に割り当てられ、Name 属性が server_2 に設定されます。

create Server "server_2" as s2;

次の例では、User オブジェクトが作成されて変数 u1 に割り当てられ、Name 属性が user1 に設定されます。

create User "user1" as u1;

デフォルトでは、このユーザはグループ「Administrators」に割り当てられます。

変数に既存のコンフィグレーション オブジェクトを割り当てる

既存のコンフィグレーション オブジェクトを編集する前に、テンプレートでオブジェクトを検出し、変数に割り当てる必要があります。変数にコンフィグレーション オブジェクトを割り当てるには、find 処理を次のように使用します。

find object_type "name" as variable;

表 4-4 では、値を指定する必要がある find 処理パラメータについて説明します。

表 4-4 find 処理のパラメータ 

パラメータ	説明
object_type	『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) で定義されているコンフィグレーション オブジェクト。
name	コンフィグレーション オブジェクトの Name 属性の値。このパラメータ (name) は、引用符で囲む必要がある。
variable	コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。

 

次の例では、「myserver」という名前の Server オブジェクトが変数 s1 に割り当てられます。

find Server "myserver" as s1;

変数に既存の子要素を割り当てる

コンフィグレーション オブジェクト タイプの中には、子要素を持つものがあります。既存の子要素を編集する前に、テンプレートで要素を検出し、変数に割り当てる必要があります。変数に子要素を割り当てるには、次のように find 処理を使用します。

find object_type.child_element "name.child_element_name" as variable;

表 4-5 では、値を指定する必要がある find 処理パラメータについて説明します。

注意 : サイレントモードのコンフィグレーションでは、コンフィグレーション オブジェクト タイプのすべての子要素がサポートされています。コンフィグレーション オブジェクトの子要素の完全なリストについては、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照してください。

表 4-5 子要素の find 処理のパラメータ

パラメータ	説明
object_type	『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) で定義されているコンフィグレーション オブジェクト。
child_element	コンフィグレーション オブジェクトの子要素。サイレントモードのコンフィグレーションでは、コンフィグレーション オブジェクト タイプのすべての子要素がサポートされている。コンフィグレーション オブジェクトの子要素の完全なリストについては、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照。
name	コンフィグレーション オブジェクトの Name 属性の値。
child_element_name	子要素の Name 属性の値。
variable	コンフィグレーション オブジェクトの子要素の指定に使用されるユーザ定義の変数。

 

次の例では、「myserver」という名前の Server オブジェクトおよび「mywebserver」という名前の WebServer 子要素が、変数 ws1 に割り当てられます。

find Server.WebServer "myserver.mywebserver" as ws1;

コンフィグレーション オブジェクト属性を設定する

コンフィグレーション属性を設定するには、次のように変数と属性名を指定します。

set variable.attribute "value";

表 4-6 では、値を指定する必要があるパラメータについて説明します。

表 4-6 set 処理のパラメータ 

パラメータ	説明
variable	コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。 新しいコンフィグレーション オブジェクトについては、「コンフィグレーション オブジェクトを作成する」で説明したように、作成プロセス中に変数にコンフィグレーション オブジェクトを割り当てる。 既存のコンフィグレーション オブジェクトについては、「変数に既存のコンフィグレーション オブジェクトを割り当てる」で説明したように、find 処理を使用して変数にコンフィグレーション オブジェクトを割り当てる。
attribute	値を指定するコンフィグレーション オブジェクト属性。
value	指定した属性に割り当てる値。このパラメータ (value) は、引用符で囲む必要がある。

 

次の例では、s2 (つまり server_2) によって参照される Server コンフィグレーション オブジェクトの ListenAddress および ListenPort 属性が、それぞれ localhost および 7001 に設定されます。

set s2.ListenAdress "localhost";
set s2.ListenPort "7001";

JDBC 接続プールの Properties 属性の設定に関する考慮事項

JDBC 接続プールの Properties 属性は、JDBC ドライバに渡される一連のプロパティを指定するもので、物理的なデータベース接続を作成する際に使用されます。

この属性を指定する場合は、使用中の JDBC ドライバに必要なすべてのプロパティを指定するようにしてください。

Properties 属性に指定した値で、現在設定されているすべての値がオーバーライドされるため、Properties リストで値を省略すると、そのプロパティが未定義のままとなり、予期しない結果が生じます。

子要素の特定の属性を設定する

子要素の属性に値を割り当てるには、次のように、子要素に割り当てられている変数と属性の名前を指定します。

set variable.attribute "value";

表 4-7 では、値を指定する必要があるパラメータについて説明します。

表 4-7 子要素の属性の設定に使用する set 処理のパラメータ

パラメータ	説明
variable	コンフィグレーション オブジェクトの子要素の指定に使用されるユーザ定義の変数。 既存のコンフィグレーション オブジェクトについては、「変数に既存の子要素を割り当てる」で説明したように、find 処理を使用して変数に子要素を割り当てる。
attribute	値を指定する子要素の属性。
value	指定した属性に割り当てる値。このパラメータ (value) は、引用符で囲む必要がある。

 

次の例では、「myserver」という名前の Server および「mywebserver」という名前の WebServer 子要素が、変数 ws1 に割り当てられます。その後、webserver 子要素の LogFileName 属性に、値 c:\bea\weblogic\logs\newAccess.log が割り当てられます。

find Server.WebServer "myserver.mywebserver" as ws1;
set ws1.LogFileName "c:\bea\weblogic\logs\newAcess.log";

子要素のすべてのインスタンスの属性を設定する

特定タイプの子要素のすべてのインスタンスの属性に値を割り当てるには、次のフォーマットを使用します。

set variable.child_element.attribute "value";

表 4-8 では、値を指定する必要があるパラメータについて説明します。

表 4-8 子要素のすべてのインスタンスの属性に使用する set 処理のパラメータ

パラメータ	説明
variable	コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。 新しいコンフィグレーション オブジェクトについては、「コンフィグレーション オブジェクトを作成する」で説明したように、作成プロセス中に変数にコンフィグレーション オブジェクトを割り当てる。 既存のコンフィグレーション オブジェクトについては、「変数に既存のコンフィグレーション オブジェクトを割り当てる」で説明したように、find 処理を使用して変数にコンフィグレーション オブジェクトを割り当てる。
child_element	コンフィグレーション オブジェクトの子要素。サイレントモードのコンフィグレーションでは、コンフィグレーション オブジェクト タイプのすべての子要素がサポートされている。コンフィグレーション オブジェクトの子要素の完全なリストについては、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照。
attribute	値を指定する子要素の属性。
value	指定した属性に割り当てる値。このパラメータ (value) は、引用符で囲む必要がある。

 

次の例では、「myserver」という名前のサーバが変数 s1 に割り当てられます。その後、s1 で参照されるサーバの ExecuteQueue 子要素のすべての ThreadCount 属性が、25 に設定されます。

find Server "myserver" as s1;
set s1.ExecuteQueue.ThreadCount "25";

名前のない子要素の属性を設定する

子要素のインスタンスの Name 属性が定義されていないときは、その子要素を個別に参照することができません。この場合、名前のない子要素の属性に値を割り当てる唯一の方法は、「子要素のすべてのインスタンスの属性を設定する」で説明したように、子要素のすべてのインスタンスの属性を設定することです。

クラスタの HTTP プロキシ サーバを設定する

次のように、set 処理を使用して、クラスタの HTTP プロキシ サーバを指定することもできます。

set variable.ProxyServer "unclustered_managed_server";

注意 : プロキシ サーバとして使用できるのは、クラスタ化されていない管理対象サーバのみです。

表 4-9 では、HTTP プロキシ サーバを設定する際に値を指定する必要があるパラメータについて説明します。

表 4-9 HTTP プロキシ サーバの set 処理のパラメータ

パラメータ	説明
variable	cluster コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。 新しいコンフィグレーション オブジェクトについては、「コンフィグレーション オブジェクトを作成する」で説明したように、作成プロセス中に変数にコンフィグレーション オブジェクトを割り当てる。 既存のコンフィグレーション オブジェクトについては、「変数に既存のコンフィグレーション オブジェクトを割り当てる」で説明したように、find 処理を使用して変数にコンフィグレーション オブジェクトを割り当てる。
ProxyServer	プロキシ サーバを指定するコンフィグレーション オブジェクト属性。この属性は変更しないこと。
unclustered_managed_server	クラスタの ProxyServer として割り当てる、クラスタ化されていない管理対象サーバの名前。このパラメータ (unclustered_managed_server) は、引用符で囲む必要がある。

 

次の例では、myCluster という名前のクラスタが変数 mycluster に割り当てられます。その後、サーバ AnUnClusteredServer が、mycluster によって参照されるクラスタの属性 ProxyServer に割り当てられます。

create Cluster "myCluster" as mycluster;
set mycluster.ProxyServer "AnUnClusteredServer";

新しいドメインを作成する際のコンフィグレーション オプションを設定する

次のように、set 処理を使用して、ドメインのコンフィグレーション オプションを指定することもできます。

set configuration_option value;

表 4-10 では、値を指定する必要があるパラメータについて説明します。

表 4-10 コンフィグレーション オプションの set 処理のパラメータ

パラメータ	説明
configuration_option	定義するコンフィグレーション オプションの名前。新しいドメインを作成する際に指定できるコンフィグレーション オプションについては、表 4-11 を参照。
value	コンフィグレーション オプションに割り当てる値。このパラメータ (value) は、引用符で囲む必要がある。

 

次の例では、Windows の [スタート] メニューにドメインのショートカットは作成されません。

set CreateStartMenu "false";

表 4-11 では、set 処理を使用して指定できるコンフィグレーション オプションについて説明します。

表 4-11 新しいドメインの作成時に set 処理を使用して指定されるコンフィグレーション オプション

コンフィグレーション オプション	指定する値
AllowCasualUpdate	拡張テンプレートを追加せずにドメインの更新を許可するかどうか。このオプションの有効な値は常に true である。つまり、拡張テンプレートを追加してもしなくてもドメインの更新は許可される。
AppDir	指定されたテンプレートに従って、アプリケーションに別のディレクトリが必要な場合のアプリケーション ディレクトリの絶対パス名。別のアプリケーション ディレクトリが不要な場合は、この設定は影響しない。 注意 : このオプションは、新しいドメインの作成時および既存のドメインの拡張時に使用できる。
CreateStartMenu	Windows の [スタート] メニューにドメインのショートカットを作成するかどうか。このオプションには、次の値が有効である。 true - ショートカットを作成する (デフォルト)。 false - ショートカットを作成しない。
JavaHome	サーバの起動時に使用される Java 2 SDK ディレクトリの絶対パス名。
OverwriteDomain	すでに存在するドメインを上書きするかどうか。残しておくドメインのバックアップ コピーを必ずとるようにする。デフォルトは false。
ServerStartMode	ドメインの起動モード。このオプションには、次の値が有効である。 dev - サーバを開発モードで起動する (デフォルト)。 prod - サーバをプロダクション モードで起動する。 ドメインの起動モードの選択の詳細については、「起動モードの選択」を参照。

 

クラスタにサーバを割り当てる

クラスタにサーバを割り当てるには、assign Server 処理を次のように使用します。

assign Server "server" to Cluster "cluster";

表 4-12 では、値を指定する必要がある assign Server 処理パラメータについて説明します。

表 4-12 assign Server 処理のパラメータ 

パラメータ	説明
server	クラスタに割り当てるサーバの名前。クラスタに複数のサーバを割り当てるには、各サーバ名をカンマで区切って指定する。サーバ名は、引用符で囲む必要がある。
cluster	サーバを割り当てるクラスタの名前。1 つのサーバは、1 つのクラスタにしか割り当てることができない。クラスタ名は、引用符で囲む必要がある。

 

次の例では、myServer1 という名前のサーバと myServer2 という名前のサーバがクラスタ myCluster に割り当てられます。

assign Server "myServer1,myServer2" to Cluster "myCluster";

サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる

サーバまたはクラスタにドメイン内のすべてのアプリケーションまたはサービスを割り当てるには、assign all 処理を次のように使用します。

• サーバまたはクラスタにすべてのアプリケーションを割り当てるには、assign all Applications 処理を次のように使用する。

assign all Applications to Target "server_or_clusters"

次の例では、ドメイン内のすべてのアプリケーションが対象 AdminServer および Cluster1 に割り当てられます。

assign all Applications to Target "adminServer,cluster1";

• サーバまたはクラスタにすべてのサービスを割り当てるには、assign all Services 処理を次のように使用する。

assign all Services to Target "server_or_clusters";

次の例では、ドメイン内のすべてのサービスが対象 AdminServer および Cluster1 に割り当てられます。

assign all Services to Target "adminServer,cluster1";

表 4-13 では、値を指定する必要がある唯一の assign all 処理パラメータについて説明します。

表 4-13 assign all 処理のパラメータ 

パラメータ	説明
server_or_clusters	アプリケーションまたはサービスを割り当てるサーバまたはクラスタの名前。複数のサーバ名またはクラスタ名を指定するには、カンマで区切る。対象のサーバおよびクラスタの名前は、引用符で囲む必要がある。

 

assign all Services 処理を使用した場合、ドメインの config.xml で定義されているか、またはこのスクリプトで追加した以下のサービスのすべてが対象のサーバまたはクラスタに割り当てられます。

• MigratableRMIService
• Shutdownclass
• Startupclass
• FileT3
• RMCFactory
• MailSession
• MessagingBridge
• JMSConnectionFactory
• JDBCConnectionPool
• JDBCMultipool
• JDBCTxDataSource
• JDBCDataSource
• JDBCPoolComp
• JoltConnectionPool
• WLECConnectionPool
• WTCServer

サーバまたはクラスタに個々のアプリケーションを割り当てる

サーバまたはクラスタに個々のアプリケーションおよびアプリケーション コンポーネント (Web アプリケーションや EJB モジュールなど) を割り当てるには、assign Application 処理を次のように使用します。

assign Application "application_names" to Target "server_or_clusters";

表 4-14 では、値を指定する必要がある assign Application 処理パラメータについて説明します。

表 4-14 assign Application 処理のパラメータ 

パラメータ	説明
application_names	サーバまたはクラスタに割り当てるアプリケーションまたはコンポーネントの名前。複数のアプリケーション名を指定するには、カンマで区切る。アプリケーション コンポーネントを指定するには、次のフォーマットを使用する。 application_name.component_name 注意 : アプリケーション コンポーネントを指定するためのセパレータとして . (ピリオド) が使われるので、アプリケーションまたはコンポーネントの名前にピリオドを使用することはできない。
server_or_clusters	アプリケーションまたはサービスを割り当てるサーバまたはクラスタの名前。複数のサーバ名またはクラスタ名を指定するには、カンマで区切る。対象のサーバおよびクラスタの名前は、引用符で囲む必要がある。

 

次の例では、MedRecEAR という名前のアプリケーションと PhysicianEAR という名前のアプリケーションがサーバ myServer1 に割り当てられます。

assign Application "MedRecEAR, PhysicianEAR" to Target "myServer1";

次の例では、アプリケーション MedRecEAR のアプリケーション コンポーネント SessionEJB がサーバ MedRecServer に割り当てられます。

assign Application "MedRecEAR.SessionEJB" to Target "MedRecServer";

サーバまたはクラスタに個々のサービスを割り当てる

次のように、名前やカテゴリを使用して、サーバまたはクラスタに個々のサービスを割り当てることができます。

assign service_type "service_names" to Target "server_or_clusters";

表 4-15 では、サーバまたはクラスタに個々のサービスを割り当てる際に値を指定する必要がある assign 処理パラメータについて説明します。

表 4-15 個々のサービスを割り当てるための assign 処理のパラメータ 

パラメータ	説明
service_type	割り当てるサービスのタイプ。「サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる」に記載されているサービスのほかに、以下のサービス カテゴリも個々に割り当てることができる。 JMSServer JMSDistributedQueue JMSDistributedTopic
service_names	サーバまたはクラスタに割り当てるサービスの名前。複数のサービス名を指定するには、カンマで区切る。service_type パラメータを使用して指定したタイプのすべてのサービスを割り当てる場合は、このパラメータにアスタリスクを指定する。service_names パラメータは、引用符で囲む必要がある。
server_or_clusters	サービスを割り当てるサーバまたはクラスタの名前。複数のサーバ名またはクラスタ名を指定するには、カンマで区切る。対象のサーバおよびクラスタの名前は、引用符で囲む必要がある。

 

次の例では、サービス MedRecJMSServer がサーバ myServer1 に割り当てられます。

assign JMSServer "MedRecJMSServer" to Target "myServer1";

次の例では、すべての JMS サーバが myServer1 に割り当てられます。

assign JMSServer "*" to Target "myServer1";

セキュリティ割り当てを生成する

新しいドメインを作成する際に、以下の割り当てを実行できます。

• グループへのユーザの割り当て - 個々のユーザを特定のグループのメンバーとして指定できます。グループを使用すると、複数のユーザを同時に管理できます。通常、各ユーザを個々に管理するよりも効率的です。

注意 : ユーザを作成すると、自動的に Administrators グループに割り当てられます。

• グループへのグループの割り当て - セキュリティ管理をさらに細かく設定するために、あるグループを別のグループのサブグループとして指定できます。

グループにユーザを割り当てるには、assign User 処理を次のように使用します。

assign User "username" to Group "group";

グループにグループを割り当てるには、assign Group 処理を次のように使用します。

assign Group "group" to Group "group";

表 4-16 では、グループにユーザおよびグループを割り当てる際に値を指定する必要がある assign 処理パラメータについて説明します。

表 4-16 assign Users および assign Groups 処理のパラメータ

パラメータ	説明
username	特定のグループに割り当てるユーザの名前。ユーザ名は、引用符で囲む必要がある。
group	ユーザまたはグループを割り当てるグループ、または別のグループに割り当てるグループの名前。グループ名は、引用符で囲む必要がある。

 

次の例では、ユーザ weblogic がグループ Monitors に割り当てられ、グループ Deployers がグループ Monitors のサブグループとして指定されます。

assign User "weblogic" to Group "Monitors";
assign Group "Deployers" to Group "Administrators";

Unassign 処理を使用して割り当てを解除する

assign コマンドと同じパラメータを使用して、unassign 処理によって割り当てを解除できます。そのためには、assign を unassign に、to 演算子を from に変更します。

以下は、unassign 処理の使用例です。

unassign Application "MedRecEAR, PhysicianEAR" from Target "myServer1";
unassign all Services from Target "adminServer,cluster1";
unassign User "weblogic" from Group "Monitors";

コンフィグレーション オブジェクトを削除する

コンフィグレーション オブジェクトを削除するには、delete 処理を次のように使用します。

delete variable;

表 4-17 では、値を指定する必要がある唯一の delete 処理パラメータについて説明します。

表 4-17 delete 処理のパラメータ 

パラメータ	説明
variable	コンフィグレーション オブジェクトの指定に使用されるユーザ定義の変数。 新しいコンフィグレーション オブジェクトについては、「コンフィグレーション オブジェクトを作成する」で説明したように、作成プロセス中に変数にコンフィグレーション オブジェクトを割り当てる。 既存のコンフィグレーション オブジェクトについては、「変数に既存のコンフィグレーション オブジェクトを割り当てる」で説明したように、find 処理を使用して変数にコンフィグレーション オブジェクトを割り当てる。 注意 : 管理サーバについては、名前またはコンフィグレーションを変更することのみ可能。管理サーバ自体は削除できない。

 

次の例では、s2 (つまり server_2) によって参照される Server コンフィグレーション オブジェクトが削除されます。

delete s2;

手順 3 : ドメインを作成する

手順 2 で定義したコンフィグレーション設定を使用してドメインを作成するには、write 処理を次のように使用します。

write domain to "domain_name";

表 4-18 では、値を指定する必要がある唯一の write 処理パラメータについて説明します。

表 4-18 write 処理のパラメータ 

パラメータ	説明
domain_name	ドメインの名前を含む、ドメインを作成するディレクトリの絶対パス名。パス名は、引用符で囲む必要がある。 注意 : weblogic という名前のドメインは作成しない。この名前は WebLogic Server の内部使用のために予約されている。

 

次の例では、C:¥bea¥user_projects¥ ディレクトリに、wlsDomain というドメインが作成されます。

write domain to "C:¥bea¥user_projects¥wlsDomain";

手順 4 : コンフィグレーション テンプレートを閉じる

コンフィグレーション テンプレートを閉じるには、close 処理を次のように使用します。

close template;

コンフィグレーションの定義が完了したら、スクリプトを保存します。必要に応じてスクリプトに名前を付け、「サイレントモードでの開始」で説明したように、スクリプトの相対パス名または絶対パス名を config コマンドに渡すことができます。

 

---

サイレントモードで既存のドメインを拡張するためのスクリプトの作成

以下の節では、既存のドメインを拡張するためのスクリプトで実行する必要がある手順を説明します。

• 手順 1 : ドメイン ディレクトリを選択する
• 手順 2 : ドメインに拡張テンプレートを追加する
• 手順 3 : 既存のコンフィグレーション情報を編集する (省略可能)
• 手順 4 : ドメインを更新する
• 手順 5 : ドメインを閉じる

注意 : この節で説明する各処理の末尾には、セミコロンを付ける必要があります。

手順 1 : ドメイン ディレクトリを選択する

アプリケーションやサービスを追加して更新するドメイン ディレクトリを選択するには、read 処理を次のように使用します。

read domain from "domain_directory_name";

表 4-19 では、値を指定する必要がある唯一の read domain 処理パラメータについて説明します。

表 4-19 read domain 処理のパラメータ 

パラメータ	説明
domain_directory_name	更新する既存のドメイン ディレクトリの絶対パス名。パス名は、引用符で囲む必要がある。

 

次の例では、mydomain という名前のドメインの絶対パス名が指定されています。

read domain from "C:¥bea¥user_projects¥domains¥mydomain";

手順 2 : ドメインに拡張テンプレートを追加する

拡張テンプレートでは、既存のドメインの拡張に使用できる、JDBC または JMS コンポーネント、起動クラス、停止クラスなどのアプリケーションやサービスが定義されます。add 処理を使用して、手順 1 で read domain 処理によって指定したドメインに拡張テンプレートを追加します。

add template extension_template_jar_name;

表 4-20 では、値を指定する必要がある唯一の add template 処理パラメータについて説明します。

表 4-20 add template 処理のパラメータ 

パラメータ	説明
extension_template_jar_name	拡張テンプレート ファイルの名前を含む、拡張テンプレートの絶対パス名。パス名は、引用符で囲む必要がある。

 

次の例では、テンプレートの絶対パス名を使用して、基本的な Web アプリケーションを追加する拡張テンプレートが指定されています。

add template "C:¥bea¥weblogic81¥common¥templates¥applications¥DefaultWebApp.jar";

手順 3 : 既存のコンフィグレーション情報を編集する (省略可能)

デフォルトのコンフィグレーション情報を編集することで、新しいコンフィグレーション オブジェクトの作成、コンフィグレーション オブジェクト属性の既存の値の編集、コンフィグレーション オブジェクトの削除、およびサーバやクラスタへのアプリケーションやサービスの割り当てを行うことができます。これらのタスクに使用可能な処理は、ドメインを拡張する場合も新しいドメインを作成する場合も同じです。これらの処理を使用する手順については、以下の節を参照してください。

• コンフィグレーション オブジェクトを作成する
• 変数に既存のコンフィグレーション オブジェクトを割り当てる
• コンフィグレーション オブジェクト属性を設定する
• コンフィグレーション オブジェクトを削除する
• サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる
• サーバまたはクラスタに個々のアプリケーションを割り当てる
• サーバまたはクラスタに個々のサービスを割り当てる

ドメインを拡張する際にコンフィグレーション オプションを設定することもできます。これについては、「既存のドメインを拡張する際のコンフィグレーション オプションを設定する」で説明されています。

サイレントモードでは、セキュリティ オブジェクトを除く、有効なコンフィグレーション オブジェクトとその子要素を作成および編集できます。有効なコンフィグレーション オブジェクトの詳細については、『コンフィグレーション リファレンス』(http://edocs.beasys.co.jp/e-docs/wls/docs81/config_xml/index.html) を参照してください。

既存のドメインを拡張する際のコンフィグレーション オプションを設定する

ドメインを拡張する際に、次のように、set 処理を使用して、ドメインのコンフィグレーション オプションを指定できます。

set configuration_option value;

表 4-21 では、値を指定する必要があるパラメータについて説明します。

表 4-21 コンフィグレーション オプションの set 処理のパラメータ

パラメータ	説明
configuration_option	定義するコンフィグレーション オプションの名前。既存のドメインを拡張する際に指定できるコンフィグレーション オプションについては、表 4-22 を参照。
value	コンフィグレーション オプションに割り当てる値。このパラメータ (value) は、引用符で囲む必要がある。

 

表 4-22 では、既存のドメインを拡張する際に set 処理を使用して指定できるコンフィグレーション オプションについて説明します。

表 4-22 ドメインの拡張時に set 処理を使用して指定されるコンフィグレーション オプション

コンフィグレーション オプション	指定する値
AppDir	指定されたテンプレートに従って、アプリケーションに別のディレクトリが必要な場合のアプリケーション ディレクトリの絶対パス名。別のアプリケーション ディレクトリが不要な場合は、この設定は影響しない。 注意 : このオプションは、新しいドメインの作成時および既存のドメインの拡張時に使用できる。
ReplaceDuplicates	拡張テンプレートから更新されたコンフィグレーションとの間に衝突がある場合、ドメインで元のコンフィグレーションを保持するか、拡張テンプレートのコンフィグレーションで上書きするか。

 

手順 4 : ドメインを更新する

read domain 処理で開いたドメインを更新するには、update 処理を次のように使用します。

update domain;

注意 : ドメインを更新するには、add template 処理を指定しておく必要があります。

手順 5 : ドメインを閉じる

ドメインを閉じるには、close 処理を次のように使用します。

close domain;

コンフィグレーションの定義が完了したら、スクリプトを保存します。必要に応じてスクリプトに名前を付け、「サイレントモードでの開始」で説明したように、スクリプトの相対パス名または絶対パス名を config コマンドに渡すことができます。

 

---

サイレントモード コンフィグレーション用のサンプル コンフィグレーション スクリプト

以下のサンプル スクリプトは、サイレントモードのコンフィグレーションを使用してドメインを作成および更新するために必要な基本的な概念を示します。

コンフィグレーション テンプレートから新しいドメインを作成するためのサンプル スクリプト

以下の節では、コンフィグレーション テンプレートから新しいドメインを作成するために使用できるサンプル スクリプトを提供します。ここには、次のトピックがあります。

• Basic WebLogic Server Domain テンプレートに基づくサンプル スクリプト
• Avitek Medical Records Sample Domain テンプレートに基づくサンプル スクリプト
• Basic WebLogic Portal Domain テンプレートに基づくサンプル スクリプト

Basic WebLogic Server Domain テンプレートに基づくサンプル スクリプト

次のサンプル スクリプトは、Basic WebLogic Server Domain テンプレートに基づいています。このスクリプトは、製品インストール ディレクトリ common¥templates¥silent_scripts にあります。

左側の余白に示されている数字は、スクリプト内で主要なタスクを実行するコードの各セクションの先頭を示します。特定のタスクの詳細については、表 4-23 でこの数字に対応する説明を参照してください。

コード リスト 4-1 Basic WebLogic Server Domain に基づいて新しいドメインを作成するためのサンプル スクリプト

read template from "C:¥bea¥weblogic81¥common¥templates¥domains¥wls.jar";
//////////////////////////////////////////////////////////////////////////
//管理サーバを検索してコンフィグレーションする
/////////////////////////////////////////////////////////////////////////


find Server "myserver" as s1;
set s1.ListenAddress "";
set s1.ListenPort "7001";
set s1.SSL.Enabled "true";
set s1.SSL.ListenPort "7002"
//////////////////////////////////////////////////////////////////////////
//JMSQueue を作成する
//////////////////////////////////////////////////////////////////////////
//JMSServer を先に作成する必要がある


create JMSServer "myJMSServer" as jmsserver;
create JMSQueue "myJMSQueue" as myq;
//必須属性
set myq.JNDIName "jms/myjmsqueue";
//必須属性
set myq.JMSServer "myJMSServer";
//省略可能な属性
//set myq.StoreEnabled "false";
//target "myJMSServer" to server "myserver"
assign JMSServer "myJMSServer" to target "myserver";
//////////////////////////////////////////////////////////////////////////
//JDBCConnectionPool を作成する
//////////////////////////////////////////////////////////////////////////


create JDBCConnectionPool "demoPool" as mypool;
//必須属性
set mypool.DriverName "com.pointbase.jdbc.jdbcUniversalDriver";
//必須属性
set mypool.URL "jdbc:pointbase:server://localhost:9092/demo";
//必須属性
set mypool.Password "PBPUBLIC";
//省略可能な属性 (db ユーザの設定を推奨)
set mypool.Properties "user=PBPUBLIC";
//target all JDBC connection pools to server "myserver"
assign JDBCConnectionPool "*" to target "myserver";
//////////////////////////////////////////////////////////////////////////
//既存のアプリケーションを対象として指定する
//////////////////////////////////////////////////////////////////////////
//現在のドメイン テンプレートに存在するアプリケーションのみを対象として指定する


//assign application "*" to target "myserver";
//////////////////////////////////////////////////////////////////////////
//Admin ユーザを検索し、テンプレートに設定されていないパスワードを設定する

//////////////////////////////////////////////////////////////////////////


find User "weblogic" as u1;
set u1.password "weblogic";
//////////////////////////////////////////////////////////////////////////
//ドメインを書き出す
//////////////////////////////////////////////////////////////////////////


set OverwriteDomain "true";


write domain to "C:¥bea/user_projects/domains/wls";
//////////////////////////////////////////////////////////////////////////
//作業の完了を示すためにドメインを閉じる
//////////////////////////////////////////////////////////////////////////


close template;

WebLogic Server Domain テンプレートに基づいたサンプル スクリプトでは、以下の表に定義されているタスクが実行されます。

表 4-23 WebLogic Server Domain テンプレートに基づくサンプル スクリプトに示されている主なタスク 

コードのセクション	実行されるタスク
	Basic WebLogic Server Domain テンプレートを選択する。詳細については、「手順 1 : コンフィグレーション テンプレートを選択する」を参照。
	管理サーバをコンフィグレーションする。詳細については、「手順 2 : コンフィグレーション情報を編集する」にある以下の関連する節を参照。 変数に既存のコンフィグレーション オブジェクトを割り当てる コンフィグレーション オブジェクト属性を設定する
	JMS キューを作成する。詳細については、「手順 2 : コンフィグレーション情報を編集する」内の以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する コンフィグレーション オブジェクト属性を設定する サーバまたはクラスタに個々のサービスを割り当てる
	JDBC 接続プールを作成する。 JDBC 接続プールの Properties 属性を指定する場合は、必ず、使用中の JDBC ドライバに必要なすべてのプロパティを指定する。JDBC 接続プールの Properties 属性の設定に関するガイドラインについては、「JDBC 接続プールの Properties 属性の設定に関する考慮事項」を参照。コード リスト 4-1 では、次の Properties の指定が適切である。これは、JDBC Pointbase ドライバが user の定義のみを必要とするためである。 set mypool.Properties "user=PBPUBLIC"; プロパティは、個別に割り当てることもできる。たとえば、ユーザ名を定義する場合は、次のコマンドを指定することもできる。 set mypool.UserName "myname"; 詳細については、「手順 2 : コンフィグレーション情報を編集する」にある以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する コンフィグレーション オブジェクト属性を設定する サーバまたはクラスタに個々のサービスを割り当てる
	ドメイン内に存在するアプリケーションを任意で myserver に割り当てる。デフォルトでは、Basic WebLogic Server Domain にアプリケーションは含まれていない。詳細については、「サーバまたはクラスタに個々のアプリケーションを割り当てる」を参照。
	ユーザ weblogic のパスワードを更新する。詳細については、「手順 2 : コンフィグレーション情報を編集する」内の以下の関連する節を参照。 変数に既存のコンフィグレーション オブジェクトを割り当てる セキュリティ割り当てを生成する 注意 : ドメインにすでに定義されているセキュリティ情報を確認するには、ドメイン テンプレート JAR ファイル内の security.xml ファイルを参照する。ユーザ パスワードが "????????" (未設定を意味する) に設定されている場合は、サイレント スクリプトでパスワードを定義する必要がある。
	OverwriteDomain コンフィグレーション オプションを "true" に設定し、指定のドメインが存在する場合にそれを上書きできるようにする。詳細については、「新しいドメインを作成する際のコンフィグレーション オプションを設定する」を参照。
	C:¥bea¥user_projects¥domains¥wls にドメインを作成する。詳細については、「手順 3 : ドメインを作成する」を参照。
	コンフィグレーション テンプレートを閉じる。詳細については、「手順 4 : コンフィグレーション テンプレートを閉じる」を参照。

 

Avitek Medical Records Sample Domain テンプレートに基づくサンプル スクリプト

次のサンプル スクリプトは、Avitek Medical Records Sample Domain テンプレートに基づいています。このスクリプトは、製品インストール ディレクトリ common¥templates¥silent_scripts にあります。

左側の余白に示されている数字は、スクリプト内で主要なタスクを実行するコードの各セクションの先頭を示します。特定のタスクの詳細については、表 4-24 でこの数字に対応する説明を参照してください。

コード リスト 4-2 Avitek Medical Records Sample Domain に基づいて新しいドメインを作成するためのサンプル スクリプト

/* コンフィグレーション テンプレートから新しいドメインを作成する */


read template from "C:¥bea¥weblogic81¥common¥templates¥domains¥medrec.jar";
 
//medrec.jar にはすでに、定義済みのユーザ "weblogic" のパスワードが設定されている
//設定済みのパスワードがないテンプレートには、パスワードを設定する必要がある


create User "user1" as u1;
set u1.Password "password";
//"user1" はデフォルトで "Administrators" グループに属する
unassign User "user1" from Group "Administrators"
assign User "user1"to Group "Deployers"; 
 
//サーバの作成によって自動コンフィグレーションがトリガされる


create Server "myServer1" as s1;
set s1.ListenPort "8001";
set s1.SSL.Enabled "true";
set s1.SSL.ListenPort "8002"; 
 
//子要素を検索し、その属性を設定する


find Server.ExecuteQueue "MedRecServer.default" as eq1;
set eq1.ThreadCount "25";
 
//アプリケーションがない場合は、それらの割り当てを行わない 


assign all Applications to Target "MedRecServer";
assign all Services to Target "MedRecServer, myServer1";
//JMSServer は、"assign all Services" によって割り当てることができない


assign JMSServer "*" to Target "myServer1"; 
 


set ServerStartMode "prod";
set JavaHome "C:¥bea¥jrockit81sp3_142_04";
set CreateStartMenu "false";
//MedRec テンプレートでアプリケーションの分割が指定されていないので、ここでは影響しない
set AppDir "C:¥bea¥user_projects¥applications¥myMedRec"; 
 


write domain to "C:¥bea¥user_projects¥domains¥myMedRec";


close template; 

Avitek Medical Records Sample Domain テンプレートに基づいたサンプル スクリプトでは、以下の表に定義されているタスクが実行されます。

表 4-24 Avitek Medical Records Sample Domain テンプレートに基づくサンプル スクリプトに示されている主なタスク 

コードのセクション	実行されるタスク
	Avitek Medical Records Sample テンプレートを選択する。詳細については、「手順 1 : コンフィグレーション テンプレートを選択する」を参照。
	ドメインのユーザを定義する。詳細については、「手順 2 : コンフィグレーション情報を編集する」内の以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する 変数に既存のコンフィグレーション オブジェクトを割り当てる セキュリティ割り当てを生成する Unassign 処理を使用して割り当てを解除する 注意 : ドメインにすでに定義されているセキュリティ情報を確認するには、ドメイン テンプレート JAR ファイル内の security.xml ファイルを参照する。ユーザ パスワードが "????????" (未設定を意味する) に設定されている場合は、サイレント スクリプトでパスワードを定義する必要がある。
	サーバ myServer1 を定義してコンフィグレーションする。詳細については、「手順 2 : コンフィグレーション情報を編集する」内の以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する コンフィグレーション オブジェクト属性を設定する
	子要素 ExecuteQueue を定義してコンフィグレーションする。詳細については、「手順 2 : コンフィグレーション情報を編集する」にある以下の関連する節を参照。 変数に既存のコンフィグレーション オブジェクトを割り当てる コンフィグレーション オブジェクト属性を設定する
	すべてのアプリケーションとサービスを、MedRecServer および myServer1 に割り当てる。詳細については、「サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる」を参照。
	すべての JMS サーバを myserver1 に割り当てる (JMS サーバは、手順 5 で説明されているすべてのサービスを割り当てる方法を使用して割り当てることができない)。詳細については、「サーバまたはクラスタに個々のサービスを割り当てる」を参照。
	複数のコンフィグレーション オプションを設定する。詳細については、「新しいドメインを作成する際のコンフィグレーション オプションを設定する」を参照。
	C:¥bea¥user_projects¥domains¥myMedRec にドメインを作成する。詳細については、「手順 3 : ドメインを作成する」を参照。
	コンフィグレーション テンプレートを閉じる。詳細については、「手順 4 : コンフィグレーション テンプレートを閉じる」を参照。

 

Basic WebLogic Portal Domain テンプレートに基づくサンプル スクリプト

次のサンプル スクリプトは、Basic WebLogic Portal Domain テンプレートに基づいています。

左側の余白に示されている数字は、スクリプト内で主要なタスクを実行するコードの各セクションの先頭を示します。特定のタスクの詳細については、表 4-25 でこの数字に対応する説明を参照してください。

コード リスト 4-3 Basic WebLogic Portal Domain に基づいて新しいドメインを作成するためのサンプル スクリプト

/* コンフィグレーション テンプレートから新しいドメインを作成する */


read template from "C:¥bea¥weblogic81¥common¥templates¥domains¥wlp.jar";
 
//設定済みのパスワードがないテンプレートには、パスワードを設定する必要がある


create User "system" as u1;
set u1.Password "password";
find User "weblogic" as u2;
set u2.Password "password";

//サーバを検索し、その属性を設定する


find Server "portalServer" as s1;
set s1.Name "adminServer";
set s1.ListenPort "7001";
set s1.SSL.Enabled "true";
set s1.SSL.ListenPort "7002";



set ServerStartMode "dev";
set JavaHome "C:¥bea¥jrockit81sp3_142_04";
set CreateStartMenu "false";

//アプリケーションがない場合は、それらの割り当てを行わない 


assign all Applications to Target "adminServer";
assign all Services to Target "adminServer";



assign JMSConnectionFactory "*" to Target "adminServer";
//JMSServer は、"assign all Services" によって割り当てることができない
assign JMSServer "*" to Target "adminServer"; 

//XA ドライバを使用するデータベースに切り替える場合は、以下の行のコメントを解除する必要がある
//portalPool JDBC 接続プールでは、SuportsLocalTransaction が
//"false" に設定されている必要がある
//find JDBCConnectionPool "portalPool" as portalcp; 
//set portalcp.SupportsLocalTransaction "false";
 


write domain to "C:¥bea¥user_projects¥domains¥mywlp";


close template; 

Basic WebLogic Portal Domain テンプレートに基づいたサンプル スクリプトでは、以下の表に定義されているタスクが実行されます。

表 4-25 Basic WebLogic Portal Domain テンプレートに基づくサンプル スクリプトに示されている主なタスク 

コードのセクション	実行されるタスク
	Basic WebLogic Portal Domain テンプレートを選択する。詳細については、「手順 1 : コンフィグレーション テンプレートを選択する」を参照。
	ドメインのユーザを定義する。詳細については、「手順 2 : コンフィグレーション情報を編集する」にある以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する 変数に既存のコンフィグレーション オブジェクトを割り当てる セキュリティ割り当てを生成する 注意 : ドメインにすでに定義されているセキュリティ情報を確認するには、ドメイン テンプレート JAR ファイル内の security.xml ファイルを参照する。ユーザ パスワードが "????????" (未設定を意味する) に設定されている場合は、サイレント スクリプトでパスワードを定義する必要がある。
	サーバ portalServer を検索してコンフィグレーションする。詳細については、「手順 2 : コンフィグレーション情報を編集する」にある以下の関連する節を参照。 変数に既存のコンフィグレーション オブジェクトを割り当てる コンフィグレーション オブジェクト属性を設定する
	複数のコンフィグレーション オプションを設定する。詳細については、「新しいドメインを作成する際のコンフィグレーション オプションを設定する」を参照。
	すべてのアプリケーションとサービスを、admin および desktop に割り当てる。詳細については、「サーバまたはクラスタにすべてのアプリケーションまたはサービスを割り当てる」を参照。
	すべての JMS 接続ファクトリおよびサーバを desktop に割り当てる (JMS サーバは、手順 6 で説明されているすべてのサービスを割り当てる方法を使用して割り当てることができない)。詳細については、「サーバまたはクラスタに個々のサービスを割り当てる」を参照。
	portalPool JDBC 接続プールを検索し、SupportsLocalTransaction オプションを "false" に設定する。XA ドライバを使用するデータベースに切り替える場合は、これらのコード行のコメントを解除する必要がある。
	C:¥bea¥user_projects¥domains¥mywlp にドメインを作成する。詳細については、「手順 3 : ドメインを作成する」を参照。
	コンフィグレーション テンプレートを閉じる。詳細については、「手順 4 : コンフィグレーション テンプレートを閉じる」を参照。

 

新しいドメインを作成し、拡張テンプレートを使用して更新するためのサンプル スクリプト

以下のサンプル スクリプトでは、Basic WebLogic Server Domain テンプレートに基づいて新しいドメインを作成し、それを Default WebApp 拡張テンプレートを使用して更新します。

左側の余白に示されている数字は、スクリプト内で主要なタスクを実行するコードの各セクションの先頭を示します。特定のタスクの詳細については、表 4-26 でこの数字に対応する説明を参照してください。

コード リスト 4-4 新しいドメインを作成し、拡張テンプレートを使用して更新するためのサンプル スクリプト

/* コンフィグレーション テンプレートからドメインを作成し、更新する */
 


read template from "C:¥bea¥weblogic81¥common¥templates¥domains¥wls.jar";
 


find User "weblogic" as admin;
set admin.Password "newPassword";
create User "user1" as u1;
set u1.Password "password";
assign User "user1" to Group "Deployers";
 


set ServerStartMode "dev";
set JavaHome "C:\bea\jrockit81sp3_142_04";
set CreateStartMenu "false";
 


write domain to "C:¥bea¥user_projects¥domains¥wls";


close template;     
 
/* 既存のドメインを更新する */


read domain from "C:¥bea¥user_projects¥domains¥wls";
 
//追加する拡張テンプレートとの間に重複がある場合、元のコンフィグレーションを保持する
//wls テンプレートにアプリケーションがないので、実際には、ここではこれは必要ない


set ReplaceDuplicates "false";
 
//拡張テンプレートを追加する


add template
    "C:\bea\weblogic81\common\templates\applications\DefaultWebApp.jar";
 

assign Application "DefaultWebApp" to Target "myserver";
 


update domain;


close domain;

このサンプル スクリプトでは、以下の表に定義されたタスクが実行されます。

表 4-26 新しいドメインを作成し、拡張テンプレートを使用してそれを更新するためのサンプル スクリプトに示されている主要なタスク 

コードのセクション	実行されるタスク
	Basic WebLogic Server Domain テンプレートを選択する。詳細については、「手順 1 : コンフィグレーション テンプレートを選択する」を参照。
	ドメインのユーザを定義する。詳細については、「手順 2 : コンフィグレーション情報を編集する」内の以下の関連する節を参照。 コンフィグレーション オブジェクトを作成する 変数に既存のコンフィグレーション オブジェクトを割り当てる セキュリティ割り当てを生成する 注意 : ドメインにすでに定義されているセキュリティ情報を確認するには、ドメイン テンプレート JAR ファイル内の security.xml ファイルを参照する。ユーザ パスワードが "????????" (未設定を意味する) に設定されている場合は、サイレント スクリプトでパスワードを定義する必要がある。
	複数のコンフィグレーション オプションを設定する。詳細については、「新しいドメインを作成する際のコンフィグレーション オプションを設定する」を参照。
	C:¥bea¥user_projects¥domains¥wls にドメインを作成する。詳細については、「手順 3 : ドメインを作成する」を参照。
	コンフィグレーション テンプレートを閉じる。詳細については、「手順 4 : コンフィグレーション テンプレートを閉じる」を参照。
	拡張するドメイン ディレクトリを選択する。詳細については、「手順 1 : ドメイン ディレクトリを選択する」を参照。
	ReplaceDuplicate コンフィグレーション オプションを "false" に設定することで、拡張テンプレートに定義されている重複するコンフィグレーション オプションが上書きされないように指定する。詳細については、「既存のドメインを拡張する際のコンフィグレーション オプションを設定する」を参照。
	基本の Web アプリケーションをサポートするようにドメインを拡張するために、Default WebApp 拡張テンプレートからリソースをインポートする。詳細については、「手順 2 : ドメインに拡張テンプレートを追加する」を参照。
	myserver にアプリケーションを割り当てる。詳細については、「サーバまたはクラスタに個々のアプリケーションを割り当てる」を参照。
	ドメインを更新する。詳細については、「手順 4 : ドメインを更新する」を参照。
	ドメインを閉じる。詳細については、「手順 5 : ドメインを閉じる」を参照。