Oracle® Identity Manager Connector Guide for Oracle Internet Directory Release 9.0.2 Part Number B32165-01 |
|
|
View PDF |
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:
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
In the log.properties
file in the same directory:
Set the path of the directory in which you want to create the log files as the value of the following parameter:
log4j.appender.logfile.File=log_file_path
Here, log_file_path
is the path of the directory in which you want to create the log file.
Specify any one of the following log levels:
- DEBUG
- INFO
- WARN
- ERROR
- FATAL
For example, if the log level for DEBUG
is to be enabled, then you must add the following entry file:
log4j.rootLogger=DEBUG, stdout, logfile
Perform the following tests:
Note: When you run a BAT file to perform the corresponding test, theglobal.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.
This section provides instructions for identifying and resolving some commonly encountered errors of the following types:
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:
|
|
Target not available
Returned Error Message: Target server not available Returned Error Code:
|
|
Authentication error
Returned Error Message: Authentication error Returned Error Code:
|
Ensure that the specified Oracle Internet Directory connection password is correct. |
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:
|
Check the values specified during user creation. |
Oracle Identity Manager cannot create a user.
Returned Error Message: Required information missing Returned Error Code:
|
Ensure that the following information is provided:
|
Oracle Identity Manager cannot create a user.
Returned Error Message: User already exists Returned Error Code:
|
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:
|
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:
|
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. |
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:
|
Ensure that the following information is provided:
|
Oracle Identity Manager cannot delete a user.
Returned Error Message: User does not exist on the target system. Returned Error Code:
|
The specified user ID does not exist in Oracle Internet Directory. |
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:
|
|
Oracle Identity Manager cannot modify an attribute of a user.
Returned Error Message: Invalid attribute value or state Returned Error Code:
|
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:
|
|
Oracle Identity Manager cannot update information about a user.
Returned Error Message: Error while updating user info Returned Error Code:
|
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:
|
Generic error. Review the log for more details. |
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Generic error. Review the log for more details. |