5 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected.

You can use the testing utility, supplied with the connector package, to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.

The test-utility directory of connector installation media contains the following files:

  • The example-config.groovy file is a sample configuration that can be used to set the connection properties of the target system and the connector.

  • The README file contains instructions to configure and run the testing utility.

  • The test-utility.jar file contains the class files used by the testing utility.

Note:

The testing utility does not support delete user operation.

To use the testing utility, perform the following steps:

  1. Ensure JDK 1.6 is installed.

  2. Extract the contents of the connector bundle into a temporary directory.

  3. Locate and switch to the test-utility directory in the contents of the extracted zip file.

    The test-utility.jar and example-config.groovy files already exist in this directory.

  4. Update the example-config.groovy file with the target system, connector bundle, and connector information.

  5. Copy the following JAR files to the test-utility directory:

    • connector-framework.jar

    • connector-framework-internal.jar

    • groovy-all.jar

    Note:

    These are files are delivered as part of the OIM EAR application, and they are located in the oim.ear/APP-INF/lib directory.

  6. Copy the following third-party JAR files from the target system to the test-utility directory:

    • arapiVERSION_NUM.jar (replace VERSION_NUM with the release number of the target system that you are using)

      For example, the arapi80_build001.jar file.

    • log4j-1.2.14.jar

  7. Run one of the following commands from the test-utility directory:

    • For UNIX:

      java -classpath ./test-utility.jar:./connector-framework.jar:./connector-framework-internal.jar:./groovy-all.jar:./arapiVERSION_NUM.jar:./log4j-1.2.14.jar oracle.iam.connectors.testutility.Main example-config.groovy | tee test.log

    • For Windows (assuming the current directory is c:\test-utility):

      java -classpath C:/test-utility/test-utility.jar;C:/test-utility/connector-framework.jar;C:/test-utility/connector-framework-internal.jar;C:/test-utility/groovy-all.jar;C:/test-utility/arapiVERSION_NUM.jar;C:/test-utility/log4j-1.2.14.jar oracle.iam.connectors.testutility.Main example-config.groovy