3 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected.

This chapter contains the following sections:

• Running Test Cases

• Troubleshooting

Running Test Cases

This section discusses test cases that you can perform by using the troubleshooting utility.

You can use the troubleshooting utility to directly use the connector for identifying the cause of problems associated with connecting to the target system server and performing basic operations on the target system.

The troubleshooting utility should be extracted to a directory. This utility consists of the components described in the "Files and Directories That Comprise the Connector" section.

When you extract the troubleshooting utility, you must ensure that all the files in the troubleshooting directory are retained in the same directory.

Before you can use the troubleshooting utility, you must set the required values in the config.properties file. This file is in the xellerate_home\xellerate\groupwise\troubleshoot directory. The following table describes the sections of this file.

Section Name	Information
Novell GroupWise Connection Parameters	Connection parameters required to connect to the Novell GroupWise system
Novell eDirectory Connection Parameters	Connection parameters required to connect to the Novell eDirectory system
Create User	Values requited to create a user
Modify User	Values required to modify a user
Delete User	DN of the user to be deleted

If required, edit the log4j.properties file to specify the location of the log file.

Run the appropriate batch file to test the creation, modification, and deletion of users in Novell GroupWise as follows:

• Create a user.

  Double-click the testcreate.bat file. Then, check if the user is created in Novell GroupWise with the details given in the config.properties file. If you run this BAT file from the command window, then the User_Creation_Successful message is displayed.

• Modify the user.

  Double-click the testmodify.bat file. Then, check if the user is modified in Novell GroupWise with the details given in the config.properties file. If you run this BAT file from the command window, then the User_Modification_Successful message is displayed.

• Delete the user.

  Double-click the testdelete.bat file. Then, check if the user is deleted in GroupWise with the details given in the config.properties file. If you run this BAT file from the command window, then the User_Deletion_Successful message is displayed.

Troubleshooting

This section provides solutions to the following commonly encountered errors associated with the connector:

• Remote Method Invocation Errors

• Novell GroupWise Connector Errors

Remote Method Invocation Errors

The following are steps to resolve remote method invocation errors:

• Verify that the GroupWise XRM IT resource has the right URL value.

• In the remote manager form, ensure that the Running check box is selected for the GroupWise XRM IT resource. If it is not selected, then the remote manager may not be running.

Novell GroupWise Connector Errors

Errors discussed in this section are divided into the following categories:

• Common Response Codes for All Use Cases

• Use Case-Specific Response Codes

Common Response Codes for All Use Cases

The errors discussed in the following table correspond to common response codes for all use cases.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with Novell eDirectory. Returned Error Message: Unable to communicate with the eDirectory server Returned Error Code: GW_EDIR_COMMUNICATION_ERROR	Ensure that the Novell eDirectory server is running. Ensure that Oracle Identity Manager is running (that is, the database is running). Ensure that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form). Ensure that the IP address, admin ID, and admin password are correct. Check if the SSL IT resource parameter is set to false. It must be set to true if the Novell eDirectory server is accepting only SSL connections. Check if the specified eDirectory connection values (in the Novell eDirectory IT resource) are correct.
Target not available. Returned Error Message: eDirectory server is probably unavailable Returned Error Code: GW_EDIR_TARGET_UNAVAILABLE_ERROR	Check if the Novell eDirectory server is down. Check if the given Novell eDirectory connection values (in the eDirectory IT resource) are correct. Check if the server name in the eDirectory/GroupWise connection information is correct.
Authentication error Returned Error Message: Unable to authenticate to the eDirectory server Returned Error Code: GW_EDIR_AUTHENTICATION_ERROR	Check if the specified Novell eDirectory connection values (especially the admin credentials in the eDirectory IT resource) are correct. Check if the SSL flag is set to false. It must be set to true if the eDirectory server is accepting only SSL connections.
Naming error Returned Error Message: Naming exception occurred while trying to connect to the eDirectory server Returned Error Code: GW_EDIR_INVALID_NAMING_ERROR	Check if the specified Novell eDirectory connection values (in the eDirectory IT Resource IT resource) are correct.
Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS). Returned Error Message: NDS Connection failed Returned Error Code: GW_NDS_CONNECTION_FAILED	Ensure that the eDirectory is up and running. Ensure that Oracle Identity Manager is running (that is, the database is running). Ensure that all the adapters have been compiled. Examine the Oracle Identity Manager record (from the IT Resources form). Ensure that the IP address, admin ID, and admin password are correct. Check if the given Novell GroupWise connection values (in the GroupWise IT resource) are correct. Check if some other user is connected to the NDS server through Novell Client. If yes, then close that connection.
Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS). Returned Error Message: Invalid NDS eDirectory credentials Returned Error Code: GW_NDS_INVALID_CREDENTIALS	Check if the specified Novell GroupWise connection values (especially the admin DN & password in the GroupWise IT Resource IT resource) are correct. Check if some other user is connected to the NDS server through Novell Client. If yes, then close that connection.
Oracle Identity Manager cannot establish a connection to GroupWise. Returned Error Message: Failed to create instance of GroupWise class Returned Error Code: GW_FAILED_TO_CREATE_INSTANCE	Check if Novell Client has been installed on the computer where the remote manager is installed. Check if the Novell GroupWise client has been installed on the computer where the remote manager is installed.
Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS) or GroupWise. Returned Error Message: Invalid eDirectory Tree Returned Error Code: GW_INVALID_TREE	Check if the given Novell GroupWise connection values (especially the eDirectory Tree in the GroupWise IT Resource IT resource) are correct.
Oracle Identity Manager cannot establish a connection to GroupWise. Returned Error Message: Invalid Domain DN or Path Returned Error Code: GW_INVALID_DOMAIN_DN_OR_PATH	Check if the given Novell GroupWise connection values (especially the GroupWise domain DN or path in the GroupWise IT Resource IT resource) are correct and if it has been entered in the format specified in this document. Check if the Novell GroupWise domain database is corrupted.
JNI out of memory. Returned Error Message: JNI Out of memory error Returned Error Code: GW_JNI_OUT_OF_MEMORY_ERROR	JNI has run out of memory. Increase JVM memory on the server on which the remote manager is installed.
Internal error has occurred Returned Error Message: An internal error has occurred in GroupWise. Returned Error Code: GW_INTERNAL_ERROR	Some unknown error has occurred. Review the log file to determine the exact error.
Invalid argument Returned Error Message: Invalid arguments passed to method Returned Error Code: GW_INVALID_ARGUMENTS	Check if the given Novell GroupWise connection values (especially the eDirectory Port, which has a numeric value in the GroupWise IT Resource IT resource) are correct.
User commit failed Returned Error Message: User commit failed Returned Error Code: GW_USER_COMMIT_FAILED	The user has insufficient NDS rights to the object. The disk is full. Check if you are using an evaluation version of Novell eDirectory and exceeding its limitations.
Required information missing Returned Error Message: Empty or null arguments were passed for mandatory fields or for connection information Returned Error Code: GW_INSUFFICIENT_INFO_PROVIDED	Ensure that the IP address, admin ID, and admin password are correct. Ensure that the required information has been provided as values of the following IT resource parameters: Information about the Novell eDirectory connection: - Novell eDirectory server name - Novell eDirectory port number - Novell eDirectory root context - Admin user DN - Admin user password - Whether or not SSL is to be used Information about the Novell GroupWise connection: - Novell eDirectory tree - Novell eDirectory context - Novell admin user DN - Novell admin password - Novell GroupWise domain DN or path The required information also includes other process data, such as the user ID.
User not present Returned Error Message: User does not exist Returned Error Code: GW_USER_DOESNOT_EXIST	The specified user ID does not exist in Novell eDirectory.
Mailbox not present Returned Error Message: Mailbox does not exist Returned Error Code: GW_MAILBOX_DOESNOT_EXIST	The specified mailbox does not exist in Novell GroupWise.
Mailbox already present Returned Error Message: Mailbox already exists Returned Error Code: GW_MAILBOX_ALREADY_EXISTS	The specified mailbox already exists in Novell GroupWise.
PostOffice not present Returned Error Message: PostOffice does not exist Returned Error Code: GW_POSTOFFICE_DOES_NOT_EXIST	The specified post office does not exist in Novell GroupWise.
Distribution List not present Returned Error Message: Distribution List does not exist Returned Error Code: GW_DISTLIST_DOES_NOT_EXIST	The specified distribution list does not exist in Novell GroupWise.
Nickname not present Returned Error Message: Nickname does not exist Returned Error Code: GW_NICKNAME_DOES_NOT_EXIST	The specified nickname does not exist in Novell GroupWise.

Use Case-Specific Response Codes

The errors discussed in the following table correspond to response codes that are specific to use cases. For all the errors listed in the table, you have to review the log file to determine the exact error.

Problem Description	Solutions
Oracle Identity Manager cannot create a user or mailbox in Novell GroupWise. Returned Error Message: Create Mailbox failed Returned Error Code: GW_MAILBOX_CREATE_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot delete a user or mailbox in Novell GroupWise. Returned Error Message: Delete Mailbox failed Returned Error Code: GW_MAILBOX_DELETE_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot disable a user or mailbox in Novell GroupWise. Returned Error Message: Disable Mailbox failed Returned Error Code: GW_MAILBOX_DISABLE_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot add a nickname to the user. Returned Error Message: Nickname add failed Returned Error Code: GW_NICKNAME_ADD_FAILED	Some unknown error has occurred. Review the log file to determine the exact error. A nickname already exists for the specified user.
Oracle Identity Manager cannot remove the nickname of a user. Returned Error Message: Nickname remove failed Returned Error Code: GW_NICKNAME_REMOVE_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot add a user to a distribution list. Returned Error Message: Add user to distribution list failed Returned Error Code: GW_DISTLIST_USERADD_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot remove a user from a distribution list. Returned Error Message: Remove user from distribution list failed Returned Error Code: GW_DISTLIST_USERREMOVE_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot reset the password of a user. Returned Error Message: Password reset failed Returned Error Code: GW_PASSWORD_RESET_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot move a user to the specified post office. Returned Error Message: Move user to postoffice failed Returned Error Code: GW_POSTOFFICE_MOVEUSER_FAILED	Some unknown error has occurred. Review the log file to determine the exact error.
Oracle Identity Manager cannot modify an attribute of a user. Returned Error Message: User attribute modify failed Returned Error Code: GW_USER_ATTRIBUTE_SET_FAILED	Some unknown error has occurred. Review the log file to determine the exact error. The specified attribute name may be invalid.