4 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:

Testing the Connector
Troubleshooting

Testing the Connector

You can use the testing 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 testing utility:

Specify values for the parameters in the config.properties file. This file is in the OIM_home/xellerate/LotusNotes/test/config directory.

See Also:
The "Defining IT Resources" section for information about the parameters in the config.properties file

Run one of the following files:

For UNIX:

OIM_home/xellerate/XLIntegrations/LotusNotes/scripts/lotusNotes.sh

For Microsoft Windows

OIM_home\xellerate\XLIntegrations\LotusNotes\scripts\lotusNotes.bat

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the IBM Lotus Notes and Domino connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with the IBM Lotus Notes and Domino server.	Ensure that the IBM Lotus Notes and Domino server 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.
An Operation Failed message is displayed on the Oracle Identity Manager Administrative and User Console	Ensure that the attribute values do not contain delimiter characters (white space). Ensure that the attribute values do not exceed the specified length.

The following table describes solutions to errors related to the IT resource parameter values.

Error Message	Solution
The prompt for the password was aborted by user	The certifier account password specified as the value of the `CertPwd` IT resource parameter is not correct. Specify the correct password, and then try again.
Destination path does not exist	The directory path specified as the value of the `IDFilePath` IT resource parameter is not correct. Specify the correct path, and then try again.
Restricted operations not allowed in the server	The administrator whose user ID you have provided in the `Admin` IT resource parameter must belong to the Full Access Administrator list. Ensure that the administrator belongs to this list, and then try again.
Could not open the ID file	The path of the certifier ID file that you have specified as the value of the `CertPath` IT resource parameter is not correct. Specify the correct path, and then try again.
You are not authorized to perform that operation	The administrator whose user ID you have provided in the `Admin` IT resource parameter does not have the access privileges described in the "Enabling Modification of ID Files" section. Ensure that the administrator is assigned the required privileges, and then try again.