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 use the troubleshooting utility, you must set the required values in the config.properties file. This file is in the troubleshoot directory. The following table describes the sections of this file.

Section Name	Information
Novell eDirectory 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

In addition, you must set the classpath to the following JAR files:

• xellerate_home\xellerate\lib\xlLogger.jar

• xellerate_home\xellerate\lib\xlUtils.jar

• xellerate_home\xellerate\JavaTasks\eDirProv.jar

• xellerate_home\xellerate\JavaTasks\ldap.jar

• log4j.jar file in the application server installation directory

Then, perform the following tests:

Note:

While performing these tests, ensure that the location of the TroubleShootLdap.properties and log.properties files is correctly specified.

• Create a Novell eDirectory user as follows:

  java  -DpropertyFile=xellerate_home/xellerate/eDir/troubleshoot/TroubleShootLdap.properties -Dlog4j.configuration=file:/xellerate_home/xellerate/eDir/troubleshoot/log.properties TroubleShootingUtilityLdap createUser
  

• Modify a Novell eDirectory user as follows:

  java  -DpropertyFile=xellerate_home/xellerate/eDir/troubleshoot/TroubleShootLdap.properties -Dlog4j.configuration=file:/xellerate_home/xellerate/eDir/troubleshoot/log.properties TroubleShootingUtilityLdap modifyUser
  

• Delete a Novell eDirectory user as follows:

  java  -DpropertyFile=xellerate_home/xellerate/eDir/troubleshoot/TroubleShootLdap.properties -Dlog4j.configuration=file:/xellerate_home/xellerate/eDir/troubleshoot/log.properties TroubleShootingUtilityLdap deleteUser
  

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to Novell eDirectory. Returned Error Message: LDAP Connection exception Returned Error Code: INVALID_CONNECTION_ERROR	Ensure that the Novell eDirectory server is running. Ensure that Oracle Identity Manager is working (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: Connection error - unable to create Initial LDAP Returned Error Code: TARGET_UNAVAILABLE_ERROR	Ensure that the specified Novell eDirectory connection values are correct.
Returned Error Message: Connection error - unable to create Initial LDAP. Returned Error Code: AUTHENTICATION_ERROR	Ensure that the specified Novell eDirectory connection values are correct.
Oracle Identity Manager cannot create a user. Returned Error Message: Required information missing Returned Error Code: INSUFFICIENT_INFORMATION_PROVIDED	Ensure that the specified IP address, admin ID, and administrator password are correct. Ensure that the following information has been 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_EXISTS	A user with the assigned ID already exists in Novell eDirectory.
Oracle Identity Manager cannot create a user. Returned Error Message: Connection error - unable to create Initial LDAPContext Returned Error Code: INVALID_NAMING_ERROR	Ensure that the specified Novell eDirectory connection values are correct. Check if the value for an attribute violates the schema definition.
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.
The Create User function failed because a value was being added to a nonexistent attribute. Returned Error Message: Attribute does not exist Returned Error Code: ATTRIBUTE_DOESNOT_EXIST	In the AttrName.Recon.Map.EDIR lookup definition, check if the decode values are valid attribute names in the target system.
The Create User function failed because an invalid value was specified. 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 delete a user. Returned Error Message: User does not exist in target Returned Error Code: USER_DOESNOT_EXIST	The specified user ID does not exist in Novell eDirectory.
Oracle Identity Manager cannot modify the value of a user. Returned Error Message: Invalid attribute value or state Returned Error Code: INVALID_ATTR_MODIFY_ERROR	Check the attribute ID and value that were specified.
The Modify User function 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 specified 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.
The Modify User function failed because an invalid value was specified. Returned Error Message: Invalid value specified for an attribute Returned Error Code: INVALID_ATTR_VALUE_ERROR	Check the value entered.
The Modify User function failed because a value was specified for an attribute that does not exist in the AttrName.Prov.Map.EDIR 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 specified for AttrName of the connector. Using the name obtained in the previous step, check if an entry has been made in the AttrName.Recon.Map.EDIR lookup definition.
Error caused because a duplicate value was specified for an attribute. Returned Error Message: Duplicate value Returned Error Code: DUPLICATE_VALUE_ERROR	The attribute specified already exists for another user in the system.
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.
Oracle Identity Manager cannot add a user to a security group. Returned Error Message: Group does not exist Returned Error Code: SEC_GROUP_DOESNOT_EXIST	The specified user security group does not exist in Novell eDirectory.
Oracle Identity Manager cannot add a user to a security group. Returned Error Message: User is already a member of this group Returned Error Code: DUPLICATE_VALUE	The user is already a member of the specified security group.
Oracle Identity Manager cannot add the Trustee Right to a user. Returned Error Message: Trustee Right already added Returned Error Code: DUPLICATE_VALUE	Check if the Trustee Right value has already been specified for the user in Novell eDirectory.
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 in Oracle Identity Manager does not exist in Novell eDirectory. Create the role in Novell eDirectory.
Oracle Identity Manager cannot add a role to 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 add a role to a user. Returned Error Message: User has already been assigned this role Returned Error Code: DUPLICATE_VALUE	The user has already been assigned this role.
Oracle Identity Manager cannot remove an assigned role from a user. Returned Error Message: Removing Assigned role failed Returned Error Code: USER_DELETE_ASSIGNED_ROLE_FAILED	Generic error. Review the log for more details.
Oracle Identity Manager cannot add a network restriction. Returned Error Message: This Network Restriction already exists Returned Error Code: DUPLICATE_VALUE	The specified network restriction already exists for this user in Novell eDirectory.