トレースやトラブルシューティングを始める前に

Identity Manager のトレースやトラブルシューティングを始める前に、次のセクションの内容を確認しておいてください。

• 「対象読者」

• 「Identity Manager のトレースとトラブルシューティングの重要な注意点」

• 「サポートにお問い合せになる前に」

• 「関連ドキュメントと Web サイト」

• 「手順の概要」

対象読者

この章は、アプリケーションサーバーとデータベースの管理者、第一線のサポートエンジニア、および配備環境で Identity Manager の維持管理を担当しているパートナーの方を対象としています。

Identity Manager の問題をトラブルシューティングする前に、次が必要になります。

• Java 5.0 (Sun Identity Manager 8.1 に必須) に使い慣れておくこと。

• トラブルシューティングしようとしているコンポーネントを理解していること。

Identity Manager のトレースとトラブルシューティングの重要な注意点

Identity Manager のトレースまたはトラブルシューティングを開始する前に、次の点にご注意ください。

• トレースは、システムパフォーマンスに影響を及ぼします。最適なパフォーマンスが得られるようにするには、システムのデバッグ終了後に最小限のトレースレベルに抑えるか、トレースを無効にします。

• com.waveset クラスにはトレースを有効に設定しないでください。com.waveset クラスは冗長で多数のクラスがあるため、このクラスをトレースするとサーバーがハングすることがあります。

• Sun サポートから特定の指示がない限りは、Identity Manager が高度なレベルでトレースするように設定しないでください。

• 特定の問題をデバッグするのに Waveset.properties ファイルの exception.trace を使用する場合は、長期間使用せず、デバッグが終了したら必ず無効に設定してください。Waveset.properties ファイルの exception.trace を設定すると、システムパフォーマンスに著しい影響を及ぼします。

サポートにお問い合せになる前に

Sun テクニカルサポートにサポートをお問い合わせになる前に、問題の領域を絞り込むことができる次の推奨事項を試してみてください。

• Web ブラウザの検索ツールで、問題を調べてみる。

• リソースに固有のサポートオプションがあれば、それを使用する。リソースに関連する問題では、リソースのパッチを使用すれば解決することがあります。

• 適切なクライアントツールが使用できればそれを使用して、その状況から Identity Manager をアンインストールします。たとえば、Java LDAP ブラウザを使用します。

また、Sun サポートにサポートをお問い合わせになる前に、次の情報を集めて用意しておく必要があります。

収集する情報	情報の確認方法
製品のバージョンと次の情報  インストールされているパッチ、ホットフィックス、e-fix カスタマイズのリスト	Identity Manager コンソールで次のコマンドを使用します。  installed inventory
Identity Manager のトポロジと次の情報 Identity Manager クラスタの構成 問題の環境のローカリゼーションと環境に関するその他の情報 サーバーのリスト	情報は次のように取得します。 手動で確認する必要があります。 手動で確認する必要があります。 実行中の Identity Manager サーバーで、Identity Manager 管理者インタフェースから「設定」>「サーバー」の順に選択します。
環境で行った最近の変更	手動で確認する必要があります。
Java のバージョンとタイプ	次の Java コマンドを使用します。  java -version
アプリケーションサーバーのバージョンとタイプ	使用している Application Server によって異なりますが、手動で確認する必要があります。
オペレーティングシステムのレベルと情報	手動で確認する必要があります。
デフォルト XML 出力 (すべてのリポジトリオブジェクトのリスト)	コンソールで export default.xml default コマンドを使用します。
タスクインスタンスのデータと次の情報 実行中のタスクのリスト 現在のすべてのタスクインスタンスのサイズ	コンソールで次のコマンドを使用します。 listTasks showSizes TaskInstance
システムログ	注 – 報告する問題の種類に応じて、追加のシステムログの提出を要求される場合があります。

関連ドキュメントと Web サイト

Identity Manager のトレースとトラブルシューティングについては、この章で説明する内容のほかにもこのセクションに記載されているドキュメントと Web サイトをご覧ください。

推奨ドキュメント

Identity Manager のトレースとトラブルシューティングについては、次のドキュメントを参照してください。

• XPRESS 関数の推奨トレース方法については、『Sun Identity Manager Deployment Reference』の「Testing Your Customized Form」を参照してください。

• JConsole を使用して Java プラットフォームで動作するアプリケーションを監視する方法については、「JConsole を使用したアプリケーションの監視」 という記事。この記事は、次の URL から入手できます。

  http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html

有用な Web サイト

次の表に、Identity Manager のトラブルシューティングに関する Web サイトを説明します。

表 5–1 有用な Web サイト

Web サイト URL	説明
http://sunsolve.sun.com/	診断ツール、フォーラム、機能と記事、セキュリティー情報、パッチの内容を含む Sun の Web サイト。  注意: このサイトの情報は、次の 3 分野に分かれています。 社内。Sun 従業員のみ。 契約。契約アクセス権をお持ちのお客様のみ。 公開。全員。
http://www.sun.com/service/online/us	Sun テクニカルサポートの Web サイト。
https://sharespace.sun.com/gm/folder-1.11.60181?	Sun Microsystems の Share Space の Identity Manager フォルダ。Identity Manager の FAQ、フォーラムへのリンク、特集記事や記事などが記載されています。  注意: このサイトに記載されている情報にアクセスするには、Share Space ID を登録する必要があります。
https://identitymanageride.dev.java.net	オープンソースの Sun Identity Manager 統合開発環境 (Identity Manager IDE) プロジェクト。Identity Manager IDE のインストール方法と設定方法の手順が記載されています。

手順の概要

次の図に示す手順に従えば、通常は使用中の配備の問題を見つけて解決することができます。

図 5–1 問題のトレースとトラブルシューティング

Identity Manager の各種オブジェクトとアクティビティーのトレースを有効にする方法については、「Identity Manager のオブジェクトとアクティビティーのトレース」を参照してください。

オブジェクトとアクティビティーによくある問題をトラブルシューティングする方法については、「よくある問題のトラブルシューティングと解決策」を参照してください。