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

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

• テスト・ケースの実行

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

テスト・ケースの実行

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

トラブルシューティング・ユーティリティを使用するには、次のようにします。

1. TroubleShootIPlanet.propertiesファイル内に必要な値を指定します。

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

   セクション	情報
   Sun Java System Directory Server connection parameters	ターゲット・システムへの接続に必要な接続パラメータ。 指定する必要のある値の詳細は、「ITリソースの定義」を参照してください。
   Create User Information	ユーザーの作成に必要な値。
   Modify User Information	ユーザーの変更に必要な値。
   Delete User Information	削除するユーザーのDN。

   
   

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

   OIM_home\xellerate\JavaTasks\xliIPlanet.jar
   OIM_home\xellerate\lib\xlLogger.jar
   OIM_home\xellerate\ext\log4j-1.2.8.jar
   OIM_home\xellerate\lib\xlUtils.jar
   
   

3. 同じディレクトリ内のlog.propertiesファイルで、次のようにします。

   1. ログ・ファイルの作成先のディレクトリのパスを、次のパラメータの値として設定します。

      log4j.appender.logfile.File=log_file_path
      
      

      ここで、log_file_pathは、ログ・ファイルの作成先のディレクトリのパスです。

   2. 次のいずれかのログ・レベルを指定します。

      - DEBUG

      - INFO

      - WARN

      - ERROR

      - FATAL

      たとえば、DEBUGのログ・レベルを有効にする場合は、次のエントリ・ファイルを追加する必要があります。

      log4j.rootLogger=DEBUG, stdout, logfile
      
      

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

   
   

   注意: TroubleShootIPlanet.propertiesファイルの内容を変更するたびに、この手順を実行してください。

   
   

   1. コマンド・ウィンドウで、次のディレクトリに移動します。

      OIM_home\xellerate\troubleshoot
      
      

   2. 次のコマンドを入力します。

      native2ascii TroubleShootIPlanet.properties global.properties
      
      

      native2asciiコマンドを実行すると、global.propertiesが作成されます。このファイルの内容は、TroubleShootIPlanet.propertiesファイルの内容のASCII形式のコピーです。

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

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

     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
     

トラブルシューティング

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

• 接続エラー

• ユーザー作成エラー

• ユーザー変更エラー

• ユーザー削除エラー

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

接続エラー

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

問題の詳細	解決方法
Oracle Identity ManagerはSun Java System Directoryサーバーとの接続を確立できません。 表示されるエラー・メッセージ: LDAP接続例外 表示されるエラー・コード: INVALID_CONNECTION_ERROR	Sun Java System Directoryが稼働していることを確認します。 Oracle Identity Managerが稼働している（つまりデータベースが稼働している）ことを確認します。 すべてのアダプタがコンパイルされていることを確認します。 （「ITリソース」フォームから）Oracle Identity Managerレコードを調べます。指定したIPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。
ターゲットがありません。 表示されるエラー・メッセージ: 接続エラー - 初期LDAPコンテキストを作成できません。 表示されるエラー・コード TARGET_UNAVAILABLE_ERROR	指定したSun Java System Directoryサーバーの接続値が正しいことを確認します。
認証エラー。 表示されるエラー・メッセージ 接続エラー - 初期LDAPを作成できません 表示されるエラー・コード AUTHENTICATION_ERROR	指定した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はユーザーを作成できません。 表示されるエラー・メッセージ: 接続エラー - 初期LDAPコンテキストを作成できません 表示されるエラー・コード: 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_ATTR_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_DOESNOT_EXIST	指定したユーザー・セキュリティ・グループがSun Java System Directoryに存在しません。グループ名を確認してください。
Oracle Identity Managerはユーザーをグループに追加できません。 表示されるエラー・メッセージ: ユーザーはすでにこのグループのメンバーです 表示されるエラー・コード: DUPLICATE_VALUE	ユーザーはすでにグループのメンバーです。
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	ユーザーはすでにこのロールを割り当てられています。
Oracle Identity Managerはユーザーに割り当てられたロールを削除できません。 表示されるエラー・メッセージ: 割当て済ロールの削除に失敗しました 表示されるエラー・コード: USER_DELETE_ROLE_FAILED	一般的なエラー。詳細はログを調べてください。

ユーザー削除エラー

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

問題の詳細	解決方法
Oracle Identity Managerはユーザーを削除できません。 表示されるエラー・メッセージ: User does not exist in target 表示されるエラー・コード: USER_DOESNOT_EXIST	指定したユーザーが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を再起動します。