WebOTX Manual V10.3 (第4版) 目次を表示

---

1.2. ドメインの作成・削除

WebOTXのドメインを作成および削除する方法について説明します。 作成・削除時はWebOTXサービスが起動している必要があります。

Windows ではドメインの作成・削除は特権昇格したコマンドプロンプトから実行する必要があります。 詳しくは[ ドメインの運用操作の前に ] を参照してください。

1.2.1. ドメインの作成

1.2.1.1. ドメインの作成 (コマンド)

otxadmin create-domainコマンドで生成します。その際、新規ドメインの設定を記述した<ドメイン名>.propertiesファイルが必要になります。

新規にsampleドメインを作成する場合の手順を以下に示します。

1. UNIXの場合、WebOTX運用ユーザでログインします。
2. WebOTXインストールディレクトリ(${AS_INSTALL})に移動します。
3. WebOTXインストールディレクトリに新規ドメイン用の<ドメイン名>.propertiesファイルを準備します。 sample用のsample.propertiesはWebOTXインストールディレクトリにすでに配置されています。 sample以外のドメインを新規作成する際はsample.propertiesファイルをコピーし、<ドメイン名>.propertiesにリネームしてください。
   Caution
   ドメイン名として利用可能な文字は英数字、及び、ハイフン(-)、ピリオド(.)、アンダースコア(_)で、32文字以内を指定する必要があります。また、予約語としてadmin, cluster, proxy, batch という名前は使用することができません。
4. <ドメイン名>.propertiesファイルの設定をエディタで編集してください。 [ ドメインの作成・削除 > ドメインの作成 > propertiesファイル ] を参考に編集してください。
   Caution
   設定の際、使用するポート番号や識別名の設定が既存のドメインの設定と重複した場合、 同時にドメイン起動ができなくなるので注意してください。
   既定で作成されるdomain1ドメインの定義ファイル(domain1.properties)とsampleドメインの定義ファイル(sample.properties)の設定は排他的になっています。変更を行わなければ既定値で共存が可能です。
5. ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合 [ ドメインの作成・削除 > ドメインの作成 > ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合の設定 ] を参考に設定を変更してください。

6. otxadminコマンドを実行しドメインを作成します。このとき管理ドメインに接続する必要があります。 管理ドメインの起動方法は[ドメインの起動・停止 > 管理ドメインの起動/停止 ] を確認してください。

   otxadmin > login --user <管理ドメインのユーザ名> ---password <管理ドメインのパスワード> --port <管理ドメインのポート番号>
   otxadmin > create-domain --file="C:\WebOTX\sample.properties" sample
   ドメインの作成を開始します。この処理に数分以上かかる場合がありますが、処理が完了するまでしばらくそのままお待ちください。
   コマンド create-domain は正常に実行されました。
   		

   なお、管理ドメインの既定値は以下の通りです。

   パラメータ	既定値
   管理ドメインのユーザ	admin
   管理ドメインのパスワード	adminadmin
   管理ドメインのポート	6202

   ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合、create-domainコマンドを実行時 --domaindir オプションを指定します。

   otxadmin > login --user <管理ドメインのユーザ名> ---password <管理ドメインのパスワード> --port <管理ドメインのポート番号>
   otxadmin > create-domain --file=<ドメイン名>.properties --domaindir=<作成先ディレクトリ名> sample
   ドメインの作成を開始します。この処理に数分以上かかる場合がありますが、処理が完了するまでしばらくそのままお待ちください。
   コマンド create-domain は正常に実行されました。
   		

7. ドメイン作成が完了した後、以下のコマンドで新規作成したドメインを起動します。

   otxadmin > login --user <管理ドメインのユーザ名> ---password <管理ドメインのパスワード> --port <管理ドメインのポート番号>
   otxadmin > start-domain --remote <ドメイン名>
   		

8. 以上で作成は完了です。作成後、[ ドメインの作成・削除 > ドメインの作成 > ドメイン作成後の注意点 ] を確認してください。

1.2.1.2. ドメインの作成(統合運用管理ツール)

統合運用管理ツールでドメインを作成する場合、既に起動している管理ドメインに接続する必要があります。統合運用管理ツールの起動等の操作は[ 統合運用管理ツール(WebOTX Administrator) ] を確認してください

1. ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合[ ドメインの作成・削除 > ドメインの作成 > ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合の設定 ] を参考に設定を変更してください。
2. 統合運用管理ツールを起動し、管理ドメインに接続します。
3. WebOTX管理ドメインを選択し、右クリックから [管理対象ドメインの作成] を選択します。

   
   

4. 表示されるウィンドウのうち、必要なパラメータを入力し実行します。

   
   

5. ドメイン作成時に、より詳細なパラメータを入力する場合、[システム]メニューから [システム設定] を選択し、パラメータの表示レベルを [詳細レベルの情報を表示] に変更します。

   
   

   
   

6. ドメイン作成が完了した後、[管理対象ドメインの起動] から作成したドメインを起動します。

   
   

7. 以上で作成は完了です。作成後、[ ドメインの作成・削除 > ドメインの作成 > ドメイン作成後の注意点 ] を確認してください。

1.2.1.3. チューング機能を利用したドメインの作成

コマンド

ドメインの作成時に指定する<ドメイン名>.propertiesファイルの設定をエディタで編集してください。

なお、設定可能な項目は、コメントアウトされています。チューニング機能を利用する場合は [ ドメインの作成・削除 > ドメインの作成 > propertiesファイル ] を参考に編集してください。

                                 :
                                 :
## Tuning ###
# If you want to use the tuning feature, set following parameters. 
# tuning-attributes.enabled=false
# tuning-attributes.webApplication=true
# tuning-attributes.ejbApplication=false
# tuning-attributes.corbaApplication=false
# tuning-attributes.clients=
# tuning-attributes.servers=1
# tuning-attributes.connectionsPerClient=1
# tuning-attributes.connectTime=
# tuning-attributes.transactionsPerSecond=
# tuning-attributes.requestsPerTransaction=1
# tuning-attributes.requestProcessingTime=0
# tuning-attributes.highLoadPolicy=1

統合運用管理ツール

ドメイン作成時に表示されるウィンドウの[チューニング]タブを選択し、必要なパラメータを入力してください

1.2.1.4. ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合の設定

ドメインディレクトリの作成先を${AS_INSTALL}/domains 以外にする場合、${AS_INSTALL}/domains/admin/configのserver.policyファイルをエディタで編集します。「Basicset of required permissions granted to all remainingcode」ブロックの「java.io.FilePermission」の定義に「execute」を追記します。

これは管理ドメインから${AS_INSTALL}/domains以外に配置されたファイルを実行するためです。

//
// Copyright (C) 1998 ・・・
//
　　　　　　　　・
　　　　　　　　・
　　　　　　　　・

// Basic set of required permissions granted to all remaining code
grant {
permission java.lang.RuntimePermission "loadLibrary.*";
permission java.lang.RuntimePermission "queuePrintJob";
permission java.net.SocketPermission "*", "connect";
permission java.io.FilePermission "<<ALL FILES>>", "read,write,execute";

　　　　　　　　・
　　　　　　　　・
　　　　　　　　・

編集が終わったらファイルを保存し、設定を反映させるためにWebOTXサービスを再起動します。サービスの起動・停止方法については [ サービスの起動停止 ] を参照してください。

1.2.1.5. ドメイン作成後の注意点

対象: Linuxを利用している場合

サーバOSとしてLinuxを利用している場合、次の設定がされている環境ではRMI通信によるリモート接続が行えないため、 運用管理ツールからドメインに接続できないという問題が発生します。

• サーバの/etc/hostsファイルに次の記述がある。
  127.0.0.1 "ホスト名"
  
  

上記の条件に当てはまる場合、作成したドメインに対して次の手順でJavaシステムプロパティを設定してください。

1. 作成したドメインにログインします。

   otxadmin> login --user <ユーザ名> --password <ユーザパスワード> --port <ポート番号>
   

2. Javaシステムプロパティを設定します。

   otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名>
   

3. ドメインを再起動します。
   
   

対象: 複数のネットワークカードを利用している場合

WebOTXが動作するサーバが複数のネットワークカードを利用している場合、運用管理ツールからドメインへの接続が失敗することがあります。該当する環境を利用している場合、作成したドメインに対して次の手順でJavaシステムプロパティを設定してください。

1. 作成したドメインにログインします。

   otxadmin> login --user <ユーザ名> --password <ユーザパスワード> --port <ポート番号>

2. Javaシステムプロパティを設定します。

   otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名、または、IPアドレス>

3. ドメインを再起動します。
   
   

1.2.1.6. propertiesファイル

<ドメイン名>.propertiesファイルで設定する各プロパティについて説明します。

実際に<ドメイン名>.propertiesに記述されるのはプレフィックスを含めた完全プロパティ名です。

たとえばドメイン設定項目のhostnameの完全プロパティ名はdomain.hostnameになります。

チューニング機能設定

下記の表では<ドメイン名>.propertiesに記載するプロパティのうち、チューニング機能向けに提供しているプロパティについて記載します。