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.