第23章

Debugサブシステムの使用

この章では、exteNd DirectorのDebugサブシステムを使用する方法について説明します。トピックは次のとおりです。

• Debugサブシステムについて

• Debugサブシステムのセットアップ

• Debugサブシステムの実行

Debugサブシステムについて

Debugサブシステムでは、そのアプリケーションおよびサーバ環境についてのレポートを提供することによって、展開されたexteNd Directorアプリケーションを簡単にトラブルシューティングできます。次のようなレポートがあります。

動作

Debugサブシステムは、サポートされているタグライブラリ(debug.tld)および基礎となるクラスと共にさまざまなデバッグレポートを表示する一連のJSPページから構成されています。

• index.jspはDebugサブシステムのホームページです。

• debugEbo.jspには、exteNd Directorリソースレポートが表示されます。ここでは、debug.tldで定義されているカスタムタグDebugEboが使用されます。

• debugResources.jspには、HTTPリソースレポートが表示されます。ここでは、debug.tldで定義されているカスタムタグDebugResourcesが使用されます。

• debugJNDI.jspには、JNDIリソースレポートが表示されます。ここでは、debug.tldで定義されているカスタムタグDebugJNDIが使用されます。

• debugArchives.jspには、Novellアーカイブリソースレポートが表示されます。ここでは、debug.tldで定義されているカスタムタグDebugArchiveが使用されます。

EARプロジェクトでは、デバッグシステムはDebug.warファイルにパッケージ化されています。WARプロジェクトでは、サブシステムに必要なリソースはWAR内の適切な場所に保存されています。 たとえば、JSPページはWARのトップレベルの［pages］フォルダに保存されています。

セキュリティ上の考慮事項

Debugサブシステムでは、実行する環境についての多くの情報が公開されます。デフォルトでは、このサブシステムは保護されていません。

通常は、運用環境にDebugサブシステムを展開しないようにします。 運用環境にDebugサブシステムを展開する場合は、(デバッグのweb.xmlファイルを編集することによって)少なくとも/Debug/ URIを制限して、認証ユーザのみがアクセスできるようにします。

Debugサブシステムのセットアップ

exteNd DirectorアプリケーションでDebugサブシステムを使用する

1. DebugサブシステムをexteNd Directorプロジェクトに追加します。

   ［ファイル］>［新規プロジェクト］の順に選択することによって新しいexteNd Directorプロジェクトを作成して一般設定を要求すると、Debugサブシステムは自動的に含まれます。 カスタム設定を要求する場合、Debugサブシステムを明示的に選択する必要があります。

   後で［プロジェクト］>［exteNd Director Project］>［設定］の順に選択することによって、exteNd Directorプロジェクトを変更して、Debugサブシステムを追加または削除できます。

2. J2EEサーバにプロジェクトを作成、アーカイブ、および展開します。

これで、Debugサブシステムを実行する準備が整いました。

Debugサブシステムの実行

exteNd Directorアプリケーションの一部としてDebugサブシステムを展開したら、このデバッグシステムは、簡単にWebブラウザを使用して1つまたは複数のデバッグページにアクセスすることによって実行できます。

• デバッグホームページへの移動

• exteNd Directorリソースに関するレポート

• HTTPリソースに関するレポート

• JNDIリソースに関するレポート

• exteNd Directorアーカイブリソースに関するレポート

デバッグホームページへの移動

Debugサブシステムでは、デバッグレポートへのリンクを表示するホームページが利用できます。

Debugサブシステムのホームページに移動する

1. Webブラウザで、次のいずれかのURLを入力します。

   展開場所	URL
   exteNd Application Server	http://server/database/ear-namespace/Debug/ たとえば、次のとおりです。 http://localhost/MyDirectorDB/MyDirectorApp/Debug/
   別のJ2EEサーバ	http://server/ear-namespace/Debug/ たとえば、次のとおりです。 http://localhost/MyDirectorApp/Debug/

2. デバッグホームページが表示されたら、リンクをクリックしてデバッグレポートを表示します。

exteNd Directorリソースに関するレポート

exteNd Directorリソースレポートを使用して、次のいずれかの処理を実行できます。

• アプリケーションの「サブシステム設定エントリ」を表示する。

  デフォルトでは、レポートにはすべてのエントリが表示されますが、オプションで指定された文字列で開始または終了するエントリのみを選択することもできます。各エントリの現在の(メモリ内)値が表示されます(これらの値はサブシステムconfig.xmlファイルからロードされますが、API呼び出しを通じて一時的に変更される可能性もあります)。

• アプリケーションの「サブシステムサービスエントリ」を表示する。

  デフォルトでは、レポートにはすべてのエントリが表示されますが、オプションで指定された文字列で開始するエントリのみを選択することもできます。各エントリの現在の(メモリ内)値が表示されます(これらの値はサブシステム services.xmlファイルからロードされますが、API呼び出しを通じて一時的に変更される可能性もあります)。

• アプリケーションの「ResourceSetバインドを検証」する。

  

Debugサブシステムには、このレポート情報を取得するための別の方法もあります。それはecho servletです。

アプリケーションのexteNd Directorリソースに関してレポートする

1. デバッグホームページから、［Directorリソースのデバッグ］をクリックします。

   exteNd Directorリソースレポートページが表示されます。

2. ［選択タイプ］ドロップダウンを使用して、レポートで表示する情報の種類を選択します。

   • 設定エントリ

   • サービスエントリ

   • ResourceSetエントリ

3. ［設定エントリ］または［サービスエントリ］を選択すると、オプションでレポートクエリの範囲をしぼることができます。特定の文字列を含むエントリ名のみを表示する

   • ［text box］テキストボックスにその文字列を入力します(たとえば、com.sssw.portal)

   • ［次で始まる］ラジオボタンまたは［次で終わる］ラジオボタンを選択して、エントリ名でその文字列を検索する場所を指定します。

     注記:   サービスエントリの場合、［次で始まる］のみを選択できます。

4. ［送信］ボタンをクリックします。

   レポート結果がページに表示されます。

エコーサーブレットを使用する

1. Webブラウザで、エコーサーブレットURLの入力を次のように開始します。

   展開場所	URLの開始
   exteNd Application Server	http://server/database/ear-namespace/Debug/echo? たとえば、次のとおりです。 http://localhost/MyDirectorDB/MyDirectorApp/Debug/echo?
   別のJ2EEサーバ	http://server/ear-namespace/Debug/echo? たとえば、次のとおりです。 http://localhost/MyDirectorApp/Debug/echo?

2. 生成するレポートに関する情報を追加することによって、URLの入力を完了します。

   作業内容	URLに追加する内容
   サブシステム設定エントリを表示する	次のいずれか1つ 特定の文字列で「開始」する設定エントリ名を取得する type=c&sw=string 特定の文字列で「終了」する設定エントリ名を取得する type=c&ew=string 「すべての」設定エントリ名を取得する type=c&sw=
   サブシステムサービスエントリを表示する	次のいずれか1つ 特定の文字列で「開始」するサービスエントリ名を取得する type=s&sw=string 「すべての」サービスエントリ名を取得する type=s&sw=
   リソースセットバインドを検証する	type=rs

たとえば、このURLはエコーサーブレットを呼び出して、com.sssw.portalで開始するサブシステム設定エントリを表示します。

  http://localhost/MyDirectorDB/MyDirectorApp/Debug/echo?type=c&sw=com.sssw.portal

HTTPリソースに関するレポート

HTTPリソースレポートを使用して、アプリケーションで特定のURIにマップされているサーブレットおよびJSPページに関する情報を表示できます。 レポートは、Servlet APIを使用することによってこの情報を取得します。

アプリケーションのHTTPリソースに関してレポートする

1. デバッグホームページから、［Httpリソースのデバッグ］をクリックします。

   HTTPリソースレポートページが表示されます。

2. ［URIから属性を取得］テキストボックスに、情報が必要なマッピングを入力します。

   アプリケーションに対して確立したEARネームスペースで開始します。この例では、EARネームスペースはMyDirectorAppです。

     /MyDirectorApp/Portal/
   

3. ［送信］ボタンをクリックします。

   レポート結果がページに表示されます。

JNDIリソースに関するレポート

JNDIリソースレポートを使用して、J2EEサーバでアプリケーションに対して使用できるJNDIリソースのツリーを表示できます。exteNd Directorアプリケーションのコードは、JNDIルックアップを通じてこれらのリソースにアクセスできます。

このレポートはexteNd Application Serverで最大の効果を発揮します。

J2EEサーバのJNDIリソースに関してレポートする

• デバッグホームページから、［JNDIリソースのデバッグ］をクリックします。

  JNDIリソースレポートページが開き、結果が表示されます。

exteNd Directorアーカイブリソースに関するレポート

exteNd Directorアーカイブリソースレポートを使用して、アプリケーションサーバに展開されたアーカイブを一覧表示できます。このリストを使用して、詳細を表示するアーカイブを選択できます。このレポートによって提供されるアーカイブ詳細には、次の内容が含まれています。

• 「コンテンツ」(クラス、その他のアーカイブなど)

• 未解決のJAR参照

  レポートでは、マニフェストクラスパスで参照されているものの、サーバ上のクラスパスでは使用できないJARファイルが確認されます。このような未解決の参照によって、ランタイム時にClassNotFoundExceptionが発生する可能性があります。レポートではこれらが赤色で表示され、ユーザに対して警告します。

  

exteNd Directorアーカイブレポートに関してレポートする

1. デバッグホームページから、［exteNd Directorアーカイブリソースのデバッグ］をクリックします。

   exteNd Directorアーカイブリソースレポートページが表示されます。

2. ［URLからJarを取得］テキストボックスに入力して、適切なサーバおよびデータベースを指定します。たとえば、次のとおりです。

     http://localhost:80/MyDirectorDB
   

3. ［アーカイブの取得］ボタンをクリックします。

   ［アーカイブ］ドロップダウンに、その場所からの現在のアーカイブリストが表示されます。

4. ［アーカイブ］ドロップダウンを使用して、詳細が必要な項目を選択します。

   特定のアーカイブを選択するか、［-all-］(すべてのアーカイブについての詳細)を選択できます。

5. ［確認］ボタンをクリックします。

   アーカイブの詳細がページに表示されます。

Copyright © 2004 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.  more ...