B Oracle Database Gatewayのトラブルシューティング

この付録では、トラブルシューティングに関する情報について説明します。この付録の内容は次のとおりです。

要件の確認
インストール・エラーが発生した場合の処置
インストール・セッションのログの確認
コンフィギュレーション・アシスタントのトラブルシューティング
サイレント・モードのレスポンス・ファイルのエラー処理
インストール失敗後のクリーンアップ

B.1 要件の確認

この付録のトラブルシューティング手順のいずれかを実行する前に、システムが要件を満たしていることと、各章に記載されたインストール前のタスクをすべて完了していることを確認してください。

リリース・ノートの確認

製品のインストール前に、製品に関するリリース・ノートを参照してください。リリース・ノートは、Oracle Database 11gのインストール・メディアに含まれます。最新版のリリース・ノートは、次の場所にあるOTN Webサイトから入手できます。

http://www.oracle.com/technology/documentation/index.html

B.2 インストール・エラーが発生した場合の処置

インストール中にエラーが発生した場合、次の指示に従ってください。

Oracle Universal Installerを終了しないでください。
インストール画面の1つに間違った情報を入力した後に「次へ」をクリックした場合、「戻る」をクリックしてその画面に戻り、情報を修正します。
Oracle Universal Installerによるファイルのコピー中またはリンク中にエラーが発生した場合、「インストール・セッションのログの確認」を参照してください。
コンフィギュレーション・アシスタントの実行中にエラーが発生した場合、「コンフィギュレーション・アシスタントのトラブルシューティング」を参照してください。
問題を解決できない場合、「インストール失敗後のクリーンアップ」に記載された手順に従って失敗したインストールを削除します。

B.3 インストール・セッションのログの確認

インストール中にOracle Universal Installerにより実行されるすべてのアクションは、ログ・ファイルに記録されます。インストール中に問題が発生した場合、ログ・ファイルを確認し、考えられる問題の原因に関する情報を収集してください。

ログ・ファイルを表示するには、次の手順を実行します。

必要に応じて、次のコマンドを入力してoraInventoryディレクトリの場所を確認します。

AIXおよびLinuxの場合:
```
$ cat /etc/oraInst.loc
```
Solaris（SPARC）の場合:
```
# more /var/opt/oracle/oraInst.loc
```
HP-UX PA-RISCの場合:
```
$ cat /var/opt/oracle/oraInst.loc
```
このファイルのinventory_locパラメータにより、oraInventoryディレクトリの場所が指定されます。
次のコマンドを入力してOracle Universal Installerのログ・ファイル・ディレクトリに移動します（orainventory_locationはoraInventoryディレクトリの場所です）。
```
$ cd /orainventory_location/logs
```
次のコマンドを入力して、ログ・ファイルの名前を確認します。
```
$ ls -ltr
```
このコマンドにより、作成順にファイルがリストされます（最新のファイルが最後に表示されます）。インストーラのログ・ファイルには、次のような名前が付けられます（date_timeはインストールが開始された日時を示します）。
```
installActionsdate_time.log
```
問題に関する情報が出現している可能性の最も高い、ログ・ファイルの最新のエントリを表示するには、次のようなコマンドを入力します。
```
$ tail -50 installActionsdate_time.log | more
```
このコマンドにより、ログ・ファイルの最終50行が表示されます。
Oracle Universal Installerにより表示されたエラー、またはログ・ファイルにリストされたエラーが、再リンクの問題を示している場合、その詳細は次のファイルを参照してください。
```
$ORACLE_HOME/install/make.log
```

B.4 コンフィギュレーション・アシスタントのトラブルシューティング

コンフィギュレーション・アシスタントの実行時に発生したインストール・エラーをトラブルシューティングするには、次のようにします。

「インストール・セッションのログの確認」に記載されているインストール・ログ・ファイルを確認します。
$ORACLE_HOME/cfgtoollogsディレクトリにある特定のコンフィギュレーション・アシスタントのログ・ファイルを確認します。エラーの原因となっている問題を修正してください。
「致命的エラーです。再インストールしてください」というメッセージが表示されたら、ログ・ファイルを確認して問題の原因を調査します。詳細は、「致命的エラー」を参照してください。

B.4.1 コンフィギュレーション・アシスタントの障害

Oracleのコンフィギュレーション・アシスタントの障害は、インストール画面の下部に示されます。コンフィギュレーション・アシスタントのインタフェースに、（提供可能であれば）追加情報が表示されます。コンフィギュレーション・アシスタントの実行ステータスは、次のファイルに格納されます。

oraInventory_location/logs/installActionsdate_time.log

次の表に、実行ステータス・コードをリストします。

ステータス	結果コード
コンフィギュレーション・アシスタントの成功	0
コンフィギュレーション・アシスタントの失敗	1
コンフィギュレーション・アシスタントの取消し	-1

B.4.2 致命的エラー

コンフィギュレーション・アシスタントの実行中に致命的エラーが発生した場合、次のように現在のインストールを削除してOracleソフトウェアを再インストールする必要があります。

「インストール失敗後のクリーンアップ」の手順に従って失敗したインストールを削除します。
致命的エラーの原因を修正します。
Oracleソフトウェアを再インストールします。

B.5 サイレント・モードのレスポンス・ファイルのエラー処理

サイレント・モードによるインストールが成功したか失敗したかを確認するには、次のログ・ファイルを参照します。

/oraInventory_location/logs/silentInstalldate_time.log

必要に応じて、前述の項を参照してoraInventoryディレクトリの場所を確認してください。

次の場合、サイレント・インストールは失敗します。

レスポンス・ファイルを指定しない場合
間違った、または不完全なレスポンス・ファイルを指定した場合
Oracle Universal Installerにエラーが発生した場合（ディスク領域が不十分であるなど）

Oracle Universal Installerまたはコンフィギュレーション・アシスタントは、実行時にレスポンス・ファイルを検証します。検証に失敗すると、サイレント・モードによるインストールまたは構成プロセスは終了します。Oracle Universal Installerでは、間違ったコンテキスト、形式またはタイプのパラメータ値は、ファイル内に指定されていないものとして処理されます。

B.6 インストール失敗後のクリーンアップ

インストールに失敗した場合、インストールの試行中にOracle Universal Installerによって作成されたファイルとOracleホーム・ディレクトリを削除する必要があります。次の手順を実行してファイルを削除してください。

「Oracle Universal Installerの実行」の手順に従ってOracle Universal Installerを起動します。
ようこそウィンドウの「製品の削除」をクリックするか、任意のインストーラ・ウィンドウの「インストールされた製品」をクリックします。

インストールされた製品がリストされたインベントリ・ウィンドウが表示されます。
削除対象の製品が含まれるOracleホームを選択し、「削除」をクリックします。
失敗したインストール中に作成されたOracleホーム・ディレクトリを手動で削除します。
Oracleソフトウェアを再インストールします。