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

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

  1. Copy the files in the test/config directory on the installation media to the following directory:

    • For Oracle Identity Manager release 9.1.0.x:

      OIM_HOME/xellerate/XLIntegrations/LotusNotes/config

    • For Oracle Identity Manager release 11.1.1:

      OIM_HOME/server/XLIntegrations/LotusNotes/config

  2. Copy the files in the test/scripts directory on the installation media to the following directory:

    • For Oracle Identity Manager release 9.1.0.x:

      OIM_HOME/xellerate/XLIntegrations/LotusNotes/scripts

    • For Oracle Identity Manager release 11.1.1:

      OIM_HOME/server/XLIntegrations/LotusNotes/scripts

  3. Specify values for the parameters in the config.properties file. This file is in the config directory.

    See Also:

    Section 2.2.2, "Configuring the IT Resource" for information about the parameters in the config.properties file

  4. Run one of the following scripts from the scripts directory:

    • For UNIX, run lotusNotes.sh.

    • For Microsoft Windows, run lotusNotes.bat.

5.2 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 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.

File does not exist (<username>)

The name of the mail template file specified as the value of the MailTemplateName IT resource parameter is not correct. Ensure that the mail template file exists on the target Domino server. This file is typically found in the data directory of the Domino server. Specify the correct mail template file name and then try again.

For example, the name of the mail template file for IBM Lotus Notes and Domino Server version 6.x is mail6.ntf.

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.

Suppose the following error message is displayed while provisioning in secure mode:

NotesException: Could not get IOR from Domino Server.

Try using 63148 as the port number for the secure connection.