WebOTX 運用編(ドメインの運用)

1 はじめに

本書はWebOTX実行環境を運用するための運用操作法について概要や具体的な設定項目や設定方法について記載しています。

1.1 対象読者

このマニュアルはWebOTX Application Server Web Edition、Standard-J Edition、Standard Edition、Enterprise Editionを使って運用環境を構築するシステムエンジニア、日々の運用を行うオペレータを対象としています。

1.2 表記について

1.2.1 パス名表記

本書ではパス名の表記については特にOSを限定しない限りセパレータはスラッシュ’/’で統一しています。Windows環境においては’\’に置き換えてください。

1.2.2 環境変数表記

インストールディレクトリやドメインルートディレクトリなど環境によって値の異なるものについては環境変数を用いて表します。

${env} または $(env)で表しています。

例

${AS_INSTALL} : インストールディレクトリ
${INSTANCE_ROOT}: ドメインルートディレクトリ

1.2.3 コマンド操作について

本書中では運用操作に用いるコマンドの詳細についての説明は省略しています。

コマンドの詳細は「運用管理コマンド」、「運用管理コマンドリファレンス」を参照してください。

2 サービスの起動・停止

システムを構築、運用するための手順について説明します。

2.1 WebOTXのサービスについて

WebOTXのサービスについて説明します。

2.1.1 Windows

Windowsのサービスとして以下のサービスがあります。

• WebOTX Agent Service

WebOTX全体を管理するエージェントサービスです。既定値では自動起動するように設定しています。

• WebOTX WebServer domainname

Apache HTTP Server 1.3ベースのWebOTX Webサーバのサービスです。インストール時に「Webサーバ 1.3」を選択した場合に登録され、WebOTX Webサーバを利用するドメイン毎に作成されます。既定値では手動起動です。該当ドメイン起動時に自動的に起動します。サービスマネージャから起動する必要はありません。

• WebOTX WebServer2 domainname

Apache HTTP Server 2.0ベースのWebOTX Webサーバのサービスです。インストール時に「Webサーバ 2.0」を選択した場合に登録され、WebOTX Webサーバを利用するドメイン毎に作成されます。既定値では手動起動です。該当ドメイン起動時に自動的に起動します。サービスマネージャから起動する必要はありません。

• ObjectSpinner

WebOTXとしては利用しませんが、WebOTX以外のモジュールがドメイン外でCORBAサービスとして利用する場合に利用します。既定値では手動起動で通常は起動しません。

• WebOTX TPBASEadm

WebOTX Standard EditionもしくはEnterprise Editionを利用する場合、TPモニタに対する制御を行なうサービスです。「WebOTX Agent Service」と依存関係があり、「WebOTX Agent Service」を起動すると自動的に起動されます。

• WebOTX WatchServer

Enterprise Editionを利用する場合、マルチサーバ構成の負荷分散構成とした場合に、アプリケーションサーバの監視を行なうサービスです。Enterprise Edition、もしくはStandardEditionとクラスタ環境を組み合わせて利用することができます。

• WebOTX Transaction Service

Transactionサービスです。WebOTX以外のモジュールがドメイン外でTransactionサービス管理用プロセス(RCD)を使用する場合に起動します。初期状態ではサービス登録されていません。使用する場合は"wotsrcd -a"コマンドでサービスを登録する必要があります。既定値では手動起動で通常は起動しません。

• WebOTX TS RecoveryServer

Transactionサービスです。リカバリサーバを使用する場合に起動します。インストール時に[APサーバ環境] - [TransactionService] - [旧バージョン互換サービス]を選択する必要があります。既定値では手動起動で通常は起動しません。

2.1.2 HP-UX

HP-UXではマシン起動時にサービスが起動できるよう以下の起動スクリプトを提供しています。ただしObjectSpinner、WebOTX_TSに関してはWindowsと同様マシン起動時には起動しません。

• /sbin/init.d/WOAgentSvc
• /sbin/rc1.d/K200WOAgentSvc(/sbin/init.d/WOAgentSvcへのシンボリックリンク)
• /sbin/rc2.d/S800WOAgentSvc(/sbin/init.d/WOAgentSvcへのシンボリックリンク)
• /sbin/init.d/ObjectSpinner
• /sbin/rc1.d/K250ObjectSpinner(/sbin/init.d/ObjectSpinnerへのシンボリックリンク)
• /sbin/rc2.d/S750ObjectSpinner(/sbin/init.d/ObjectSpinnerへのシンボリックリンク)
• /sbin/init.d/WebOTXinit
• /sbin/rc1.d/K215WebOTXinit(/sbin/init.d/WebOTXinitへのシンボリックリンク)
• /sbin/rc2.d/S790WebOTXinit(/sbin/init.d/WebOTXinitへのシンボリックリンク)
• /sbin/init.d/WatchServer
• /sbin/rc1.d/K210WatchServer(/sbin/init.d/WatchServerへのシンボリックリンク)
• /sbin/rc2.d/S795WatchServer(/sbin/init.d/WatchServerへのシンボリックリンク)
• /sbin/init.d/WebOTX_TS
• /sbin/rc1.d/K230WebOTX_TS(/sbin/init.d/WebOTX_TSへのシンボリックリンク)
• /sbin/rc2.d/S770WebOTX_TS(/sbin/init.d/WebOTX_TSへのシンボリックリンク)

2.1.3 Solaris

Solarisではマシン起動時にサービスが起動できるよう以下の起動スクリプトを提供しています。ただしObjectSpinner、WebOTX_TS に関してはWindowsと同様マシン起動時には起動しません。

• /etc/init.d/WOAgentSvc
• /etc/rc0.d/K30WOAgentSvc
• /etc/rc1.d/K30WOAgentSvc
• /etc/rc2.d/S81WOAgentSvc
• /etc/init.d/ObjectSpinner
• /etc/rc0.d/K50ObjectSpinner
• /etc/rc1.d/K50ObjectSpinner
• /etc/rc2.d/S75ObjectSpinner
• /etc/init.d/WebOTXinit
• /etc/rc0.d/K35WebOTXinit
• /etc/rc1.d/K35WebOTXinit
• /etc/rc2.d/S79WebOTXinit
• /etc/init.d/WatchServer
• /etc/rc0.d/K33WatchServer
• /etc/rc1.d/K33WatchServer
• /etc/rc2.d/S80WatchServer
• /etc/init.d/WebOTX_TS
• /etc/rc0.d/K40WebOTX_TS
• /etc/rc1.d/K40WebOTX_TS
• /etc/rc2.d/S77WebOTX_TS

2.1.4 Linux

Linuxではマシン起動時にサービスが起動できるよう以下の起動スクリプトを提供しています。ただしObjectSpinner、WebOTX_TSに関してはWindowsと同様マシン起動時には起動しません。

• /etc/init.d/WOAgentSvc
• /etc/rc0.d/K30WOAgentSvc
• /etc/rc1.d/K30WOAgentSvc
• /etc/rc2.d/S81WOAgentSvc
• /etc/rc3.d/S81WOAgentSvc
• /etc/rc5.d/S81WOAgentSvc
• /etc/rc6.d/K30WOAgentSvc
• /etc/init.d/ObjectSpinner
• /etc/rc0.d/K50ObjectSpinner
• /etc/rc1.d/K50ObjectSpinner
• /etc/rc2.d/S75ObjectSpinner
• /etc/rc3.d/S75ObjectSpinner
• /etc/rc4.d/S75ObjectSpinner
• /etc/rc5.d/S75ObjectSpinner
• /etc/rc6.d/K50ObjectSpinner
• /etc/init.d/WebOTXinit
• /etc/rc0.d/K35WebOTXinit
• /etc/rc1.d/K35WebOTXinit
• /etc/rc2.d/S79WebOTXinit
• /etc/rc3.d/S79WebOTXinit
• /etc/rc5.d/S79WebOTXinit
• /etc/init.d/WatchServer
• /etc/rc0.d/K33WatchServer
• /etc/rc1.d/K33WatchServer
• /etc/rc2.d/S80WatchServer
• /etc/rc3.d/S80WatchServer
• /etc/rc5.d/S80WatchServer
• /etc/init.d/WebOTX_TS
• /etc/rc0.d/K40WebOTX_TS
• /etc/rc1.d/K40WebOTX_TS
• /etc/rc2.d/S77WebOTX_TS
• /etc/rc3.d/S77WebOTX_TS
• /etc/rc4.d/S77WebOTX_TS
• /etc/rc5.d/S77WebOTX_TS
• /etc/rc6.d/K40WebOTX_TS

[WebOTX SIP Application Server V8.13の場合]

• /usr/lib/systemd/system/WOAgentSvc.service
• /usr/lib/systemd/system/ObjectSpinner.service

2.2 サービスの起動・停止方法

WebOTXのサービス全体を起動および停止する方法について説明します。デフォルトの設定ではマシン起動時にサービスが起動するようになっています。ObjectSpinner、WebOTX_TSのサービスはWebOTXとしては利用しませんが、下記と同様の方法で起動・停止することができます。

注意：UNIXでの起動停止の操作はrootユーザで実行してください。

2.2.1 Windows

「WebOTX AS Agent Service」サービスを起動・停止します。サービスコントロールマネージャもしくはnet start、net stopコマンドより実行できます。

例) サービスの起動

net start "WebOTX AS Agent Service"

例) サービスの停止

net stop "WebOTX AS Agent Service"

サービス起動コマンド実行直後はまだ起動処理が行われています。サービスの起動完了は「ドメインの起動完了確認」より、ドメインの起動処理完了をもって確認してください。

サービス停止時、WebOTXドメインの停止処理時間が定められたタイムアウト値を超過すると、サービス制御マネージャによって「ローカルコンピュータのWebOTX Agent Service サービスを停止できません。」と出力されることがあります。しかしながら、このメッセージが出力されても、実際には停止処理は引き続き行われています。よって、プロセスのストールなどの異常が発生していなければ最終的には停止することになります。

2.2.2 HP-UX

/sbin/init.d/WOAgentSvc に起動・停止スクリプトがあります。スクリプトを実行することによりサービスの起動、停止が行えます。

例) サービスの起動

/sbin/init.d/WOAgentSvc start 

例) サービスの停止

/sbin/init.d/WOAgentSvc stop 

2.2.3 Solaris

/etc/init.d/WOAgentSvc に起動・停止スクリプトがあります。スクリプトを実行することによりサービスの起動、停止が行えます。

例) サービスの起動

/etc/init.d/WOAgentSvc start 

例) サービスの停止

/etc/init.d/WOAgentSvc stop 

2.2.4 Linux

/etc/init.d/WOAgentSvc に起動・停止スクリプトがあります。スクリプトを実行することによりサービスの起動、停止が行えます。

WebOTX SIP Application Server V8.13の場合、systemctlコマンドを実行することによりサービスの起動、停止が行えます。

例) サービスの起動

/etc/init.d/WOAgentSvc start 

WebOTX SIP Application Server V8.13の場合：

systemctl start WOAgentSvc

例) サービスの停止

/etc/init.d/WOAgentSvc stop 

WebOTX SIP Application Server V8.13の場合：

systemctl stop WOAgentSvc

2.3 サービスの設定

Windows版のサービスは、プロパティファイルを持っています。ここに記述されたコマンドを実行してドメイン起動を行っています。

${AS_INSTALL}\config\woasinfo.properties

この設定を変更することにより、コマンド実行待ち時間を変更することが可能です。

3 システムに関する設定

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

3.1 システム環境変数

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

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

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

${INSTALL_ROOT}\config\asenv.bat

3.1.2 UNIX・Linux版のドメイン共通環境変数設定ファイル

${INSTALL_ROOT}/config/asenv.conf

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

3.1.3 ドメイン共通の環境変数

3.1.4 ドメイン固有の環境変数

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

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

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

set 環境変数名=値

3.1.6 Unix・Linux版での環境変数設定方法

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

3.2 使用するポート番号

3.2.1 管理ドメインで使用するポート番号

管理ドメインで使用するポート番号について以下に説明します。

3.2.2 TPモニタ運用管理プロセスで使用するポート番号

Standard Edition/Enterprise Editionでは、TPモニタ管理プロセスが以下のポートを使用します。このポート番号はローカルマシン内での通信のみに使用されます。

UNIX・Linux版の場合、/etc/servicesにTPモニタ管理プロセスのサービス名とポート番号の対応を記述する必要があります。WebOTXインストール後に手動で設定してください。詳しくは「インストール後の作業」を参照してください。Windowsの場合はこの手順は必要ありません。

3.2.3 一般ドメインで使用するポート番号

一般ドメインで使用するポート番号について説明します。既定値はインストール時に作成される、domain1のものです。

一般ドメインはサーバ上に複数作成することが可能です。その際はそれぞれのドメインが上記設定のすべてのポートを使用します。「ドメインの作成」を参照してください。

3.2.4 自動的で割り当てられる一時ポート(エフェメラルポート)番号に関する注意制限事項

OSの種類によって、以下の表で示される範囲のポート番号が、OSで自動的に割り当てる一時ポート番号として規定されています。

WebOTXが使用するポート番号が一時ポートの割り当て範囲と重複していた場合、別のアプリケーションが同じポート番号を一時ポートとして使用しWebOTXの起動が失敗するなどの問題を引き起こすことがあります。

例えばWindows 2000 Server/Windows Server 2003では、一時ポート番号は1024〜5000の範囲となります。これはWebOTXのdomain1の名前サーバ(2809)のポート番号を含んでいるため、まれに起動失敗などの問題を引き起こす可能性があります。

一時ポートとの重複を回避する方法

WebOTXが利用するポート番号をOSの一時ポートの対象外であると登録することによって回避してください。WebOTX付属の設定用コマンドを用いる方法と、レジストリエディタによる方法があります。

設定用コマンドによる登録

コマンドプロンプトを起動し、以下のコマンドを実行します。

> ${INSTANCE_ROOT}\bin\ReservPorts.bat install
Microsoft (R) Windows Script Host Version 5.6
Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.
Add ReservPorts :[2809-2809 ]
ReservPorts registerd Succeed! Please reboot the machine.

一時ポート範囲から除外されたポート番号が、Add ReservPorts:[開始ポート番号-終了ポート番号 ・・・]として表示されます。設定変更後はマシンの再起動が必要です。

ReservedPort.bat コマンド: ${INSTANCE_ROOT}\bin\ReservPorts.bat [ list | install | uninstall ]

レジストリエディタによる登録方法

レジストリエディタを起動します。

レジストリキー[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters]を検索し、配下に以下の項目を追加します。

3.2.5 ファイアーウォールの設定に関して

クライアントマシンからの接続には、以下のポート番号に対しファイアーウォールのブロックを解除する必要があります。

「Edition別提供サービス」の表記については以下を参照してください。

「○」・・・既定で有効

「△」・・・既定で有効でない

「-」・・・未提供のサービス

3.3 動作プロセスについて

3.3.1 サービスプロセス

3.3.2 管理ドメインで動作するプロセス

3.3.3 一般ドメインで動作するプロセス

ドメインを起動すると以下のプロセスが起動します。複数ドメインを起動した場合は、同一名のプロセスが複数起動します。

3.3.4 単体で動作するプロセス

ツールなど単独で動作可能なプロセスです。複数起動した場合は、同一名のプロセスが複数起動します。

3.3.5 プロセス構成図

WebOTX Application Server のサービス(またはスクリプト)と各プロセスの関係図を以下に記します。

• Windows版
　　　　　　
• Web Edition



• Standard-J Edition



• Unix版
　　　　　　
• Web Edition



• Standard-J Edition

3.4 ディレクトリ構成

3.4.1 インストールディレクトリのディレクトリ構成

WebOTXをインストールしたディレクトリ(${AS_INSTALL})のディレクトリ構成について説明します。

以下にそれぞれのディレクトリについて説明します。

• *1：インストール時にオプションとして選択した場合にインストールされます。
• *2：UNIX環境の場合は、/opt/share.necにインストールされます。
• *3：WebOTX拡張製品をインストールした場合にインストールされます。
• *4：WebOTX Developerをインストールし、かつJDK 6を使用した場合にインストールされます。

3.4.2 ドメインルートのディレクトリ構成

ドメインのルートディレクトリ(${INSTANCE_ROOT})のディレクトリ構成について説明します。

以下にそれぞれのディレクトリについて説明します。

3.5 設定ファイル一覧

3.5.1 WebOTX全体に関係する構成情報ファイル

WebOTX全体に関係する各種設定ファイル(${INSTALL_ROOT}/config以下)について説明します。

3.5.2 ドメインの設定ファイル

ドメインの各種設定ファイル(${INSTANCE_ROOT}/config以下)について説明します。

3.6 Java Developer Kitの設定

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

3.6.1 JDKの更新・変更

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

Windows版

1. 環境変数設定ファイルの変更

${INSTALL_ROOT}\config\asenv.bat に記述されている AS_JAVAの設定をJDKの環境に合わせて変更します。

set AS_JAVA=C:\jdk1.5.0_15

2. JMS環境設定ファイルの変更(Standard-J Edition 以上)

${INSTALL_ROOT}\wojms\var\jdk-env.bat に記述されている WOJMS_JAVAHOMEの設定をJDKの環境に合わせて変更します。

set WOJMS_JAVAHOME=C:\jdk1.5.0_15\jre

HP-UX,Solaris,Linux版

1. 環境変数設定ファイルの変更

${INSTALL_ROOT}/config/asenv.conf に記述されている AS_JAVAの設定をJDKの環境に合わせて変更します。

AS_JAVA="/opt/java1.5"

2. JMS環境設定ファイルの変更(Standard-J Edition以上)

${INSTALL_ROOT}/wojms/var/jdk.env に記述されている WOJMS_JAVAHOMEの設定をJDKの環境に合わせて変更します。

/opt/java1.5/jre

3.6.2 Java SE 6へのバージョンアップ設定

J2SE 5.0でインストールを行ったWebOTX環境をJava SE 6へバージョンアップする際、WebOTXの設定を変更する必要があります。

• ドメインにJavaシステムプロパティ-Dsun.lang.ClassLoader.allowArraySyntaxを追加

例

otxadmin> create-jvm-options -Dsun.lang.ClassLoader.allowArraySyntax=true

3.6.3 Java SE6から J2SE 5.0 のダウングレード

Java SE 6でインストールを行ったWebOTX環境を、J2SE 5.0へダウングレードする場合、以下の手順でWebOTXの設定を変更する必要があります。

1. アプリケーションの配備解除

業務アプリケーションを一端配備解除します

2. Javaシステムプロパティ-Dsun.lang.ClassLoader.allowArraySyntaxの削除

J2SE 5.0で不要なJavaシステムプロパティを削除します。システムプロパティが設定されていない場合、この作業は不要です。

例

otxadmin> delete-jvm-options -Dsun.lang.ClassLoader.allowArraySyntax=true

3. 環境変数設定ファイルの変更

3.6.1に記載されている、環境変数ファイルを使用するJDKの環境に合わせて編集してください。

4. アプリケーションの配備

ドメインを再起動した後、業務アプリケーションを配備解除してください。業務アプリケーションがJDK1.6でコンパイルされていた場合、JDK1.5で再度コンパイルし直した後、配備を行ってください。

3.7 管理ユーザ設定（HP-UX,Solaris,Linux）

3.7.1 WebOTX管理ユーザ(運用ユーザ)の設定

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

運用ユーザを変更するスクリプトを提供していますので、インストール後でも運用ユーザに変更することが可能です。

ただし、WebOTX管理ユーザを利用する場合には、OSの制限により、1024以下のポート番号を利用することができなくなります。HTTP/HTTPS用のポート番号を1024以下で設定している場合には、ポート番号の再設定等が必要になるため、注意が必要です。

なお、UNIX系OSにおける運用ユーザのパスワード変更によるWebOTXへの影響はありません。Windows OSの場合は「Windowsサービスアカウントの変更」を参照してください。

インストール後の運用ユーザ変更手順

1. rootユーザでログインします。
2. WebOTXを停止します。

# otxadmin stop-domain WebOTXAdmin

3. WebOTXのWebOTX運用ユーザのユーザ、および、グループアカウントを作成します。

ここでは説明の為に、ユーザ名を「admin」、 グループ名を「webotx」と設定します。アカウントの作成はシステム管理者に依頼するか、各OSの運用マニュアルを参照して登録を行ってください。

4. 新しく作成したアカウントがtelnetなどで正しくログインできることを確認してください。
5. rootユーザで以下のコマンドを実行します。

# cd /opt/WebOTX/bin
# ./otxown.sh
## Executing WebOTX Operation User Change script.
Would you like to change as WebOTX Operation User? [y, n](default n)
y
Please input WebOTX Operation User name.
admin
Please input WebOTX Operation User group name.
webotx
**********************************************************
* Change of WebOTX Operation User. To continue, input y. *
* Input q to exit the installation. [y, q](default y)    *
**********************************************************

6. 設定がおわりましたら、/opt/WebOTX配下のファイルオーナが運用ユーザに設定されていることを確認します。
7. サーバを再起動してください。

3.7.2 複数のドメインを異なるユーザで運用

UNIX系のOSでは、複数のドメインを異なるユーザで運用する機能をサポートしています。ここではそのための手順を説明します。

ドメインごとに運用ユーザを変えたい時はこちらの設定をご検討ください。

設定の際の注意点

設定の際は、以下の点に注意してください。

1. 各ドメインに設定するユーザは、すべてのドメイン間で同じグループに属している必要があります。
2. 管理ドメイン「WebOTXAdmin」は、rootでなければなりません。
3. Standard Edition/Enterprise EditionではWebOTX内部のソケット通信用ポートは、w-tpadm(既定値: 8899)で設定したものを使用します。別ユーザで運用する場合は、各ドメイン用にシステムIDを加えたポートも設定する必要があります。サーバマシン内で使用されていないポート番号となるようにシステムIDを設定してください。 システムIDはドメイン間で一意である必要があります。
4. ファイルの直接編集やディレクトリ等のオーナ・権限等の変更は、WebOTXが停止した状態で行ってください。
5. ファイルを直接編集する際は、必ずバックアップを取ってください。

設定の手順

以下の環境を例にして設定方法を説明します。

OS設定上の変更

ここでは、OSに対してポートの設定やサービス登録を行います。

1. /etc/services への設定追加
(Standard Edition/Enterprise Editionのみ)

サービス名とポートの追加を行います。ポート番号には、「w-tpadm(既定値: 8899)+システムID」の数値を設定します。

w-tpadm  8899/tcp # WebOTX TPBASEadm(SV)
w-tpadm2 8901/tcp # WebOTX TPBASEadm(SV)

ここでは、今まで設定されていたw-tpadmの他に、domain2用としてw-tpadmにシステムID 2を追加した値を設定しています。サービス名とポート番号は、他と重複しないように設定してください。

2. inetd へのサービス登録
(Standard Edition/Enterprise Editionのみ)

ドメインごとにinetdの設定を行います。ここで指定したドメインのオーナとグループがドメイン起動時のプロセスに反映されます。OSごとにサービス登録手順が違います。

HP-UXの場合

/etc/inetd.confファイルにエディタ等で以下の2行を追加して下さい。それぞれ改行をいれず、1行で記述してください。

w-tpadm stream tcp6 nowait root /opt/WebOTX/Trnsv/bin/tpadm.sh w-tpadmd /opt/WebOTX/domains/domain1
w-tpadm2 stream tcp6 nowait root /opt/WebOTX/Trnsv/bin/tpadm.sh w-tpadmd /opt/WebOTX/domains/domain2

第1フィールドには、/etc/servicesに設定したサービス名をinetdに追加します。さらに、サーバ・プログラム引数フィールドは、ドメインのディレクトリを与えます。

編集後は設定を再読み込みさせてください。

# /usr/sbin/inetd -c

Solarisの場合

/etc/inet/inetd.confファイルにエディタ等で以下の2行を追加して下さ。それぞれ改行をいれず、1行記述してください。

w-tpadm stream tcp nowait root /opt/WebOTX/Trnsv/bin/tpadm.sh w-tpadmd /opt/WebOTX/domains/domain1
w-tpadm2 stream tcp nowait root /opt/WebOTX/Trnsv/bin/tpadm.sh w-tpadmd /opt/WebOTX/domains/domain2

第1フィールドには、/etc/servicesに設定したサービス名でinetdに追加します。さらに、サーバ・プログラム引数フィールドは、ドメインのディレクトリを与えます。

編集後は設定を再読み込みさせてください。

# kill -HUP <inetdのプロセスID>

Linuxの場合

インストール時にxinetdへのサービスを一つ登録しています。そのサービスに対して引数を設定します。また、新規にサービスを追加します。

/etc/xinetd.d/webotxファイルをエディタ等で以下のように修正して下さい。

service w-tpadm
{
socket_type = stream
protocol = tcp
wait = no
user = root
server = /opt/WebOTX/Trnsv/bin/tpadm.sh
server_args = /opt/WebOTX/domains/domain1
}
service w-tpadm2
{
socket_type = stream
protocol = tcp
wait = no
user = root
server = /opt/WebOTX/Trnsv/bin/tpadm.sh
server_args = /opt/WebOTX/domains/domain2
}

インストール時に設定されているサービスw-tpadmにserver_argsを追加し、ドメインのディレクトリを設定します。また、/etc/servicesに新たに設定したサービスとその設定をinetdに追加します。

編集後は設定を再読み込みさせてください。

 # kill -USR2 <xinetdのプロセスID>

WebOTX制御ファイルの変更

ここでは、WebOTXの制御ファイルに関して、値の変更や権限の変更を行います。

1. /opt/WebOTX/Trnsv/bin/tpadm.shの変更
(Standard Edition/Enterprise Editionのみ)

tpadm.sh内の記述において、「wosh」に引数を追加するため「 $1」を書き加えます。$1の前に半角スペースが必要です。

/opt/WebOTX/Trnsv/bin/wosh /opt/WebOTX/Trnsv/bin/tpadm2.sh start $1

Linuxのパッチを適用する際、tpadm.shが上書きされる可能性があります。適用前にtpadm.shのバックアップをとってパッチ適用後に復元するか、パッチ適用後に再度「 $1」を加えてください。

2. asenv.confの変更

/opt/WebOTX/config/asenv.confに以下の一行を追加してください。

AS_MULTIUSER=TRUE

3. ディレクトリ権限変更

すべての関連するディレクトリとファイルのオーナ・グループ・権限を再設定します。/opt/WebOTX/bin/otxown.sh を用いて、WebOTX配下のオーナとグループをrootに戻してください。

次に、各ドメインの<INSTANCE_ROOT>配下のディレクトリ・ファイルのオーナとグループを各運用ユーザにそれぞれ変更してください。

ディレクトリ	ファイルオーナ	グループ
/opt/WebOTX/domains/domain1 とその配下	otxadm	otxadmin
/opt/WebOTX/domains/domain2 とその配下	otxadm2	otxadmin

また、以下のディレクトリとファイルは、各運用ユーザすべてが読み込み・書き込みできる必要があります。それらに対して、運用ユーザのオーナ/グループで書き込みができるようにファイル権限設定してください。(/opt/WebOTX/Trnsv/multitpm に設定するグループは、各運用ユーザと同一にしておく必要があります。)

・ファイル権限を775に設定するもの

         /opt/WebOTX/domains
         /opt/WebOTX/Trnsv/conf/CommAPIとその配下
         /opt/WebOTX/Trnsvmultitpmとその配下("."で始まるファイルも)
         /opt/WebOTX/Trnsv/logs
         /opt/WebOTX/Trnsv

・ファイル権限を750に設定するもの

       /opt/WebOTX/domains/config
       /opt/WebOTX/domains/config/tpsystem

設定についての補足

設定について、以下の補足事項があります。

1. システムIDの変更
(Standard Edition/Enterprise Editionのみ)

/etc/services にサービス名とポート番号を指定するとき、「w-tpadm+システムID」の値を指定する必要があります。もしその値が使用できない場合は、既存のシステムIDを変更して、新たな「w-tpadm+システムID」を付与してください。

そのままの値を使用できるのであれば (例えば、w-tpadmが8899、システムIDが2で、8901が使用できるなら)、既存のシステムを変更せずに使用できます。変更する場合は、以下の手順で行ってください。

パッチモジュールの適用前にドメインを起動して、統合運用管理ツールから変更を行います。

[ドメイン名] - [TPシステム] - [システム情報]タグ

[システム情報]画面内の「システムID」値を更新します。

運用管理コマンドによる設定も可能です。

# cd <INSTALLDIR>
# bin/otxadmin
otxadmin> login --user <ユーザ名> --password <パスワード> --host <ホスト名> --port <管理ポート番号>
otxadmin> set tpsystem.systemID=<システムID>

2. Webサーバ設定の変更

WebOTX運用管理ユーザをroot以外に設定した場合、OSの制約上1024番以下のポート番号は使用できません。もし、ポート番号1024番以下で内蔵型Webサーバを使用中のドメインがあれば、そのドメインに対して、1025番以降の現在のシステムで利用可能な番号に変更してください。

下に示したdomain.xmlファイルを編集して、ポート番号を変更してください。

• /opt/WebOTX/domains/domain1/config/domain.xml
• /opt/WebOTX/domains/domain2/config/domain.xml

編集する箇所は、<http-service>要素の以下のサブ要素です。idが"http-listener-1"、"http-listener-2"となっているhttpリスナのポートを変更してください。

<http-listener accept-count="10" address="0.0.0.0"
buffer-size="2048" connection-timeout="60000" default-virtual-server="server"
enable-lookups="false"enabled="true" id="http-listener-1" limit-processors="15"
max-processors="20" min-processors="5" port="80"
protocol="HTTP/1.1" security-enabled="false" server-name="" xpowered-by="true">
</http-listener>
<http-listener accept-count="10" address="0.0.0.0"
buffer-size="2048" connection-timeout="60000" default-virtual-server="server"
enable-lookups="false"enabled="true"id="http-listener-2" limit-processors="15"
max-processors="20" min-processors="5" port="443"
protocol="HTTP/1.1" security-enabled="true" server-name="" xpowered-by="true">
</http-listener>

この設定は、パッチモジュールを適用する前にドメインが起動した状態から、以下のように統合運用管理ツールを用いて変更することもできます。

• [ドメイン名] - [アプリケーションサーバ] - [HTTPサービス] - [HTTPリスナ] - [HTTPリスナ1] - [一般]タグ
• [ドメイン名] - [アプリケーションサーバ] - [HTTPサービス] - [HTTPリスナ] - [HTTPリスナ2] - [一般]タグ

[一般]画面内のポート番号を変更します。

運用管理コマンドによる設定も可能です。

# cd <INSTALLDIR>
# bin/otxadmin
otxadmin> start-domain <ドメイン名>
otxadmin> login --user <ユーザ名> --password <パスワード> --host <ホスト名> --port <管理ポート番号>
otxadmin> set server.http-service.http-listener.http-listener-1.port=<ポート番号>
otxadmin> set server.http-service.http-listener.http-listener-2.port=<ポート番号>
otxadmin> stop-domain <ドメイン名>

3.8 ホスト名の変更

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

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

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

ドメインのホスト名変更

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

otxadmin> set domain.hostname=<hostname>

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>:サーバセット名

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

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

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

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

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

otxadmin> set server.resources.jdbc-datasource.hostname.dataSourceName=jdbc:oracle:thin:@<hostname>:1521:orcl

・serverNameのTCPホスト名の見直し

otxadmin> set server.resources.jdbc-datasource.hostname.serverName=<hostname>

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.objectbrokerservice.namesv.NameServiceHostName=<hostname>

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

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

otxadmin> set server.objectbrokerservice.irsv.InterfaceRepositoryHost=<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)なので、設定不要です。

「WebOTX Object Broker JavaにおけるORB のプロパティ定義」を参照してください。

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>

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

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

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

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

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

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

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

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

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

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

2. トランザクション一覧取得

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>

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

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

ドメインの停止

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

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

namesv.ndfファイルの削除

以下のパスにあるバイナリファイル内に古いホスト名情報がキャッシュとして残っています。 ドメイン停止状態で削除してください。 このファイルは、ドメイン起動時に存在していなければ再作成されます。

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

(注意) このファイルの削除を行わないと、名前サーバ(namesv)の起動が失敗します。名前サーバに依存関係のあるJNDIサーバの起動も失敗します。 この削除手順を忘れることが非常に多いので、注意してください。

domain.xmlの修正

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

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

ドメインの起動

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

3.9 Windowsサービスアカウントの変更

Windows版 Standard EditionあるいはEnterprise Editionをインストールしたときに [ユーザアカウントの入力] 画面で指定したユーザアカウントは、Windowsサービス「WebOTX TPBASEadm」のログオンアカウントとして設定されます。

TPBASEadmプロセスは、このアカウントの環境変数を引き継ぐことになります。

このアカウント、パスワードを変更する場合は以下のように行ってください。

1. Windowsのコントロールパネルから、[管理ツール]-[サービス]を実行する
2. WebOTX TPBASEadmを選択し、右クリックでプロパティを開き、[ログオン]タブを表示する
3. 指定されているアカウントとパスワードを指定する

指定するアカウントはAdministrators権限が必要です。また、 "サービスとしてログオン" の権限を持っている必要があります。

4 ドメインの運用操作

システムを構築、運用するための手順について説明します。

4.1 ドメインの運用操作の前に

4.1.1 Windows Server 2008

Windows Server 2008ではUAC(User Account Control)によりビルトインアカウントを除くユーザに対し特権の制限がかかります。 WebOTX ASではドメインの運用操作にはOSの管理者特権を必要とするため、特権昇格したコマンドプロンプトからドメインの運用操作を実行する必要があります。

ただし、WebOTX ASで管理者特権のチェックを行わせたくない場合はOSの環境変数に「AS_NO_UAC_CHECK=YES」を設定することでWebOTX ASで行う全てのUACに対する特権チェックを回避することが出来ます。

特権昇格したコマンドプロンプトを起動するにはコマンドプロンプトのショートカットの右クリックメニューから「管理者として実行」を選択して起動する方法などがあります。

4.2 ドメインの作成・削除

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

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

4.2.1 ドメインの作成

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

新規にdomain2を作成する場合の手順を以下に示します。

1. UNIXの場合、WebOTX運用ユーザでログインします。
2. WebOTXインストールディレクトリ(${AS_INSTALL})に移動します。
3. WebOTXインストールディレクトリに新規ドメイン用の<ドメイン名>.propertiesファイルを準備します。 domain2用のdomain2.propertiesはWebOTXインストールディレクトリにすでに配置されています。 domain2以外のドメインを新規作成する際は既存のdomain1.propertiesファイルあるいは domain2.propertiesファイルをコピーし、<ドメイン名>.propertiesにリネームしてください。
4. <ドメイン名>.propertiesファイルの設定をエディタで編集してください。 propertiesファイルを参考に編集してください。 その際、使用するポート番号や識別名の設定が既存のドメインの設定と重複した場合、 同時にドメイン起動ができなくなるので注意してください。 (domain1.propertiesとdomain2.propertiesの設定は排他的になっています。変更を行わなければ 既定値で共存が可能です。)
5. WebOTXサービスが起動していることを確認してください。(起動していない場合は、「サービスの起動・停止方法」の手順で起動します)
6. 以下のコマンドを実行し、ドメインを作成します。

   bin/asant -buildfile setup.xml -Dfile=<ドメイン名>.properties create-domain

   ※ 管理ドメインの運用ユーザパスワードを変更した場合は、上記コマンドの引数に「-Dadmdomain.admin.password=<管理ドメインの運用ユーザパスワード>」を追加してください。
7. 正常にドメイン作成を行えたならば、以下のコマンドで新規作成したドメインを起動します。

   bin/otxadmin start-domain <ドメイン名>

8. (対象: 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. ドメインを再起動します。
      
      
9. (対象: 複数のネットワークカードを利用している場合)
   WebOTXが動作するサーバが複数のネットワークカードを利用している場合、運用管理ツールからドメインへの接続が失敗することがあります。該当する環境を利用している場合、作成したドメインに対して次の手順でJavaシステムプロパティを設定してください。
   
   
   1. 作成したドメインにログインします。

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

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

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

   3. ドメインを再起動します。
      
      
   ※ 設定内容は手順 8 と同じです。手順 8 を実施済みの場合、上記の手順を再度実施する必要はありません。
   ※ 本問題の詳細につきましては、セットアップガイド「2.3.7 複数のネットワークカードを利用している場合の設定」を参照してください。

propertiesファイル

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

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

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

4.2.2 ドメインの削除

asant delete-domainコマンドで削除します。削除するドメイン名は-Ddomain.name=<ドメイン名>引数で指定して削除します。asantコマンドは${AS_INSTALL}/binにあります。

domain2を削除する場合の手順を以下に示します。

1. UNIXの場合WebOTX運用ユーザでログインします。
2. WebOTXインストールディレクトリに移動します。
3. WebOTXサービスが起動していることを確認します（起動していない場合は、「サービスの起動・停止方法」の手順で起動します）
4. Transactionサービスを利用したトランザクション管理を行っている場合は、Transactionサービスで提供するwotstxコマンドを使用して、全てのトランザクションが存在しないことを確認してください。トランザクションが残っている場合は全てのトランザクションを終了させてください。
5. ドメインが起動している場合は停止します

otxadmin> stop-domain domain2

6. 以下のコマンドを実行します

bin/asant -buildfile setup.xml -Ddomain.name=domain2 delete-domain

※ 管理ドメインの運用ユーザパスワードを変更した場合は、上記コマンドの引数に「-Dadmdomain.admin.password=<管理ドメインの運用ユーザパスワード>」を追加してください。

4.3 ドメインの確認

ドメインの状態を確認する方法について説明します。

4.3.1 ドメインの一覧確認

ドメインの一覧を確認するにはotxadmin list-domainsコマンドを実行してください。そのマシン上で動作するドメインの一覧とそれぞれの状態が表示されます。

注意：このコマンドはローカルマシンからしか実行できません。

otxadmin> list-domains
List of domains:
domain1 running
WebOTXAdmin running

各ドメイン名の表示につづけて以下のいずれかの状態が表示されます。

<ドメイン名> not running     (停止中)
<ドメイン名> starting        (起動処理中)
<ドメイン名> running         (稼働中)

補足 : WebOTXAdminは管理ドメインです。

4.3.2 ドメインの起動完了確認

ドメインの起動が完了し、サービスの要求を受け付けられる状態になっているか確認する方法について説明します。

イベントログによる確認

以下のメッセージがドメインの起動・停止完了時にイベントログへ通知されます。

OTX01205135: アプリケーションサーバ[domain1:server] の起動に成功しました。 (com.nec.webotx.enterprise.system.core)

ログファイルの出力による確認

以下のメッセージがドメインの起動・停止完了時に各ドメインのログファイル(webotx_agent.log)に出力されます。

9999-99-99 00:00:00,000 SLOGINFO com.nec.webotx.enterprise.system.core - OTX01205135: アプリケーションサーバ [domain1:server] の起動に成功しました。 [main] 

4.3.3 コマンドの実行ステータスによるサービスの状態確認

otxadminコマンドのgetコマンドを利用しWebOTXの各サービスの状態を確認します。

get コマンドの --exitstatusオプションを利用することでotxadminコマンドの終了コードに状態コードを反映させることができます。状態によってバッチ処理を行いたいような場合に利用することができます。

例: Webコンテナの起動状態を確認する(Windows)

otxadmin get --exitstatus=true --exiterrornum=-1 server.internal-lifecycle-module.WebContainerService.state
if %errorlevel%==1 echo WebContainer running!

状態コードは以下のように対応しています。

以下のサービスは状態表示をサポートしています。

4.4 ドメインの起動・停止

WebOTXのドメインを起動および停止する方法について説明します。

Windows Server 2008ではドメインの起動・停止は特権昇格したコマンドプロンプトから実行する必要があります。詳しくは「ドメインの運用操作の前に」を参照してください。

4.4.1 ドメインの自動起動設定

WebOTXサービス起動時にドメインを自動起動させるかどうかの設定について説明します。なおデフォルトでは作成したドメインは自動起動します。

ドメインの自動起動を行わないよう設定するには管理ドメインに対して以下のコマンドを実行します。

domain1の自動起動を無効に設定

※この操作は、対象となるドメイン(ここではdomain1)が停止している状態で行ってください。

# otxadmin
otxadmin> login --user admin -password **** --port 6202
otxadmin> invoke domain.disable domain1
otxadmin> exit

再度、自動起動を有効にするには管理ドメインに対して以下のコマンドを実行します。

domain1の自動起動を有効に設定

※この操作は、対象となるドメイン(ここではdomain1)が停止している状態で行ってください。

# otxadmin
otxadmin> login --user admin -password **** --port 6202
otxadmin> invoke domain.enable domain1
otxadmin> exit

4.4.2 管理ドメインの起動/停止

管理ドメインはWebOTXサービスと連動して起動、停止を行います。管理ドメインを起動・停止するにはWebOTXサービスを起動・停止させてください。なおサービスを停止すると全てのドメインは停止されます。

4.4.3 一般ドメインの起動/停止

特定のドメインを起動・停止させるには次のコマンドを実行してください。なおこのコマンドはローカルマシン上でのみ実行可能です。なおコマンドの実行は必ずWebOTX運用ユーザで行なってください。

起動

# otxadmin start-domain <domainname>

停止

# otxadmin stop-domain <domainname>

4.4.4 サービスでの運用とコマンドでの運用の違い

本節は Windows OS で運用している場合限定の内容であり、UNIX OS で運用している場合は対象外です。

start-domain、stop-domainコマンドによるドメイン運用はあくまで開発・評価時に対象となるドメインの起動・停止操作を速やかに行えることを第一の目的として提供しているコマンドです。

サービスからの運用方法との違いはプロセスを起動するユーザの違いに現れます。サービスから運用した場合、WebOTXの各種プロセスはシステムユーザとして起動されます。対して、運用管理コマンドから起動した場合は、運用ユーザのプロセスとして起動します。そのため、起動ユーザの環境設定に依存してしまい、運用時の思わぬトラブルの原因となってしまう場合があります。

そのため、本番環境での運用時にstart-domain、stop-domain　コマンドによるドメイン制御は行わないようご注意ください（本番時はWebOTXサービスとして各ドメインの起動・停止処理を行う運用となります）。

なお、ユーザドメインに対して次のコマンドを実行することで、管理ドメインと同一のユーザプロセスとして起動することが可能です。既に管理ドメインをサービスとして起動していて、システムユーザとしてユーザドメインを運用したい場合にご利用ください。

otxadmin> login --user admin --password xxxx --port 6202
otxadmin> invoke domain.startDomain <domainname>

併せて、ドメイン停止時は管理ドメインに対して次のコマンドを実行してください。

otxadmin> login --user admin --password xxxx --port 6202
otxadmin> invoke domain.stopDomain <domainname>

4.5 運用ユーザの設定

WebOTX運用ユーザの設定は、otxadmin create-file-userおよび、otxadmin delete-file-userコマンドを用いて行います。

4.5.1 運用ユーザの作成

以下に、サーバhost1にあるdomain1（ポート番号6212）に対して、ユーザ名admin1、 パスワードadminadmin1の運用ユーザを作成する例を示します。

otxadmin> create-file-user --userpassword adminadmin1 --groups otxadmin --authrealmname admin-realm admin1

4.5.2 運用ユーザの削除

運用ユーザの削除は、delete-file-userコマンドで行います。コマンドを実行する際のオプションとして--authrealmnameでadmin-realmを指定してください。

otxadmin> delete-file-user --authrealmname admin-realm admin1

4.4.3 運用ユーザの注意事項

• パスワードは8文字以上で「\」「"」は使用できません。
• 作成するユーザはotxadminグループに所属していなければいけません。
• create-file-userコマンドの--authrealmnameオプションは必ずadmin-realmを指定してください。
• ユーザ作成・削除は実際にはドメイン再起動後に有効になります。

4.6 サービスの起動・停止

ドメイン上で動作している各サービスを起動、停止する方法について説明します。

4.6.1 各サービスの起動・停止方法

サービスを起動・停止するotxadminコマンドは、以下の表の通りです。

*: WebOTX Webサーバインストール時のみ

4.6.2 自動起動

ドメインの起動時にサービスを自動起動させるかどうかの設定方法について説明します。

自動起動の確認

現在の設定を確認するには次のコマンドを実行します。

otxadmin> get server.internal-lifecycle-module.<サービス名>.enabled

trueの場合は自動起動をする、falseの場合は自動を起動しない設定です。

<サービス名>は以下の表に従ってください。

例) Object Brokerサービスの自動起動設定を確認

otxadmin> get server.internal-lifecycle-module.ObjectBrokerService.enabled
server.internal-lifecycle-module.ObjectBrokerService.enabled = true

自動起動の設定

自動起動の設定を変更するには次のコマンドを実行します。

otxadmin> set server.internal-lifecycle-module.<サービス名>.enabled={ true | false }

<サービス名>は上記表を参照してください。trueの場合は自動起動設定、falseの場合は自動起動しないに変更します。

注意:表になりサービスの自動起動設定は変更しないでください。正常にドメインが起動しなくなります。

例: Object Brokerサービスが自動起動しないように設定する。

otxadmin> set server.internal-lifecycle-module.ObjectBrokerService.enabled=false

4.7 ポリシーファイルの設定

WebOTXはセキュリティポリシーによりアクセス権が明示的に設定されています。

WebOTXの各サービスが動作するために必要なセキュリティポリシーはデフォルトで以下のファイルに記述されています。

${INSTANCE_ROOT}/config/server.policy

アプレット (またはセキュリティマネージャの下で動作しているアプリケーション) が、ファイルの読み書きなど、セキュリティ保護された操作を行うためには、その操作を行うためにアクセス権を付与する必要があります。必要に応じてserver.policyファイルに必要な権限を設定するようにしてください。

WebOTXでは、各サービスの基本的動作に必要な権限に加え、統合運用管理ツールなどリモートからの運用操作に必要なアクセス権限をデフォルトで定義しています。リモート接続時に必要な権限は、プリンシパル javax.management.remote.JMXPrincipal "otxadmin"によって定義されています。

セキュリティポリシー、ポリシーファイルの記述に関する詳細は、Java SDK の 「セキュリティ」 に関する情報を参照してください。

http://java.sun.com/j2se/1.5.0/ja/docs/ja/guide/security/

4.7.1 新たなポリシーの付与

ドメイン停止状態でポリシーファイルを編集することによって、ポリシーを追加することが可能です。

例: ポリシーの追加

// Grant everyone the following permission:
grant {
    permission java.io.FilePermission "/tmp/*", "read,write";
};

この例では、/tmpディレクトリのすべてのファイルに対する、読み込みと書き込み権を全てのJavaクラスに与えます。

4.7.2 ポリシーファイル編集の際の注意点

• ポリシーファイル編集の際、定められたフォーマットから逸脱してしまうと、Java VMが起動に失敗します。 とくに";"のつけ忘れに注意してください。
• パーミッションを与えすぎると、セキュリティレベルを低下させます。 codeBaseを指定するなど、なるべくパーミッション付与の範囲を狭くするように心がけてください。

4.8 Java VMの設定

WebOTX AS で既定としているJava VM オプションの変更方法とユーザ定義の独自のJava VM オプションの追加方法について説明します。

4.8.1 WebOTX AS で既定のJava VM オプションの設定方法

　　　　　　　　
• クラスパスの設定

JDBCドライバや独自のライブラリをクラスパスに追加する方法について説明します。

• コマンドによるclasspath-suffixの設定

運用管理コマンド(otxadmin)を利用することにより任意の場所にあるライブラリをクラスパスに追加できます。追加はCLASSPATHの最後に行われます。よってWebOTXのシステムライブラリが先に検索されます。

注意:setコマンドで指定するパスは追加ではありません。全て上書きします。

以下のコマンドを実行します。

確認

otxadmin> get server.java-config.classpath-suffix

設定

otxadmin> set server.java-config.classpath-suffix=<クラスパス>

例: クラスパスにD:\mylib.jarを追加

otxadmin> set server.java-config.classpath-suffix=D:\\mylib.jar

• ${INSTANCE_ROOT}/lib/extへの配置

ライブラリを${INSTANCE_ROOT}/lib/extディレクトリに配置することにより自動的にそのライブラリをクラスパスに追加することができます。ここにjar, zipファイルをコピーするとWebOTXのシステムライブラリより上位のクラスローダによってロードされます。このため、例えばJava EEのAPIクラスなど、WebOTXのシステムライブラリに含まれるクラスを含むライブラリをここに配置すると、クラスロードの依存関係が変わり、ドメインが起動できなくなる可能性がありますので注意してください。

• ${INSTANCE_ROOT}/libへの配置

ライブラリを${INSTANCE_ROOT}/libディレクトリにコピーすることにより自動的にそのライブラリをクラスパスに追加することができます。ここにjar, zipファイルをコピーするとWebOTXのシステムライブラリより後で検索されます。

• 共有コンポーネントとして登録（Standard/Enterprise Editionのみ）

ライブラリを共有コンポーネントとして作成し、ドメインに配備することでCORBA JavaアプリケーションまたはEJBアプリケーションからそのライブラリを参照することができます。この場合配備したアプリケーションの設定で参照する共有コンポーネントを指定する必要があります。

• プロセスグループの環境変数CLASSPATHへの追加（Standard/Enterprise Editionのみ）

CORBA JavaアプリケーションまたはEJBアプリケーションのプロセスグループの環境変数CLASSPATHを指定するとそのプロセスグループのクラスパスを指定することができます。

各コンテナでロードされるライブラリと検索の優先順位

EJBコンテナはStandard-J EditionとStandard/Enterprise Editionでは、実行されるJava VMのプロセスが異なります。Standard-J Editionの場合は、エージェント同じJava VM上で動作しますが、Standard/Enterprise Editionの場合は、エージェントとは別のプロセスグループのJava VM上で動作します。

Edition別のコンテナがロードするライブラリと、検索の優先順位を以下に示します。優先度の高いもの順から記述しています。“○” はロードされることを示し、”×”はロードされないことを示します。

設定方法	Webコンテナ	EJBコンテナ(Standard-J)	EJBコンテナ(Standard/Enterprise)
${INSTANCE_ROOT}/lib/extへの配置	○	○	○
WebOTXシステムライブラリ	○	○	○
classpath-suffix	○	○	×
プロセスグループの環境変数CLASSPATHへの追加	×	×	○
${INSTANCE_ROOT}/lib	○	○	○
共有コンポーネントとして配備	×	×	○



• Java VM のメモリサイズの設定

Java VM のメモリサイズに関する設定項目として以下のものがあります。

オプション名	オプションの役割	属性
-Xms	初期Javaヒープサイズ	server.java-config.heap-size
-Xmx	最大Javaヒープサイズ	server.java-config.max-heap-size
-XX:PermSize	初期Javaパーマネントサイズ	server.java-config.perm-size
-XX:MaxPermSize	最大Javaパーマネントサイズ	server.java-config.max-perm-size



• Java VM のヒープサイズの設定方法

運用管理コマンド(otxadmin)を利用することによりJava VM のヒープサイズを設定することができます。

以下のコマンドを実行します。

確認

otxadmin> get server.java-config.classpath-suffix

設定

otxadmin> set server.java-config.classpath-suffix=<クラスパス>

例: クラスパスにD:\mylib.jarを追加

otxadmin> set server.java-config.classpath-suffix=D:\\mylib.jar

• GCログの設定

GCログに関する設定項目として以下のものがあります。

オプション名	オプションの役割	属性
-verbose:gc	GCログ採取(標準出力)	server.java-config.verbose-gc-enabled
-Xloggc	GCログ採取(指定ファイルへの出力)	server.java-config.heap-size

設定方法は「Java VM のヒープサイズの設定方法」と同様です。



• ネイティブライブラリパスの設定

ネイティブライブラリパスに関する設定項目として以下のものがあります。

オプション名	オプションの役割	属性
-java.library.path	ネイティブライブラリパス	server.java-config.native-library-path-prefix
		server.java-config.native-library-path-suffix

ネイティブライブラリパスであるjava.library.pathシステムプロパティへのパスの追加には「Java VM のヒープサイズの設定方法」と同様の手順で行うことができます。

但し、ネイティブライブラリパスへの追加はパスの順序の違いにより以下の2通りがあります。

• native-library-path-prefix

java.library.pathの先頭に追加

• native-library-path-suffix

java.library.pathの末尾に追加

• デバッグオプションの設定

デバッグオプションに関する設定項目として以下のものがあります。

　　　　　　　　　　

オプション名	オプションの役割	属性
-Xdebug	デバッグ有効オプション	server.java-config.debug-enabled
-Xrunjdwp	jdwpロードオプション	server.java-config.debug-options

設定方法は「Java VM のヒープサイズの設定方法」と同様です。

4.8.2 ユーザ独自のJava VMオプションの追加方法

ドメイン起動のJava VMに独自のオプションを設定する方法について説明します。

コマンドによる設定

運用管理コマンド(otxadmin)を利用することにより、任意の場所にあるライブラリをクラスパスに追加したり、Java VMの動作を調整するためのオプションを指定したりすることができます。なお運用管理コマンド「create-jvm-options」、「delete-jvm-options」については「運用管理コマンドリファレンスマニュアル」を参照してください。

注意:VMオプション削除時はプロパティ名だけでなく現在設定されているプロパティの値も指定してください。また、現在設定していいるプロパティを変更するにはいったん削除して作成しなおしてください。

以下のコマンドを実行します。

確認

otxadmin> get server.java-config.jvm-options

設定

otxadmin> create-jvm-options <オプション名>=<値>

削除

otxadmin> delete-jvm-options <オプション名>

例: -Dmy-debug-option=trueを追加

otxadmin> create-jvm-options -Dmy-debug-option=true

なお、「<オプション名>=<値>」の形式にならないオプションを設定、削除する場合は明示的にオプションの終了を示す':'（コロン）を最後に付け加えてください。

例） オプション -Xss(スレッドのネイティブスタックサイズ) の値を1024kとして追加

otxadmin> create-jvm-options -Xss1024k:

オペランドの前に'--'を記述することでも実行可能です。

otxadmin> create-jvm-options -- -Xss1024k

また、予めシステム側で設定しているオプションを参照したり、それらの値に変更を加える場合には、次のように指定してください。

確認

otxadmin> get server.java-config.system-jvm-options

設定

otxadmin> create-jvm-options --system <オプション名>=<値>

削除

otxadmin> delete-jvm-options --system <オプション名>

例） システム側で定義済みのシステムプロパティ java.ext.dirs(インストール型拡張機能の位置をオーバーライド)を変更

otxadmin> delete-jvm-options --system -Djava.ext.dirs=<現在のプロパティ値>

otxadmin> create-jvm-options --system -Djava.ext.dirs=<新規のプロパティ値>

注意:これらのオプション変更は慎重に行って下さい。誤ってオプションを削除したり、不正なオプションを指定すると、ドメインが起動しなくなる恐れがあります。

4.9 統計情報の取得

統計情報の採取および取得方法について説明します。なお詳細は「WebOTX運用編(モニタリング)」を参考にしてください。

4.9.1 統計情報の出力レベル設定

まず統計方法の出力レベルを設定します。otxadminのsetコマンドを利用してレベルを設定します。なおモジュールにより設定できる出力レベルが異なります。

otxadmin> set server.monitoring-service.module-monitoring-levels.<モジュール名>=<レベル>

指定できるレベル

• OFF(統計情報を出力しない)
• ON(統計情報を出力する(LOWと同様))
• LOW(概要レベルの統計情報を出力する)
• HIGH(詳細レベルの統計情報を出力する)

設定可能な統計情報

例: jvmモジュールのレベルをHIGHに設定します

otxadmin> set server.monitoring-service.module-monitoring-levels.jvm=HIGH

4.9.2 統計情報の出力レベル確認

現在の統計情報の出力レベルを確認するにはotxadminのgetコマンドを利用します。

例: 全てのモジュールのレベルを確認

otxadmin> get server.monitoring-service.module-monitoring-levels.*
server.monitoring-service.module-monitoring-levels.connector-connection-pool = OFF
server.monitoring-service.module-monitoring-levels.connector-service = OFF
server.monitoring-service.module-monitoring-levels.ejb-container = OFF
server.monitoring-service.module-monitoring-levels.http-service = OFF
server.monitoring-service.module-monitoring-levels.jdbc-datasource = OFF
server.monitoring-service.module-monitoring-levels.jms-service = OFF
server.monitoring-service.module-monitoring-levels.jvm = HIGH
server.monitoring-service.module-monitoring-levels.thread-pool = OFF
server.monitoring-service.module-monitoring-levels.transaction-service = OFF
server.monitoring-service.module-monitoring-levels.web-container = OFF

4.9.3 統計情報の取得

統計情報の出力レベルをON,LOW,HIGHに設定すると、統計情報採取用のWebOTX統計MBeanが登録されますので、その属性をotxadminコマンドで取得することができます。

例: モジュールjvmの現在登録されている統計情報

otxadmin> get --monitor=true server.jvm.*
server.jvm.HeapFreeSize-Current = 34199456
server.jvm.HeapFreeSize-HighWaterMark = 34199456
server.jvm.HeapFreeSize-LowWaterMark = 0
server.jvm.HeapFreeSize-LowerBound = 0
server.jvm.HeapFreeSize-UpperBound = 518979584
server.jvm.HeapSize-Current = 73805824
server.jvm.HeapSize-HighWaterMark = 73805824
server.jvm.HeapSize-LowWaterMark = 0
server.jvm.HeapSize-LowerBound = 0
server.jvm.HeapSize-UpperBound = 518979584
server.jvm.HeapUsedRate-Current = 53
server.jvm.HeapUsedRate-HighWaterMark = 60
server.jvm.HeapUsedRate-LowWaterMark = 0
server.jvm.HeapUsedRate-LowerBound = 0
server.jvm.HeapUsedRate-UpperBound = 100
server.jvm.HeapUsedSize-Current = 39716224
server.jvm.HeapUsedSize-HighWaterMark = 39802144
server.jvm.HeapUsedSize-LowWaterMark = 0
server.jvm.HeapUsedSize-LowerBound = 0
server.jvm.HeapUsedSize-UpperBound = 518979584
server.jvm.UpTime-Count = 2507712

また、レベル設定後、otxadmin コマンド上でこれらの統計情報を定期的に取得するための monitor コマンドを用意しています。一定期間情報を取り続け、そのデータから分析を行う場合に有効です。

4.9.4 Transactionサービス（JTA）統計情報の取得

Transactionサービス（JTA）に関する統計情報の採取および取得方法について説明します。

パフォーマンスデータの取得方法

統合運用管理ツールを利用する場合

次の手順で実施します。

1. 統合運用管理ツールよりドメインと接続します。
2. ツリービューより「<ドメイン名>」-「統計情報」-[domain] -「アプリケーションサーバ」-「Transactionサービス」を選択すると右側に表示されます。ただしこのツリーは、モニタリングレベルがOFF以外に設定されている必要がありますのでご注意ください。設定方法については「モニタリングについて」を参照してください。

コマンドを利用する場合

次のコマンドで取得します。ただし統合運用管理ツールの場合同様に、モニタリングレベルがOFFに設定されている場合失敗します。

otxadmin> get --monitor=true server.transaction-service.*
server.transaction-service.ActiveCount-Count = 0
server.transaction-service.ActiveIds-Current = No Transactions exists.
server.transaction-service.ApplicationRolledbackCount-Count = 1
server.transaction-service.AverageTAT-Count = 26975
server.transaction-service.Committed2PCCount-Count = 2
server.transaction-service.CommittedCount-Count = 5
server.transaction-service.CompletedCount-Count = 7
server.transaction-service.DeletedCount-Count = 0
server.transaction-service.ForgottenCount-Count = 0
server.transaction-service.HeuristicCount-Count = 0
server.transaction-service.ResourceRolledbackCount-Count = 1
server.transaction-service.RolledbackCount-Count = 2
server.transaction-service.SystemRolledbackCount-Count = 0
server.transaction-service.TimedOutCount-Count = 0
server.transaction-service.TransferedCount-Count = 1

トランザクション一覧の取得、および操作方法

モニタリングレベルをLOW、あるいはHIGHに設定した場合には、統合運用管理ツール、およびotxadminコマンドを使用して実行中のトランザクション情報も取得することができます。また表示したトランザクションに対する操作も可能です。

なお、モニタリングレベルがOFFの場合はotxadminコマンドでは表示されません。

次にotxadminコマンドを使用したトランザクション一覧の取得、および操作について説明します。

トランザクション一覧の表示

otxadminコマンドを使用する場合、属性名を次のように指定します。

otxadmin> get --monitor=true server.transaction-service.ActiveIds-Current

これにより実行中トランザクションの一覧が確認できます。実行中のものが存在しない場合、

server.transaction-service.ActiveIds-Current = No Transaction Exists.

と表示されます。存在する場合は

server.transaction-service.ActiveIds-Current =
Transaction ID Status A/R Start Time
----------------+--------------------+-------+-------------------
0277689751350000 StatusCommitting     Active  2008/6/8 14:39:53
0384489751290000 StatusCommitting     Active  2008/6/8 14:39:54
0255289751170000 StatusPrepared       Active  2008/6/8 14:39:57
0277689749150001 StatusUnknown        Recover 2008/6/8 14:40:49
0384489749070001 StatusUnknown        Active  2008/6/8 14:40:51

のように表示されます。統合運用管理ツールでは前述の方法で実施すると右側ペインに上記のように表示されます。

次にそれぞれの項目について説明します。詳細については「コンフィグレーション」をご参照ください。

トランザクションの操作

トランザクションの操作は次のように実施します。

統合運用管理ツールを利用する場合

1. 統合運用管理ツールよりドメインと接続します。
2. ツリービューより「<ドメイン名>」-「統計情報」-[domain]-「アプリケーションサーバ」-「Transactionサービス」を選択します。
3. 右側に表示されるTransaction IDをコピーし、「Transactionサービス」ツリーを右クリックして上図のようなメニューを出します。
4. 実施するコマンドを指定してください。なお、トランザクションの状態によって実行可能なコマンドが制限されます。詳細は「トランザクションの状態一覧」をご参照ください。
5. 次のような画面が出ますのでparam1のところに3.でコピーしたTransaction IDを貼り付けて「実行」を押して処理を開始してください。

コマンドを利用する場合

1. otxadminコマンドを起動し、ドメインにログインします。

otxadmin> login

2. それぞれ次のように、トランザクション識別子を指定してコマンドを実施します。ただしモニタリングレベルがOFFに設定されている場合失敗します。なお、この処理によってデータベースの状態が不安定になる可能性がありますので実行には十分注意が必要です。
• トランザクションの強制コミット

otxadmin> commit-transaction 0277689751350000

• トランザクションの強制ロールバック

otxadmin> rollback-transaction 0277689751350000

• トランザクションの破棄(フォゲット)

otxadmin> forget-transaction 0277689751350000

• トランザクションの強制削除

otxadmin> delete-transaction 0277689751350000

トランザクションの操作については、Transactionサービス(統合運用管理ツールの「<ドメイン名>」-「アプリケーションサーバ」-「Transactionサービス」ツリー)からも実施可能です。詳細については「Transactionサービスの運用操作」をご参照ください。

4.10 コード変換について

コード変換について説明します。

4.10.1 CORBA通信におけるコード変換

CORBA通信でのコード変換について説明します。

C++アプリケーションとJavaアプリケーション間のCORBA通信で、日本語データを送受信する場合には、文字化けが発生しないように、適切なコードセットの設定を行う必要があります。C++アプリケーションとJavaアプリケーション間ではそのコードセットの設定情報を交換して、どのようにコード変換を行うかを決定しています。個々の文字列の内容をチェックしている訳ではありません。そのため、実際にC++アプリケーションがどのような文字列を送受信するかによって、正しいNativeコードセットの設定を行っておく必要があります。例えば、C++アプリケーションでSJISの文字列をデータベースやファイルから読み込んで送受信するのであれば、NativeコードセットもSJISに設定する必要があります。

詳細については、次を参照してください。

Object Broker C++では、運用編「コンフィグレーション」の「WebOTX Object Broker C++における環境設定」 の「コードセットに関するオプション設定」を参照してください

を参照してください。

Object Broker Javaでは、

WebOTX アプリケーション開発ガイド- 第4部 7.2.Object Broker - Object Broker Java の機能 - 文字コードセットを参照してください。

4.10.2 Webアプリケーションの文字エンコーディングの設定について

Webアプリケーションでは、リクエストやレスポンスの文字エンコーディングをさまざまなところで指定することができます。以下に、場所に応じた文字エンコーディングの指定方法を説明します。

Servletの場合

リクエストパラメータ

Webブラウザから POSTメソッドで送付されるリクエストパラメータは、javax.servlet.ServletRequest.getParameter() を使って取得しますが、このパラメータを取得する際の文字エンコーディングは次のメソッドで指定します。

javax.servlet.ServletRequest.setCharacterEncoding()

このメソッドは、getParameter() の前に呼び出す必要があります。

レスポンス

Servlet からクライアントに出力するレスポンスの文字エンコーディングは次のメソッドで指定します。

javax.servlet.ServletResponse.setContentType()

引数として、"text/html; charset=Shift_JIS" のように指定します。このメソッドは、PrintWriterを取得する前に呼び出す必要があります。

JSPの場合

リクエストパラメータ

Servlet の場合と同様です。

レスポンス

JSP からクライアントに出力するレスポンスの文字エンコーディングは次のように pageディレクティブで指定します。

<%@ page contentType="text/html; charset=Shift_JIS" %>

また、JSPファイル自体がどの文字エンコーディングで保存されているかを指定する要素として次のものがあります。

<%@ page pageEncoding="Shift_JIS" %>

もし、上記の指定をしていない場合、デフォルトの "ISO-8859-1" となりますが、このデフォルト値を変更する事も可能です。

変更するには、次のように otxadmin コマンドを使って default-encoding プロパティで指定します。ドメインを起動したあと、次のようにコマンドを実行してください。

otxadmin> set server.web-container.property.default-encoding=Shift_JIS

また、JSP を事前コンパイルする場合のデフォルト文字エンコーディングは nec-web.xml で次のように指定します。

<jsp-config>
    <property name="precompileDefaultEncoding" value="Shift_JIS"/>
</jsp-config>

なお、デフォルト文字エンコーディングの指定は JSP をコンパイルする時に決定します。事前コンパイルした場合は nec-web.xml の指定が、そうでない場合は default-encoding プロパティ指定が有効になります。事前コンパイルでない場合、指定を変更するには Webアプリケーションを再配備し、JSP を再コンパイルする必要があります。

4.11 Javaプロセスの監視・管理

ドメイン内で起動するJavaプロセス(JVM)を監視・管理する方法について説明します。
方法は幾つかあり、それぞれ対象となるJavaプロセスやその表示形式が異なりますので、目的に応じて使い分けて下さい。

4.11.1 運用管理ツールによる監視・管理

WebOTXが提供する各種運用管理ツールを使用してJavaプロセスの監視・管理を行います。
この方法では、次のJavaプロセスが監視・管理の対象となります。

• ドメインに対するエージェントプロセス
  javaw.exe(Windows)、java(UNIX)

統合運用管理ツール

ドメインに接続後、「<ドメイン名>」-「統計情報」-「domain」-「アプリケーションサーバ」-「JVM」を選択すると、画面右側に監視情報が表示されます。

運用管理コマンド

ドメインにログイン後、JVMの統計情報に対するコマンド表記名(server.jvm)を使用して、次のコマンドを実行します。

otxadmin> get --monitor=true server.jvm.*

デフォルトの状態では、ヒープの消費状況や実行時間についての情報を参照することができます。

より詳細な情報を参照するためには、JVMに対するモニタリングレベルを変更します。モニタリングレベルに応じて、次のような情報を参照することができます。

なお、各監視対象で参照可能な監視項目の詳細については、運用編(モニタリング)を参照してください。

統合運用管理ツール

「<ドメイン名>」-「アプリケーションサーバ」-「モニタリングサービス」-「モジュールモニタリングレベル」を選択し、画面右側に表示される設定項目「JVM」の値を LOW もしくは HIGH に変更し、「更新」ボタンを押します。

運用管理コマンド

次のコマンドを実行します。

• LOW レベルに変更 :

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

• HIGH レベルに変更 :

  otxadmin> set server.monitoring-service.module-monitoring-levels.jvm=HIGH

※監視を終了する場合は、モニタリングレベルを OFF に戻して設定を更新してください。

また、統合運用管理ツールでは、定期的な情報採取によりこれまでに取り上げた監視項目をグラフ化表示したり、監視項目が一定条件を満たした際にその旨を通知画面に出力したりすることができます。一方で、運用管理コマンドではJVMヒープ情報に関して、定期的な情報採取により監視項目をプロンプト画面に出力することができます。詳しくは、運用管理ツール「統計情報」を参照してください。

4.11.2 jconsoleによる監視・管理

JDK 5.0およびJDK6.0に付属のJMX(Java Management Extensions)仕様に準拠した監視ツールjconsoleを利用して、Javaプロセスの監視・管理を行います。
この方法では、次のJavaプロセスが監視・管理の対象となります。

• JDK 5.0使用時
• ドメインに対するエージェントプロセス
  javaw.exe(Windows)、java(UNIX)
• JDK 6.0使用時
• ドメインに対するエージェントプロセス
  javaw.exe(Windows)、java(UNIX)
• その他のJavaプロセス(ローカルマシン上のプロセスのみ)

また、jconsoleに関する詳しい説明は、使用するバージョンに応じてSunの公式サイトを参考にして下さい。

• JDK5.0向け（http://java.sun.com/j2se/1.5.0/ja/docs/ja/guide/management/jconsole.html）
• JDK6.0向け（http://java.sun.com/javase/ja/6/docs/ja/technotes/guides/management/jconsole.html）

但し、jconsoleをWebOTXと同じマシン（ローカル）で動作させるか、異なるマシン（リモート）で動作させるかによってパラメータ指定画面が異なります。以下に接続例を示します。

jconsoleをWebOTXと同じマシン（ローカル）で動作させている場合

JDK5.0付属jconsole画面

JDK6付属jconsole画面

「ローカル」タブ（JDK5.0版）/「ローカルプロセス」（JDK6版）をクリックし、接続候補リストの中から「クラスと引数」（JDK5.0版）/「名前」（JDK6版）列に“com.nec.webotx.enterprise.server.WOLaunch start”（JMXエージェントへの接続）が表示されている行を選択し、「接続」ボタンを押します。

※上記以外のJavaプロセスを監視する場合には、「3.3 動作プロセスについて」で記載されている引数情報を参考に対象のプロセスを選択してください。

jconsoleをWebOTXと異なるマシン（リモート）で動作させている場合

JDK5.0付属jconsole画面

JDK6付属jconsole画面

「リモート」タブ（JDK5.0版）/「リモートプロセス」（JDK6版）をクリックし、「ホストまたはIP」列に接続先のホスト名またはIPアドレスを、「ポート」にはドメインの管理ポート番号を入力します（JDK5.0版）。あるいは、入力フィールドに<ホスト名>:<ポート>の形式で入力します（JDK6版）。「ユーザ名」と「パスワード」には、ドメインに対して設定されている運用ユーザ名とパスワードを入力します。

パラメータ指定後、「接続」ボタンを押します。

接続に成功すると、以下のような画面が表示されます。

JDK5.0付属jconsole画面

JDK6付属jconsole画面

初期表示画面では「概要」タブが選択されており、監視対象のJVMに関するパフォーマンス情報とリソース消費情報、およびOSに関するリソース情報が表示されます。

この他の画面では、カテゴリ毎に情報が細分化され、それらの監視項目がグラフィカルに表示されます。以下に、各表示項目について簡潔に説明します。

• メモリ: JVM内でのメモリの消費状況や、メモリプールに関する情報が表示されます。
• スレッド: JVM内で生成されるスレッドに関する情報が表示されます。WebOTXが生成するスレッドや、ユーザが配備したアプリケーションなどのスレッドに関する情報も併せて表示されます。
• クラス: JVM内で使用されるクラスのロードに関する情報が表示されます。
• MBean: JVM内に存在するMBean（Managed Bean）に関する情報が表示されます。ユーザが作成したMBeanに関する情報も併せて表示されます。なお、WebOTXが生成するMBeanの情報を参照することはできません。※
• VM（の概要）: JVMに関する監視項目に加え、クラスパスなどの設定情報が表示されます。WebOTXやユーザが追加設定したクラスパスなどの情報も併せて表示されます。

（※）WebOTXでは、高機能化の実現にあたり、独自にJMX仕様を拡張させたMBeanを使用しています。そのため、そのMBeanを示すツリーノードは画面左側に表示されますが、ノードをクリックした場合、jconsoleでは対応しきれず以下のエラーメッセージが表示されます。

これらのMBeanは通常システム内部でのみ使用するため、ユーザが参照する必要はありません。これらのMBeanは、システム内部および「統合運用管理ツール」や「運用管理コマンド」などから参照されます。

4.11.3 統計レポート出力

運用管理コマンドを使用して、Javaプロセスに対する様々な監視項目をレポート形式で出力します。
この方法では、次のJavaプロセスが監視・管理の対象となります。

• ドメインに対するエージェントプロセス
  javaw.exe(Windows)、java(UNIX)

指定したドメインにログイン後、以下に示すコマンドを入力することで、ドメイン内のJavaプロセスに対して対象となる監視項目を画面に表示することができます。

otxadmin> generate-jvm-report --type <統計情報のタイプ名> <サーバ名>

<統計情報のタイプ名>には、summary、memory、class、thread のいずれかを指定します。<サーバ名>には、情報取得の対象となるサーバ(Javaプロセス)の名前を指定します。サーバ名は次のようになります。

• ドメインに対するエージェントプロセス : server

なお、--type オプションが省略された場合は<統計情報のタイプ名>に "summary" が、<サーバ名>が省略された場合は "server" がデフォルトとして指定されます。

• サマリ情報の表示(OS、クラスパス、システムプロパティ、etc.)
  

  otxadmin> generate-jvm-report --type summary <サーバ名>

  ＜出力結果例＞

otxadmin> generate-jvm-report --type summary server

**** Java Virtual Machine [Application Server Instance Name: server] Summary ****

Operating System Information:
Name of the Operating System: Windows 2003
Binary Architecture name of the Operating System: x86, Version: 5.2
    :

General Java Runtime Environment Information for the VM: 3780@HOSTNAME
[JRE BootClassPath]
D:\WebOTX/lib/endorsed\activation.jar
D:\WebOTX/lib/endorsed\resolver.jar
D:\WebOTX/lib/endorsed\serializer.jar
    :

[JRE ClassPath]
D:\WebOTX\lib\wosv-launch.jar
D:\WebOTX\lib\javaee.jar
D:\Program Files\Java\jdk1.5.0_15/lib/tools.jar
    :

[JRE Native Library Path]
D:\WebOTX\lib
D:\WebOTX\share\bin
D:\WebOTX\TS\bin
    :

JRE name: Java HotSpot(TM) Server VM Vendor: Sun Microsystems Inc. Version: 1.5.0_15-b04
List of System Properties for the Java Virtual Machine:
awt.toolkit = sun.awt.windows.WToolkit
catalina.base = D:\WebOTX\domains\domain1
catalina.home = D:\WebOTX\domains\domain1
    :

コマンドを実行したタイミングでの、JVMが動作するOS情報を始め、設定されているクラスパス(ブートクラスパス、システムクラスパス)やネイティブライブラリパスおよび、システムプロパティなどが一覧形式で表示されます。

• メモリ情報の表示(ヒープ、GC、etc.)
  

  otxadmin> generate-jvm-report --type memory <サーバ名>

  ＜出力結果例＞

otxadmin> generate-jvm-report --type memory server

**** Memory (Perm Gen, Eden Space etc.) Information for Java Virtual Machine [Application Server Instance Name: server] ****

[Memory Information]
Heap Memory Usage:         53,695 K /    96,832 K total(committed),  55 % used [        0 K init,   466,048 K max]
Non-heap Memory Usage:     53,184 K /    65,376 K total(committed),  81 % used [   18,688 K init,   245,760 K max]

Approximate number of objects for which finalization is pending: 0

[Memory Pool Information]
The uptime of Java Virtual Machine: 4 Hours 48 Minutes 45 Seconds
PS Eden Space      14,165 K /    38,400 K total(committed),  36 % used [    3,072 K init,   158,848 K max]
PS Perm Gen        45,804 K /    57,984 K total(committed),  78 % used [   16,384 K init,   196,608 K max]
PS Survivor Space   2,000 K /     6,912 K total(committed),  28 % used [      512 K init,     6,912 K max]
    :

PS Eden Space
  +------------------------------------------------------------+
  |/////        |                                              |  36 % used
  +------------------------------------------------------------+
  || init (3,072 K)
  |----| used (14,165 K)
  |-------------| committed (38,400 K)
  |------------------------------------------------------------| max (158,848 K)

PS Perm Gen
  +------------------------------------------------------------+
  |/////////////   |                                           |  78 % used
  +------------------------------------------------------------+
  |----| init (16,384 K)
  |------------| used (45,804 K)
  |----------------| committed (57,984 K)
  |------------------------------------------------------------| max (196,608 K)
    :

[Garbage Collector Information]
Name of the Garbage Collector: PS MarkSweep
Number of collections occured using this garbage collector: 10 Times
Garbage Collection Time: 2 Seconds 840 Milliseconds
    :

コマンドを実行したタイミングでの、ヒープ、非ヒープ領域のメモリ使用状況を始め、各メモリプール毎に細分化したメモリ情報のスナップショット、およびそれらの視覚的な表示、ならびにGC動作情報などが一覧形式で表示されます。

JVMベンダーや指定されたJVMオプションによって多少メモリプール情報の内容が異なりますが、大抵の場合、次のような内容となります。

• ヒープ領域
• "Eden" を含む項目
  Javaヒープ領域における Eden 領域部分のメモリ情報を示します。生成されたオブジェクトが最初に格納される領域です。
• "Survivor" を含む項目
  Javaヒープ領域における Survivor 領域のメモリ情報を示します。Eden 領域に対してGCが実行された結果生き残ったオブジェクトがここに格納されます。
• "Tenured" を含む項目
  Javaヒープ領域における Tenured 領域のメモリ情報を示します。Survivor 領域に対してGCが実行された結果生き残ったオブジェクトがここに格納されます。
• 非ヒープ領域
• "Perm" を含む項目
  Javaヒープ領域における Permanent 領域のメモリ情報を示します。JVM自体のデータやクラスのデータを格納する領域です。
• "Code Cache" を含む項目
  Javaヒープ領域における Code Cache 領域のメモリ情報を示します。JITコンパイラによって生成されたネイティブコードなどを格納する領域です。

また、それぞれの値に示された項目は次のような内容となります。

• init
  起動中にJVMがOSから要求する初期メモリサイズ(Kバイト)を表します。
• used
  現在使用されているメモリサイズ(Kバイト)を表します。
• committed
  JVMが使用できることが保証されているメモリサイズ(Kバイト)を表します。
• max
  メモリ管理に使用できる最大メモリサイズ(Kバイト)を表します。

なお、JVM側の挙動により、まれにスナップショットされた値に不整合が生じる影響で、視覚的な表示が正しく表示されない場合があります。ご了承ください。

• クラス情報の表示(クラスのロード/アンロード、コンパイル、etc.)
  

  otxadmin> generate-jvm-report --type class <サーバ名>

  ＜出力結果例＞

otxadmin> generate-jvm-report --type class server

**** Class Statistics for Java Virtual Machine [Application Server Instance Name: server] ****

Class loading and unloading in the Java Virtual Machine:
Number of classes currently loaded in the Java Virtual Machine: 8,135
Number of classes loaded in the Java Virtual Machine since the startup: 8,667
    :

コマンドを実行したタイミングでの、ロードおよびアンロードされたクラスのカウント情報などが一覧形式で表示されます。

• スレッド情報の表示(スレッドダンプ、デッドロック検出、etc.)
  

  otxadmin> generate-jvm-report --type thread <サーバ名>

  ＜出力結果例＞

otxadmin> generate-jvm-report --type thread server

**** Thread Dump for Java Virtual Machine [Application Server Instance Name: server] ****

Full Java Thread Dump Java HotSpot(TM) Server VM 1.5.0_15-b04 Sun Microsystems Inc.
Number of threads: 98
Number of daemon threads: 79

Thread "Thread-739" thread-id 2,309 thread-state RUNNABLE Running in native
         at: java.net.SocketInputStream.socketRead0(Native Method)
         at: java.net.SocketInputStream.read(SocketInputStream.java:129)
         at: jp.co.nec.orb.GIOP.Message.readPartOfMessage(Message.java:944)
         at: jp.co.nec.orb.GIOP.Message.readOneMessage(Message.java:894)
         at: jp.co.nec.orb.GIOP.Message.dispatchReceiveMessage(Message.java:823)
         at: jp.co.nec.orb.ClientReader.run(ClientReader.java:648)
         at: java.lang.Thread.run(Thread.java:595)

Thread "RMI TCP Connection(1360)-HOSTNAME" thread-id 2,308 thread-state RUNNABLE Running in native
         at: java.net.SocketInputStream.socketRead0(Native Method)
         at: java.net.SocketInputStream.read(SocketInputStream.java:129)
         at: java.io.BufferedInputStream.fill(BufferedInputStream.java:218)
         at: java.io.BufferedInputStream.read(BufferedInputStream.java:235)
         at: java.io.FilterInputStream.read(FilterInputStream.java:66)
         at: sun.rmi.transport.tcp.TCPTransport.handleMessages(TCPTransport.java:448)
         at: sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(TCPTransport.java:707)
         at: java.lang.Thread.run(Thread.java:595)

Thread "RMI TCP Connection(1359)-HOSTNAME" thread-id 2,307 thread-state RUNNABLE Running in native
         at: java.net.SocketInputStream.socketRead0(Native Method)
         at: java.net.SocketInputStream.read(SocketInputStream.java:129)
         at: java.io.BufferedInputStream.fill(BufferedInputStream.java:218)
         at: java.io.BufferedInputStream.read(BufferedInputStream.java:235)
         at: java.io.FilterInputStream.read(FilterInputStream.java:66)
         at: sun.rmi.transport.tcp.TCPTransport.handleMessages(TCPTransport.java:448)
         at: sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(TCPTransport.java:707)
         at: java.lang.Thread.run(Thread.java:595)

    :

No deadlock found

コマンドを実行したタイミングでの、JVM内の全スレッドの動作情報、およびスレッド毎のスタックトレース情報(＝スレッドダンプ)などが一覧形式で表示されます。また、JVM内のスレッド間でデッドロックが発生している場合には、その旨を示す内容が画面に表示されます。

プロンプトの設定状況によっては記述の途中で改行されたり、最初の方の出力結果が表示されない場合があります。一方で、出力結果をファイルに保存したい場合があります。その際は、コマンドの実行結果を任意のファイルにリダイレクトする等の方法が有効です。

otxadmin generate-jvm-report --user <ユーザ名> --password <パスワード> --host <ホスト名> --port <ポート番号> --type thread server > <出力先ファイルパス>

4.11.4 GCログ出力

JavaプロセスにおけるGC処理の様子をファイルへ出力します。
この方法では、次のJavaプロセスが監視・管理の対象となります。

• ドメインに対するエージェントプロセス
  javaw.exe(Windows)、java(UNIX)

統合運用管理ツール

ドメインに接続後、「<ドメイン名>」-「アプリケーションサーバ」-「JVM構成」を選択し、画面右側に表示される「GC」タブ内の設定項目-「GC情報の出力」にチェックを入れます。この状態では、標準出力用のログファイルであるserver.log(${INSTANCE_ROOT}/logs配下)に出力されますので、任意のファイルにGCログ情報を出力するためには、さらに同タブ内の項目「GC情報の出力先」にて、ファイル出力先のフルパスを指定して下さい。
設定後、「更新」ボタンを押します。設定は、ドメインの再起動後に反映されます。

運用管理コマンド

ドメインにログイン後、次のコマンドを実行します。

otxadmin> set server.java-config.verbose-gc-enabled=true

※GCログの採取を終了する場合は、設定を元の状態に戻します(運用管理コマンドの場合は値をfalseに設定)。

なお、ドメイン再起動の度に過去のGCログファイルは上書きされますので、ログを残す場合にはドメイン起動の前にファイルを別の場所に退避するか、リネームするなどの処置を行ってください。

出力結果例

3.886: [GC 16446K->3056K(62848K), 0.0165272 secs]
9.617: [GC 19504K->4723K(62848K), 0.0174459 secs]
16.169: [GC 21171K->7358K(62848K), 0.0296354 secs]
17.911: [GC 11882K->7984K(62848K), 0.0125603 secs]
17.924: [Full GC 7984K->7787K(62848K), 0.1311320 secs]
        :

上記出力例の場合、1行目のログは、JVMが起動してから3.886秒後に、GCによってJavaヒープ領域内のオブジェクトの合計サイズが16,446K(≒16M)バイトから3,056K(≒3M)バイトに減少したことを示します。すなわち、このGCにより13,390K(≒13M)バイトの領域が解放されたことになります。また、カッコ内の数値は、現在のJavaヒープ全体のサイズが62,848K(≒62M)バイトであることを示します。最後の数値は、このGCに要した時間で、0.0165272(≒17ミリ)秒となります。
なお、ログ中の "GC" は、Scavenge GC、"Full GC" は、フルGC が発生したことを示します。

• Scavenge GC
  Young領域(下図 Eden、Survivor)が不足した場合に実行されます。頻繁に行われ、数ミリ〜数十ミリ秒程度の処理時間を要します。
• Full GC
  Young領域、Old領域(下図 Tenured)、Permanent領域(下図 Permanent)が不足した場合に実行され、数ミリ〜数百ミリ秒程度、場合によっては数秒の処理時間を要します。

より詳細なGC情報を参照するためには、JVMオプションを追加します。オプションに応じて、次のような情報を参照することができます。

統合運用管理ツール

「<ドメイン名>」-「アプリケーションサーバ」-「JVM構成」を選択し、画面右側に表示される「JVMオプション」タブ内の設定項目-「JVMオプション」に上述のオプションを追加し、「更新」ボタンを押します。

運用管理コマンド

次のコマンドを実行します(上述のオプションを全て指定する場合)。

otxadmin> create-jvm-options -- "-XX\:+PrintGCTimeStamps"

otxadmin> create-jvm-options -- "-XX\:+PrintGCDetails"

otxadmin> create-jvm-options -- "-XX\:+PrintHeapAtGC"

otxadmin> create-jvm-options -- "-XX\:+PrintTenuringDistribution"

GCログの採取を終了する場合は、オプションを削除します(運用管理コマンドの場合は delete-jvm-options コマンドにて各オプションを指定し削除)。

上述のオプションを全て指定した場合の出力結果例

3.970: [GC {Heap before gc invocations=0:
 def new generation   total 19648K, used 17472K [0x10010000, 0x11560000, 0x1aab0000)
  eden space 17472K, 100% used [0x10010000, 0x11120000, 0x11120000)
  from space 2176K,   0% used [0x11120000, 0x11120000, 0x11340000)
  to   space 2176K,   0% used [0x11340000, 0x11340000, 0x11560000)
 tenured generation   total 43712K, used 0K [0x1aab0000, 0x1d560000, 0x30010000)
   the space 43712K,   0% used [0x1aab0000, 0x1aab0000, 0x1aab0200, 0x1d560000)
 compacting perm gen  total 65536K, used 7519K [0x30010000, 0x34010000, 0x38010000)
   the space 65536K,  11% used [0x30010000, 0x30767e60, 0x30768000, 0x34010000)
No shared spaces configured.
3.971: [DefNew
Desired survivor size 1114112 bytes, new threshold 1 (max 15)
- age   1:    2228224 bytes,    2228224 total
: 17472K->2176K(19648K), 0.0265893 secs] 17472K->3213K(63360K)Heap after gc invocations=1:
 def new generation   total 19648K, used 2176K [0x10010000, 0x11560000, 0x1aab0000)
  eden space 17472K,   0% used [0x10010000, 0x10010000, 0x11120000)
  from space 2176K, 100% used [0x11340000, 0x11560000, 0x11560000)
  to   space 2176K,   0% used [0x11120000, 0x11120000, 0x11340000)
 tenured generation   total 43712K, used 1037K [0x1aab0000, 0x1d560000, 0x30010000)
   the space 43712K,   2% used [0x1aab0000, 0x1abb3790, 0x1abb3800, 0x1d560000)
 compacting perm gen  total 65536K, used 7519K [0x30010000, 0x34010000, 0x38010000)
   the space 65536K,  11% used [0x30010000, 0x30767e60, 0x30768000, 0x34010000)
No shared spaces configured.
}
, 0.0268294 secs]
        :

この場合のログは、ヒープ内の各メモリ領域ごとに非常に詳細なGC情報が出力されますが、JVMのベンダーによってその出力形式が異なるため、解析の際には各ベンダーが提供する専用のツールなどをご利用ください。

4.12 接続プロトコルの変更

クライアントからドメインに接続を行う際に使用するプロトコルはデフォルトではJRMPとなっています。WebOTXではJRMP以外にも 下位互換用のプロトコルとしてJMXMPを提供しています。また、SSLを利用した接続もサポートしています。

4.12.1 JMXMPを利用する手順

下位互換用のプロトコルJMXMPを利用する手順について説明します。

• ドメインの設定

  JMXMPを有効にするために、以下のコマンドを実行し、ドメインを再起動してください。

  otxadmin> set server.admin-service.jmx-connector.system-option.enabled=true
  

• クライアント

  JMXMPを利用してドメインに接続するにはコマンドに--protocolオプションでjmxmpを指定してください。loginコマンドの実行例を以下に示します。

  otxadmin> login --user admin --password adminadmin --port 6712 --protocol jmxmp --secure=true

4.12.2 SSLを利用する手順

SSLを利用してクライアントからドメインに接続する手順について説明します。SSLはJMXMP利用時は使用することはできません。JRMP利用時のみ可能です。

otxadmin> set server.admin-service.jmx-connector.system.security-enabled=true

otxadmin> login --user admin --password adminadmin --port 6212 --secure=true

otxadmin> set domain.num-config-backup-generations=1

otxadmin > set domain.backup-option=all

otxadmin > set domain.backup-option=configs