3 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected.

This chapter contains the following sections:

• Running Test Cases

• Troubleshooting

Running Test Cases

This section discusses test cases that you can perform by using the troubleshooting utility.

You can use the troubleshooting utility to directly use the connector for identifying the cause of problems associated with connecting to the target system server and performing basic operations on the target system.

Before you can use the troubleshooting utility, you must provide the required values in the config.properties file. This file is in the xellerate_home\xellerate\Troubleshoot directory. The following table describes the sections of this file.

Section Name	Information
Oracle Internet Directory Connection Parameters	Connection parameters required to connect to the target system
Create User	Values requited to create a user on the target system
Modify User	Values required to modify a user
Delete User	DN of the user to be deleted

After you specify the required values in the config.properties file, perform the following tests:

• Create a user.

  Run the testcreate.bat file. Then, check if the user is created in Oracle Internet Directory with the details given in the config.properties file. If you run this BAT file from the command window, then the User_Creation_Successful message is displayed.

• Modify the user.

  Run the testmodify.bat file. Then, check if the user is modified in Oracle Internet Directory with the details given in the config.properties file. If you run this BAT file from the command window, the User_Modification_Successful message is displayed.

• Delete the user.

  Run the testdelete.bat file. Then, check if the specified user is deleted from Oracle Internet Directory. If you run this BAT file from the 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

• Common LDAP 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
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 the Oracle Internet Directory server is running. Ensure that Oracle Identity Manager is running (that is, the database is running). Ensure that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form). 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 the specified Oracle Internet Directory connection values are correct. Ensure that the Oracle Internet Directory server is running.
Authentication error Returned Error Message: Authentication error Returned Error Code: AUTHENTICATION_ERROR	Ensure that the specified Oracle Internet Directory connection password is correct.

Common LDAP Errors

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

Problem Description	Solution
Trying to add a value to a nonexistent attribute. Therefore, the Modify User operation failed. 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.EDIR lookup definition if the decode value is a valid attribute name in the target.
Trying to add an invalid value. Therefore, the Create User operation failed. Returned Error Message: Invalid value specified for an attribute Returned Error Code: INVALID_ATTR_VALUE_ERROR	Check the values specified during user creation.

Create User Errors

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

Problem Description	Solution
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 container User first name User last name User ID User password
Oracle Identity Manager cannot create a user. Returned Error Message: User already exists Returned Error Code: USER_ALREADY_EXIST	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 on the target Oracle Internet Directory server.
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 proper 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
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
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.
Trying to add a value to an attribute that does not exist in the AttrName.Prov.Map.OID lookup definition. Therefore, the Modify User operation failed. 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.
Trying to add a duplicate value 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.