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 for testing reconciliation:

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

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

   Section	Information
   SAP HRMS Server Parameters	Parameters required to connect to SAP Employee Reconciliation Refer to the "Defining IT Resources" section for information about the values that you must provide.
   Reconciliation 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\ext\log4j-1.2.8.jar
   OIM_home\Xellerate\JavaTasks\xliSAPHR.jar
   OIM_home\xellerate\lib\xlLogger.jar
   OIM_home\xellerate\lib\xlUtils.jar
   OIM_home\Xellerate\JavaTasks\sapjco.jar
   
   

3. In the log.properties file in the same directory:

   1. Set the path of the directory in which you want to create the log files as the value of the following parameter:

      log4j.appender.logfile.File=log_file_path
      
      

      Here, log_file_path is the path of the directory in which you want to create the log file.

   2. Specify any one of the following log levels:

      - DEBUG

      - INFO

      - WARN

      - ERROR

      - FATAL

      For example, if the log level for DEBUG is to be enabled, then you must add the following entry file:

      log4j.rootLogger=DEBUG,stdout,logfile
      
      

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:

      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.

5. Enter the following command to test reconciliation:

   java -DTproperties=OIM_home\xellerate\XLIntegrations\saphrms\troubleshoot\troubleshoot.properties -Dlog4j.configuration=file:\OIM_home\xellerate\XLIntegrations\saphrms\troubleshoot\log.properties com.thortech.xl.troubleshooting.src.troubleShootingUtility R
   
   

Troubleshooting

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

• Connection Errors

• Common SNC Errors

Connection Errors

The following table provides solutions to common connection errors.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to SAP Employee Reconciliation. Returned Error Message: SAP Connection exception Returned Error Code: INVALID_CONNECTION_ERROR	Ensure that SAP Employee Reconciliation 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.
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 Descriptions	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