4 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:

Testing the Connector
Troubleshooting

4.1 Testing the Connector

You can use the testing utility to test basic connector functionality.

To use the testing utility:

Specify values for the parameters in the config.properties file. This file is in the OIM_HOME/xellerate/RACF/config directory.

These parameters are the same as the parameters of the IT resource.
Use the testing utility to perform the following tests:

Note:
The testing utility files are in the OIM_HOME/XLIntegrations/RACF directory.
- Create an IBM RACF user.
  
  In the config.properties file, set the action to CREATE_USER and provide the user ID value for the USER_ID parameter.
  
  Save the changes and then run one of the following scripts:
  - For Microsoft Windows
```
OIM_HOME\xellerate\XLIntegrations\RACF\scripts\RACF.bat.
```
  - For UNIX:
```
OIM_HOME/xellerate/XLIntegrations/RACF/scripts/RACF.sh
```
- Update an IBM RACF user.
  
  In config.properties file, set the action UPDATE_USER and provide the user ID and user attributes. The attribute_name parameter can be set to one of the following:
  - NAME: To update the name
  - PASSWORD: To update the password
  The attribute_value parameter is the value of the attribute_name to be changed. For example, if you set attribute_name to NAME, then attribute_value can be set to John.
  
  Save the changes and run the script.
- Delete an IBM RACF user.
  
  In the config.properties file, set the action to DELETE_USER and provide the user ID value for the USER_ID parameter.
  
  Save the changes and run the script.

4.2 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 with the IBM Mainframe server	Ensure that the IBM Mainframe server is up and running. Check if the user is already logged in. Check if the user has been disabled on the IBM Mainframe server. Check if Oracle Identity Manager is running. Ensure that all the adapters have been compiled. Use the IT Resources form to examine the Oracle Identity Manager record. Ensure that the IP address, admin ID, and admin password are correct. Check the security parameters if an SSL connection is in use.
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, commas, apostrophes, and quotation marks). Ensure that the attribute values do not exceed their permitted lengths.
Reconciliation fails	Ensure that the files specified for storing new user data on IBM RACF do not already exist on the server.