6 トラブルシューティング

この章では、インストールおよび構成の一般的な問題とその解決方法を説明します。

• インストールおよび構成の問題

• NFSトラブルシューティング

• Oracle Content Management SDKの削除

• オラクル社カスタマ・サポート・センターへの問合せ

インストールおよび構成の問題

インストールおよび構成のエラーのほとんどは、インストール前の作業手順に正しく従わないために発生します。次の表は、インストールおよび構成の一般的な問題、考えられる原因および対処方法を示します。インストールおよび構成のアクションは、次のように2つのログ・ファイルに記録されるので、これらを調べるとトラブルシューティングに役立ちます。

• $ORACLE_BASE/oraInventory/logs/installActions.logファイルには、Oracle CM SDKのインストール時に発生したエラーが記録されます。

  $ORACLE_BASEが定義されていない場合、デフォルトで$ORACLE_HOMEに設定されます。

• $ORACLE_HOME/ifs/cmsdk/log/CmsdkConfig.logファイルには、Oracle CM SDKの構成時に発生したエラーが記録されます。

  表6-1    インストールの問題と解決方法 

  問題	考えられる原因	対処方法
  Oracle CM SDK Configuration Assistant実行時に表示される「Classpathの検証に失敗しました」のメッセージ	ライブラリ・ファイルがありません。Oracle CM SDK Configuration Assistantは、ファイルtranslator.zipを検索して見つからない場合にエラー・メッセージを表示します。 Oracle CM SDKには、translator.zipに含まれるSQLJライブラリによってサポートされるLoadJavaが必要です。	Oracle Application Serverを再インストールします。
  データベース・オブジェクトの作成時またはアップグレード時のエラー	データベースが実行されていないか、使用できません。または、リスナーが実行されていません。	構成の前に、データベースおよびリスナーを起動します。
  データベース関連のインストーラ・エラー・メッセージ	インストールを開始するときに、データベースが実行されていません。 Oracle CM SDKを構成するときに、Oracle Textが正しく構成されていません。	インストールを開始する前にデータベースを起動します。また、tnsnames.oraファイルおよびlistener.oraファイルの設定を確認します。
  インストール時のアクセス権の問題	インストールするユーザーが不正です。	ファイル・システムのアクセス権を確認します。 中間層コンピュータにOracle Application Serverをインストールしたときに使用したのと同じアカウントでOracle CM SDKをインストールします。
  不十分なデータベース・リソースが原因のOracle CM SDKサーバーの障害	initsid.oraの値が小さすぎます。	$ORACLE_HOME/ifs/cmsdk/logディレクトリで、障害が発生したサーバーのログ・ファイルを検索します。initsid.oraファイルを編集（またはSPFILEを変更）して、値を増やします。
  「Oracle Text構成を検証しています」フェーズでのifscaの停止	ctxhx実行可能ファイルの構成が不正です。	topまたはpsコマンドを使用してオペレーティング・システム・プロセスを調べて、ctxhxのCPU使用率が80%を超えており、1分以内に完了しないことを確認します。 ctxhxプロセスを終了します。 ifscaを再実行します。 これで問題が解決しない場合は、次の2つのコマンドを発行して、ifscaとは別にctxhxをテストします。 cd $ORACLE_HOME/ctx/bin ./ctxhx $ORACLE_HOME/ifs/cmsdk/ admin/binaries/ifsctxtest.doc test.html このテストが失敗した場合は、オラクル社カスタマ・サポート・センターに問い合せてください。 このテストが成功した場合は、ifscaとは別にVerifyContextをテストします。 BLOB列を持つ一時表を作成します。 そのBLOB列にOracle Text索引を作成します。 BLOB列に単純なMicrosoft Wordドキュメントを格納します。 Oracle Text索引を同期化します。 ドキュメントの内容に対して問合せを発行します。 次の2つのコマンドを使用して、CLASSPATH環境変数にVerifyContextを含めます。 cd $ORACLE_HOME/ifs/cmsdk/admin/binaries $IFS_JRE -classpath $IFS_BASE_CLASSPATH oracle.ifs.admin.tools.schema.VerifyCont ext sys change_on_install $ORACLE_ HOME/ifs/cmsdk/admin/binaries/ifsctxtest .doc データベースが別のコンピュータにある場合は、オプションとしてJDBC接続文字列を追加します。たとえば、次のとおりです。 jdbc:oracle:oci8:@myTNSalias VerifyContextの出力を確認して、エラーの原因を特定します。
  Oracle CM SDKの構成時の「No ocijdbc9 in java library path」というエラー・メッセージ	構成しようとしているコンピュータが、LD_LIBRARYが正しく設定されていない64-bitコンピュータです。	環境変数LD_LIBRARY_PATHに$ORACLE_HOME/lib32を追加します。追加するには、.profileまたは.loginを使用するか、Oracle CM SDKをインストールするユーザー・アカウントの環境変数を設定するスクリプトを作成します。 BourneシェルまたはKornシェルの例（.profile）: ... LD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH Cシェルの例（.login）: ... setenv LD_LIBRARY_PATH $ORACLE_HOME/lib32:$LD_LIBRARY_PATH これらの環境変数を設定した後、.profileまたは.loginを実行して環境変数を有効にします。BourneシェルまたはKornシェルの場合: $ . .profile Cシェルの場合: % source .cshrc 変更を行った後、再度ifscaを実行します。
  Oracle CM SDKの構成時に表示される「oracle.ifs.utils.action.ActionFailedException: Oracle Textは不適当に構成された可能性があります」エラー・メッセージ	環境変数に、必要なLD_LIBRARY_PATHまたはPATHの設定が含まれていません。	データベース・サーバーのLD_LIBRARY_PATH環境変数およびPATH環境変数に、必要な設定が含まれていることを確認します。 LD_LIBRARY_PATHには、$ORACLE_HOME/libおよび$ORACLE_HOME/ctx/libが必要です。 PATHには、$ORACLE_HOME/ctx/binが必要です。 データベース・リスナーを再起動して変更を有効にし、再度ifscaを実行します。
  Oracle CM SDKの構成時に表示される「OracleユーザーSYSのパスワードが無効です」エラー・メッセージ	パスワード・ファイルがデータベース・サーバーにありません。 Oracle CM SDK Configuration Assistantは、データベース文字列を使用してSYS 'AS SYSDBA'として接続しようとしています。	データベースは、パスワード・ファイルで構成する必要があります。詳細は、『Oracle9i データベース管理者ガイド』を参照してください。
  Oracle CM SDKの構成時に表示される「この値は50である必要があります。」というエラー・メッセージ	initsid.oraファイルのsession_max_open_files値が正しく設定されていません。	initsid.oraファイルを変更して、session_max_open_filesパラメータの値を50に設定します。 ファイルに次の行を追加するように編集します。 session_max_open_files=50 ファイルの編集後、データベースを停止し、新しいinitsid.oraファイルでデータベースを再起動します。SQL*Plusで次のコマンドを使用してデータベースを起動します。 startup pfile="$ORACLE_HOME/pfile/initsid.ora"
  $ORACLE_HOME/ifs/cmsdk/log/domain_name/node_name.logへの「Out of database cursors」メッセージの書込み	initsid.oraのopen_cursorsの値が小さすぎます。	initsid.oraファイルを編集（またはSPFILEを変更）して、open_cursorsの値を増やします。
  サーバーが遅い	サーバーのチューニングが必要です。	『Oracle Content Management SDK管理者ガイド』のトラブルシューティングに関する章を参照してください。
  Oracle CM SDKのアップグレード後にドキュメントの内容の検索ができない	Oracle Text索引が再移入されていません。	Oracle Textの再移入については、『Oracle Content Management SDK管理者ガイド』を参照してください。
  CUPクライアント・スクリプト（ifsshell）を実行できない	FTPによる転送時に、Solarisのumaskの設定によって、ファイルのデフォルトのアクセス権が変更されました。	次のコマンドを使用して実行可能なifsshellスクリプトを作成します。 chmod +x ifsshell ifsshellスクリプトは$ORACLE_HOME/ifs/clients/cmdline/unixディレクトリにあります。
  共有メモリーが割り当てられないというエラー	shared_pool_sizeデータベース初期化パラメータの値が小さすぎます。	shared_pool_sizeの値を最低80MB（83886080バイト）に設定します。
  Oracle CM SDKのプロセスを開始しようとすると、ノード・マネージャがstdinのデータ形式が正しくないというエラーをレポートする	コンピュータのCPUが過負荷です。	不必要なプロセスを停止するか、CPUをアップグレードします。
  カスタム・クラスにアクセスできない	カスタム・クラスは次のディレクトリに配置する必要があります。 $ORACLE_HOME/ifs/cmsdk/custom_classes	すべてのカスタム・クラスを、$ORACLE_HOME/ifs/cmsdk/custom_classesディレクトリに移動します。 注意: LINKという名前のカスタム・クラスがある場合、Oracle CM SDK 9.0.4をインストールする前にそのクラス名を変更してください。
  Windows 64-bit Oracle9i Database Serverリリース2（9.2.0.2）データベースに対するOracle CM SDKの構成が失敗する	Oracle Textをスキーマで有効にするために必要なctxhx実行可能ファイルがデータベースにありません。	2つの解決方法があります。 Oracle Textが無効の状態でスキーマを作成する。 独自のctxhx実行可能ファイルを構築する。詳細は、OTNのhttp://www.oracle.com/technology/products/text/htdocs/FilterServer.htmを参照してください。

NFSトラブルシューティング

NFSドライブのマウント時に「許可されません」エラーが発生した場合、次の表を参考にして問題の原因を特定してください。

表6-2    NFSトラブルシューティング 

トラブルシューティングの手順	詳細
ノードのログ・ファイルで詳細を確認します。通常ノードのログには、ノードごとに同じタイプの情報が記録されています。このログは、プロトコル・サーバーおよびエージェントのトラブルシューティングに役立ちます。すべてのエラーが、スタック・トレースで記録されます。ログ・レベル、ログ・ローテーション間隔などのログ・ファイル・プロパティは、監視対象ノードのノード構成で指定します。	ノードのログのデフォルトの場所は、次のとおりです。 $ORACLE_HOME/ifs/cmsdk/log/transferred_domain_name/node_name.log
Oracle CM SDK NFSサーバーの構成がプライマリ・サーバーかセカンダリ・サーバーかを確認します。サーバーがセカンダリ・サーバーとして構成されている場合、またはOracle CM SDK NFSサーバーが標準のポート番号でない場合、Solarisクライアントではpublicオプションを指定し、Linuxクライアントではマウント・ポートを指定する必要があります。	詳細は、第5章「クライアント・アクセスのパスおよびソフトウェア」の「NFS（Network File System）プロトコル」を参照してください。
クライアントがトラステッド・クライアント・リストに含まれていることを確認します。	詳細は、第4章「構成後の作業」の「トラステッド・クライアント・リストの設定」を参照してください。
NFSサーバーが実行されているポート番号およびマウント・ポート番号を確認します。	Oracle CM SDKの構成時におけるNFSサーバー・ポート番号の選択の詳細は、第3章「インストールと構成」を参照してください。
netstatコマンドを使用して（Windowsクライアントの場合）、指定したポートをコンピュータが現在リスニングしていることを確認します。	コマンド・プロンプトにnetstat ?と入力してパラメータのリストを表示します。
動作保証されているNFSクライアントを使用していることを確認します。	NFSへのクライアント・アクセス機能は、すべてのUNIXオペレーティング・システムで使用可能ですが、Windowsシステムでは追加のクライアント・ソフトウェアが必要です。Hummingbird Maestro NFSは、Oracle CM SDK NFSサーバーでの使用がサポートされているクライアントです。 Windows 2000ユーザーがOracle CM SDK NFSサーバーに接続するには、Hummingbird Maestro NFS 7.0を使用する必要があります。 Windows NTユーザーがOracle CM SDK NFSサーバーに接続するには、Hummingbird Maestro NFS 6.0以降を使用します。 サポートされているその他のNFSクライアント・アプリケーションとそのバージョンについては、Oracle Content Management SDKのリリース・ノートを参照してください。

Oracle Content Management SDKの削除

Oracle Universal Installerを起動して、次のようにOracle CM SDKを削除します。

1. Oracle CM SDKのインストールおよび構成に使用したアカウントでログオンします。通常、これはoracleというアカウントです。

2. ドメインおよびノードを停止します。HTTPノードでは、OC4Jプロセスを停止します。

3. 製品のリリースに対応したコマンドで、すべてのプロトコル・サーバーおよびエージェントを停止します。

   表6-3    削除コマンド 

   リリース	コマンド
   Oracle Internet File System 9.0.1、9.0.2	$ORACLE_HOME/9ifs/bin/ifsjservctl stop $ORACLE_HOME/9ifs/bin/ifsstopdomain （あるいは、Oracle Enterprise Manager 10g コンソールを使用してドメインおよびすべてのノードを停止）
   Oracle CM SDK 9.0.3および9.0.4	$ORACLE_HOME/ifs/cmsdk/bin/ifsctl stop $ORACLE_HOME/opmn/bin/opmnctl stopall

4. すべてのプロセスが停止するのを待ちます。

5. Oracle Universal InstallerをインストールCDから起動します。

6. 「ようこそ」画面で「製品の削除」をクリックします。「インベントリ」画面が表示されます。

7. 「インベントリ」画面で$ORACLE_HOMEディレクトリをクリックして、すべてのインストール済コンポーネントを表示します。そのリストにOracle CM SDKまたはOracle Internet File Systemが含まれていることを確認します。

8. Oracle CM SDKまたはOracle Internet File Systemをリストから選択し、「削除」をクリックします。

9. 「はい」をクリックしてOracle CM SDKの削除を確定します。ソフトウェア・コンポーネントが削除され、Oracle Universal Installerが再度表示されます。

10. 「閉じる」をクリックします。

11. Oracle Universal Installerを終了します。

12. Oracle CM SDKまたはOracle Internet File Systemのディレクトリをコンピュータから完全に削除するには、root（またはoracle）としてログオンし、UNIXの削除コマンド（rm）を再帰および強制のオプションを付けて実行します。

    重要 表6-4に示されているコマンドを実行する前に、正しいパス名が入力されていることを必ず確認してください。強制のパラメータ（-f）によって、書込みアクセス権のないファイルを含めてすべてのファイルが削除され、再帰のパラメータ（-r）によって、パスの下にあるすべてのサブディレクトリ内のすべてのファイルが削除されます。誤ったパス名を入力すると、システムに深刻な障害をもたらす恐れがあります。

    表6-4    削除コマンド 

    リリース	コマンド
    Oracle Internet File System 9.0.1、9.0.2	rm -rf $ORACLE_HOME/9ifs
    Oracle CM SDK 9.0.3および9.0.4	rm -rf $ORACLE_HOME/ifs/cmsdk

オラクル社カスタマ・サポート・センターへの問合せ

オラクル社カスタマ・サポート・センターには、http://metalink.oracle.comからアクセスできます。

オラクル社カスタマ・サポート・センターに問い合せる前に、次の項目を確認してください。

使用しているソフトウェア、データベースおよび環境が、第2章「要件」に記載されている要件を満たしていることを確認します。

CSI番号（該当する場合）または詳しいコンタクト情報（特別なプロジェクト情報、Oracle CM SDKとその関連製品の完全なリリース番号、オペレーティング・システム名とそのバージョン番号など）を確認します。

問題のエラー・コード、メッセージおよびその他の詳細情報を、次のように記録します。

• 発生したエラーまたは実行されなかった処理の内容。

• たとえば、使用したコマンドとそれによって得られた結果など。

• エラーが発生したタイミング。

• たとえば、システム負荷のピーク時、特定のコマンドの実行後、またはオペレーティング・システムのアップグレード後など。

• エラーが発生した場所。

• たとえば、データベース・コンピュータまたはOracle CM SDKコンピュータなど。

• 問題の影響が及ぶ範囲。たとえば、本番システムが使用できなくなった、またはほとんど影響がないなど。

インストール・ログ、Oracle CM SDKログ、Oracle Textログ、トレース・ファイル、コア・ダンプおよび問題の発生以後のREDOログ・ファイルのコピーを保管します。オラクル社カスタマ・サポート・センターでは、問題を詳細に検討するために、これらのログを必要とする場合があります。

インストールに関連する問題では、この他に次の情報も必要です。

• $ORACLE_HOMEおよびステージング領域の内容のリスト（使用した場合）

• $ORACLE_HOME/ifs/cmsdk/logディレクトリのすべてのログ・ファイル