8 Testing and Troubleshooting the UNIX Connector
After you create the application, you must test the connector to ensure that it functions as expected.
This chapter provides details on the following topics related to connector testing:
8.1 Testing the UNIX Connector
You can use the testing utility, supplied with the connector package, to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.
The test-utility directory of connector installation media contains the following files:
-
The example-config.groovy file is a sample configuration that can be used to set the connection properties of the target system and the connector.
-
The README file contains instructions to configure and run the testing utility.
-
The test-utility.jar file contains the class files used by the testing utility.
Note:
The testing utility does not support separate update and delete actions. You can update and delete a user while creating the user in the same operation.
To use the testing utility, perform the following steps:
8.2 Troubleshooting the UNIX Connector
You can troubleshoot the UNIX connector depending on the type of error you encounter.
The following sections list solutions to some commonly encountered errors of the following types:
8.2.1 Connection Errors
This table lists the solution to a commonly encountered Connection error.
Problem Description | Solution |
---|---|
Oracle Identity Governance cannot establish a connection to the target system. Returned Error Message: UNIX connection exception |
|
8.2.2 Create User Errors
This table lists the solution to a commonly encountered Create User error.
Problem Description | Solution |
---|---|
Oracle Identity Governance cannot create a user. Returned Error Message: User already exists |
A user with the assigned ID already exists in the target system. |
8.2.3 Delete User Errors
This table lists the solution to a commonly encountered Delete User error.
Problem Description | Solution |
---|---|
Oracle Identity Governance cannot delete a user. Returned Error Message: User does not exist in target system |
The specified user does not exist in the target system. |
8.2.4 Edit User Errors
This table lists the solution to a commonly encountered Edit User error.
Problem Description | Solution |
---|---|
Oracle Identity Governance cannot update a user. Returned Error Message: User does not exist in target system |
Review the log for more details. |
8.2.5 TimeOut Errors
This table lists the solution to a commonly encountered TimeOut error.
Problem Description | Solution |
---|---|
Connection timeout during connector operations, typically during reconciliation operations. Returned Error Message: Command timed out |
Increase the value of the Command Timeout entry. See Advanced Settings Parameters for more information. |
Reconciliation fails with an error. Returned Error Message: org.identityconnectors.genericunix.common.GenericUnixUtil :getMatchedResponseInfo : Buffer:-> > > > >Password: |
Change the value of the Sudo Passwd Expect Expression entry from Password: to Note: The letter "P" must be in lowercase. See Advanced Settings Parameters for more information. |