dumpNameSpace ツールを使用して、 ネーム・サーバーを介してアクセスしたネーム・スペースの内容をダンプすることができます。 dumpNameSpace ツールは、Java Naming and Directory Interface (JNDI) に基づいています。
dumpNameSpace ツールを 実行する場合は、ネーミング・サービスがアクティブでなければなりません。 dumpNameSpace ツールは、 サーバー・プロセスに対してローカルなネーム・スペース (java: や local: などの URL スキームが使用されているネーム・スペース) をダンプすることはできません。 local: ネーム・スペースには、ローカル・インターフェースを持つエンタープライズ Bean への参照が含まれています。 java: および local: のネーム・スペースをダンプする場合は、java:、local:、および サーバー・ネーム・スペース用のネーム・スペース・ダンプ・ユーティリティーを使用してください。
これを除外する非デフォルト開始コンテキストが指定されていない場合、 そのツールは、指定されたホストおよびポートのサーバーのサーバー・ルート・コンテキストをダンプします。 そのツールは、その他のサーバーのサーバー・ルート・コンテキストはダンプしません。
コマンド行から、または ツールのプログラム・インターフェースを使用して、ツールを実行することができます。 このトピックでは、コマンド行呼び出しについて説明します。 dumpNameSpace ツールのプログラム・インターフェースを介して dumpNameSpace ツールにアクセスするには、WebSphere Application Server API 資料のクラス com.ibm.websphere.naming.DumpNameSpace を参照してください。
コマンド行によってこのツールを 実行するには、WebSphere/AppServer/bin ディレクトリー で dumpNameSpace コマンドを入力します。
dumpNameSpace.sh [[-keyword value]...]
セキュリティーを使用可能に して dumpNameSpace ツールを実行すると、ログイン・プロンプトが表示されます。 ログイン・プロンプトをキャンセルすると 、dumpNameSpace ツールは「UNAUTHENTICATED」証明書を使ってアウトバウンドを続行します。 つまり、デフォルトでは、「Everyone」アクセス許可ポリシーと等価である 「UNAUTHENTICATED」証明書が使用されます。 このデフォルト設定を変更する には、app_server_root/properties/sas.client.props ファイルの com.ibm.CSI.performClientAuthenticationRequired プロパティーの 値を、true に変更します。 このプロパティーを true に変更した場合に 、dumpNameSpace ツールを再実行してログイン・プロンプトをキャンセルすると 、許可が失敗し、コマンドはアウトバウンドを続行しません。
dumpNameSpace ツールのキーワードとそれに関連する値は、 以下のとおりです。
dumpNameSpace -host myhost.mycompany.comを実行 して、myhost.mycompany.com で実行されているサーバーのネーム・スペースを表示します。
WebSphere Application Server バージョン 5.0 以降のサーバーの場合:
cell | 製品バージョン 5.0 以降のサーバーの DumpNameSpace デフォルト。セル・ルート・コンテキストからツリーをダンプします。 |
server | サーバー・ルート・コンテキストからツリーをダンプします。 |
node | ノード・ルート・コンテキストからツリーをダンプします。 |
tree | ツリー・ルート・コンテキストからツリーをダンプします。 |
すべての WebSphere Application Server および その他のネーム・サーバーの場合:
default | JNDI がそのサーバー・タイプに対してデフォルトで戻す初期コンテキストからツリーをダンプします。これは、 WebSphere Application Server 以外のネーム・サーバーと互換性のある唯一の -root オプションです。 |
jndi | デフォルト。ネーム・コンポーネントをアトミック・ストリングとして表示します。 |
ins | Interoperable Naming Service (INS) 規則 (id.kind) を使用して構文解析される名前コンポーネントを表示します。 |
short | デフォルト。バインディング名およびバインド済みオブジェクト・タイプをダンプします。 この出力は JNDI Context.list() によっても提供されます。 |
long | バインディング名、バインド済みオブジェクト・タイプ、ローカル・オブジェクト・タイプ、およびローカル・オブジェクトのストリング表現 (すなわち IOR、ストリング値、およびその他の印刷される値) をダンプします。 ユーザー定義クラスのオブジェクトが long の報告オプションで正しく表示されるためには、 オブジェクトが入っているディレクトリーを、検索を行うディレクトリーのリストに加える必要がある場合があります。 コマンド行で、環境変数 WAS_USER_DIRS を設定します。 値には、1 つ以上のディレクトリーを組み込むことができます。 これで、 指定されたディレクトリー内のすべての .zip、.jar、および .class ファイルは、 dumpNameSpace ツールを実行するときにクラス・ローダーによって解決することができます。 |