java:local:、および server 名前空間ダンプの表示

ネーミング操作が失敗した理由を理解するために、java: または local: 名前空間のダンプを表示することができます。 WebSphere® Application Server スクリプト・ツールから NameServer MBean を起動して、java: または local: 名前空間をダンプします。

始める前に

ネーミング・サービスを開始します。

表示したい名前空間がサーバー・プロセスに対してローカルではない場合、dumpNameSpace ツールを使用します。

このタスクについて

dumpNameSpace ツールを使用して、java: または local: 名前空間をダンプすることはできません。dumpNameSpace ツールが、これらの名前空間にアクセスできないからです。

Java Platform, Enterprise Edition (Java EE) アプリケーションの java: 名前空間には、そのアプリケーションでしかアクセスできません。 NameServer MBean を起動して、同じサーバー・プロセスで実行されている任意の Java EE アプリケーションの java: 名前空間をダンプすることができます。

local: 名前空間には、ローカル・インターフェースを持つエンタープライズ Bean への参照が含まれています。 1 つのサーバー・プロセスには、local: 名前空間が 1 つだけあります。 そのサーバー・プロセスに関連した NameServer MBean を起動して、local: 名前空間をダンプできます。

スクリプト・ツールを使用して、アプリケーションのサーバー・プロセスで実行されている NameServer MBean を起動し、java:local:、または server 名前空間のダンプを生成します。

手順

  1. WebSphere Application Server スクリプト・ツールを使用して、NameServer MBean でメソッドを起動します。

    以下のコマンドを使用して、スクリプト・コマンド・プロンプトを入力します。

    [AIX][Linux][HP-UX][Solaris][z/OS]
    wsadmin.sh
    [Windows][IBM i]
    wsadmin

    wsadmin コマンドの使用法に関するヘルプを表示するには、-help オプションを使用します。

  2. 起動する NameServer MBean インスタンスを選択します。
    以下のスクリプト・コマンドを実行して、起動する NameServer インスタンスを選択します。以下に例を示します。
    set mbean [$AdminControl completeObjectName WebSphere:*,type=NameServer,cell=cellName,node=nodeName,process=serverName]
    ここで、cellNamenodeName、および serverName は、起動する MBean のセル、ノード、およびサーバーの名前です。MBean でメソッドを起動するには、指定されたサーバーが実行中である必要があります。
    以下の照会を実行することによって、実行中のすべての NameServer MBeans のリストを表示することができます。
    $AdminControl queryNames {*:*,type=NameServer}
  3. NameServer MBean を起動します。

    java:local:、または server 名前空間をダンプできます。それぞれについて、opts の値は、java:、local:、および server 名前空間の名前空間ダンプ・ユーティリティーで説明する名前空間ダンプ・オプションのリストです。 リストは空である場合があります。

    java: 名前空間
    java: 名前空間は、NameServer MBean で dumpJavaNameSpace メソッドを起動することによってダンプします。各サーバー・アプリケーションには独自の java: 名前空間があるため、アプリケーションは、メソッドの起動時に指定する必要があります。 アプリケーションは、アプリケーション名、モジュール名、およびコンポーネント名によって識別されます。メソッド構文は、
    $AdminControl invoke $mbean dumpJavaNameSpace {{appname}{modName}{compName}{opts}}

    であり、ここで appnamemodNamecompName はそれぞれ、ダンプする java: 名前空間のアプリケーション名、モジュール名、およびコンポーネント名です。

    local: 名前空間
    java: 名前空間は、NameServer MBean で dumpLocalNameSpace メソッドを起動することによってダンプします。 1 つのサーバー・プロセスには、local: 名前空間が 1 つだけあるため、名前空間ダンプ・オプションのみを指定する必要があります。
    $AdminControl invoke $mbean dumpLocalNameSpace {{opts}}
    サーバー名前空間
    アプリケーション・サーバーの NameServer MBean で dumpServerNameSpace メソッドを呼び出すことにより、サーバー名前空間をダンプします。これにより、dumpNameSpace コマンド行ユーティリティーと全く同様にアプリケーション・サーバー上で名前空間をダンプするための代替方法が提供されます。
    $AdminControl invoke $mbean dumpServerNameSpace {{opts}}

タスクの結果

名前空間ダンプ出力はコンソールに送信されます。また、サーバーの log ディレクトリー内のファイル DumpNameSpace.log にも書き込まれます。

java: 名前空間のダンプ
セル MyCell のノード node1 上のサーバー server1 で実行されているアプリケーション・コンポーネントの java: 名前空間をダンプすると想定します。 以下のスクリプト・コマンドによって、このアプリケーションの DefaultApplication 用 java: 名前空間の長いフォーマット・ダンプが生成されます。
set mbean [$AdminControl completeObjectName WebSphere:*,type=NameServer,cell=MyCell,node=node1,process=server1]
$AdminControl invoke $mbean dumpJavaNameSpace {{DefaultApplication}{Increment.jar}{Increment}{-report long}}
local: 名前空間のダンプ
セル MyCell のノード node1 上のサーバー server1 の local: 名前空間をダンプすると想定します。 以下のスクリプト・コマンドによって、このサーバーのローカル名前空間の短いフォーマット・ダンプが生成されます。
set mbean [$AdminControl completeObjectName WebSphere:*,type=NameServer,cell=MyCell,node=node1,process=server1]
$AdminControl invoke $mbean dumpLocalNameSpace {{-report short}}
Jython を使用した java:local:、または server 名前空間のダンプ
Jython を使用して、ノード node1 上のサーバー server1 の java:local:、または server 名前空間をダンプする NameServer MBean メソッドを実行すると想定します。

以下のスクリプト・コマンドは、nameServerString に対して呼び出す NameServer インスタンスを設定してから、DefaultApplication の java: 名前空間をダンプします。

nameServerString = AdminControl.completeObjectName("WebSphere:type=NameServer,node=node1,process=server1,*")
print AdminControl.invoke(nameServerString, "dumpJavaNameSpace", 
           '[DefaultApplication Increment.jar Increment "-report long"]')

以下のスクリプト・コマンドは、nameServerString に対して呼び出す NameServer インスタンスを設定してから、local: 名前空間をダンプします。

nameServerString = AdminControl.completeObjectName("WebSphere:type=NameServer,node=node1,process=server1,*")
print AdminControl.invoke(nameServerString, "dumpLocalNameSpace", '["-report short"]')

以下のスクリプト・コマンドは、nameServerString に対して呼び出す NameServer インスタンスを設定してから、server 名前空間をダンプします。

nameServerString = AdminControl.completeObjectName("WebSphere:type=NameServer,node=node1,process=server1,*")
print AdminControl.invoke(nameServerString, "dumpServerNameSpace", '["-root server"]')

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tnam_dump_utility_java_local
ファイル名:tnam_dump_utility_java_local.html