5 Testing the Connector

You must test the connector to ensure that it functions as expected. You can use one of the following options to test the connector:

Using the Testing Utility
Using the Diagnostic Dashboard

5.1 Using the Testing Utility

You can use the testing utility to conduct provisioning tests on the connector. This type of test involves using Oracle Identity Manager to provision a target system account for an OIM User.

To use the testing utility:

Ensure that all the steps to deploy the connector have been performed.
From the installation media:
- Copy the files in the scripts directory into a temporary directory on the Oracle Identity Manager host computer. For example, OIM_HOME/ADUM/scripts.
- Copy the files in the config directory into another temporary directory on the Oracle Identity Manager host computer. For example, OIM_HOME/ADUM/config.
Note:
From the next step onward, this procedure has been explained using the example directories into which the files in the scripts and config directory on the installation media have been copied.
If you are using Oracle Identity Manager release 9.1.0.x, then:
- If Oracle Identity Manager is running on IBM WebSphere Application Server, then perform the following steps:
  1. Copy the xlapiclient.ear file from the OIM_HOME/ADUM/scripts directory into the OIM_HOME/client/xlclient directory.
  2. Copy the wsapiclient.cmd file from the OIM_HOME/ADUM/scripts directory into the OIM_HOME/client/xlclient directory.
  3. In the WEBSPHERE_CLIENT_HOME/properties/sas.client.props file, specify values for the following:
    
    Note:
    WEBSPHERE_CLIENT_HOME is the directory in which you install the IBM WebSphere Application Server client.
```
com.ibm.CORBA.securityServerHost=OIM_HOST_NAME_OR_IP_ADDRESS
com.ibm.CORBA.securityServerPort=PORT_AT_WHICH_OIM_IS_LISTENING
com.ibm.CORBA.loginSource=properties
com.ibm.CORBA.loginUserid=xelsysadm
com.ibm.CORBA.loginPassword=xelsysadm
```
  4. Ensure that Oracle Identity Manager is running.
- If Oracle Identity Manager is running on JBoss Application Server, Oracle Application Server, or Oracle WebLogic Server, then update the following entries in the OIM_HOME/ADUM/scripts/runADTest.bat script:
```
set OIM_JARS = OIM_HOME\xellerate
```
  In the preceding line, change OIM_HOME to the full path of the xellerate directory.
```
set APPSERVER_HOME = APPSERVER_HOME
```
  In the preceding line:
  - For JBoss Application Server, replace APPSERVER_HOME with the full path of the JBOSS_HOME/client directory.
  - For Oracle WebLogic Server, replace APPSERVER_HOME with the full path of the WEBLOGIC_HOME/weblogic81/server/lib directory.
  - For Oracle Application Server, replace APPSERVER_HOME with the full path of the ORACLE_HOME/j2ee/home directory.
If you are using Oracle Identity Manager release 11.1.1 or 11.1.2.x, then update the following entries in the OIM_HOME/ADUM/scripts/runADTest.bat script:
```
set OIM_JARS = OIM_HOME\server
```
In the preceding line, change OIM_HOME to the full path of the server directory.
```
set APPSERVER_HOME = APPSERVER_HOME
```
In the preceding line, replace APPSERVER_HOME with the full path of the WEBLOGIC_HOME/server/lib directory.
```
set CLASSPATH=%classpath%;.;%XL_JARS%;%APP_JARS%;
```
In the preceding line, add the full path of the directory containing the oimclient.jar, xliActiveDirectory.jar, spring.jar, commons-logging.jar files.
In the OIM_HOME/ADUM/config/config.properties file, specify values for the identity fields of the user that will be created on the target system during the provisioning test. In addition, specify the name of the IT resource for the target system. See "Configuring the IT Resource for the Target System" for information about this IT resource.
In the OIM_HOME/ADUM/config/log.properties file, specify log messages that must be displayed on the console when you run the connector testing utility.
If Oracle Identity Manager is installed on, JBoss Application Server, Oracle Application Server, or Oracle WebLogic Server, then run the OIM_HOME/ADUM/scripts/runADTest script as follows:
```
runADTest.bat ARGUMENT_TO_INDICATE_APPLICATION_SERVER
```
In this command, replace ARGUMENT_TO_INDICATE_APPLICATION_SERVER with one of the following:
- 1 for JBoss Application Server
- 2 for Oracle WebLogic Server
- 3 for Oracle Application Server
For example, if Oracle Identity Manager is installed on Oracle WebLogic Server, then run the command as follows:
```
runADTest.sh 2
```
If Oracle Identity Manager is running on IBM WebSphere Application Server, run wsapiclient.cmd from the OIM_HOME/client/xlclient directory.

If the script runs without any error, then the "User created true" message is displayed in the command window. Verify that the user has been created in Microsoft Active Directory.

5.2 Using the Diagnostic Dashboard

The Diagnostic Dashboard is a utility shipped with Oracle Identity Manager. In addition to tests that can be run on the Oracle Identity Manager installation, this utility offers the following connector-related tests:

Test Basic Connectivity
Test Provisioning
Test Reconciliation

For information about these tests, refer to the "Working with the Diagnostic Dashboard" chapter in the following guide:

For Oracle Identity Manager release 9.1.0.x:

Oracle Identity Manager Administrative and User Console Guide
For Oracle Identity Manager release 11.1.1 or 11.1.2.x:

Oracle Fusion Middleware Administrator's Guide for Oracle Identity Manager