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

• Running Test Cases

• Troubleshooting

Running Test Cases

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, in a command window, change to the OIM_home\xellerate\JavaTasks directory, in which the xlLotusNotesProvision.jar file is present. Then, perform the following tests:

• Create an IBM Lotus Notes and Domino user as follows:

  java -jar xlLotusNotesProvision.jar Create host portNo admin  adminpassword \
  certpath regsrv  maildbpath reglog lastName  idpath  mailserver  firstName \
  password certpws mailtemplatename;
  
  

  For example:

  java -jar xlLotusNotesProvision.jar Create 172.21.106.106  63148 "John \
  Doe/TEST" password C:\\Test\\cert.id SGM mail\\ log.nsf lname C:\\Test\\ \
  CN=SGM/O=TEST fname password password mail6.ntf;
  
  

• Update information, such as the first name and last name, of an IBM Lotus Notes and Domino user as follows:

  java -jar xlLotusNotesProvision.jar UpdateUserInfo host portNo \
  admin adminpassword mailserver firstName lastName middleName orgUnit \
  attrName attrValue;
  
  

• Update information, such as the location and forward domain, of an IBM Lotus Notes and Domino user as follows:

  java -jar xlLotusNotesProvision.jar UpdateUserName host portNo admin \
  adminpassword mailServer certPath certPassword firstName lastName \
  middleName orgUnit attrName attrValue;
  
  

• Delete an IBM Lotus Notes and Domino user as follows:

  java -jar xlLotusNotesProvision.jar Delete host \
  portNo admin adminpassword mailserver firstName lastName middleName orgUnit \
  regserver;
  
  

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.