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

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

ログファイルの形式

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

• サマリーファイル。何をインストールして設定したかについての概要情報が記録されます。

• 詳細バージョン A ファイル。完了情報が記録されます。

• 詳細バージョン B ファイル。ログメッセージの詳細が記録されます。

• デバッグファイル。インストールに失敗したときにそれに関連する情報が記録されます。デバッグファイルは、ほかのいずれかのログにエラーが示された場合に使用します。

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

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

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

次の表は、ソースログファイルの形式を示しています。

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

ログに記録される内容	ログファイル名の形式
インストーラ	Sun_Java_Communications_Suite_install.Atimestamp
	Sun_Java_Communications_Suite_install.Btimestamp
	Sun_Java_Communications_Suite_log.timestamp
	Sun_Java_Communications_Suite_Summary_Report_install. timestamp
アンインストーラ	Sun_Java_Communications_Suite_uninstall.Atimestamp
	Sun_Java_Communications_Suite_uninstall.Btimestamp
	Sun_Java_Communications_Suite_UnInstall_log.timestamp
	Sun_Java_Communications_Suite_Summary_Report_uninstall. timestamp

ログメッセージは ULF (Unified Logging Format) で保存されます。この形式で読み取るのが難しい場合は、vi などのテキストエディタでソースファイルを編集するか、または Communications Suite ログビューアを使用して、ログメッセージを表示することもできます。

ログビューアのしくみ

Communications Suite ログビューアは、Sun_Java_Communications_Suite_Install_log. timestamp ファイルまたは Sun_Java_Communications_Suite_UnInstall_log. timestamp ファイルのインストーラログメッセージを表示するためのグラフィカルディスプレイを提供します。メッセージをフィルタで検索するときには、重要度の高いものまたは目的に合っているものから表示されるように、3 つの方法が用意されています。ログレベル別、モジュール ID 別、内容別の 3 つがあります

• ログレベル。次の 8 つのログレベルから選択できます。SEVERE、ERROR、WARNING、INFO、CONFIG、FINE、FINER、および FINEST です。ログレベルを選択すると、そのログレベル以上の重要度のログレコードのみが表示されます。「FINEST」を選択することは、すべてのレコードを表示することを選択することになります。

• モジュール ID。モジュールはログメッセージを書き込むインストーラの一部です。モジュール ID (JAVAESConfig、JAVAESInstall、または JAVAESUninstall) を選択すると、選択したモジュール ID に関連付けられたメッセージのみが表示されます。

• 「Content」。内容フィルタは、「configure」などの文字列を入力するように求められ、その文字列を含むメッセージのみが表示されます。

一般的なフィルタの例には次のようなものがあります。

• SEVERE ログメッセージのみを表示する。

• ログレベルが「ERROR」以上のログメッセージだけを表示する。

• インストール手順からのログメッセージのみを表示する。

• インストールログメッセージのうち、ログレベルが「ERROR」以上のメッセージだけを表示する。

• フィルタリングしたシナリオの結果をファイルに保存します。

次の表に、ログビューアの基本機能の概要を示します。

表 10–2 ログビューアの機能

作業	機能
「開く」	フィルタリングし、表示するログファイルを選択します。
「保存」	フィルタリングし、翻訳したメッセージを「ファイル」>「名前を付けて保存」オプションで指定したファイルに保存します。
「名前を付けて保存」	フィルタリングし、翻訳したメッセージを書き込む個別のファイルを選択します。  注意: このファイルは、インストーラがソースログの保存に使用するディレクトリに置くことはできません。
「印刷」	フィルタリングし、翻訳したファイルを印刷します。
「終了」	開いているすべての出力ファイルを閉じ、入力ファイルを閉じて、ログビューアページを閉じます。
「ログレベルのフィルタ」	フィルタリングするログレベルを選択します。
「モジュール ID のフィルタ」	開いたファイル内のいずれかのモジュール ID を選択するか、選択しません。リストは、フィルタリングするログファイルを選択したときに作成されます。
「内容のフィルタ」	ユーザー定義の文字列を含むメッセージを選択します。
「言語の選択」	翻訳言語を選択します。デフォルトは英語です。このリストは、インストーラによって格納される翻訳リソースバンドルに基づいて表示されます。

この機能によって、ログビューアはトラブルシューティングの状況に役立つ選別された情報を表示できます。フィルタ条件を満たすメッセージが単一のログテーブルに表示されます。ログテーブルの行を選択して、詳細を表示し、メッセージを複数行形式で表示することができます。

ログビューアを実行する

ログビューアは読み取り専用モードで動作するため、複数のユーザーが同時にログビューアを使用できます。インストール後、ログビューアは次の場所に存在します。

• Solaris SPARC の場合: /var/sadm/prod/SUNWcomm-entsys5i/Solaris_sparc

• Solaris x86 の場合: /var/sadm/prod/SUNWcomm-entsys5i/Solaris_x86

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

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

   ログビューアをグラフィカルモードで実行するには、次のコマンドを入力します。

   ./viewlog

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

1. Sun_Java_Communications_Suite_Summary_Report_install. timestamp などのサマリーファイルを検証します。

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

2. Sun_Java_Communications_Suite_install.A timestamp などの詳細ログ (A および B) を検証します。

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

   2. 問題の原因となっているコンポーネントまたはパッケージの名前を探します。問題の解決に失敗したら、デバッグログを調査します。

3. Sun_Java_Communications_Suite_Install_log. timestamp などのデバッグログを検証します。