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:

• Running Test Cases

• Troubleshooting

4.1 Running Test Cases

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

To use the testing utility:

1. Open the following file:

   OIM_HOME/xellerate/XLIntegrations/OracleEBiz/config/config.properties
   

2. Specify values for the attributes in this file. These attributes are described in the following table.

   Attribute	Description	Sample Value
   Action	Specifies the provisioning action to be performed by the testing utility	The required action can be any one of the following: CONNECT CREATE UPDATEUSER UPDATEUSER_LIFESPAN UPDATEPASSWORD DISABLEUSER ENABLEUSER ADD_RESPONSIBILITY REMOVE_RESPONSIBILITY
   serverName	Specifies the IP address or computer name of the Oracle E-Business User Management server	172.21.136.200
   serverPort	Port at which the Oracle E-Business User Management server is listening	1521
   admin	User ID of the Oracle E-Business User Management server administrator	apps
   userName	User login ID	ORATEST
   description	Description of the user	ORATEST
   lifeSpanType	LifeSpan type of the User	LifeSpan Days, LifeSpan Accesses, None
   lifeSpanValue	LifeSpan value of the User	This value depends on the value assigned to the lifeSpanType attribute.
   password	Password of the user	password
   emailAddress	E-mail address of the user	[e-mail]
   startDate	Start date of employment of the user	2006-11-11
   endDate	End date of employment of the user	2007-4-12
   employeeId	Employee ID of the user	1452
   resetPswdOnFirstLogon	Specifies whether or not the password of the user must be reset at first login	Yes, No
   respName	Responsibility name	@Engineering
   respStartDate	Start date of responsibility	2006-11-11
   respEndDate	End date of responsibility	2006-11-12
   attrName	Attribute to be updated	Email, Employee Id, End Date, Life Span Type, Life Span, Password, Start Date
   attrValue	Value of the attribute to be updated

   
   

   See Also:

   The config.properties file for more information about these attributes

3. Run the testing utility file.

   • For Microsoft Windows, run the following file:

     OIM_HOME\xellerate\XLIntegrations\OracleEBiz\scripts\OracleEBiz.bat
     

   • For UNIX, run the following file:

     OIM_HOME\xellerate\XLIntegrations\OracleEBiz\scripts\OracleEBiz.sh
     

4. If the script runs without any error, then verify that the required provisioning action has been carried out on the target system.

4.2 Troubleshooting

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

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with the Oracle E-Business User Management server.	Ensure that the Oracle E-Business User Management server is running. Check if the user exists in Oracle E-Business User Management. Ensure that 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, administrator ID, and administrator password are correct.
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 (white space). Ensure that the attribute values do not exceed the specified length.
One of the following error messages is thrown when Oracle Identity Manager tries to exchange data with the target system: table or view does not exist insufficient privileges	This error message is thrown because the target system account for connector operations does not have the required privileges. See "Configuring the Target System" for information about creating this account and assigning the required privileges to it.