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:

1. Specify the required values in the global.properties file.

   This file is in the OIM_home\xellerate\Siebel\Troubleshoot directory. The following table describes the sections of this file in which you must provide information for running the tests.

   Section	Information
   Siebel Server Parameters	Parameters required to connect to Siebel Enterprise Applications Refer to the "Defining IT Resources" section for information about the values that you must provide.
   Create User Parameters	Values required to create a user
   Modify User Parameters	Values required to modify a user
   Delete User Parameters	User ID of the user to be deleted
   Recon Parameters	Date from which modified data is to be reconciled The To Date value is taken as the current date and time.

   
   

2. Add the following to the CLASSPATH environment variable:

   OIM_home\xellerate\lib\xlUtils.jar
   OIM_home\xellerate\JavaTasks\xlSiebel.jar
   OIM_home\xellerate\lib\xlLogger.jar 
   OIM_home\xellerate\ext\log4j-1.2.8.jar
   
   

   For Siebel 7.5, the following files from the OIM_home\xellerate\JavaTasks directory

   SiebelJI_enu.jar
   SiebelJI_Common.jar
   SiebelJI.jar
   
   

   For Siebel 7.8, the following files from the OIM_home\xellerate\JavaTasks directory

   Siebel.jar
   SiebelJI_enu.jar
   
   

3. Create an ASCII-format copy of the global.properties file as follows:

   Note:

   You must perform this procedure every time you make a change in the contents of the global.properties file.

   1. In a command window, change to the following directory:

      OIM_home\Xellerate\sapcua\troubleshoot
      
      

   2. Enter the following command:

      native2ascii global.properties troubleshoot.properties
      
      

      The troubleshoot.properties is created when you run the native2ascii command. The contents of this file are an ASCII-format copy of the contents of the global.properties file.

4. Perform the following tests:

   • Enter the following command to create a user:

     java -DTproperties=OIM_home\xellerate\Siebel\Troubleshoot\troubleshoot.properties-Dlog4j.configuration=file:\OIM_home\xellerate\Siebel\Troubleshoot\log.properties TroubleShootingUtility C
     
     

   • Enter the following command to modify a user:

     java -DTproperties=OIM_home\xellerate\Siebel\Troubleshoot\troubleshoot.properties-Dlog4j.configuration=file:\OIM_home\xellerate\Siebel\Troubleshoot\log.properties TroubleShootingUtility M
     
     

   • Enter the following command to delete a user:

     java -DTproperties=OIM_home\xellerate\Siebel\Troubleshoot\troubleshoot.properties-Dlog4j.configuration=file:\OIM_home\xellerate\Siebel\Troubleshoot\log.properties TroubleShootingUtility D
     
     

   • Enter the following command to reconcile user information:

     java TroubleShootingUtilityLdap -java -DTproperties= OIM_home\xellerate\Siebel\Troubleshoot\troubleshoot.properties -Dlog4j.configuration=file:\OIM_home\xellerate\Siebel\Troubleshoot\log.properties TroubleShootingUtility R
     

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 Enterprise Applications. Returned Error Message: SIEBEL connection exception	Ensure that Siebel Enterprise Applications 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 Enterprise Applications.

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 does not exist in Siebel Enterprise Applications.

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.