Skip Headers
Oracle® Identity Manager Connector Guide for Novell GroupWise
Release 9.0.4

E10433-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

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:

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. Specify the required values in the config.properties file. This file is located in one of the following directories:

    • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

      OIM_HOME/xellerate/groupwise/test/troubleshoot

    • For Oracle Identity Manager release 11.1.x:

      OIM_HOME/server/groupwise/test/troubleshoot

    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

    See Section 2.3.2, "Configuring IT Resources" for information about the values that you must provide.

    Novell GroupWise Connection Parameters

    Connection parameters required to connect to the Novell GroupWise system

    See Section 2.3.2, "Configuring IT Resources" 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 one of the following directories:

    • For Oracle Identity Manager release 9.0.1 through 9.0.3.x or release 9.1.0.x:

      OIM_HOME/xellerate/groupwise/test/troubleshoot

    • For Oracle Identity Manager release 11.1.x:

      OIM_HOME/server/groupwise/test/troubleshoot

    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 testing utility, the debugGW.log file is created in the OIM_HOME/xellerate/groupwise/test/troubleshoot directory.

4.1.1 Testing Limited Reconciliation

To test query-based reconciliation, you can specify the following types of query conditions as values for the CustomizedReconQuery parameter:

  • Queries with user attributes

    • Value assigned to the CustomizedReconQuery parameter: cn=JOHN|cn=JANE

      The user with user ID JOHN and JANE are reconciled.

    • Value assigned to the CustomizedReconQuery parameter: nGWFileID=f06|nGWFileID=s1z

      The users with File ID f06 and s1z are reconciled.

    • Value assigned to the CustomizedReconQuery parameter: nGWFileID=f06&nGWAccountID=s1z

      The users with File ID f06 and Account ID s1z are reconciled.

    • Value assigned to the CustomizedReconQuery parameter: nGWGatewayAccess=jkl12

      The users with the Gateway Access value jkl12 are reconciled.

4.1.2 Testing Batch-Based Reconciliation

You can test reconciliation based on batching and data paging of user records by specifying values for the following user reconciliation scheduled task attributes:

  • If you set the value of StartRecord to 1, BatchSize to 0, and NumberOfBatches to All Available, then all the users are reconciled.

  • If you set the value of StartRecord to 1, BatchSize to 5, and NumberOfBatches to 50, then all the users starting from record 1 are reconciled in 50 batches, with 5 records in each batch.

  • If you set the value of StartRecord to 200, BatchSize to 5, and NumberOfBatches to 50, then all the users starting from record 200 are reconciled in 50 batches, with 5 records in each batch.

The results of batching are displayed in the logger file, which is located in the following path:

JBOSS_HOME/server/default/log/server.log

In this file, you can view the batch numbers, the user ids of the users that are reconciled, and whether the reconciliation is successful or not.

4.2 Troubleshooting

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

4.2.1 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.

4.2.2 Novell GroupWise Connector Errors

Errors discussed in this section are divided on the basis of response codes:

4.2.2.1 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 may not be available

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 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 encountered while trying to connect to the 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 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:

Could not 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 encountered

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:

Internal error encountered 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.

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_DOES_NOT_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_DOES_NOT_EXIST

The specified mailbox does not exist in Novell GroupWise.

Mailbox already present

Returned Error Message:

Mailbox already exists for the specified user

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.


4.2.2.2 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:

Could not create mailbox

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:

Could not delete mailbox

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:

Mailbox could not be disabled

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:

Could not add user to distribution list

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:

Could not remove user from distribution list

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:

Could not move mailbox

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:

Could not modify mailbox

Returned Error Code:

GW_USER_ATTRIBUTE_SET_FAILED

The specified attribute name may be invalid. Review the log file to determine the exact error.