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

   Section	Information
   SAP User Management 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 timestamp 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\SAPAdapter.jar
   OIM_home\xellerate\lib\xlLogger.jar
   OIM_home\xellerate\lib\xlUtils.jar 
   OIM_home\xellerate\JavaTasks\sapjco.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\SAP\troubleshoot\troubleshoot.properties -Dlog4j.configuration=file:\OIM_home\Xellerate\SAP\troubleshoot\log.properties TroubleShootingUtility C
     
     

   • Enter the following command to modify a user:

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

   • Delete a user as follows:

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

   • Enter the following command to test reconciliation from the timestamp specified to the current time:

     java -DTproperties=OIM_home\Xellerate\SAP\troubleshoot\troubleshoot.properties -Dlog4j.configuration=file:\OIM_home\Xellerate\SAP\troubleshoot\log.properties TroubleShootingUtility R
     
     

Troubleshooting

The following table lists solutions to a commonly encountered problem associated with this connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to SAP User Management. Returned Error Messages SAP.CONNECTION_ERROR	Ensure that SAP User Management is running. Ensure that the connection parameters for the SAP User Management server have been correctly specified. Check that information in the IT resource, such as the user name and password, are correct. If required, restart SAP User Management.