WebOTX Manual V11.1 (第6版) 目次を表示

---

OLF/TP Adapter の運用手順と設定

1. 概要

本編では、OLF/TP Adapterを動作させるために必要となる運用手順を説明しています。

2. 運用

2.1. 管理環境での運用

管理環境上でOLF/TP Adapterを運用する場合、コネクタコネクションプールの作成とコネクタリソースの登録が必要になります。

コネクタコネクションプールの作成とコネクタリソースの登録は、OLF/TP Adapterのrarファイル、 OLF/TP Adapterを利用するAPコンポーネントを配備後、運用管理コマンド(otxadmin)や運用管理コンソールを利用して行うことができます。
詳細な方法は、[ Application Server > 構築・運用 > ドメインの構築 > リソース作成・削除 ]を参照してください。

OLF/TP Adapterでは、コネクタコネクションプールの以下の属性にOLF/TP Adapter固有の値を設定してください。

コネクタコネクションプールの作成、コネクタリソースの登録が正しく行われますと運用管理コンソールの画面は以下のようになります。

WebOTX Application Server Standard上でOLF/TP Adapterを動作させる場合は、コネクタコネクションプールの作成、コネクタリソースの登録後、次の設定を行ってください。

OLF/TP Adapterを利用するAPコンポーネントの配備先によって、設定内容が異なります。

• APコンポーネントをエージェントプロセスに配備する場合
  • 「JMXエージェント上でロードする」を有効
  • 「全てのプロセスグループで使用する」を無効
  
  
• APコンポーネントをプロセスグループに配備する場合
  • 「JMXエージェント上でロードする」を無効
  • 「全てのプロセスグループで使用する」を無効
  
  

1. ツリービューで、「アプリケーション」-「リソースアダプタ」-「<アプリケーション名>」-「module」-「<アプリケーション名>」- 「engine」-「connector」-「connector-module-config」を選択し、設定を行います。
   [アプリケーションの開発 > 管理環境で動作するAPコンポーネントの開発手順 > OLF/TP Adapterの配備 > リソースアダプタの設定変更 ] にも同じ説明を載せています。すでに設定済みの場合は次の設定に進んでください。
   

   

   [APコンポーネントをエージェントプロセスに配備する場合]
   「JMXエージェント上でロードする」にチェックが入っていることを確認してください。 チェックが入っていない場合は、チェックを入れてください。
   また、「全てのプロセスグループで使用する」にチェックが入っていないことを確認してください。 チェックが入っている場合は、チェックを外してください。
   
   [APコンポーネントをプロセスグループに配備する場合]
   「JMXエージェント上でロードする」及び、「全てのプロセスグループで使用する」にチェックが入っていないことを確認してください。 チェックが入っている場合は、チェックを外してください。
   

   WebOTXが提供する運用管理コマンド(otxadmin)にて設定を行う場合、以下の属性設定を行ってください。
   [JMXエージェント上でロードするかどうかを設定する場合]
   server.applications.connector-module.<アプリケーション名>.module.<アプリケーション名>.engine.connector.connector-module-config.use-jmx-agent
   
   [全てのプロセスグループで使用するかどうかを設定する場合]
   server.applications.connector-module.<アプリケーション名>.module.<アプリケーション名>.engine.connector.connector-module-config.use-all-ejb-processgroups
   

2. ツリービューで、「リソース」-「コネクタリソース」-「登録したコネクタリソース名」を選択して右側画面で「一般」タブを選択し、設定を行います。
   

   

   [APコンポーネントをエージェントプロセスに配備する場合]
   「JMXエージェント上でロードする」にチェックが入っていることを確認してください。 チェックが入っていない場合は、チェックを入れてください。
   また、「全てのプロセスグループで使用する」にチェックが入っていないことを確認してください。 チェックが入っている場合は、チェックを外してください。
   
   [APコンポーネントをプロセスグループに配備する場合]
   「JMXエージェント上でロードする」及び、「全てのプロセスグループで使用する」にチェックが入っていないことを確認してください。 チェックが入っている場合は、チェックを外してください。
   

   WebOTXが提供する運用管理コマンド(otxadmin)にて設定を行う場合、以下の属性設定を行ってください。
   [JMXエージェント上でロードするかどうかを設定する場合]
   server.resources.connector-resource.<コネクタリソース名>.use-jmx-agent
   
   [全てのプロセスグループで使用するかどうかを設定する場合]
   server.resources.connector-resource.<コネクタリソース名>.use-all-ejb-processgroups
   

3. ツリービューで、「TPシステム」-「アプリケーショングループ」-「アプリケーショングループ名」-「プロセスグループ」-「プロセスグループ名」を 選択して右側画面で「リソース」タブを選択し、設定を行います。 「使用するコネクタリソース」で使用するコネクタリソースを指定します。 (使用しないコネクタリソースは削除してください。) また、「使用するリソースアダプタ」で使用するリソースアダプタを選択します。 (使用しないリソースアダプタは削除してください。)

   
   

   ※1つのプロセスグループにはリソースアダプタを1つだけ設定してください。

4. ドメインツリー上で、「リソース」-「コネクタコネクションプール」-「登録したコネクタコネクションプール名」を 選択し、「異常時コネクション解放」にチェックが入っていないことを確認してください。 チェックが入っている場合は、チェックを外してください。

5. 設定完了後、プロセスグループを再起動することで設定が有効になります。

2.2. 非管理環境での運用

非管理環境上でOLF/TP Adapterを運用する場合、WebOTX固有機能定義(nec-j2ee.xml)によりプール管理のプロパティを指定しておく必要があります。

詳細については、 [ アプリケーションの開発 > 非管理環境で動作するAPコンポーネントの開発手順 > OLF/TP Adapterの配備 > WebOTX固有機能定義(nec-j2ee.xml)の編集 ] を参照してください。

3. 設定

OLF/TP Adapterを使用するには、OLF/TP Adapterの動作環境についての設定を行う必要があります。OLF/TP Adapterでは、実行時に通信環境定義(OLFAdapter.ini)、端末定義(OLFAdapter.xml)を参照して動作します。これらのファイルは通信に使用するリソース及び接続先の情報を定義しています。

これらの設定に加え、配備記述子(ra.xml)とよばれるOLF/TP Adapterのプロパティを設定する必要があります。配備記述子はJ2EEコネクタアーキテクチャ準拠の設定ファイルで、リソースアダプタのプロパティ情報を設定します。

非管理環境で動作させる場合は、コネクションプールの設定などをWebOTX固有機能定義(nec-j2ee.xml)で定義する必要があります。

3.1. 通信環境定義(OlfAdapter.ini)

OLF/TP Adapterを使用してバックエンドサーバと通信するには、まず通信に使用するリソースを定義します。通信環境定義は以下のファイルを編集してください。

<OLF/TP Adapterインストールディレクトリ>/Adapter/OLFTP/Run/conf/OlfAdapter.ini

本定義では、以下の情報を定義します。

（注意：定義を変更する場合は、APサーバを停止してください。）

3.2. 端末定義(OlfAdapter.xml)

OLF/TP Adapterを使用しての通信相手となるホストの情報を定義します。端末定義は以下のファイルを編集してください。

<OLF/TP Adapterインストールディレクトリ>/Adapter/OLFTP/Run/conf/OlfAdapter.xml

本定義では、以下の情報を定義します。

（注意：定義を変更する場合は、APサーバを停止してください。）

3.3. 配備記述子(ra.xml)

OLF/TP Adapterのプロパティを指定するファイルです。OLF/TP Adapterのプロパティは、<config-property>タグで指定します。
配備記述子の内容を編集するには以下のファイルを編集してください。

<OLF/TP Adapterインストールディレクトリ>/Adapter/OLFTP/Run/conf/ra.xml

以下に、OLF/TP Adapterのプロパティ一覧を示します。

(注：大文字／小文字は区別されます)

[OLF/TP Adapter全体に関する定義]

[OLF/TP AdapterのOutbound方向に関する定義]

[OLF/TP AdapterのInbound方向に関する定義]

（注意：定義を変更する場合は、OLF/TP Adapterのrarファイルを再配備する必要があります。）

3.4. WebOTX固有機能定義(nec-j2ee.xml)

OLF/TP Adapterのプール管理のプロパティ等を指定するファイルです。この設定は非管理環境下でのみ使用されます。
nec-j2ee.xmlは後述の記載例を参考に新規に作成してください。

（注意：複数のOLF/TP Adapterプロパティを指定することはできません。）

以下に記載例を示します。

<?xml version="1.0" encoding="UTF-8"?> <j2ee-specific-information>    <connector>        <display-name>OLFTP</display-name>        <jndi-name>ACOSAdapt</jndi-name>        <pool-param>            <initial-capacity>1</initial-capacity>            <max-capacity>4</max-capacity>            <Shrink-period-minutes>15</Shrink-period-minutes>            <cleanup-frequency>1000</cleanup-frequency>            <connection-duration-time>0</connection-duration-time>            <max-wait-time-in-millis>60000</max-wait-time-in-millis>        </pool-param>        <default-ra-principal>            <name>name</name>            <password>password</password>        </default-ra-principal>        <log>            <logging-enabled>false</logging-enabled>            <log-filename>C:/WebOTX/domains/domain1/logs/OLFAdpt.log</log-filename>            <log-filesize>1024</log-filesize>            <log-backupindex>1</log-backupindex>        </log>    </connector> </j2ee-specific-information>

WebOTX固有機能定義ファイルで指定されたログファイルのトレース内容詳細については、 [操作方法・設定 > 障害解析 > 3. OLF/TP Adapterのトレース ]を参照してください。

3.5. セキュリティポリシー(server.policy)

WebOTXのセキュリティポリシーのファイルです。OLF/TP Adapterを使ったアプリケーション（リソースアダプタなど）をWebOTX上で動作させ、イベントログやsyslogにエラー情報を記録するには、ポリシーの追加が必要です。

WebOTXのセキュリティポリシーのファイルは、デフォルトで以下のファイルになります。WebOTXのドメインを停止してから編集してください。

${INSTANCE_ROOT}/config/server.policy

以下のいずれかの定義を追加してください。定義例1は、配備したすべてのアプリケーションに対する設定です。定義例2は、配備したリソースアダプタごとに行う設定です。

定義例1

grant codeBase "file:${com.nec.webotx.instanceRoot}/applications/-" {
    permission java.lang.RuntimePermission "getenv.*";
    permission java.lang.management.ManagementPermission "monitor";
};

定義例2

grant codeBase "file:${com.nec.webotx.instanceRoot}/applications/＜リソースアダプタ名＞/-" {
    permission java.lang.RuntimePermission "getenv.*";
    permission java.lang.management.ManagementPermission "monitor";
};

WebOTXのセキュリティポリシーファイルの詳細は、[ Application Server > 構築・運用 > ドメインの構築 > ポリシーファイルの設定 ]を参照してください。