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

5.1 Testing the Connector

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

To use the testing utility:

  1. Specify values for the parameters in the config.properties file. This file is located in the following directory:

    • For Oracle Identity Manager release 9.0.1 through 9.0.3.x and 9.1.0.x:

      OIM_HOME/xellerate/RACF/config

    • For Oracle Identity Manager release 11.1.1:

      OIM_HOME/server/RACF/config

    • For Oracle Identity Manager release 11.1.2:

      OIM_HOME/server/RACF/config

    These parameters are the same as the parameters of the IT resource.

  2. 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

        RACF.bat

      • For UNIX:

        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.

5.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.
Provisioning operation fails while creating RACF Standard account if the user ID contains a special character such as _ (underscore) (for example, usr1_1) Ensure that the user ID for RCAF Standard account follows the following rules in the RACF target system:

  • First character is A-Z, @, or #.

  • Other characters in the word can contain number from 0 to 9.

  • User ID must contain maximum 7 characters.
TSO ADD task shows rejected status in the target system even after the task is added to the target system. This is the default behavior due to security reasons.