3 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

Running Test Cases

You can use the troubleshooting 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 troubleshooting utility:

1. Specify the required values in the config.properties file.

   This file is in the OIM_home\xellerate\groupwise\troubleshoot directory. The following table describes the sections of this file in which you must provide information for running the tests.

   Section	Information
   Novell eDirectory Connection Parameters	Connection parameters required to connect to the Novell eDirectory system Refer to the "Defining IT Resources" section for information about the values that you must provide.
   Novell GroupWise Connection Parameters	Connection parameters required to connect to the Novell GroupWise system Refer to the "Defining IT Resources" section for information about the values that you must provide.
   Create Mailbox Parameters	Values required to create a mailbox
   Modify Mailbox Parameters	Values required to modify a mailbox
   Delete Mailbox Parameters	Values required to delete a mailbox

   
   

2. Use a text editor to open each of the BAT files in the OIM_home\xellerate\groupwise\troubleshoot directory. The names of the JAR files that must be added to the CLASSPATH environment variable are given in these BAT files. Copy these JAR files into the same directory as the BAT files and then add them to the CLASSPATH environment variable.

3. Run the appropriate BAT file to test the creation, modification, and deletion of users in Novell GroupWise:

   • Create a user by running the testcreate.bat file.

     After you run the BAT file, check if the user is created in Novell GroupWise according to the details given in the config.properties file. If you run this BAT file from a command window, then the User_Creation_Successful message is displayed.

   • Modify the user by running the testmodify.bat file.

     After you run the BAT file, check if the user is modified in Novell GroupWise according to the details given in the config.properties file. If you run this BAT file from a command window, then the User_Modification_Successful message is displayed.

   • Delete the user by running the testdelete.bat file.

     After you run the BAT file, check if the user is deleted from Novell GroupWise. If you run this BAT file from a command window, then the User_Deletion_Successful message is displayed.

When you run troubleshooting utility, the debugGW.log file is created in the OIM_home\xellerate\groupwise\troubleshoot directory.

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 URL has been correctly specified in the GroupWise XRM IT resource definition.

• 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 on the basis of response codes:

• 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. 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 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 Novell eDirectory is running. Check if the Novell eDirectory connection values specified in the eDirectory IT resource definition are correct. Check if the server IP address in the Novell eDirectory/GroupWise connection information is correct.
Authentication error Returned Error Message: Unable to authenticate to the Novell eDirectory server Returned Error Code: GW_EDIR_AUTHENTICATION_ERROR	Check if the Novell eDirectory connection values, especially the admin credentials, specified in the IT resource definition are correct. Check if the SSL IT resource parameter is set to false. It must be set to true if SSL has been enabled on the Novell eDirectory server.
Naming error Returned Error Message: Naming exception occurred while trying to connect to the Novell eDirectory server Returned Error Code: GW_EDIR_INVALID_NAMING_ERROR	Check if the Novell eDirectory connection values specified in the IT resource definition 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 Novell eDirectory 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. Check if the Novell GroupWise connection values specified in the IT resource definition 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 Novell GroupWise connection values, especially the admin credentials, specified in the IT resource definition 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 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 on which the remote manager is installed. Check if the Novell GroupWise client has been installed on the computer on which the remote manager is installed.
Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS) or Novell GroupWise. Returned Error Message: Invalid eDirectory Tree Returned Error Code: GW_INVALID_TREE	Check if the Novell GroupWise connection values, especially the eDirectory tree, specified in the IT resource definition are correct.
Oracle Identity Manager cannot establish a connection to Novell GroupWise. Returned Error Message: Invalid Domain DN or Path Returned Error Code: GW_INVALID_DOMAIN_DN_OR_PATH	Check if the Novell GroupWise connection values specified in the IT resource definition, especially the GroupWise domain DN or path, are correct. Check if the connection values have been specified in the format given 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	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 Novell GroupWise connection values specified in the IT resource definition 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 following connection information has been provided IT resource definition: 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.
Post office 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 must 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	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	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	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	A nickname already exists for the specified user. Review the log file to determine the exact error.
Oracle Identity Manager cannot remove the nickname of a user. Returned Error Message: Nickname remove failed Returned Error Code: GW_NICKNAME_REMOVE_FAILED	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	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	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	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	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	The specified attribute name may be invalid. Review the log file to determine the exact error.