3 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected.

This chapter contains the following sections:

• Running Test Cases

• Troubleshooting

Running Test Cases

This section discusses test cases that you can implement by using the troubleshooting utility.

You can use the troubleshooting utility to directly use the connector for identifying the cause of problems associated with connecting to the target system server and performing basic operations on the target system.

Before you use the troubleshooting utility, you must set the required values in the troubleShoot.properties file. This file is in the xellerate_home\xellerate\Siebel1.0.0\Troubleshoot directory. The following table describes the sections of this file.

Section Name	Information
Siebel Connection Parameters	Connection parameters required to connect to the target system
Create User	Values requited to create a user on the target system
Modify User	Values required to modify a user
Delete User	User ID of the user to be deleted
Reconciliation	Date from which modified data is to be reconciled The To Date value is taken as the current date and time.

Depending on the version of Siebel that you are using, set the classpath to the JAR files listed in the "Step 2: Copying the Connector Files and External Code" section.

Then, perform the following tests:

• Create a user as follows:

  java -DTproperties=xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/troubleShoot.properties-Dlog4j.configuration=file:/xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/log.properties TroubleShootingUtility C
  
  

• Modify a user as follows:

  java -DTproperties=xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/troubleShoot.properties-Dlog4j.configuration=file:/xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/log.properties TroubleShootingUtility M
  
  

• Delete a user as follows:

  java -DTproperties=xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/troubleShoot.properties-Dlog4j.configuration=file:/xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/log.properties TroubleShootingUtility D
  
  

• Reconcile data as follows:

  java TroubleShootingUtilityLdap -java -DTproperties= xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/troubleShoot.properties -Dlog4j.configuration=file:/xellerate_home/xellerate/Siebel1.0.0/Troubleshoot/log.properties TroubleShootingUtility R
  

Note:

Ensure that the location of the troubleShoot.properties and log.properties files is correctly specified.

Troubleshooting

The following sections list solutions to some commonly encountered errors of the following types:

• Connection Errors

• Create User Errors

• Delete User Errors

• Edit User Errors

Connection Errors

The following table lists the solution to a commonly encountered connection error.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to Siebel. Returned Error Message: SIEBEL Connection exception	Ensure that the Siebel server is running. Ensure that Oracle Identity Manager is working (that is, the database is running). Ensure that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form). Ensure that values for all the IT resource parameters have been correctly specified.

Create User Errors

The following table lists the solution to a commonly encountered Create User error.

Problem Description	Solution
Oracle Identity Manager cannot create a user. Returned Error Message: User already exists Returned Error Code: SIEBEL.EMPLOYEE_ALREADY_EXIST	A user with the assigned ID already exists in Siebel.

Delete User Errors

The following table lists the solution to a commonly encountered Delete User error.

Problem Description	Solution
Oracle Identity Manager cannot delete a user. Returned Error Message: User does not exist in target system Returned Error Code: SIEBEL.EMPLOYEE_DOES_NOT_EXIST	The specified user ID does not exist in Siebel.

Edit User Errors

The following table lists the solution to a commonly encountered Edit User error.

Problem Description	Solution
Oracle Identity Manager cannot update a user. Returned Error Message: User does not exist in target system Returned Error Code: SIEBEL.EMPLOYEE_DOES_NOT_EXIST	Review the log for more details.