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

コネクタをデプロイおよび構成した後、テストを行いコネクタが正常に機能することを確認する必要があります。この章では、コネクタのテストに関連する次のトピックについて説明します。

テスト・ケースの実行
コネクタの問題のトラブルシューティング

4.1 テスト・ケースの実行

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

テスト・ユーティリティを使用するには、次のようにします。

インストール・メディアのtestディレクトリの内容をOIM_HOME/xellerate/SJSDS/test/troubleshootディレクトリにコピーします。

TroubleShootIPlanet.propertiesファイルのパラメータに値を指定します。

このファイルはOIM_HOME/xellerate/SJSDS/test/troubleshootディレクトリにあります。次の表に、テストを実行するための情報を指定するこのファイルのセクションを示します。

セクション	情報
Sun Java System Directory Server connection parameters	ターゲット・システムへの接続に必要な接続パラメータ。これらのパラメータは、このガイドで前述した手順を実行して構成したITリソースのパラメータと同一です。
Create User Information	ユーザーの作成に必要なパラメータ。
Modify User Information	ユーザーの変更に必要なパラメータ。
Delete User Information	削除するユーザーのDN。

次のパスをCLASSPATH環境変数に追加します。

OIM_HOME/xellerate/JavaTasks/SJSDSProv.jar
OIM_HOME/xellerate/lib/xlLogger.jar
OIM_HOME/xellerate/ext/log4j-1.2.8.jar
OIM_HOME/xellerate/lib/xlUtils.jar

次のようにして、TroubleShootIPlanet.propertiesファイルのASCII形式のコピーを作成します。

注意:
TroubleShootIPlanet.propertiesファイルの内容を変更するたびに、この手順を実行してください。
1. コマンド・ウィンドウで、次のディレクトリに移動します。
```
OIM_HOME/xellerate/SJSDS/test/troubleshoot
```
2. 次のコマンドを入力します。
```
native2ascii TroubleShootIPlanet.properties global.properties
```
  native2asciiコマンドを実行すると、global.propertiesが作成されます。このファイルの内容は、TroubleShootIPlanet.propertiesファイルの内容のASCII形式のコピーです。

次のテストを実行します。

次のようにユーザーを作成します。

java -DpropertyFile=./global.properties 
-Dlog4j.configuration=./log.properties TroubleShootingUtilityIPlanet 
createUser

次のようにユーザーを変更します。

java -DpropertyFile=./global.properties 
-Dlog4j.configuration=./log.properties TroubleShootingUtilityIPlanet 
modifyUser

次のようにユーザーを削除します。

java -DpropertyFile=./global.properties 
-Dlog4j.configuration=./log.properties TroubleShootingUtilityIPlanet 
deleteUser

4.2 コネクタの問題のトラブルシューティング

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

接続エラー
ユーザー作成エラー
ユーザー変更エラー
ユーザー削除エラー
リコンシリエーション・エラー

4.2.1 接続エラー

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

問題の詳細	解決方法
Oracle Identity ManagerはSun Java System Directoryサーバーとの接続を確立できません。表示されるエラー・メッセージ: 接続エラーが発生しました表示されるエラー・コード: INVALID_CONNECTION_ERROR	Sun Java System Directoryが稼働していることを確認します。 Oracle Identity Managerが稼働している（つまりデータベースが稼働している）ことを確認します。すべてのアダプタがコンパイルされていることを確認します。（「ITリソース」フォームから）Oracle Identity Managerレコードを調べます。指定したIPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。
ターゲットがありません。表示されるエラー・メッセージ: ターゲット・サーバーが使用できません表示されるエラー・コード TARGET_UNAVAILABLE_ERROR	指定したSun Java System Directoryサーバーの接続値が正しいことを確認します。
認証エラー。表示されるエラー・メッセージパスワードが無効か正しくありません表示されるエラー・コード AUTHENTICATION_ERROR	指定したユーザー・アカウントの資格証明でパスワードが正しいことを確認します。

問題の詳細

解決方法

Oracle Identity ManagerはSun Java System Directoryサーバーとの接続を確立できません。

表示されるエラー・メッセージ:

接続エラーが発生しました

表示されるエラー・コード:

INVALID_CONNECTION_ERROR

Sun Java System Directoryが稼働していることを確認します。
Oracle Identity Managerが稼働している（つまりデータベースが稼働している）ことを確認します。
すべてのアダプタがコンパイルされていることを確認します。
（「ITリソース」フォームから）Oracle Identity Managerレコードを調べます。指定したIPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。

ターゲットがありません。

表示されるエラー・メッセージ:

ターゲット・サーバーが使用できません

表示されるエラー・コード

TARGET_UNAVAILABLE_ERROR

指定したSun Java System Directoryサーバーの接続値が正しいことを確認します。

認証エラー。

表示されるエラー・メッセージ

パスワードが無効か正しくありません

表示されるエラー・コード

AUTHENTICATION_ERROR

指定したユーザー・アカウントの資格証明でパスワードが正しいことを確認します。

4.2.2 ユーザー作成エラー

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

問題の詳細	解決方法
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: 必須フィールドの情報が指定されていません表示されるエラー・コード: INSUFFICIENT_INFORMATION_PROVIDED	IPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。次の情報が指定されていることを確認します。ユーザーID ユーザー・パスワードユーザー・コンテナユーザーの名ユーザーの姓
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: ユーザーはすでに存在します表示されるエラー・コード: USER_ALREADY_EXIST	指定したIDを持つユーザーがSun Java System Directoryにすでに存在するかどうか確認します。ユーザーに新しいIDを割り当て、再試行します。
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: ネーミング例外が発生しました表示されるエラー・コード: INVALID_NAMING_ERROR	指定したSun Java System Directoryの接続値が正しいことを確認します。属性値がスキーマの定義に違反しているかどうか確認します。
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: 必要な情報がありません。ユーザーを作成できませんでした表示されるエラー・コード: USER_CREATION_FAILED	属性値がスキーマの定義に違反しているかどうか確認します。
存在しない属性に値を追加しようとしたため、ユーザー作成操作は失敗しました。表示されるエラー・メッセージ: 属性が存在しません表示されるエラー・コード: ATTRIBUTE_DOESNOT_EXIST	`AttrName.Prov.Map.iPlanet`参照定義で、デコード値がターゲット・システムにおいて有効な属性名かどうか確認します。
無効な値を追加しようとしたため、ユーザー作成操作は失敗しました。表示されるエラー・メッセージ: 属性に指定した値が無効です表示されるエラー・コード: INVALID_ATTR_VALUE_ERROR	ユーザー作成中に指定した値を確認します。

4.2.3 ユーザー変更エラー

次の表は、一般的なユーザー変更エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーの属性値を変更できません。表示されるエラー・メッセージ: 属性値または状態が無効です表示されるエラー・コード: INVALID_ATTR_MODIFY_ERROR	指定したユーザーIDを確認します。
存在しない属性に値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 属性が存在しません表示されるエラー・コード: ATTRIBUTE_DOESNOT_EXIST	対応するプロセス・タスクから、コネクタの`AttrName`に渡される値を取得します。前の手順で取得した名前を使用して、デコード値がターゲットで有効な属性名かどうか、`AttrName.Prov.Map.iPlanet`参照定義で確認します。
無効な値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 属性に指定した値が無効です表示されるエラー・コード: INVALID_ATTRIBUTE_VALUE_ERROR	指定した値を確認してください。
`AttrName.Recon.Map.iPlanet`参照定義に存在しない属性に値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 1つ以上の属性マッピングがありません表示されるエラー・コード: ATTR_MAPPING_NOT_FOUND	対応するプロセス・タスクから、コネクタの`AttrName`に渡される値を取得します。前の手順で取得した名前を使用して、`AttrName.Recon.Map.iPlanet`参照定義にエントリが作成されているかどうかを確認します。
重複する値を属性に追加しようとしたため、操作は失敗しました。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	指定した値を確認してください。
Oracle Identity Managerはユーザーをコンテナから別のコンテナに移動できません。表示されるエラー・メッセージ: 異なるコンテナにユーザーを移動できませんでした表示されるエラー・コード: USER_MOVE_FAILED	一般的なエラー。詳細はログを調べてください。
Oracle Identity Managerはセキュリティ・グループにユーザーを追加できません。表示されるエラー・メッセージ: グループが存在しません表示されるエラー・コード: GROUP_DOES_NOT_EXIST	指定したユーザー・セキュリティ・グループがSun Java System Directoryに存在しません。グループ名を確認してください。
Oracle Identity Managerはユーザーをグループに追加できません。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	ユーザーはすでにグループのメンバーです。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: ロールが存在しません表示されるエラー・コード: ROLE_DOESNOT_EXIST	Oracle Identity Managerでユーザーに指定したロールがSun Java System Directoryに存在しません。Sun Java System Directoryにロールを作成します。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: ユーザーを更新できませんでした表示されるエラー・コード: USER_UPDATE_FAILED	一般的なエラー。詳細はログを調べてください。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	ユーザーはすでにこのロールを割り当てられています。
Oracle Identity Managerはユーザーに割り当てられたロールを削除できません。表示されるエラー・メッセージ: ユーザーからロールを削除できませんでした表示されるエラー・コード: USER_REMOVE_ROLE_FAILED	一般的なエラー。詳細はログを調べてください。

4.2.4 ユーザー削除エラー

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

問題の詳細	解決方法
Oracle Identity Managerはユーザーを削除できません。表示されるエラー・メッセージ: ユーザーが存在しません表示されるエラー・コード: USER_DOESNOT_EXIST	指定したユーザーがSun Java System Directoryに存在しません。

問題の詳細

解決方法

Oracle Identity Managerはユーザーを削除できません。

表示されるエラー・メッセージ:

ユーザーが存在しません

表示されるエラー・コード:

USER_DOESNOT_EXIST

指定したユーザーがSun Java System Directoryに存在しません。

4.2.5 リコンシリエーション・エラー

次の表は、一般的なリコンシリエーション・エラーの解決方法を示します。

問題の詳細解決方法

問題の詳細	解決方法
Oracle Identity ManagerはSun Java System Directoryからのユーザーをリコンサイルできません。表示されるエラー・メッセージ: `javax.naming.NamingException: tcUtilLDAPOperations -> : NamingException : Unable to search LDAP` 表示されるエラー・コード: `LDAP: error code 11 - Administrative Limit Exceeded`	Sun Java System Directoryの構成を次のように変更します。 Sun ONE Directory Server管理コンソールを開きます。「Configuration」、「Performance」および「Client Control」を選択します。サイズ制限を`unlimited`に設定します。検索制限を`unlimited`に設定します。変更を保存し、Sun Java System Directoryを再起動します。

Oracle Identity ManagerはSun Java System Directoryからのユーザーをリコンサイルできません。

表示されるエラー・メッセージ:

javax.naming.NamingException: tcUtilLDAPOperations -> : NamingException : Unable to search LDAP

表示されるエラー・コード:

LDAP: error code 11 - Administrative Limit Exceeded

Sun Java System Directoryの構成を次のように変更します。

Sun ONE Directory Server管理コンソールを開きます。
「Configuration」、「Performance」および「Client Control」を選択します。
サイズ制限をunlimitedに設定します。
検索制限をunlimitedに設定します。
変更を保存し、Sun Java System Directoryを再起動します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: 必須フィールドの情報が指定されていません表示されるエラー・コード: INSUFFICIENT_INFORMATION_PROVIDED	IPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。次の情報が指定されていることを確認します。ユーザーID ユーザー・パスワードユーザー・コンテナユーザーの名ユーザーの姓
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: ユーザーはすでに存在します表示されるエラー・コード: USER_ALREADY_EXIST	指定したIDを持つユーザーがSun Java System Directoryにすでに存在するかどうか確認します。ユーザーに新しいIDを割り当て、再試行します。
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: ネーミング例外が発生しました表示されるエラー・コード: INVALID_NAMING_ERROR	指定したSun Java System Directoryの接続値が正しいことを確認します。属性値がスキーマの定義に違反しているかどうか確認します。
Oracle Identity Managerはユーザーを作成できません。表示されるエラー・メッセージ: 必要な情報がありません。ユーザーを作成できませんでした表示されるエラー・コード: USER_CREATION_FAILED	属性値がスキーマの定義に違反しているかどうか確認します。
存在しない属性に値を追加しようとしたため、ユーザー作成操作は失敗しました。表示されるエラー・メッセージ: 属性が存在しません表示されるエラー・コード: ATTRIBUTE_DOESNOT_EXIST	`AttrName.Prov.Map.iPlanet`参照定義で、デコード値がターゲット・システムにおいて有効な属性名かどうか確認します。
無効な値を追加しようとしたため、ユーザー作成操作は失敗しました。表示されるエラー・メッセージ: 属性に指定した値が無効です表示されるエラー・コード: INVALID_ATTR_VALUE_ERROR	ユーザー作成中に指定した値を確認します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーの属性値を変更できません。表示されるエラー・メッセージ: 属性値または状態が無効です表示されるエラー・コード: INVALID_ATTR_MODIFY_ERROR	指定したユーザーIDを確認します。
存在しない属性に値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 属性が存在しません表示されるエラー・コード: ATTRIBUTE_DOESNOT_EXIST	対応するプロセス・タスクから、コネクタの`AttrName`に渡される値を取得します。前の手順で取得した名前を使用して、デコード値がターゲットで有効な属性名かどうか、`AttrName.Prov.Map.iPlanet`参照定義で確認します。
無効な値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 属性に指定した値が無効です表示されるエラー・コード: INVALID_ATTRIBUTE_VALUE_ERROR	指定した値を確認してください。
`AttrName.Recon.Map.iPlanet`参照定義に存在しない属性に値を追加しようとしたため、ユーザー変更操作は失敗しました。表示されるエラー・メッセージ: 1つ以上の属性マッピングがありません表示されるエラー・コード: ATTR_MAPPING_NOT_FOUND	対応するプロセス・タスクから、コネクタの`AttrName`に渡される値を取得します。前の手順で取得した名前を使用して、`AttrName.Recon.Map.iPlanet`参照定義にエントリが作成されているかどうかを確認します。
重複する値を属性に追加しようとしたため、操作は失敗しました。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	指定した値を確認してください。
Oracle Identity Managerはユーザーをコンテナから別のコンテナに移動できません。表示されるエラー・メッセージ: 異なるコンテナにユーザーを移動できませんでした表示されるエラー・コード: USER_MOVE_FAILED	一般的なエラー。詳細はログを調べてください。
Oracle Identity Managerはセキュリティ・グループにユーザーを追加できません。表示されるエラー・メッセージ: グループが存在しません表示されるエラー・コード: GROUP_DOES_NOT_EXIST	指定したユーザー・セキュリティ・グループがSun Java System Directoryに存在しません。グループ名を確認してください。
Oracle Identity Managerはユーザーをグループに追加できません。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	ユーザーはすでにグループのメンバーです。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: ロールが存在しません表示されるエラー・コード: ROLE_DOESNOT_EXIST	Oracle Identity Managerでユーザーに指定したロールがSun Java System Directoryに存在しません。Sun Java System Directoryにロールを作成します。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: ユーザーを更新できませんでした表示されるエラー・コード: USER_UPDATE_FAILED	一般的なエラー。詳細はログを調べてください。
Oracle Identity Managerはロールをユーザーに追加できません。表示されるエラー・メッセージ: 重複値表示されるエラー・コード: DUPLICATE_VALUE_ERROR	ユーザーはすでにこのロールを割り当てられています。
Oracle Identity Managerはユーザーに割り当てられたロールを削除できません。表示されるエラー・メッセージ: ユーザーからロールを削除できませんでした表示されるエラー・コード: USER_REMOVE_ROLE_FAILED	一般的なエラー。詳細はログを調べてください。