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\sapcua\Troubleshoot directory. The following table describes the sections of this file in which you must provide information for running the tests.

   Section	Information
   SAP CUA connection parameters	Connection parameters required to connect to the target system Refer to the "Defining IT Resources" section for information about the values that you must provide.
   User information	Field information required to create, modify, and delete a user profile
   Reconciliation information	The From Date time stamp The To Date is set to the current date and time by default.

   
   

2. Add the following to the CLASSPATH environment variable:

   OIM_home\xellerate\ext\log4j-1.2.8.jar
   OIM_home\Xellerate\JavaTasks\xliSAPCUA.jar
   OIM_home\xellerate\lib\xlUtils.jar
   OIM_home\Xellerate\JavaTasks\sapjco.jar
   OIM_home\xellerate\lib\xlLogger.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\sapcua\Troubleshoot\troubleshoot.properties -Dlog4j.configuration=file:\OIM_home\Xellerate\sapcua\Troubleshoot\log.properties TroubleShootingUtility C
     
     

   • Enter the following command to modify a user:

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

   • Enter the following command to delete a user:

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

   • Enter the following command to test reconciliation:

     java -DTproperties=OIM_home\Xellerate\sapcua\Troubleshoot\troubleShoot.properties -Dlog4j.configuration=file:\OIM_home\Xellerate\sapcua\Troubleshoot\log.properties TroubleShootingUtility R
     
     

Troubleshooting

The following sections provide solutions to some commonly encountered problems associated with the connector:

• Connection Errors

• Common SNC Errors

• Create User Errors

• Delete User Errors

• Modify User Errors

• Child Data Errors

Connection Errors

The following table provides solutions to common connection errors.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to SAP CUA. Returned Error Message: SAP connection exception Returned Error Code: INVALID_CONNECTION_ERROR	Ensure that SAP CUA is running. Ensure that Oracle Identity Manager is running (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 the IP address, admin ID, and admin password are correct.
Target not available Returned Error Message: Target Server not available Returned Error Code: TARGET_UNAVAILABLE_ERROR	Ensure that SAP CUA is running Ensure that the specified SAP connection values are correct.
Authentication error Returned Error Message: Authentication error Returned Error Code: AUTHENTICATION_ERROR	Ensure that the specified SAP connection user ID and password are correct.

Common SNC Errors

The following table provides a solution to an SNC error.

Problem Description	Solution
Trying to connect to SAP through SNC. Returned Error Message: SAP Connection JCO Exception Returned Error Code: SNC required for this connection	Ensure that values for the following IT resource parameters are correctly specified as shown in the following example: SAPsnc_mode: 1 SAPsnc_myname: p:CN=win2003, OU=SAP, O=ORA, C=IN SAPsnc_qop: 3 SAPsnc_partnername: p:CN=I47, OU=SAP, O=ORA, C=IN SAPsnc_lib: C:\\usr\\sap\\sapcrypto.dll

Create User Errors

The following table provides solutions to common Create User errors.

Problem Description	Solution
Oracle Identity Manager cannot create a user. Returned Error Message: Require information missing Returned Error Code: INSUFFICIENT_INFORMATION_PROVIDED	Ensure that the following information is specified: User ID User first name User last name User password User group Profile option Role or profile
Oracle Identity Manager cannot create a user. Returned Error Message: User already exists Returned Error Code: USER_ALREADY_EXIST	User with the assigned ID already exists in SAP. Assign a new ID to this user, and try again.
Oracle Identity Manager cannot create a user. Returned Error Message: User creation failed Returned Error Code: USER_CREATION_FAILED	User may not have been created because of one of the following errors: The Change Password operation failed. Role/profile assignment failed.

Delete User Errors

The following table provides solutions to common Delete User errors.

Problem Description	Solution
Oracle Identity Manager cannot delete a user. Returned Error Message: Require information missing Returned Error Code: INSUFFICIENT_INFORMATION_PROVIDED	Ensure that the user ID has been correctly specified.
Oracle Identity Manager cannot delete a user. Returned Error Message: User does not exist in target Returned Error Code: USER_DOESNOT_EXIST	The specified user does not exist in SAP CUA.

Modify User Errors

The following table provides solutions to common Modify User errors.

Problem Description	Solution
Oracle Identity Manager cannot update new information about a user. Returned Error Message: Error while updating user info Returned Error Code: USER_MODIFICATION_FAILED	Generic error. Refer to the log file for more details.
Oracle Identity Manager cannot update a user. Returned Error Message: User does not exist in target Returned Error Code: USER_DOESNOT_EXIST	The specified user does not exist in SAP CUA.

Child Data Errors

The following table provides solutions to common Child Data errors.

Problem Description	Solution
Oracle Identity Manager cannot add a user to a profile. Returned Error Message: Profile does not exist Returned Error Code: PROFILE_NOT_MEMBER_OF_TARGET_SYSTEM	The specified profile does not exist in SAP CUA. Check the profile name.
Oracle Identity Manager cannot assign a role to a user. Returned Error Message: Role does not exist Returned Error Code: ROLE_NOT_MEMBER_OF_TARGET_SYSTEM	The specified role for the user in Oracle Identity Manager does not exist in SAP CUA. Check the role name.
The operation failed because a duplicate value was being added to a profile or role. Returned Error Message: Duplicate value Returned Error Code: ROLE_ALREADY_EXISTS PROFILE_ALREADY_EXISTS	The user has already been added to the specified profile or role.