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 Reconciliation

• Testing Provisioning

• Troubleshooting

4.1 Testing Reconciliation

Running test cases for reconciliation involves verifying that the PeopleSoft Listener Web application can reconcile user accounts into Oracle Identity Manager. The following sections provide instructions to perform this test.

4.1.1 Prerequisites for Testing the PeopleSoft Listener Web Application

The following are prerequisites for testing the PeopleSoft Listener Web application:

• Ensure that the Microsoft Windows scripting engine is installed. This is required to run VBScript files.

• Ensure that the PeopleSoft XML message schema is described in the USR_MGMT_MSG.xml file, which is in the OIM_HOME/xellerate/test directory.

4.1.2 Testing the PeopleSoft Listener Web Application

To test the PeopleSoft Listener Web application:

1. In the OIM_HOME/xellerate/test/cbrecon/psft-xel-test.vbs file:

   • Modify the value of the ps_server_url variable so that it points to the URL for the PeopleSoft Listener Web application.

   • Specify the required PeopleSoft attributes and user data values in the ExecuteATM function.

2. Run psft-xel-test.vbs. Ensure that the script runs without any errors.

When the script is run, it creates a reconciliation event. Verify that the reconciliation event is created in Oracle Identity Manager and that the event contains the data that you specify in the VBScript file.

4.1.3 Performing Trial Reconciliation

Refer to the "Limited Reconciliation" section.

4.2 Testing Provisioning

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.

Before you use the testing utility, you must set the required values in the config.properties file. This file is in the OIM_HOME/xellerate/XLIntegrations/PSFTBase/config directory.

Use the information in the following table to modify the default attributes of the config.properties file.

Name	Description	Sample Value
serverName	IP address or host name of the PeopleSoft Enterprise Applications server	172.21.109.95
serverPort	Port at which the PeopleSoft Enterprise Applications server is listening	9000
admin	User ID of the PeopleSoft Enterprise Applications server administrator	PS
ciName	Component interface used to load user data in PeopleSoft Enterprise Applications	USER_PROFILE
NumberOfRetries	Number of times the connection to the target system must be retried before the InvocationTargetException is thrown	2
DelayBetweenRetries	Time difference between subsequent retries (in milliseconds)	10000
action	Action to be performed	You can specify one of the following values: CONNECT CREATE UPDATEUSERINFO UPDATEUSER_EMPID UPDATEPASSWORD
userId	User login ID	PSFTTEST
userDescription	Description of the user	PSFTTEST
primaryEmailAddress	Primary e-mail address	[e-mail]
primaryEmailType	E-mail type of the primary e-mail account	BUS
password	Password of the user	password
languageCode	Language code for the user	ENG
currencyCode	Currency code for the user	USD
recName	Used to validate the employee ID during user provisioning in PeopleSoft Enterprise Applications	PERSONAL_DATA
empId	Employee ID for the user	A10000
primaryPermissionList	Primary permission list for the user	HCCPAM1
userIdAlias	User ID alias	PSFTTEST1
symbId	Specifies the AccessId associated with the user profile The AccessId specifies whether or not the user has sufficient privileges on the PeopleSoft Enterprise Applications database.	PS89
attrName	Name of the attribute to be updated	You can specify one of the following values: USER_DESCRIPTION EMAIL_ADDRESS EMAILTYPE MULTI_LANGUAGE_CODE LANGUAGE_CODE CURRENCY_CODE
attrValue	Value of the attribute to be updated	The value that you provide must correspond to the attribute name that you specify as the value of the attrName parameter.

After you specify values in the config.properties file, run one of the following files:

For UNIX:

OIM_HOME/xellerate/XLIntegrations/tests/scripts/PSFTBase.sh

For Microsoft Windows

OIM_HOME\xellerate\XLIntegrations\tests\scripts\PSFTBase.bat

4.3 Troubleshooting

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

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with the PeopleSoft Enterprise Applications server.	Ensure that the PeopleSoft Enterprise Applications server is running. 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, admin ID, and admin password are correct.
The Operation Fail 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 and commas. Ensure that the attribute values do not exceed allowable length.
The Create User adapter is triggered even when the pre-populate adapter is run successfully.	Set the property associated with the user ID attribute in the process form as required.
The PSFTBaseProvisioning.jar file is not accessible while running OIM_HOME/xellerate/XLIntegrations/tests/scripts/PSFTBase.sh testing utility.	It can be resolved by running the following command on the file: dos2unix ./PSFTBase.sh
You might encounter the following error when you run the testing utility for provisioning: java.io.FileNotFoundException: null\XLIntegrations\PSFTBase\config\attributemapping_prov.properties	Update the OIM_HOME/xellerate/XLIntegrations/tests/scripts/PSFTBase.sh file with following details: XL.HomeDir=OIM_HOME