2. 環境設定

システムに関する設定項目について説明します。

2.1. システム環境変数

WebOTXでは動作環境についての情報を環境変数やJavaシステムプロパティとして保持しています。

WebOTXドメイン共通の環境変数は、以下の設定ファイルで定義されます。

2.1.1. Windows版のドメイン共通環境変数設定ファイル

${AS_INSTALL}\config\asenv.bat

2.1.2. UNIX版のドメイン共通環境変数設定ファイル

${AS_INSTALL}/config/asenv.conf

以下にその一覧を示します。

2.1.3. ドメイン共通の環境変数

表2.1.3-1
変数名	説明	既定値
AS_INSTALL	WebOTXインストールディレクトリ。インストール時に指定する。	Windows版 (システムドライブ):\WebOTX UNIX /opt/WebOTX
AS_ANT	ANTディレクトリ	${AS_INSTALL}/lib/ant
AS_ANT_LIB	ANTライブラリディレクトリ	${AS_ANT}/lib
AS_WEBSERVICES_LIB	WEBサービスライブラリディレクトリ	${AS_INSTALL}/lib
AS_IMQ_LIB	JMSライブラリディレクトリ	${AS_INSTALL}/wojms/lib
AS_IMQ_BIN	JMS実行ディレクトリ	${AS_INSTALL}/wojms/bin
AS_CONFIG	コンフィグディレクトリ	${AS_INSTALL}/config
AS_JAVA	JAVAインストールディレクトリ	${JAVA_HOME}
AS_ACC_CONFIG	アプリケーションクライアントが使用するXMLファイル	${AS_INSTALL}/lib/appclient/nec-acc.xml
AS_ICU_LIB	WebOTX実行時に必要なネイティブライブラリディレクトリ	${AS_INSTALL}/lib
AS_OSPI_LIB	Object Broker(またはObjectSpinner)ライブラリパス	Windows ${AS_INSTALL}/ObjectBroker/lib UNIX /opt/ObjectSpinner/lib
AS_DEF_DOMAINS_PATH	domainsディレクトリ	${AS_INSTALL}/domains
DERBY_INSTALL	Derbyインストールディレクトリ	Derbyは Java SE 6 に含まれています。
AS_OSPI_HOME	Object Broker(またはObjectSpiner)インストールディレクトリ	Windows版 ${AS_INSTALL}/ObjectBroker UNIX版 /opt/ObjectSpiner
AS_BOOT_DOMAIN	サーバ起動時に自動起動されるドメイン名	WebOTXAdmin (*) V6.4からV8.1まで提供していたシングルドメインモードと同様の動作としたい場合は、この値をdomain1に変更してください。

2.1.4. ドメイン固有の環境変数

これらはドメイン作成時に決定されるか、もしくは固定の値を持ちます。ドメイン作成後に変更することはできません。

表2.1.4-1
変数名	説明	既定値
DOMAIN_NAME	ドメイン名 (ドメイン作成時に指定)	domain1(WebOTXインストール時自動作成されるドメイン)
SERVER_NAME	サーバ名("server"で固定)	server
INSTANCE_ROOT	ドメインのルートディレクトリ	${AS_INSTALL}/domains/${DOMAIN_NAME}

任意の環境変数を設定する場合、または、システムで定義される環境変数をWebOTXのみ変更する必要がある場合には、以下のように設定ファイルの最後に環境変数の定義を追記します。 UNIXの場合、設定した環境変数をドメイン環境で利用する場合はexportを行う必要がありますので注意してください。

2.1.5. ユーザ任意の環境変数設定

2.1.5.1. WebOTX 全体に環境変数を設定する

WebOTX全体に対して環境変数を設定する場合、Windowsの場合はasenv.batを、Unixの場合はasenv.confを編集する必要があります。ここで設定した環境変数は、全てのドメイン及び全てのプロセスグループに対して反映されます。

Caution
asenv.bat及び、asenv.confにはWebOTXが使用する環境変数が記載されています。既に記載されている環境変数を削除しないよう注意してください。

Windows版での環境変数設定方法

${AS_INSTALL}/config/asenv.bat に以下のように任意の環境変数を追記してください。追加した環境変数は次回以降の起動時に反映されます。

set <環境変数名>=<値>

UNIX版での環境変数設定方法

${AS_INSTALL}/config/asenv.conf に以下のように任意の環境変数を追記してください。追加した環境変数は次回以降のサービス起動時に反映されます。

<環境変数名>=<値>
export <環境変数名>

例えば、Oracleのライブラリを参照する場合は次のように設定します。 $ORACLE_HOMEの部分には、該当するディレクトリ名を指定してください。

LD_LIBRARY_PATH="$ORACLE_HOME/lib:$LD_LIBRARY_PATH"
export LD_LIBRARY_PATH

2.1.5.2. ドメイン単位の環境変数設定

ドメイン単位に環境変数を設定する場合、${INSTANCE_ROOT}/config/asenv.propertiesに対して、下記のように追記してください。ここで設定した環境変数は、ドメインと、そのドメイン上で動作するプロセスグループ全てに対して反映されます

<環境変数名>=<値>

追加した環境変数は次回以降のドメイン起動時に反映されます。

2.1.5.3. プロセスグループ単位の環境変数設定 StEn

プロセスグループ単位で環境変数を設定したい場合、プロセスグループの「環境変数」で値を設定してください。

追加した環境変数は次回以降のプロセスグループ起動時に反映されます。

2.2. JDKの設定

WebOTXはインストール時に指定したJava Developer Kit(JDK)を使用して起動されます。

2.2.1. JDKの更新・変更

リビジョンアップ、バージョンアップなどによりインストール時とは別のJDKを用いるときは、以下の手順でWebOTXが使用するJDKを変更します。

Windows版

WebOTXの停止
Windowsサービスより、WebOTXを停止してください。
環境変数設定ファイルの変更
${AS_INSTALL}\config\asenv.bat に記述されている AS_JAVAの設定をJDKの環境に合わせて変更します。
```
set AS_JAVA=C:\jdk1.7.0_21
```

UNIX版

WebOTXの停止
rcスクリプト、または otxadmin コマンドを使用し、WebOTXを停止してください。
環境変数設定ファイルの変更
${AS_INSTALL}/config/asenv.conf に記述されている AS_JAVAの設定をJDKの環境に合わせて変更します。
```
AS_JAVA="/opt/java1.7"
```
シンボリックリンクの再作成 ※Linux版のみ STDENT
Linux版のWebOTX AS Standard/Enterpriseの場合、Java SE の問題を回避するためインストール時にシンボリックリンクを作成しているため、以下の手順で再作成します。
${JAVA_HOME}の箇所を新たに使用するJava SEのインストール先ディレクトリを指定ください。
- Linux(x86)の場合
```
> rm /opt/WebOTX/Trnsv/lib/headless
> rm /opt/WebOTX/Trnsv/lib/xawt
> ln -s ${JAVA_HOME}/jre/lib/i386/headless /opt/WebOTX/Trnsv/lib/headless
> ln -s ${JAVA_HOME}/jre/lib/i386/xawt /opt/WebOTX/Trnsv/lib/xawt
```
- Linux(x64)の場合
```
> rm /opt/WebOTX/Trnsv/lib/headless
> rm /opt/WebOTX/Trnsv/lib/xawt
> ln -s ${JAVA_HOME}/jre/lib/amd64/headless /opt/WebOTX/Trnsv/lib/headless
> ln -s ${JAVA_HOME}/jre/lib/amd64/xawt /opt/WebOTX/Trnsv/lib/xawt
```
Java SE の問題の詳細は、 [注意制限事項 > 1. インストール/アンインストール > 1.3. UNIX版 > 1.3.1. 注意事項 > 1.3.1.1. インストール/アンインストール ] の「Linuxプラットフォームにインストール時に作成するシンボリックリンクについて」を参照してください。

2.3. 管理ユーザ設定(UNIX)

UNIX系のOSでは、WebOTXのインストール時にシステム管理者権限をもつrootユーザとは別に、WebOTXの起動ユーザを指定してインストールが可能であり、推奨しています。WebOTX管理ユーザ(運用ユーザ)を設定することで、不用意なシステム権限領域へのアクセスを制御し、より強固なセキュリティの確保とOSのもつユーザ制限機能を利用することができます。

管理ユーザ設定の方法については、[ 4. ユーザ管理 > 4.4. その他の管理ユーザ > 4.4.1. 管理ユーザ設定(UNIX) ]を参照してください。

2.4. ホスト名の変更

WebOTXインストール後にマシンのホスト名やIPアドレスを変更するための手順について説明します。

必要となる手順は、インストールしたエディションと使用しているコンポーネントの種類によって違います。以下の表にしたがってください。

表2.4-1
手順	Express	Standard	Enterprise
ドメインのホスト名変更	○	○	○
TPシステムの設定変更	-	○	○
Webコンテナの仮想サーバ機能の設定変更	△	△	△
JDBCデータソースの設定変更	△	△	△
Object Brokerの設定変更	△	△	△
JMSの設定変更	△	△	△
JNDIクライアントの設定変更	△	△	△
トランザクションの強制終了	△	△	△
ドメインの停止	○	○	○
namesv.ndfファイルの削除	○	○	○
domain.xmlの修正	○	○	○
ドメインの起動	○	○	○
アプリケーションリファレンスの再登録	-	○	○

凡例
○	必須の手順
△	使用しているなら必要な手順
-	必要ない手順

それぞれ必要な手順を運用管理コマンドで行ってください。ここでは新たに設定するホスト名は<hostname>としています。

Caution
※ 以下の設定項目に記載されているホスト名と、変更前のドメインのホスト名が同じ場合、ドメインの再起動時に [ 2.4.1. ドメインのホスト名変更 ] で指定した値が自動的に設定されるため、設定変更は不要です。

2.4.2. TPシステムの設定変更
2.4.3. Webコンテナの仮想サーバ機能の設定変更
2.4.4. JDBCデータソースの設定変更
2.4.5. Object Brokerの設定変更
- Java システムプロパティに指定されたホスト名は自動的には設定されません。
  別途、設定変更が必要です。
2.4.6. JMSの設定変更

2.4.1. ドメインのホスト名変更

ドメインのホスト名に既定値である"localhost"が指定されているならこの手順は不要です。現在のドメインのホスト名はget domain.hostnameコマンドで確認できます。

otxadmin> set domain.hostname=<hostname>

2.4.2. TPシステムの設定変更

接続サーバ名の変更

otxadmin> set tpsystem.serverName=<hostname>

名前サービスホスト名の変更

otxadmin> set tpsystem.nameSvHostName=<hostname>

マルチサーバサーバ名の変更

マルチサーバ設定をしている場合は、サーバ名に変更があるものに対して実行してください。

otxadmin> set tpsystem.multiServers.<system group name>.<server set name>.serverName=<hostname>

<system group name>:システムグループ名
<server set name>:サーバセット名

2.4.3. Webコンテナの仮想サーバ機能の設定変更

仮想サーバ機能を使用しているときに必要な作業になります。

otxadmin> set server.http-service.virtual-server.<仮想サーバID>.hosts=<hostname>

2.4.4. JDBCデータソースの設定変更

dataSourceNameの接続文字列(JDBC URL)の見直し

dataSourceTypeがJDBCEX_OracleやJDBCの場合は、dataSourceNameで指定している接続文字列中のホスト名を変更してください。

otxadmin> set server.resources.jdbc-datasource.<データソースのJNDI名>.dataSourceName=jdbc:oracle:thin:@<hostname>:1521:orcl

serverNameのTCPホスト名の見直し

dataSourceTypeがJDBCEX_MSSqlServerやJDBCEX_Sybase、JDBCEX_DB2など、serverNameを指定している場合は、TCPホスト名を変更してください。

otxadmin> set server.resources.jdbc-datasource.<データソースのJNDI名>.serverName=<hostname>

そのほか、Oracle OCIドライバを利用している場合は、tnsnames.oraを変更してください。詳細はOracleのマニュアルをご覧ください。

2.4.5. Object Brokerの設定変更

Object Brokerでは、デフォルトでホスト名やIPアドレスが設定される項目はありませんが、次のような目的でホスト名を明示的に指定している場合には設定変更が必要です。

クラスタ構成でクライアントから自ホスト名とは異なる仮想ホスト名で接続する場合
複数のネットワークインタフェースのうち、対応する特定のホスト名を明示的に指定する場合
リモートの名前サーバやキャッシュ名前サーバを利用する場合

Object Brokerサービスの名前サーバに関する設定変更

server.objectbrokerservice.namesv.NameServiceHostName(名前サーバが動作しているホスト名)

otxadmin> set server.objectbrokerservice.namesv.NameServiceHostName=<hostname>

server.objectbrokerservice.namesv.NameServiceExportHostName(名前サーバのIOR中に含まれるホスト情報)

otxadmin> set server.objectbrokerservice.namesv.NameServiceExportHostName=<hostname>

server.objectbrokerconfig.NameServiceHostName(名前サービスが動作しているホスト名)

otxadmin> set server.objectbrokerconfig.NameServiceHostName=<hostname>

Object Brokerサービスのインタフェースリポジトリに関する設定変更

server.objectbrokerservice.irsv.InterfaceRepositoryHostName(インタフェースリポジトリが動作するホスト名)

otxadmin> set server.objectbrokerservice.irsv.InterfaceRepositoryHostName=<hostname>

server.objectbrokerconfig.InterfaceRepositoryHost(インタフェースリポジトリが動作するホスト名)

otxadmin> set server.objectbrokerconfig.InterfaceRepositoryHost=<hostname>

Object Brokerサービスのキャッシュ名前サーバに関する設定変更

server.objectbrokerservice.cnamesv.nmsvlist(キャッシュ元となる名前サーバのリスト)

otxadmin> set server.objectbrokerservice.cnamesv.nmsvlist=host1,…,<hostname>,…,hostN

IIOP通信を行う、Object Brokerサービス、CORBAアプリケーション、JNDIサービスなどに関する共通な設定変更

server.objectbrokerconfig.ExternalHostName(クライアント端末に公開するサーバのホスト名)

otxadmin> set server.objectbrokerconfig.ExternalHostName=<hostname>

server.objectbrokerconfig.AlternativeHostName(リファレンス生成時に格納するホスト名)

otxadmin> set server.objectbrokerconfig.AlternativeHostName=<hostname>

server.objectbrokerconfig.AlternativeHostNames(自ホストとみなすホスト名の一覧)

otxadmin> set server.objectbrokerconfig.AlternativeHostNames=host1:…:<hostname>:…:hostN

これらの設定で、明示的に指定しているホスト名を変更してください。
これらのホスト名をまとめて指定する場合は、server.objectbrokerconfig.ExternalHostNameだけを指定してください。

その他、Object Broker JavaのプロパティでORBInitialHostもしくはNameServiceHost(またはNameServiceHostName)を指定していれば、その変更も必要です。クライアントとサーバが同一マシンであれば、既定値は自ホスト(localhost)なので、設定不要です。

[ リファレンス集運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.10. Object Broker > 1.10.2. Object Broker JavaにおけるORBのプロパティ定義 ] を参照してください。

2.4.6. JMSの設定変更

JMSサーバのホスト名の変更

otxadmin> set server.jms-service.jms-host.default_JMS_host.host=<hostname>

JMSリソース（コネクションファクトリ）の接続先ホスト名の変更

otxadmin> set server.resources.jms-resource.jms-connection-factory.<CF name for JNDI>.wojmsBrokerHostName=<hostname>

<CF name for JNDI>:コネクションファクトリのJNDI名

JDBCの接続先のホスト名の変更

ドメインごとのconfig.propertiesに記述してある、JDBCのURLに含まれるホスト名を変更してください。

${AS_INSTALL}/domains/${DOMAIN_NAME}/wojms/instances/wojmsbroker/props/config.properties

wojms.persist.jdbc.opendburl
wojms.persist.jdbc.closedburl
wojms.persist.jdbc.createdburl

JavaAP用のJMS管理対象オブジェクト（コネクションファクトリ）の接続先ホスト名の変更

${AS_INSTALL}/wojms/bin/wojmsobjmgr update -t qf -l <CF name for JNDI> -j wojmsBrokerHostName=<hostname>

<CF name for JNDI>:コネクションファクトリのJNDI名

JMSリソースアダプタ(jmsra)に対するコネクタモジュール構成情報の接続先ホスト名の変更

コネクタモジュール構成情報の、ConnectionURLプロパティに含まれるホスト名を変更してください。

otxadmin> set server.resources.resource-adapter-config.jmsra.property.ConnectionURL=wojms\://<hostname>\:<port number>/"

2.4.7. JNDIクライアントの設定変更

クライアントアプリケーションでjava.naming.provider.urlシステムプロパティを用い、JNDIサーバのURLとしてホスト名を指定している場合は変更が必要です。

Cos名前サーバを経由しない場合(デフォルト動作)

-Djava.naming.provider.url=rmiiiop://<hostname>

Cos名前サーバを経由する場合

-Djava.naming.provider.url=corbaname://<hostname>

2.4.8. トランザクションの強制終了

以下の手順で、完了していないトランザクションを終了させる必要があります。

モニタリングレベルの変更

otxadmin> set server.monitoring-service.module-monitoring-levels.transaction-service=LOW

トランザクション一覧取得
```
otxadmin> get --monitor=true server.transaction-service.ActiveIds-Current
```
上記コマンドを実行すると、残っているトランザクションが表示されます。トランザクションが残っている場合、以下のコマンドでトランザクションをすべて終了させてください。
- 強制ロールバック
```
otxadmin > rollback-transaction <Transaction ID>
```
- 強制コミット
```
otxadmin > commit-transaction <Transaction ID>
```
- 破棄
```
otxadmin > forget-transaction <Transaction ID>
```
- 強制削除
```
otxadmin > delete-transaction <Transaction ID>
```

モニタリングレベルを戻す

otxadmin> set server.monitoring-service.module-monitoring-levels.transaction-service=OFF

2.4.9. ドメインの停止

ドメインの再起動のために停止を行います。

otxadmin > stop-domain --remote ${DOMAIN_NAME}

2.4.10. namesv.ndfファイルの削除

以下のパスにあるバイナリファイル内に古いホスト名やIPアドレスの情報がキャッシュとして残っています。WebOTXの設定で、明示的にIPアドレスを指定していない場合もホスト名から変換された IPアドレスが残ります。ドメインを停止した状態で削除してください。このファイルは、ドメイン起動時に存在していなければ再作成されます。

${AS_INSTALL}/domains/${DOMAIN_NAME}/config/ObjectBroker/namesv.ndf

IPアドレスを保存しないようにするためには、Object Broker JavaのプロパティでUseHostNameにyesを指定してください。詳細は、 [ リファレンス集運用管理・設定編 > 1. コンフィグレーション(設定一覧) > 1.10. Object Broker > 1.10.2. Object Broker JavaにおけるORBのプロパティ定義 ] を参照してください。

2.4.11. domain.xmlの修正

ドメイン構成ファイル（domain.xml）に次のシステムプロパティが設定されている場合は、ホスト名の部分を新しいホスト名に修正してください。

修正ファイル：${INSTANCE_ROOT}/config/domain.xml
修正対象のシステムプロパティ：-Djava.rmi.server.hostname=<ホスト名>

2.4.12. ドメインの起動

ドメインの再起動を完了させます。

otxadmin > start-domain --remote ${DOMAIN_NAME}

2.4.13. アプリケーションリファレンスの再登録

Caution
※ EJB/CORBAアプリケーションを配備していない場合、アプリケーションリファレンスの再登録は不要です。

「オブジェクトリファレンスのポリシ」を"永続的扱う"に設定をしている場合は、再登録の必要があります。"一時的に扱う"に設定している場合は不要です。URLを省略した場合は、名前サーバリストのURL全てが登録されます。

J2EEアプリケーションの場合

otxadmin> invoke applications.j2ee-applications.<application name>.<module name>.<bean name>.<interface name>.bindIor <bind url>

CORBAアプリケーションの場合

otxadmin> invoke applications.corba-applications.<application name>.<module name>.<interface name>.bindIor <bind url>

<application name>:アプリケーション名
<module name>:モジュール名
<bean name>:Bean名
<interface name>:インタフェース名
<bind url>:登録するURL