| Oracle® Identity Manager Connector Guide for Novell GroupWise Release 9.0.4 Part Number E10433-03 |
|
|
View PDF |
| Oracle® Identity Manager Connector Guide for Novell GroupWise Release 9.0.4 Part Number E10433-03 |
|
|
View PDF |
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:
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:
Specify the required values in the config.properties file.
This file is in the OIM_HOME/xellerate/groupwise/test/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 |
Use a text editor to open each of the BAT files in the OIM_HOME/xellerate/groupwise/test/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.
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.
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.
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.
This section provides solutions to the following commonly encountered errors associated with the connector:
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.
Errors discussed in this section are divided on the basis of 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:
|
|
| Target not available.
Returned Error Message: eDirectory server may not be available Returned Error Code:
|
|
| Authentication error
Returned Error Message: Unable to authenticate to the eDirectory server Returned Error Code:
|
|
| Naming error
Returned Error Message: Naming exception encountered while trying to connect to the eDirectory server Returned Error Code:
|
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:
|
|
| Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS).
Returned Error Message: Invalid credentials Returned Error Code:
|
|
| Oracle Identity Manager cannot establish a connection to Novell GroupWise.
Returned Error Message: Could not create instance of GroupWise class Returned Error Code:
|
|
| Oracle Identity Manager cannot establish a connection to Novell Directory Services (NDS) or Novell GroupWise.
Returned Error Message: Invalid eDirectory Tree Returned Error Code:
|
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:
|
|
| JNI out of memory
Returned Error Message: JNI out of memory error encountered Returned Error Code:
|
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:
|
Review the log file to determine the exact error. |
| Invalid argument
Returned Error Message: Invalid arguments passed to method Returned Error Code:
|
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:
|
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:
|
The specified user ID does not exist in Novell eDirectory. |
| Mailbox not present
Returned Error Message: Mailbox does not exist Returned Error Code:
|
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:
|
The specified mailbox already exists in Novell GroupWise. |
| Post office not present
Returned Error Message: PostOffice does not exist Returned Error Code:
|
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:
|
The specified distribution list does not exist in Novell GroupWise. |
| Nickname not present
Returned Error Message: Nickname does not exist Returned Error Code:
|
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: Could not create mailbox Returned Error Code:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
The specified attribute name may be invalid. Review the log file to determine the exact error. |
|
 Copyright © 2009, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
