3 Testing the Connector

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

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

This section discusses test cases that you can perform by using the troubleshooting utility.

You can use the troubleshooting utility to directly use the connector for identifying the cause of problems associated with connecting to the IBM RACF server and performing basic operations on the server. The following are sample test cases that you can run by using the troubleshooting utility.

Open a command window and switch to the directory in which the xlutilHostAccess.jar file is present. This file is in the xellerate_home\Xellerate\JavaTasks directory. This utility uses some files from the ThirdParty directory.

You can use the troubleshooting utility to perform the following tests:

• Create an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 1 user_id
  
  

• Delete an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 2 user_id
  
  

• Update an IBM RACF user by entering the following command:

  java -jar xlUtilHostAccess.jar 3 user_id attribute_name attribute_value
  
  

  In this command, attribute_name can be set to one of the following:

  • NAME: To update the name

  • PASSWORD: To update the password

  • OWNER: To update the owner

  • DFLTGRP: To update the default group

  • DATA: To update the installation data

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to the IBM RACF server	Ensure that the IBM RACF server is up and running. Check if the user is not already logged in. Check if the user has been disabled on the IBM RACF server. Check if Oracle Identity Manager is working (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). Verify that the IP address, admin ID, and admin password are correct. Check the security parameters if an SSL connection is being used.
The Operation Failed message is displayed on the Oracle Identity Manager Administrative and User Console.	Ensure that the values for the attributes do not contain delimiter characters (such as white space, comma, apostrophe, inverted comma). Ensure that the attribute values do not exceed their permitted lengths.
Reconciliation fails.	Ensure that the file names given to store new user data on IBM RACF do not already exist on the IBM RACF server.