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 also referred to as the integration.

This chapter contains the following sections:

• Supported Platforms

• Running Test Cases

• Troubleshooting

Supported Platforms

The following table provides information about the environments on which this connector has been tested.

Oracle Identity Manager Release	Host Platform	Application Server	Database	SAP BASIS Version
8.5.3	Microsoft Windows 2003	JBoss 3.2.7	Oracle9i Database	4.7
8.5.3	Linux AS 2.1	BEA WebLogic 8.1 SP 4	Oracle9i Database	4.7
8.5.3	Solaris 9	IBM WebSphere 5.1.1.5	Oracle9i Database	4.7
9.0	Windows 2003	JBoss 4.0.2	Oracle9i Database	4.7

Running Test Cases

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

The SAP Enterprise Portal versionno\troubleshoot directory contains the TroubleShootingUtility class file and the troubleShoot.properties file. The troubleshooting utility uses this properties file to connect to the SAP Enterprise Portal server. This file contains the following information:

• SAP connection parameters: Server-related information.

• Create User parameters: Field information required to create a user profile.

• Modify User parameters: All the field information required to modify a user profile.

• Delete User parameters: All the field information required to delete a user profile.

• Reconciliation information: The "From date" timestamp information is passed from this file. The "To date" is set to the current time.

• CLASSPATH information: List of files to be included in the CLASSPATH:

This file also contains commands to test the following tasks:

• Create User

• Modify User

• Delete User

• Reconcile user information

In the C:\test\troubleshoot directory (path to troubleshoot directory), set the following SAP server connection parameters in the troubleshooting.properties file:

FirstTimeReconRecords=5000
SAPUMLocation=path to sapum.properties
WSDLLocation=WSDL URL on the SAP system
For example:
http://mlbpsap02:50000/irj/servlet/prt/soap/com.sap.portal.prt.soap.RolePortalService?style=rpc_lit

In the log.properties file in the same directory, set the path for the log files in the following parameter:

log4j.appender.logfile.File=log_file_path

Note:

Ensure that all the JAR files associated with this connector are included in the CLASSPATH.

Creating a User

To test the connector for the creation of a user, specify the following information for a new user object in the troubleshooting.properties file.

userId=epTS0003
password=admin123
firstName=tshoot
lastName=testing03
email=[e-mail]
language=
telephone=123456   
Fax=123456         
mobile=123456              
street=mystreet
city=myCity
state=myState
zip=123456
country=
timeZone=
department=
validfrom=2006-04-04
validto=2008-04-04
locked=false

On the command line, use the following command to create a user:

java -DTproperties=path_to_sapum.properties\troubleshoot\troubleShoot.properties -Dlog4j.configuration=file:/path_to_sapum.properties/troubleshoot/log.properties troubleshoot.TroubleShootUtility C

Deleting a User

Delete an SAP Enterprise Portal user as follows:

java -DTproperties=path_to_sapum.properties\troubleshoot\troubleShoot.properties -Dlog4j.configuration=file:/path_to_sapum.properties/troubleshoot/og.properties troubleshoot.TroubleShootUtility D

Modifying a User

Specify the following parameters in the troubleshooting.properties file to modify a user:

changeUserId=epTS0001
fieldName=FIRSTNAME
fieldValue=epTroubleShoot

Use the following command to modify a user:

java -DTproperties=path_to_sapum.properties\troubleshoot\troubleShoot.properties -Dlog4j.configuration=file:/path_to_sapum.properties/troubleshoot/log.properties TroubleShootingUtility M

Testing Reconciliation

To test reconciliation with the SAP Enterprise Portal connector, specify a timestamp for the From Date of the reconciliation run as shown:

fromDate=Apr 10, 2006 at 10:00:00 GMT+05:30

To test reconciliation from the timestamp specified to the current time, run the following command:

java -DTproperties=path_to_sapum.properties\troubleshoot\troubleShoot.properties -Dlog4j.configuration=file:/path_to_sapum.properties/troubleshoot/log.properties troubleshoot.TroubleShootUtility R

Troubleshooting

The following sections list solutions to some commonly encountered issues associated with this connector:

• Connection Errors

• Create User

• Delete User

• Modify User

• Child Data

Connection Errors

The following table lists solutions to some commonly encountered connection errors.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection to SAP Enterprise Portal. Returned Error Message: SAP Connection exception Returned Error Code: INVALID_CONNECTION_ERROR	Ensure that SAP Enterprise Portal is running and that the sapum.properties file has been correctly configured. Verify that Oracle Identity Manager is running (that is, the database is running). Verify that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form).
Target not available Returned Error Message: Target Server not available Returned Error Code: TARGET_UNAVAILABLE_ERROR	Connection error - unable to create SAP Enterprise Portal Connection. Verify that the given SAP Enterprise Portal connection values are correct. Verify that the SAP Enterprise Portal server is running.
Authentication error Returned Error Message: Authentication error Returned Error Code: AUTHENTICATION_ERROR	Connection error - unable to create SAP Enterprise Portal connection. Verify that the specified SAP Enterprise Portal connection user ID and password are correct.

Create User

The following table lists solutions to some commonly encountered Create User errors.

Problem Description	Solution
Oracle Identity Manager cannot create a user Returned Error Message: Required information missing Returned Error Code: INSUFFICIENT_INFORMATION_PROVIDED	Ensure that all the required information has been provided. The required information includes the following: User ID User First Name User Last Name User Password User Email
Oracle Identity Manager cannot create a user Returned Error Message: User already exists Returned Error Code: USER_ALREADY_EXIST	User with the assigned ID already exists in SAP. Assign a new ID to this user, and try again.
Oracle Identity Manager cannot create a user Returned Error Message: User creation failed Returned Error Code: USER_CREATION_FAILED	User not created because of the following error. The Change Password operation fails Mandatory fields have not been specified

Delete User

The following table lists solutions to some commonly encountered Delete User errors.

Problem Description	Solution
Oracle Identity Manager cannot delete a User Returned Error Message: Require information missing Returned Error Code: INSUFFICIENT_INFORMATION_PROVIDED	Ensure that all the required information has been provided. In this case, the required information is the user ID.
Oracle Identity Manager cannot delete a user. Returned Error Message: User does not exist in target Returned Error Code: USER_DOESNOT_EXIST	The specified user ID does not exist in SAP Enterprise Portal.

Modify User

The following table lists solutions to some commonly encountered Modify User errors.

Problem Description	Solution
Oracle Identity Manager cannot update new information about the user. Returned Error Message: Error while updating user info Returned Error Code: USER_MODIFICATION_FAILED	Generic error. Review the log for more details.
Oracle Identity Manager cannot update a user. Returned Error Message: User does not exist in target system Returned Error Code: USER_DOESNOT_EXIST	The specified user does not exist in SAP Enterprise Portal. Check the user ID.

Child Data

The following table lists solutions to some commonly encountered Child Data errors.

Problem Description	Solution
Oracle Identity Manager cannot add a user to a group. Returned Error Message: Group does not exist Returned Error Code: GROUP_DOESNOT_EXIST	The specified group does not exist in SAP Enterprise Portal. Check the name of the group.
Oracle Identity Manager cannot add a role to a user Returned Error Message: Role does not exist Returned Error Code: ROLE_DOESNOT_EXIT	The specified role for the user in Oracle Identity Manager does not exist in SAP. Check the role name.
Trying to add a duplicate value to a group or role. Returned Error Message: Duplicate value Returned Error Code: ROLE_ALREADY_EXISTS GROUP_ALREADY_EXISTS	The user has already been added to the particular profile or role.