リファレンス: WebOTX Application Server Manual

WebOTX Manual V10.3 (第4版)

目次を表示

5. JNDIサービス

5.1. JNDI管理ツール

JNDI管理ツールは、JNDIサーバの名前空間のブラウズ、名前削除、同期などの管理を行います。

5.1.1. GUI版

5.1.1.1. GUI版の起動方法

Windows

[スタート]メニューを左クリックし、現れたポップアップメニューから[プログラム]を選びます。そして、その下の[WebOTX]メニューのさらに下にある[JNDI管理ツール]をクリックします。
UNIX

次のシェルスクリプトを起動します。X Windowsシステムが動作している必要があります。X Windowsシステムが動作していない場合はCUIで使用してください。

${AS_INSTALL}/bin/jndiadm

5.1.1.2. GUIツールの画面構成

display image
GUIツールの画面構成

JNDI管理ツールの画面は、以下の部分に大別されます。

ツリービュー

画面左側に位置し、JNDIサーバに登録されている名前を表示します。

名前の情報表示

画面右側上部に位置し、ツリービューで選択されている名前でバインドされているオブジェクトの情報を表示します。「オブジェクトの種類」として表示されるオブジェクトは以下の種類があります。

オブジェクトの種類」として表示されるオブジェクト一覧
表示	説明
コンテキスト	JNDIのコンテキストです。
リモートオブジェクト	RMI-IIOPのリモートオブジェクトです。
EJBのホームインタフェース	EJBコンテナに配備されているEJBのホームインタフェースです。
内部生成されたEJBのホームインタフェース	EJBコンテナに配備されているEJBのホームインタフェースです。コンテナによって配備中に自動生成されます。
リモートビジネスオブジェクトファクトリ	EJB 3.0クライアントが、EJBリモートオブジェクトを取得するためにlookupするオブジェクトです。
JDBCデータソース	JDBCデータソースです。
ユーザトランザクション	Java Transaction API (JTA)で定義されているUserTransactionオブジェクトです。
シリアライズ可能なオブジェクト	上記以外のjava.io.Serializableインタフェースを実装したクラスのオブジェクトです。
解決できないオブジェクト	JNDI管理ツールがデシリアライズに失敗したオブジェクトです。JNDI管理ツールのJava VMのクラスパスにライブラリJarを追加することで本来のクラスが表示されます。

JNDIサーバの情報表示
画面右側下部に位置し、JNDIサーバの情報を表示します。JNDIサーバがレプリケーションされている場合は、サーバの動作しているホストがすべて表示されます。状態には以下の3種類があります。
- 正常動作
  正常に動作中です。
- 停止
  そのサーバが何らかの障害で動作していないことを示します。サーバの再起動を行ってください。
- 同期が必要
  各JNDIサーバで保持している名前の情報が不一致であることを示します。「運用」メニューの「同期」を実行すれば正常動作になります。

5.1.1.3. メニューの説明

運用メニュー
- アンバインド
  名前をアンバインドします。
- 同期
  JNDIサーバがレプリケーションされている場合、各名前サーバの情報を同期させます。
- 表示の更新
  画面を最新の情報に更新します。JNDIサーバがレプリケーションされている場合は、同時に同期する必要があるかどうかをチェックします。
- 厳密な同期処理モード
  JNDI管理ツールの動作モードを「厳密な同期処理モード」にします。「同期」操作と「表示の更新」時に行われる同期の必要があるかどうかのチェックが、「厳密な同期処理モード」で動作します。
- 終了
  運用管理ツールを終了します。
設定メニュー
- URLの設定
  JNDIサーバにアクセスするためのURLを指定します。
  - rmiiiop://<ホスト名>:<JNDIサーバポート番号(デフォルト7780)>
  - corbaname://<ホスト名>:<Object Broker名前サーバポート番号(デフォルト2809)>
  のいずれかの形式で指定します。 URLは、JNDI仕様のjava.naming.provider.urlプロパティに相当します。
ヘルプメニュー
- バージョン情報
  管理ツールのバージョン情報を表示します。

5.1.2. CUI版

5.1.2.1. CUI版の起動方法

Windows

${AS_INSTALL}/bin/jndiadmcui [オプション] {オペレーション名} [引数]

UNIX

${AS_INSTALL}/bin/jndiadm -cui [オプション] {オペレーション名} [引数]

オプションの説明

オプション一覧
オプション名	説明
-timeout	更新時のロックのタイムアウト時間。 (check、syncオペレーションに対してのみ有効)
-url	CosNamingのURL

オペレーションの説明

オペレーション一覧
コマンド名	説明
check	各名前サーバに登録されている名前が一致しているか検査する。
list	各名前サーバに登録されている名前とその内容を表示する。
sync	名前空間の更新を一時的に禁止し、他のJNDI名前サーバとの同期を行う。
unbind	引数で指定した名前をJNDI名前サーバからアンバインドする。
alive	引数で指定したJNDI識別名を持つJNDIサーバの生死確認を行う。引数が省略された場合、-urlで指定されたURLでアクセス可能なJNDIサーバ全ての生死確認を行う。
listalljndiservers	-urlで指定されたCosNamingサーバにリファレンス登録されたJNDIサーバを列挙する。

5.1.3. JNDI管理ツールのクラスパスへのライブラリJarの追加方法

「解決できないオブジェクト」などが表示され、JNDI管理ツールのJava VMのクラスパスへライブラリJarを追加したい場合、jndiadm.bat (WindowsのCUI版はjndiadmcui.bat, Unix/Linuxの場合はjndiadm)をエディタ等で開き、変数 "JNDI_USERCLASSPATH" に記述してください。