3 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected. Tests that you can run on the connector can be divided into the following high-level categories:

• Reconciliation Testing: In this type of test, you reconcile Oracle Identity Manager with either a trusted source or a target resource. In other words, the trusted source or target resource is the starting point of the connector, and Oracle Identity Manager is the end point.

• Linking Testing: For this test, Oracle Identity Manager links an SAP HRMS employee and SAP User by updating the target resource. In other words, Oracle Identity Manager is the starting point of the connector, and the target resource is the end point.

Note:

In earlier releases of this guide, the connector was referred to as the integration.

This chapter contains the following sections:

• Running Test Cases

• Troubleshooting

Running Test Cases

You can use the troubleshooting utility to connect to the SAP server and to perform basic operations aimed at identifying the cause of problems. You can also use it to run test cases to test the connector functionality.

The SAP Employee Reconciliation_versionno\troubleshoot directory contains the troubleShoot.properties file. The troubleshooting utility uses this file to connect to the SAP system. This file contains the following information:

• SAP connection parameters: SAP server-related information.

• User information: User parameters specified to create, modify, delete, and update user information for provisioning.

• Reconciliation information: The From date timestamp information is passed from this file. The To date is set to the current time.

This file also contains commands to test user reconciliation and provisioning. You need to place these files in a test folder to run the test case indicated here.

To test the connector, specify the following information in the troubleshooting.properties file:

sapClient=800
sapUser=xellerate
sapPassword=project
sapLanguage=EN
sapSystem=00
sapIP=172.20.70.204
sapType=R3
FirstTimeReconRecords=10000
snc_mode=0
snc_myname=p:CN=win2003, OU=SAP, O=ORA, C=IN
snc_qop=3
snc_partnername=p:CN=I47, OU=SAP, O=ORA, C=IN 
snc_lib=C:\\usr\\sap\\sapcrypto.dll

In the log.properties file in the same directory, set the path for the log files in the following parameter:

log4j.appender.logfile.File=log_file_path

Note:

Ensure that all the JAR files associated with this connector are included in the CLASSPATH.

Testing Reconciliation

Run the following command to test reconciliation:

java -DTproperties=TEST_FOLDER_PATH\troubleshooting\troubleShoot.properties -Dlog4j.configuration=file:/TEST_FOLDER_PATH/troubleshooting/log.properties com.thortech.xl.troubleshooting.src.troubleShootingUtility R

Troubleshooting

The following table lists some commonly encountered issues associated with this resource adapter. For each issue, a suggested resolution is provided.

Connection Errors

The following table provides solutions to common connection errors.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to SAP HRMS. Returned Error Message: SAP Connection exception Returned Error Code: INVALID_CONNECTION_ERROR	Ensure that the SAP HRMS server is up and running. Verify that Oracle Identity Manager is running (that is, the database is running). Verify that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form). Verify that the IP address, admin ID, and admin password are correct.
Authentication error Returned Error Message: Authentication error Returned Error Code: AUTHENTICATION_ERROR	Verify that the given 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 the SNC. Returned Error Message: SAP Connection JCO Exception Returned Error Code: SNC required for this connection	Ensure that all the required information is given. The required information includes the following: 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