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:

• Section 5.1, "Running Test Cases"

• Section 5.2, "Troubleshooting"

5.1 Running Test Cases

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 contents of the Troubleshoot directory on the installation media, to the one of the following directories:

   • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

     OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot

   • For Oracle Identity Manager release 11.1.1:

     OIM_HOME/server/ConnectorDefaultDirectory/Siebel/Troubleshoot

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

   This file is present in the following directory:

   • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

     OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot

   • For Oracle Identity Manager release 11.1.1:

     OIM_HOME/server/ConnectorDefaultDirectory/Siebel/Troubleshoot

   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 the target system These parameters are the same as the parameters of the IT resource.
   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.

   
   

3. Depending on the Oracle Identity Manager version you are using, add one of the following to the CLASSPATH environment variable:

   • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or 9.1.0.x:

     OIM_HOME/xellerate/lib/xlUtils.jar

     OIM_HOME/xellerate/JavaTasks/xlSiebel.jar

     OIM_HOME/xellerate/ScheduleTask/SiebelRecon.jar

     OIM_HOME/xellerate/lib/xlLogger.jar

     OIM_HOME/xellerate/ext/log4j-1.2.8.jar

     In addition to the preceding list, add the following files:

     • For Siebel 7.5:

       The following files from the OIM_HOME/xellerate/ThirdParty directory:

       SiebelJI_enu.jar

       SiebelJI_Common.jar

       SiebelJI.jar

     • For Siebel 7.8:

       The following files from the OIM_HOME/xellerate/ThirdParty directory:

       Siebel.jar

       SiebelJI_enu.jar

   • For Oracle Identity Manager release 11.1.1:

     OIM_HOME/server/lib/xlUtils.jar

     OIM_HOME/server/JavaTasks/xlSiebel.jar

     OIM_HOME/server/ScheduleTask/SiebelRecon.jar

     OIM_HOME/server/lib/xlLogger.jar

     OIM_HOME/server/ext/log4j-1.2.8.jar

     In addition to the preceding list, add the following files:

     • For Siebel 7.5:

       The following files from the OIM_HOME/server/ThirdParty directory:

       SiebelJI_enu.jar

       SiebelJI_Common.jar

       SiebelJI.jar

     • For Siebel 7.8:

       The following files from the OIM_HOME/server/ThirdParty directory:

       Siebel.jar

       SiebelJI_enu.jar

4. 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:

      • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or 9.1.0.x:

        OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot

      • For Oracle Identity Manager release 11.1.1:

        OIM_HOME/server/ConnectorDefaultDirectory/Siebel/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.

5. Perform the following tests:

   • Enter the following command to create a user:

     • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility C
       

     • For Oracle Identity Manager release 11.1.1:

       java -DTproperties=OIM_HOME/server/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/server/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility C
       

   • Enter the following command to modify a user:

     • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility M
       

     • For Oracle Identity Manager release 11.1.1:

       java -DTproperties=OIM_HOME/server/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/server/Troubleshoot/log.properties TroubleShootingUtility M
       

   • Enter the following command to delete a user:

     • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility D
       

     • For Oracle Identity Manager release 11.1.1:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility D
       

   • Enter the following command to reconcile user information:

     • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility R
       

     • For Oracle Identity Manager release 11.1.1:

       java -DTproperties=OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/troubleshoot.properties -Dlog4j.configuration=file:/OIM_HOME/xellerate/ConnectorDefaultDirectory/Siebel/Troubleshoot/log.properties TroubleShootingUtility R
       

Testing Partial Reconciliation

To test query-based reconciliation, you can specify the following types of query conditions as values for the CustomizedReconQuery parameter:

• Simple query with user attributes, for example:

  • Value assigned to the CustomizedReconQuery parameter: First Name=John

    Users with first name John are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: Login Name=JOHN

    Users with login name JOHN are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: First Name=John|First Name=Jane

    Users with first name John and Jane are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: First Name=John&Last Name=Doe

    Users with the first name John and last name Doe are reconciled.

• Query based on positions and responsibilities, for example:

  • Value assigned to the CustomizedReconQuery parameter: Position=Proxy Employee|Position=ERM AnonUser

    All users having positions as Proxy Employee or ERM AnonUser are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: Responsibility=CEO&Responsibility=Consultant

    All users having responsibilities as CEO and Consultant are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: Responsibility=CEO& Position=ERM AnonUser

    All users having responsibility CEO and position as ERM AnonUser are reconciled.

• Complex queries, for example:

  • Value assigned to the CustomizedReconQuery parameter: First Name=John&Position=Proxy Employee|Position=ERM AnonUser

    All users having first name as John and position as Proxy Employee, as well as all users with position as ERM AnonUser are reconciled.

  • Value assigned to the CustomizedReconQuery parameter: Last Name=Doe|Position=Proxy Employee&Responsibility=CEO

    All users having last name as Doe plus all users having both Position as Proxy Employee and Responsibility as CEO are reconciled.

Note:

For queries with a combination of & and |, the name value pairs adjacent to the & operator are taken as if they are in parenthesis by Siebel.

Testing Reconciliation Based on User Type

You can test reconciliation based on the type of user by specifying the following values for the UserType scheduled task attribute:

Note:

To run a target system reconciliation of a user of type User, customize the Siebel process form and make the Position field optional.

• Employee

  All information about users belonging to the Employee type is reconciled.

• Partner User

  All information about users belonging to the Partner User type is reconciled.

• Customer

  All information about users belonging to the Customer type is reconciled. These users belonging to the Customer type have NONE as the value for the Position field.

5.2 Troubleshooting

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

• Section 5.2.1, "Connection Errors"

• Section 5.2.2, "Create User Errors"

• Section 5.2.3, "Delete User Errors"

• Section 5.2.4, "Edit User Errors"

5.2.1 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 the target system. Returned Error Message: SIEBEL connection exception	Ensure that the target system 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.

5.2.2 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.USER_ALREADY_EXIST	A user with the assigned ID already exists in the target system.

5.2.3 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.USER_DOES_NOT_EXIST	The specified user does not exist in the target system.

5.2.4 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.USER_DOES_NOT_EXIST	Review the log for more details.