3 Testing and Troubleshooting

After you deploy the connector, you must test it to ensure that it functions as expected. This chapter discusses the following topics related to connector testing:

Running Test Cases
Troubleshooting

Running Test Cases

You can use the troubleshooting utility to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.

To use the troubleshooting utility:

Specify the required values in the config.properties file.

This file is in the OIM_home\xellerate\Troubleshoot directory. The following table describes the sections of this file in which you must provide information for running the tests.

Section	Information
Oracle Internet Directory Connection Parameters	Connection parameters required to connect to the target system Refer to the "Defining IT Resources" section for information about the values that you must provide.
Create User Information	Values required to create a user
Modify User Information	Values required to modify a user
Delete User Information	DN of the user to be deleted

Add the following to the CLASSPATH environment variable:

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

Perform the following tests:

Note:
When you run a BAT file to perform the corresponding test, the global.properties file is automatically created in the same directory. You can view log details in the Troubleshoot.log file, which is created in the same directory when you run the tests.
- Create a user by running the testcreate.bat file.
  
  After you run the BAT file, check if the user is created in Oracle Internet Directory with the details given in the config.properties file. If you run the BAT file from a command window, then the User_Creation_Successful message is displayed.
- Modify the user by running the testmodify.bat file.
  
  After you run the BAT file, check if the user is modified in Oracle Internet Directory with the details given in the config.properties file. If you run the BAT file from a command window, the User_Modification_Successful message is displayed.
- Delete the user by running the testdelete.bat file.
  
  After you run the BAT file, check if the specified user is deleted from Oracle Internet Directory. If you run the BAT file from a command window, the User_Deletion_Successful message is displayed.

Troubleshooting

This section provides instructions for identifying and resolving some commonly encountered errors of the following types:

Connection Errors
Create User Errors
Delete User Errors
Modify User Errors
Child Data Errors

Connection Errors

The following table provides solutions to some commonly encountered connection errors.

Problem Description Solution

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with Oracle Internet Directory. Returned Error Message: LDAP Connection exception Returned Error Code: `INVALID_CONNECTION_ERROR`	Ensure that Oracle Internet Directory is running. Ensure that Oracle Identity Manager is running. Ensure that all the adapters have been compiled. Use the IT Resources form to examine the Oracle Identity Manager record. Ensure that the IP address, admin ID, and admin password are correct.
Target not available Returned Error Message: Target server not available Returned Error Code: `TARGET_UNAVAILABLE_ERROR`	Ensure that Oracle Internet Directory is running. Ensure that the specified Oracle Internet Directory connection values are correct.
Authentication error Returned Error Message: Authentication error Returned Error Code: `AUTHENTICATION_ERROR`	Ensure that the specified Oracle Internet Directory connection password is correct.

Oracle Identity Manager cannot establish a connection with Oracle Internet Directory.

Returned Error Message:

LDAP Connection exception

Returned Error Code:

INVALID_CONNECTION_ERROR

Ensure that Oracle Internet Directory is running.
Ensure that Oracle Identity Manager is running.
Ensure that all the adapters have been compiled.
Use the IT Resources form to examine the Oracle Identity Manager record. Ensure that the IP address, admin ID, and admin password are correct.

Target not available

Returned Error Message:

Target server not available

Returned Error Code:

TARGET_UNAVAILABLE_ERROR

Ensure that Oracle Internet Directory is running.
Ensure that the specified Oracle Internet Directory connection values are correct.

Authentication error

Returned Error Message:

Authentication error

Returned Error Code:

AUTHENTICATION_ERROR

Ensure that the specified Oracle Internet Directory connection password is correct.

Create User Errors

The following table provides solutions to some commonly encountered Create User errors.

Problem Description	Solution
The Create User operation failed because an invalid value was being added. Returned Error Message: Invalid value specified for an attribute Returned Error Code: `INVALID_ATTR_VALUE_ERROR`	Check the values specified during user creation.
Oracle Identity Manager cannot create a user. Returned Error Message: Required information missing Returned Error Code: `INSUFFICIENT_INFORMATION_PROVIDED`	Ensure that the following information is provided: User ID User password User container User first name User last name
Oracle Identity Manager cannot create a user. Returned Error Message: User already exists Returned Error Code: `USER_ALREADY_EXISTS`	A user with the specified ID already exists in Oracle Internet Directory. Assign a new ID to the user, and try again.
Oracle Identity Manager cannot create a user. Returned Error Message: Naming exception Returned Error Code: `INVALID_NAMING_ERROR`	Check if the specified user container value already exists in Oracle Internet Directory.
Oracle Identity Manager cannot create a user. Returned Error Message: User creation failed Returned Error Code: `USER_CREATION_FAILED`	The user cannot be created because one or more attribute values violate the schema definition. Check if the Oracle Internet Directory schema is correctly defined and contains all the object classes defined in the lookup definition.

Delete User Errors

The following table provides solutions to some commonly encountered Delete User errors.

Problem Description Solution

Problem Description	Solution
Oracle Identity Manager cannot delete a user. Returned Error Message: Required information missing Returned Error Code: `INSUFFICIENT_INFORMATION_PROVIDED`	Ensure that the following information is provided: User Container User ID
Oracle Identity Manager cannot delete a user. Returned Error Message: User does not exist on the target system. Returned Error Code: `USER_DOESNOT_EXIST`	The specified user ID does not exist in Oracle Internet Directory.

Oracle Identity Manager cannot delete a user.

Returned Error Message:

Required information missing

Returned Error Code:

INSUFFICIENT_INFORMATION_PROVIDED

Ensure that the following information is provided:

User Container
User ID

Oracle Identity Manager cannot delete a user.

Returned Error Message:

User does not exist on the target system.

Returned Error Code:

USER_DOESNOT_EXIST

The specified user ID does not exist in Oracle Internet Directory.

Modify User Errors

The following table provides solutions to some commonly encountered Modify User errors.

Problem Description	Solution
The Modify User operation failed because a value was being added to a nonexistent attribute. Returned Error Message: Attribute does not exist Returned Error Code: `ATTRIBUTE_DOESNOT_EXIST`	From the corresponding process task, get the value passed for `AttrName` of the connector. Using the name obtained in the previous step, check in the `AttrName.Recon.Map.OID` lookup definition if the decode value is a valid attribute name in the target.
Oracle Identity Manager cannot modify an attribute of a user. Returned Error Message: Invalid attribute value or state Returned Error Code: `INVALID_ATTR_MODIFY_ERROR`	The attribute ID and value specified may be wrong. Check the specified values.
The Modify User operation failed because a value was being added to an attribute that does not exist in the `AttrName.Prov.Map.OID` lookup definition. Returned Error Message: One or more attribute mappings are missing Returned Error Code: `ATTR_MAPPING_NOT_FOUND`	From the corresponding process task, get the value passed for `AttrName` of the connector. Using the name obtained in the previous step, check if an entry has been made in the `AttrName.Prov.Map.OID` lookup definition.
Oracle Identity Manager cannot update information about a user. Returned Error Message: Error while updating user info Returned Error Code: `USER_UPDATE_FAILED`	Generic error. Review the log for more details.
Oracle Identity Manager cannot move a user from one container to another. Returned Error Message: Moving user to different container failed Returned Error Code: `USER_MOVE_FAILED`	Generic error. Review the log for more details.

Child Data Errors

The following table provides solutions to some commonly encountered Child Data errors.

Problem Description	Solution
Oracle Identity Manager cannot add a user to a group. Returned Error Message: Group does not exist Returned Error Code: `GROUP_DOESNOT_EXIST`	The specified user security group does not exist in Oracle Internet Directory. Check the group name.
Oracle Identity Manager cannot add a role to a user. Returned Error Message: Role does not exist Returned Error Code: `ROLE_DOESNOT_EXIST`	The specified role for the user does not exist in Oracle Internet Directory. Check the role name.
The operation failed because a duplicate value was being added to an attribute. Returned Error Message: Duplicate value Returned Error Code: `DUPLICATE_VALUE_ERROR`	The user has already been added to the specified group or role.
Oracle Identity Manager cannot add a user to a group. Returned Error Message: Add user to group failed Returned Error Code: `ADD_USER_TO_GROUP_FAILED`	Generic error. Review the log for more details.
Oracle Identity Manager cannot remove a user from a group. Returned Error Message: Remove user from group failed Returned Error Code: `REMOVE_USER_FROM_GROUP_FAILED`	Generic error. Review the log for more details.
Oracle Identity Manager cannot add a user to a role. Returned Error Message: Add user to role failed Returned Error Code: `ADD_USER_TO_ROLE_FAILED`	Generic error. Review the log for more details.
Oracle Identity Manager cannot remove a user from a role. Returned Error Message: Removing assigned role failed Returned Error Code: `USER_REMOVE_FROM_ROLE_FAILED`	Generic error. Review the log for more details.