test

Sun Java Enterprise System 5 インストールガイド (UNIX 版)

第 9 章 トラブルシューティング

この章では、Sun JavaTM Enterprise System (Java ES) のインストールとアンインストールに関する問題を解決するためのヒントを提供します。

この章で説明する内容は、次のとおりです。

問題の解決方法

ここでは、Java ES のインストールおよびアンインストール時に、問題の原因を分析して特定するためのガイドラインを紹介します。

ここで説明する内容は、次のとおりです。

インストールログファイルの検証

インストールまたはアンインストール中に問題が発生した場合は、発生した問題に関する情報を確認するために、最初にインストールログを調べます。ユーザーの選択、パッケージの操作、インストールまたはアンインストールの手順などの操作のあとには、情報メッセージ、警告メッセージ、およびエラーメッセージが発行されます。インストール、アンインストール、およびインストール時に行なった設定に関するメッセージは、ソースログファイルに収集されます。各メッセージに表示される情報は、日時、ログレベル、モジュール ID、およびメッセージテキストで構成されます。パスワードが出力されることはありません。

ログファイルの形式

インストールまたはアンインストールの情報が収集されるログファイルには、次の 4 種類のファイルがあります。

ログメッセージは、ULF (Unified Logging Format) と呼ばれる Sun 標準形式で格納されます。ULF を読みにくい場合は、Java ES ログビューアを使ってログメッセージを表示することもできます。

ソースログファイルは、テキストエディタを使って編集できます。次の表は、ソースログファイルの形式を示しています。

表 9–1 ログファイルの形式

ログに記録される内容 

ログファイル名の形式 

インストーラ 

Java_Enterprise_System_5_install.Atimestamp

Java_Enterprise_System_5_install.Btimestamp

JavaES_Install_log.timestamp

Java_Enterprise_System_5_Summary_Report_install. timestamp

アンインストーラ 

Java_Enterprise_System_5_uninstall.Atimestamp

Java_Enterprise_System_5_uninstall.Btimestamp

JavaES_UnInstall_log.timestamp

Java_Enterprise_System_5_Summary_Report_uninstall. timestamp

アンインストールが完了すると、アンインストーラはインストーラ、ログビューア、およびアンインストーラ自体を削除します。ただし、ソースログファイルは削除されず、次の場所に格納されます。

Procedureログファイルによるトラブルシューティング

  1. サマリーファイルを調べます。例:

    Java_Enterprise_System5_Summary_Report_install. timestamp

    問題が発生した場合は、どのコンポーネントが問題の原因であるかを確認します。複数の問題が発生したかどうかを確認します。必要に応じて、詳細ログのいずれかまたは両方のファイルを調べる必要があります。

  2. 詳細ログを調べます。例:

    JavaES_Install_log timestamp

    最初に発生したエラーまたは警告を探して、解決します。1 つのエラーを解決すると、関連性がないように見える後続の多数のエラーも解決することがよくあります。

ログビューアの使用

Java ES ログビューアは、JavaES_Install_log.timestamp ファイルまたは JavaES_UnInstall_log.timestamp ファイルの ULF ログメッセージを表示するための、グラフィカルな画面です。ログファイルを表示するには、ログビューアメインページの「ファイル」メニューから「Open」を選択します。指定するファイルがすでに存在する場合または書き込み権限で開けない場合には、ログビューアエラーが発生し、ログビューアメインページに戻ります。インストーラがソースログを記録するために使用するディレクトリに、そのようなファイルを置くことはできません。

「Search」ボタンをクリックすると、フィルタ条件に一致するメッセージが 1 つのログテーブルに表示されます。ログテーブルが表示されたあとに、ログテーブルの各行を選択すると、その詳細が表示されます。複数行の形式で表示されることもあります。

フィルタのしくみ

ログ出力を調整するには、ULF ログファイルを選択したあとに、ログビューアメインページで表示設定と検索条件を指定します。「Display Preferences」には、選択内容を表示する言語と、検索したレコードの表示に適用する制限を指定します。

メッセージをフィルタで検索するときには、重要度の高いものまたは目的に合っているものから表示されるように、3 つの方法が用意されています。ログレベル別、ロガー別、および内容別の表示方法があります。

一般的な検索条件をいくつか紹介します。

Procedureログビューアの実行

ログビューアは読み取り専用モードで動作するため、複数のユーザーが同時にログビューアを実行できます。

  1. コマンド行で、ログビューアの場所に移動します。

    • Solaris SPARC の場合: /var/sadm/prod/SUNWentsys5i/Solaris_sparc

    • Solaris x86 の場合: /var/sadm/prod/SUNWentsys5i/Solaris_x86

    • Linux の場合: /var/sadm/prod/sun-entsys5i/Linux_x86

    • HP-UX の場合: /var/sadm/prod/sun-entsys5i/HPUX_PA-RISC

  2. ログビューアを起動します。


    ./viewlog

    ログビューアのメインページが表示されます。

  3. 「ファイル」メニューで、表示するログファイルを選択します。

    選択したファイルが ULF でない場合は、選択したファイルが ULF でないため選択できないというメッセージが表示されます。ログビューアを使って表示できるのは、ULF ファイルだけです。

    利用できる ULF ログファイルがない場合は、インストールまたはアンインストールがまだ完了していない可能性があります。しばらく待ってから、もう一度やり直してください。

  4. 目的に合わせて「Display Preferences」と「Search Criteria」を選択します。

  5. 「検索」をクリックします。

    フィルタ条件に一致するレコードがログテーブルに表示されます。

製品の依存関係の検証

多数の製品コンポーネントに、インストール時の相互依存関係があります。1 つの製品コンポーネントに影響を与える問題は、別の製品コンポーネントにも影響を与える可能性があります。まず、『Sun Java Enterprise System 5 インストール計画ガイド』で説明されている内容をよく理解してください。

製品コンポーネントの依存関係のほかに、一部の製品コンポーネントは Solaris パッケージがホストにインストールされているかどうかにも依存しています。パッケージが存在していない場合は、それが原因でインストールが失敗することがあります。詳細については、リリースノートの「ソフトウェア要件」の節を参照してください。

製品コンポーネントの起動時に問題が発生する場合は、その製品コンポーネントのログファイルを調べてください。多くの製品コンポーネントのログファイルの場所については、「製品コンポーネントのトラブルシューティングのためのヒント」を参照してください。

リソースと設定のチェック

次のホストレベルの問題は、インストール時に問題を引き起こす可能性があります。

インストール後の設定のチェック

製品コンポーネントの起動時に問題が発生する場合は、第 6 章「インストール後の設定の実行」に記述されている手順に正しく従っていたか確認します。

配布メディアのチェック

DVD または CD からのインストールでは、メディアの汚れや損傷を調べます。ディスクに汚れがあると、インストール時に問題が発生する可能性があります。

Directory Server の接続性チェック

Directory Server に依存する製品コンポーネントをインストールする場合、次のいずれかの問題によって問題が発生する可能性があります。

Web Server のファイルおよびディレクトリの削除

編集済みの設定ファイルなど、カスタマイズされたファイルの上書きを防ぐために、そのファイルが格納されるディレクトリには Web Server をインストールできません。

Web Server を再インストールする場合、インストールディレクトリをチェックして、それが空であることを確認します。空ではない場合は、どこか別の場所にファイルをアーカイブしてからインストールを再試行します。

パスワードの確認

インストーラは、製品コンポーネントごとにパスワードの入力を求めます。複数のホストに複数の製品コンポーネントをインストールする場合、各ホストで正しいパスワードを入力することが重要です。

パスワードの問題を解決するには、いったんアンインストールしてから再インストールすることが必要となる場合があります。アンインストールに失敗した場合は、「アンインストール時に残されたファイルによるインストールの失敗」を参照してください。

製品コンポーネントのインストール状態の検証

製品コンポーネントをインストールしたものの問題があり、再インストールまたはアンインストールを実行できない場合は、Solaris の pkginfo コマンド、Linux の rpm コマンド、または HP-UX の swlist コマンドを使用して、インストールしたコンポーネントパッケージを調べます。その結果を、『Sun Java Enterprise System 5 インストールリファレンス (UNIX 版)』の第 5 章「インストール可能なパッケージの一覧」に記載されている Java ES パッケージと比較します。追加のトラブルシューティング情報については、「アンインストール時に残されたファイルによるインストールの失敗」を参照してください。

ヒント –

Solaris 9 と Solaris 10 では、製品レジストリ (prodreg ツール) を使用することもできます。このツールは、グラフィカルインタフェースを提供し、pkg ユーティリティーの代わりに、各コンポーネントおよびそのパッケージへの索引付けをします。製品レジストリを起動するには、コマンドプロンプトで prodreg を入力します。詳細については、prodreg(1) のマニュアルページを参照してください。

アンインストールするための管理者アクセスの確認

「アンインストーラ用の管理者アクセス権の付与」で説明されているように、アンインストール時に管理者アクセス権をアンインストーラに付与しなければならないことがあります。

インストールに関する問題の解決

ここでは、インストール時に発生する可能性のある次の問題について説明します。

アンインストール時に残されたファイルによるインストールの失敗

アンインストール時に製品コンポーネントファイルやパッケージが削除されずに残されることがあります。このような場合、Java ES を再インストールする前に、ファイルやパッケージの手動での削除が必要となる場合があります。削除したと思っているにもかかわらず、インストーラは製品コンポーネントがホスト上にあるとレポートします。

次の状況が発生した可能性があります。

Procedure部分的なインストールのクリーンアップ

  1. 次のコマンドを使用して、一部だけがインストールされたパッケージがないかどうか調べます。

    Solaris OS の場合: pkginfo -p

    Linux の場合: rpm -qa |grep —I ^sun | xargs rpm -V

    HP-UX の場合: swlist -l product sun-*

    コマンドの出力で、一部だけがインストールされたパッケージのリストが表示されます。『Sun Java Enterprise System 5 インストールリファレンス (UNIX 版)』の第 5 章「インストール可能なパッケージの一覧」を参照し、返されたパッケージ名に基づいてそれらのパッケージが属している製品コンポーネントを調べます。

  2. コンポーネントまたはパッケージを削除します。

    • Solaris 9 または Solaris 10 では、prodreg というツールを使用します。

      prodreg ツールを使用すると、ホスト上のパッケージベースのコンポーネントを管理できます。各製品コンポーネントとそのパッケージについて、相互依存関係を含む完全な情報を参照できます。prodreg ツールを使用して、安全に製品コンポーネントをアンインストールし、パッケージを削除することができます。prodreg ツールで製品コンポーネントを削除すると、再インストールできるようになります。

    • Linux では、rpm -e コマンドを使用します。

      製品のレジストリファイルを編集するには、/var/opt/sun/install/productregistry ファイルを開きます。この XML ファイルには、各製品コンポーネントの説明があります。各製品コンポーネントの説明は、<compid\> タグで始まり、</compid\> タグで終わります。製品コンポーネントのエントリ全体を削除します。

    • HP-UX では、swremove コマンドを使用します。

      製品のレジストリファイルを編集するには、/var/adm/swproductregistry ファイルを開きます。この XML ファイルには、各製品コンポーネントの説明があります。各製品コンポーネントの説明は、<compid\> タグで始まり、</compid\> タグで終わります。製品コンポーネントのエントリ全体を削除します。

  3. 次のディレクトリに Java ES 製品コンポーネントやパッケージがないことを確認します。

    /opt

    /etc/opt

    /var/opt

  4. インストーラをもう一度実行します。

アンインストール後に製品レジストリに含まれる共有コンポーネントが削除されたためにインストールが失敗する

Java ES 5 リリースから、インストールが終了すると、製品レジストリファイル内に共有コンポーネントが登録されるようになっています。

Java ES アンインストーラは、製品コンポーネントをシステムから削除しますが、共有コンポーネントは削除しません。アンインストールが終了しても、製品レジストリには共有コンポーネントのエントリが依然として含まれています。アンインストール後に Java ES の共有コンポーネントを手動で削除しても、それらのコンポーネントは製品レジストリからは削除されません。したがって、次回の Java ES 5 のインストールは失敗します。なぜなら、手動で削除された共有コンポーネントに対するエントリが製品レジストリ内には依然として存在するため、インストーラはそれらのコンポーネントが存在するものと仮定するからです。

ヒント –

Java ES の共有コンポーネントをシステムから手動で削除しないでください。

推奨される解決方法: 製品レジストリファイルから対応するエントリを削除するか、製品レジストリファイル自体を削除します。製品レジストリファイルからエントリを削除するとファイルが壊れる危険性があるため、製品レジストリの全体を削除することをお勧めします。これを行う前に、Java ES コンポーネント以外の製品が製品レジストリファイルを使用していないことを確認してください。

Linux および HP-UX では、Solaris OS に存在するグラフィカル製品レジストリに相当するものはありません。Linux または HP-UX 上のファイルを手動で削除した場合は、製品レジストリファイルを手動で編集してそれらのエントリを削除する必要があります。

IBM WebSphere を Portal Server の Web コンテナとして設定できない

WebSphere を実行していない、または WebSphere のネイティブ設定と一致しない WebSphere 値を指定したことが原因として考えられます。この問題の解決には、次の 2 つの方法があります。Solaris OS では、IBM WebSphere のみが Web コンテナとしてサポートされます。

設定のチェック

1 つの方法は、WebSphere インスタンスの設定をチェックすることです。

ProcedureWebSphere 設定のチェック

  1. WebSphere が実行されていることを確認します。

  2. 次のインストーラフィールドの値を調べます。

    • WebSphere 仮想ホスト (状態ファイルの PS_IBM_VIRTUAL_HOST)

    • Application Server 名 (状態ファイルの PS_IBM_APPSERV_NAME)

  3. WebSphere ツールで設定をチェックし、これらの値と一致する値を確実に入力します。

  4. 再試行します。

新しいインスタンスの作成

もう 1 つの方法は、WebSphere エンティティーの新しいインスタンスを作成することです。

ProcedureWebSphere エンティティーの新しいインスタンスの作成

  1. adminclient.sh を使用して、WebSphere コンソールを起動します。

  2. 新しい仮想ホストのインスタンスおよび新しい Application Server のインスタンス名を作成します。

  3. ノード (通常はホスト名) の下のエントリをクリックし、Regen WebServer Plugin を選択します。

    このプロセスにより、plugin 設定ファイルに新しいエントリが保存されます。インストーラによって、その正式名称がチェックされます。

  4. インストーラに戻り、作成した値を入力します。

予期せぬ外部エラーが発生する

電源障害またはシステム障害が発生した可能性があります。または CTRL/C を入力して、インストーラのプロセスを停止した可能性もあります。

推奨される解決方法: インストール中または設定プロセスで障害が発生した場合は、おそらく一部だけがインストールされたままになっています。アンインストーラを実行します。アンインストーラが失敗した場合は、「アンインストールが失敗し、ファイルが削除されずに残った」の手順に従います。

グラフィカルインストーラが応答しない

イメージが入力を受け付けるようになる前に、インストーラによって画面上にイメージが作成されることがあります。待ちきれずにインストールウィザードで何度も「次へ」をクリックすることは避けてください。

推奨される解決方法: デフォルトの選択肢を表すボタンには、青い四角形が表示されます。この四角形は、ボタンが表示されたあとに表示されることがあります。ボタンをクリックするときは、青い四角形が表示されるまで待ってください。

サイレントインストールの失敗: 状態ファイルに互換性がない、または破損している

使用しているプラットフォームで作成された状態ファイルを使用している場合、ファイルが壊れ、原因不明であるというエラーが発生する可能性があります。この問題の解決には、次の 2 つの方法があります。

新しい状態ファイルの生成

プラットフォームに適した新規 ID の作成

状態ファイルを作成したプラットフォームが、サイレントインストールを実行しているプラットフォームと異なる場合、状態ファイルに対してプラットフォームに適した ID を新たに作成します。この方法については、「プラットフォームに適した状態ファイル ID の作成」を参照してください。

状態ファイルの編集後にサイレントインストールに失敗した

状態ファイルを編集した場合、それによってエラーが発生した可能性があります。次の点をチェックし、「状態ファイルの作成」の説明に従って状態ファイルを再生成します。

推奨される解決方法: 問題を解決し、状態ファイルを再生成します。

マニュアルページが表示されない

この問題が起きる場合、たいていはインストールしたコンポーネントの MANPATH 環境変数が正しく設定されていないことが原因です。

推奨される解決方法: 新しいマニュアルページに直接関連付けるように /etc/MANPATH を更新します。「マニュアルページの確認」を参照してください。

アンインストールに関する問題の解決

ここでは、アンインストール時に発生する可能性のある次の問題について説明します。

アンインストーラが見つからない

Java ES のインストールプログラムは、システム上の次の場所に uninstall (アンインストーラ) を格納します。

アンインストーラがこのディレクトリにない場合は、次のいずれかの原因が考えられます。

推奨される解決方法: 「アンインストールが失敗し、ファイルが削除されずに残った」の説明に従ってシステムを手動でクリーンアップします。

アンインストールが失敗し、ファイルが削除されずに残った

アンインストーラがファイルまたはプロセスを削除できなかったために手動クリーンアップが必要となった場合は、次の手順を実行し、システムからパッケージを削除します。

Procedure手動でのパッケージのクリーンアップ

  1. 削除が必要なパッケージを特定します。

    システム上のパッケージを、『Sun Java Enterprise System 5 インストールリファレンス (UNIX 版)』の第 5 章「インストール可能なパッケージの一覧」に記載されている Java ES パッケージと比較します。「アンインストール時に残されたファイルによるインストールの失敗」も参照してください。次のコマンドを使用して、インストールされているパッケージを判定できます。

    • Solaris OS pkginfo または prodreg ユーティリティー

    • Linux rpm コマンド

    • HP-UX swlist コマンド

  2. Java ES 製品コンポーネントの実行中のプロセスをすべて停止します。

    プロセスの停止手順の概要については、第 6 章「インストール後の設定の実行」の製品コンポーネントマニュアルを参照してください。

  3. 以後のインストールで再利用を考えているカスタム設定データとユーザーデータをすべてバックアップします。

    バックアップすべき設定データやユーザーデータについては、「Java ES 製品コンポーネントのアンインストール動作の確認」を参照してください。詳細については、各製品コンポーネントのマニュアルを参照してください。

  4. pkgrm、rpm -e、または swremove コマンドを使って Java ES コンポーネントパッケージを削除します。

  5. 以後のインストールで使用しない、残されている製品コンポーネントディレクトリとその内容をすべて削除します。これらのディレクトリをあとで利用する場合は、別の場所に移動します。

  6. 次の場所にある製品レジストリファイルを更新します。

    • Solaris OS の場合: /var/sadm/install/productregistry

    • Linux の場合: /var/opt/sun/install/productregistry

    • HP-UX の場合: /var/adm/sw/productregistry

    アンインストーラはこのレジストリを使用して、ホストにインストールされている製品コンポーネントを特定します。インストーラとアンインストーラは、インストールまたはアンインストールの完了時に製品レジストリを更新します。

    注 –

    アンインストーラを使用せずに、パッケージを手動で削除した場合は、システムにインストールされているソフトウェアを製品レジストリが正しく反映するように、このファイルを手動で更新する必要があります。

  7. 次の場所にあるシステムのログファイルをクリーンアップします。

    • Solaris OS の場合: /var/sadm/install/logs

    • Linux および HP-UX の場合: /var/opt/sun/install/logs

    ログファイルは、パッケージを手動削除したあとのシステムの状態を正しく反映していない可能性があります。

製品レジストリが破損している

アンインストール時に、アンインストーラは製品レジストリファイルを使用して、アンインストールが必要な要素を特定します。

Common Agent Container の問題の解決

ここでは、Common Agent Container の共有コンポーネントに関連して起きる可能性のある次の問題について説明します。

ポート番号の競合

Java ES に付属の Common Agent Container (V2.0) は、デフォルトで次のポート番号を予約します。

Sun Cluster ソフトウェアのインストールの問題を解決する場合、Sun Cluster ソフトウェアでは異なるバージョンの Common Agent Container が使用されるため、ポートの割り当てが異なります。この場合、デフォルトのポートは次のようになります。

上記のポート番号のいずれかがすでにインストール時に予約されている場合は、Common Agent Container が使用するポート番号を次の手順の説明に従って変更します。

ポート番号の確認

Common Agent Container の cacaoadm コマンドの詳細については、cacaoadm のマニュアルページを参照してください。このマニュアルページをコマンド行に表示できない場合は、MANPATH が正しく設定されているか確認します。「マニュアルページの確認」を参照してください。

ProcedureSolaris OS のポートの確認

  1. root として、Common Agent Container 管理デーモンを停止します。


    /usr/sbin/cacaoadm stop

  2. 次の構文を使用して、ポート番号を変更します。

    /usr/sbin/cacaoadm set-param param=value

    たとえば、SNMP アダプタが占有するポートをデフォルトの 11161 から 11165 に変更するには、次のようにします。

    注 –

    Sun Cluster ソフトウェアの場合は、前述のポートを使用します。


    /usr/sbin/cacaoadm set-param snmp-adaptor-port=11165

  3. Common Agent Container 管理デーモンを再起動します。


    /usr/sbin/cacaoadm start

ProcedureLinux または HP-UX のポートの確認

  1. root として、Common Agent Container 管理デーモンを停止します。


    /opt/sun/cacao/bin/cacaoadm stop

  2. 次の構文を使用して、ポート番号を変更します。

    /opt/sun/cacao/bin/cacaoadm set-param param=value

    たとえば、SNMP アダプタが占有するポートを 11161 から 11165 に変更するには、次のようにします。


    /opt/sun/cacao/bin/cacaoadm set-param snmp-adaptor-port=11165

  3. Common Agent Container 管理デーモンを再起動します。


    /opt/sun/cacao/bin/cacaoadm start

ルートパスワードの安全性が危惧される場合

Java ES が稼働するホストで、セキュリティーキーを再生成することが必要になる場合があります。たとえば、ルートパスワードが他の人に知られたおそれがあり、安全性が危うくなっている場合には、セキュリティーキーを再生成することが必要です。Common Agent Container サービスによって使用されるキーは、次の場所に格納されています。

Solaris OS の場合: /etc/opt/SUNWcacao/securityLinux および HP-UX の場合: /etc/opt/sun/cacao/security

通常の動作では、これらのキーはデフォルトの構成のままとなります。キーの安全性が危うくなったために、キーを再生成することが必要な場合は、次の手順でセキュリティーキーを再生成できます。

ProcedureSolaris OS の場合のキー生成

  1. root として、Common Agent Container 管理デーモンを停止します。


    /usr/sbin/cacaoadm stop

  2. セキュリティーキーを再生成します。


    /usr/sbin/cacaoadm create-keys --force

  3. Common Agent Container 管理デーモンを再起動します。


    /usr/sbin/cacaoadm start
    注 –

    Sun Cluster ソフトウェアの場合は、この変更をクラスタ内のすべてのノードに伝達する必要があります。詳細については、『Sun Cluster Software Installation Guide for Solaris OS』の「How to Finish a Rolling Upgrade to Sun Cluster 3.1 8/05 Software」を参照してください。

ProcedureLinux および HP-UX の場合のキー生成

  1. root として、Common Agent Container 管理デーモンを停止します。


    /opt/sun/cacao/bin/cacaoadm stop

  2. セキュリティーキーを再生成します。


    /opt/sun/cacao/bin/cacaoadm create-keys --force

  3. Common Agent Container 管理デーモンを再起動します。


    /opt/sun/cacao/bin/cacaoadm start

    cacaoadm コマンドの詳細については、cacaoadm(1M) のマニュアルページを参照してください。

インストール後の起動/再起動の問題の解決

ここでは、インストール後に発生する可能性のあるさまざまな問題について説明します。

監視規則が動作しなくなる (状態は不明)

Application Server を再起動した場合、Application Server と Monitoring Console の間の通信が中断され、再度有効にする必要があります。以前動作していた監視規則が動作しなくなり、不明の状態になります。Application Server ホストで共通エージェントコンテナを再起動した場合は、Monitoring Console ホストでも共通エージェントコンテナを再起動する必要があるため、問題は引き続き存在します。

ProcedureApplication Server から Monitoring Console への通信の再確立

  1. root として、Application Server があるホストで共通エージェントコンテナを再起動します。例:


    /usr/sbin/cacaoadm start

  2. 次に、Monitoring Console があるホストに移動し、共通エージェントコンテナを再起動します。例:

    共通エージェントコンテナがすでに実行されている場合は、いったん停止してから、次のコマンドを使用して起動します。

    Solaris OS の場合:


    /usr/sbin/cacaoadm stop
/usr/sbin/cacaoadm start

    Linux および HP-UX の場合:


    /opt/sun/cacao/bin/cacaoadm stop
/opt/suncacao/bin/cacaoadm start

Java DB の再起動後、ポータルデータベースが見つからない

これは、デフォルトの Application Server コマンドを使用して Java DB を再起動した (asadmin stop-databsse、次に asadmin start-database ) あとで、Java DB を使用する Application Server サンプルを配備したときに発生することがあります。Portal Server サンプルにアクセスできなくなります。

推奨される解決方法: この問題の対処方法は多数あります。

  1. Java DB を停止しないでください。

  2. Java DB を停止した場合は、Application Server データベースを代わりの場所に作成できる次のコマンドを使用して Java DB を再起動します。

    Solaris OS の場合: /asadmin start-database --dbhome /var/opt/SUNWportal/derby

    Linux および HP-UX の場合: /asadmin start-database --dbhome /var/opt/sun/portal/derby

    データベースをデフォルトの場所に配置する場合は、デフォルト以外のポートを使用して Java DB の 2 つ目のインスタンスを起動し、Application Server サンプル common.properties ファイルで正しい Derby ポートを指定します。例: asadmin start-database --dbport 1528

製品コンポーネントのトラブルシューティングのためのヒント

このセクションの表では、製品コンポーネントの問題を解決するためのさまざまなヒントを提供し、役立つマニュアルを紹介します。ここで説明する内容は、次のとおりです。

Access Manager のトラブルシューティングのヒント

表 9–2 Access Manager のトラブルシューティングのヒント

トピック 

詳細 

設定ファイル

AMConfig.properties

  • Solaris OS の場合: /etc/opt/SUNWam/config

  • Linux および HP-UX の場合: /etc/opt/sun/identity/config

ログファイルとデバッグファイル

ログファイルのディレクトリ: 

  • Solaris OS の場合: /var/opt/SUNWam/logs

  • Linux および HP-UX の場合: /var/opt/sun/identity/logs

デバッグファイルのディレクトリ: 

  • Solaris OS の場合: /var/opt/SUNWam/debug

  • Linux および HP-UX の場合: /var/opt/sun/identity/debug

デバッグモード

『Sun Java System Access Manager 7.1 Developer’s Guide 』の「Auditing Features」の章を参照してください。

Application Server のトラブルシューティングのヒント

表 9–3 Application Server のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

ログファイルのディレクトリ: 

  • Solaris OS の場合: /var/sadm/install/logs/

  • Linux および HP-UX の場合: /var/opt/sun/install/logs/

Application Server インスタンスのログディレクトリ (最初に作成するインスタンスのデフォルトの場所): 

  • Solaris OS の場合: /var/opt/SUNWappserver/domains/domain1/logs

  • Linux および HP-UX の場合: /var/opt/sun/appserver/domains/domain1/logs

メッセージログのファイル名: 

server.log (サーバーインスタンスごとに存在する)

設定ファイル

  • Solaris OS の場合: /opt/SUNWappserver/appserver/config/asenv.conf

  • Linux および HP-UX の場合: /opt/sun/appserver/config/asenv.conf

トラブルシューティング

『Sun Java System Application Server Enterprise Edition 8.2 トラブルシューティングガイド』を参照してください。

Directory Server のトラブルシューティングのヒント

表 9–4 Directory Server のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

インストールログファイル: 

  • Solaris OS の場合: /var/sadm/install/logs

  • Linux および HP-UX の場合: /var/opt/sun/install/logs

トラブルシューティング

『Sun Java System Directory Server Enterprise Edition 6.0 管理ガイド』のパート I「Directory Server による管理」を参照してください。

『Sun Java System Directory Server Enterprise Edition 6.0 管理ガイド』のパート II「Directory Proxy Server による管理」を参照してください。

Message Queue のトラブルシューティングのヒント

表 9–5 Message Queue のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

インストールログファイル: 

  • Solaris OS の場合: /var/sadm/install/logs

  • Linux および HP-UX の場合: /var/opt/sun/install/logs

ブローカログファイル: 

  • Solaris OS の場合: /var/mq/instances/ instance-name/log

  • Linux および HP-UX の場合: /var/opt/sun/mq/instances/ instance-name/log

トラブルシューティング

『Sun Java System Message Queue 3 2005Q4 管理ガイド』の「問題のトラブルシューティング」の章を参照してください。

パフォーマンスの問題については、『Sun Java System Message Queue 3 2005Q4 管理ガイド』の「メッセージサービスの分析と調整」を参照してください。

Monitoring Console のトラブルシューティングのヒント

表 9–6 Monitoring Console のトラブルシューティングのヒント

トピック 

詳細 

設定ファイル

Monitoring Console の場合: 

  • Solaris OS の場合: /opt/SUNWjesmc/WEB-INF/web.xml

  • Linux および HP-UX の場合: /opt/sun/jesmc/WEB-INF/web.xml

  • Solaris OS の場合: /etc/opt/SUNWmfwk/config/mfwk.properties

  • Linux および HP-UX の場合: /etc/opt/sun/mfwk/config/mfwk.properties

  • Solaris OS の場合: /etc/opt/SUNWmfwk/config/masteragent.properties

  • Linux および HP-UX の場合: /etc/opt/sun/mfwk/config/masteragent.properties

ログファイル

Monitoring Console の場合: 

  • /var/log/webconsole/console/console_config_log (すべてのプラットフォーム)

  • /var/log/webconsole/console/console_debug_log (すべてのプラットフォーム)

Monitoring Framework の場合: 

  • Solaris OS の場合: /var/opt/SUNWmfwk/logs

  • Linux および HP-UX の場合: /var/opt/sun/mfwk/logs

トラブルシューティング

Monitoring Console にアクセスできない場合は、『Sun Java Enterprise System 5 監視ガイド (UNIX 版)』の「Monitoring Console のトラブルシューティング」を参照してください。監視対象のコンポーネントが Monitoring Console に表示されない場合は、『Sun Java Enterprise System 5 監視ガイド (UNIX 版)』の「Monitoring Framework のトラブルシューティング」を参照してください。

Portal Server のトラブルシューティングのヒント

Portal Server は、Access Manager と同じログファイルとデバッグファイルを使用します。

表 9–7 Portal Server のトラブルシューティングのヒント

トピック 

詳細 

デバッグファイル

Solaris OS の場合: /var/opt/SUNWam/debug

Linux および HP-UX の場合: /var/opt/sun/identity/debug

Portal Server デスクトップのデバッグファイル: 

Solaris OS の場合: /var/opt/SUNWam/debug/desktop and /var/opt/SUNWam/debug/desktop.dpadmin.debug

Linux および HP-UX の場合: /var/opt/sun/identity/debug/desktop and /var/opt/sun/identity/debug/desktop.dpadmin.debug

dpadmin、par、rdmgr、および sendrdm という Portal Server コマンド行ユーティリティーには、デバッグメッセージを生成するためのオプションがあります。それらのオプションについては、『Portal Server 管理ガイド』を参照してください。

ログファイル

Solaris OS の場合: /var/opt/SUNWam/logs

Linux および HP-UX の場合: /var/opt/sun/identity/logs

トラブルシューティング

『Sun Java System Portal Server 7.1 管理ガイド』を参照してください。

Portal Server Secure Remote Access のトラブルシューティングのヒント

Portal Gateway のデバッグログは次のディレクトリに格納されます。

注 –

Solaris OS の場合、Access Manager 管理コンソールからロギングをオンにすると、NetFile などの Portal Server サービスのログは /var/opt/SUNWam/debug に作成されます。

Service Registry のトラブルシューティングのヒント

表 9–8 Service Registry のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

インスタンスログのディレクトリ: 

  • Solaris OS の場合: /var/opt/SUNWsrvc-registry/domains/registry/logs

  • Linux および HP-UX の場合: /var/opt/sun/srvc-registry/domains/registry/logs

メッセージログファイルの名前は server.log です。

設定ファイルの場所

Solaris OS の場合: /opt/SUNWsrvc-registry/install/install.properties

Linux および HP-UX の場合: /opt/sun/srvc-registry/install/install.properties

トラブルシューティング

『Service Registry 3.1 管理ガイド』を参照してください。

Sun Cluster ソフトウェアのトラブルシューティングのヒント

注 –

HP-UX および Linux では、Sun Cluster コンポーネントはサポートさません。

表 9–9 Sun Cluster ソフトウェアのトラブルシューティングのヒント

トピック 

詳細 

ログファイル

デフォルトのログディレクトリ: /var/cluster/logs/install

エラーメッセージ: /var/adm/messages

トラブルシューティング

『Sun Cluster Software Installation Guide for Solaris OS 』を参照してください。

Web Proxy Server のトラブルシューティングのヒント

表 9–10 Web Proxy Server のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

デフォルトのログの場所:

  • Solaris OS の場合: /opt/SUNWproxy/proxy-instance-name /logs

  • Linux および HP-UX の場合: /opt/sun/webproxyserver// proxy-instance-name/logs

errors ログファイルには、サーバーで発生したすべてのエラーが一覧表示されます。access ログファイルには、サーバーに対する要求と、サーバーからの応答に関する情報が記録されます。詳細については、『Sun Java System Web Proxy Server 4.0.4 管理ガイド』を参照してください。

設定ファイルのディレクトリ

Solaris OS の場合: /opt/SUNWproxy/proxy-instance-name /config

Linux および HP-UX の場合: /opt/sun/webserver/proxy-instance-name /config

デバッグモード

/server-root/proxy-instance-name/config/server.xml ファイル内の LOG 要素の loglevel 属性の値を、次の値に設定できます。info、fine、finer、finest。

Web Server のトラブルシューティングのヒント

表 9–11 Web Server のトラブルシューティングのヒント

トピック 

詳細 

ログファイル

Web Server のログファイルは 2 種類あります。errors ログファイルと access ログファイルです。errors ログファイルには、サーバーで発生したすべてのエラーがリストされます。access ログファイルには、サーバーに対する要求と、サーバーからの応答に関する情報が記録されます。詳細については、『Sun Java System Web Server 7.0 管理ガイド』を参照してください。

これらのログは、次のディレクトリにあります。 

  • Solaris OS の場合: /var/opt/SUNWwbsvr7/https- instancename/logs

  • Linux および HP-UX の場合: /var/opt/sun/webserver7/https- instancename/logs

Web Server の設定が「今すぐ設定」インストール時に失敗する場合は、次のログの追加情報を参照してください。 

  • Solaris OS の場合: /var/opt/SUNWwbsvr7/setup/WebServer_Install.log

  • Linux および HP-UX の場合: /var/opt/sun/webserver7/setup/WebServer_Install.log

管理サーバーのエラーログは、次の場所にあります。 

  • Solaris OS の場合: /var/opt/SUNWwbsvr7/admin-server/logs/errors

  • Linux および HP-UX の場合: /var/opt/sun/webserver7/admin-server/logs/errors

設定ファイルのディレクトリ

  • Solaris OS の場合:/var/opt/SUNWwbsvr7/https- instance-name/config

  • Linux および HP-UX の場合:/var/opt/sun/webserver7/https- instance-name/config

トラブルシューティングの追加情報

このマニュアルに記載されている次の情報も、トラブルシューティングに役立ちます。