5 テストおよびトラブルシューティング

アプリケーションを作成したら、コネクタをテストして正常に機能することを確認する必要があります。

この章では、コネクタのテストに関連する次のトピックについて説明します。

• UNIXコネクタのテスト

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

5.1 UNIXコネクタのテスト

コネクタ・パッケージで提供されるテスト・ユーティリティを使用すると、ターゲット・システムへの接続およびターゲット・システムでの基本操作の実行に関する問題の原因を特定できます。

コネクタ・インストール・メディアのtest-utilityディレクトリには次のファイルが含まれます。

• example-config.groovyファイルはサンプル構成で、ターゲット・システムとコネクタの接続プロパティを設定するのに使用できます。

• READMEファイルにはテスト・ユーティリティを構成および実行する手順が含まれています。

• test-utility.jarファイルには、テスト・ユーティリティで使用されるクラスが含まれます。

ノート:

テスト・ユーティリティでは、個別の更新および削除アクションはサポートされません。ユーザーの作成時に同じ操作内でユーザーの更新および削除を行うことができます。

テスト・ユーティリティを使用するには、次のステップを実行します。

1. JDK 1.6がインストールされていることを確認します。
2. コネクタのzipファイルを解凍します。
3. 解凍されたzipファイルのコンテンツで、test-utilityディレクトリを探して切り替えます。

   test-utility.jarおよびexample-config.groovy filesがディレクトリに存在します。

   ノート:

   Microsoft Windowsコンピュータでは、バンドル・パッケージ(org.identityconnectors.genericunix-1.0.0.jar)はtest-utilityディレクトリ以外のディレクトリにある必要があります。

4. 次のJARファイルをtest-utilityディレクトリにコピーします。

   • connector-framework.jar

   • connector-framework-internal.jar

   • groovy-all.jar

   ノート:

   これらのファイルはOIM EARアプリケーションの一部として提供され、oim.ear/APP-INF/libディレクトリにあります。

   これらの3つのJARファイルをテスト・ユーティリティを実行するJAVA_HOME/jre/lib/extディレクトリに追加する必要があります。

   これらのJARファイルをtest-utilityディレクトリにコピーする場合、ステップ6で示したJavaコマンドでこれらのファイルを除外できます。

5. example-config.groovyファイルを更新して、ローカル設定を反映させます。
6. 次のいずれかのコマンドを実行します。

   UNIXコンピュータの場合:

   java -classpath ./test-utility.jar:./connector-framework.jar:./connector-framework-internal.jar:./groovy-all.jar:./test-utility.jar oracle.iam.connectors.testutility.Main example-config.groovy | tee test.log
   

   Microsoft Windowsコンピュータの場合(現在のディレクトリをc:\test-utilityと仮定):

   java -classpath C:\test-utility\test-utility.jar;C:\test-utility\connector-framework.jar;C:\test-utility\connector-framework-internal.jar;C:\test-utility\groovy-all.jar;C:\test-utility\test-utility.jar; oracle.iam.connectors.testutility.Main example-config.groovy
   

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

発生したエラーのタイプに応じて、UNIXコネクタをトラブルシューティングできます。

以降の項で、次のタイプの一般的なエラーの解決方法を示します。

• 接続エラー

• ユーザー作成エラー

• ユーザー削除エラー

• ユーザー編集エラー

• タイムアウト・エラー

5.2.1 接続エラー

この表では、一般的な接続エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはターゲット・システムとの接続を確立できません。 表示されるエラー・メッセージ: UNIX接続例外	ターゲット・システムが稼働していることを確認します。 Oracle Identity Managerが稼働している(つまりデータベースが稼働している)ことを確認します。 すべてのアダプタがコンパイルされていることを確認します。 (「ITリソース」フォームから)Oracle Identity Managerレコードを調べます。すべてのITリソース・パラメータの値が正しく指定されていることを確認します。

5.2.2 ユーザー作成エラー

この表では、一般的なユーザー作成エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Governanceはユーザーを作成できません。 表示されるエラー・メッセージ: ユーザーはすでに存在します	割り当てたIDのユーザーはターゲット・システムにすでに存在します。

5.2.3 ユーザー削除エラー

この表では、一般的なユーザー削除エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Governanceはユーザーを削除できません。 表示されるエラー・メッセージ: ターゲット・システムにユーザーが存在しません	指定したユーザーがターゲット・システムに存在しません。

5.2.4 ユーザー編集エラー

この表では、一般的なユーザー編集エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Governanceはユーザーを更新できません。 表示されるエラー・メッセージ: ターゲット・システムにユーザーが存在しません	詳細はログを調べてください。

5.2.5 タイムアウト・エラー

この表では、一般的なタイムアウト・エラーの解決方法を示します。

問題の詳細	解決方法
コネクタ操作中、一般的にはリコンシリエーション操作中の接続タイムアウト。 表示されるエラー・メッセージ: コマンドがタイムアウトしました	構成参照定義のcommandTimeoutエントリの値を増加します。 詳細は、「コネクタ構成用の参照定義の設定」を参照してください。
リコンシリエーションがエラーで失敗する。 表示されるエラー・メッセージ: org.identityconnectors.genericunix.common.GenericUnixUtil :getMatchedResponseInfo : バッファ:-> > > > >パスワード:	Lookup.Unix.Configuration.Trustedルックアップ定義のsudoPasswdExpectExpressionエントリの値を、Password:からpasswordに変更します。 ノート: Pは小文字にします。