1 About the Connector

Oracle Identity Manager automates access rights management, security, and provisioning of IT resources. Oracle Identity Manager connectors are used to integrate Oracle Identity Manager with third-party applications. The connector for Novell GroupWise is used to integrate Oracle Identity Manager with Novell GroupWise.

Note:

Oracle Identity Manager connectors were referred to as resource adapters prior to the acquisition of Thor Technologies by Oracle.

This chapter contains the following sections:

Reconciliation Module
Provisioning Module
Supported Functionality
Multilanguage Support
Files and Directories That Comprise the Connector
Determining the Release Number of the Connector

Note:

At some places in this guide, Novell GroupWise has been referred to as the target system.

Reconciliation Module

Reconciliation involves duplicating in Oracle Identity Manager additions of and modifications to user accounts on the target system. It is an automated process initiated by a scheduled task that you configure.

See Also:

The "Deployment Configurations of Oracle Identity Manager" section in Oracle Identity Manager Connector Framework Guide for conceptual information about reconciliation configurations

Based on the type of data reconciled from the target system, reconciliation can be divided into the following types:

Lookup Fields Reconciliation
User Reconciliation

Lookup Fields Reconciliation

Lookup fields reconciliation involves reconciling the Distribution List and Post Office List lookup fields.

User Reconciliation

User reconciliation involves reconciling the fields discussed in this section.

Reconciled Resource Object Fields

The following fields are reconciled:

Note:

These fields do not have the ldap prefix.

User ID
Visibility
File ID
Exp Date
Gateway Account ID
Gateway Access
Distribution List
- Dist List
- Participation
Nick Names
- Nick Name
- NNVisibility

Reconciled Xellerate User Fields

The following fields are reconciled only if reconciliation is implemented in trusted mode:

User ID

The value reconciled into the User ID field is also reconciled into both the First Name and Last name fields.
Organization
First Name
Last Name
User Type
Employee Type

Provisioning Module

Provisioning involves creating or modifying a user's account information on the target system through Oracle Identity Manager. You use the Administrative and User Console to perform provisioning operations.

See Also:

The "Deployment Configurations of Oracle Identity Manager" section in Oracle Identity Manager Connector Framework Guide for conceptual information about provisioning

For this target system, the following fields are provisioned:

User ID
Visibility
File ID
Exp Date
Gateway Account ID
Gateway Access
Distribution List
- Dist List
- Participation
Nick Names
- Nick Name
- NNVisibility

Supported Functionality

The following table lists the functions that are available with this connector.

Function	Type	Description
Create Mailbox	Provisioning	Creates a mailbox
Delete Mailbox	Provisioning	Deletes a mailbox
Disable Mailbox	Provisioning	Disables a mailbox
Enable Mailbox	Provisioning	Enables a mailbox
Move Post Office	Provisioning	Moves a user from one post office to another
Update User	Provisioning	Updates the specified Novell GroupWise attribute of a user
Add User To Distribution List	Provisioning	Adds a user to a distribution list
Remove User From Distribution List	Provisioning	Removes a user from a distribution list
Add Nickname to User	Provisioning	Adds a nickname or alias for a user
Delete Nickname of User	Provisioning	Deletes the nickname or alias of a user
Reset User Password	Provisioning	Updates a user's Novell GroupWise password
Create Mailbox	Reconciliation	Adds a mailbox
Delete Mailbox	Reconciliation	Deletes a mailbox
Disable Mailbox	Reconciliation	Disables a mailbox
Enable Mailbox	Reconciliation	Enables a mailbox
Update User	Reconciliation	Updates the user's profile by using user information retrieved from the Novell GroupWise system
Add User To Distribution List	Reconciliation	Adds the user's distribution group membership information by using user information retrieved from the Novell GroupWise system
Remove User From Distribution List	Reconciliation	Removes the user's distribution group membership information by using user information retrieved from the Novell GroupWise system
Add Nickname to User	Reconciliation	Adds the user's nickname information by using user information retrieved from the Novell GroupWise system
Delete Nickname of User	Reconciliation	Removes the user's nickname by using user information retrieved from the Novell GroupWise system

Multilanguage Support

This release of the connector supports the following languages:

Chinese Simplified
Chinese Traditional
English
French
German
Italian
Japanese
Korean
Portuguese (Brazilian)
Spanish

Note:

Novell GroupWise does not support the entry of non-ASCII characters. Refer to Chapter 5, "Known Issues" for more information about this limitation.

See Also:

Oracle Identity Manager Globalization Guide for information about supported special characters

Files and Directories That Comprise the Connector

The files and directories that comprise this connector are in the following directory on the installation media:

Collaboration and Messaging Applications/Novell GroupWise

These files and directories are listed in the following table.

File in the Installation Media Directory	Description
lib/tcGroupWise65.dll	This DLL file contains the native code required to communicate with the Novell GroupWise client.
lib/xliGroupWise65.jar	This JAR file contains the class files required for provisioning and reconciliation.
Files in the `resources` directory	Each of these resource bundle files contains language-specific information that is used by the connector. Note: A resource bundle is a file containing localized versions of the text strings that are displayed on the user interface of Oracle Identity Manager. These text strings include GUI element labels and messages displayed on the Administrative and User Console.
troubleshoot/tcGroupWise65.dll	This file contains the native code required to interface with Novell GroupWise.
troubleshoot/tstGroupWise65.jar	This file contains the wrapper files and the test utility class.
troubleshoot/testcreate.bat troubleshoot/testmodify.bat troubleshoot/testdelete.bat	These batch files are used to run specific tests on the connector. They call the appropriate method in the test utility class.
troubleshoot/config.properties	In this configuration file, connection information about Novell eDirectory and Novell GroupWise and other related parameters are specified.
troubleshoot/log4j.properties	This file is used to specify the directory in which the log file is to be created when you run the testing utility.
xml/xliGroupwiseResourceObject.xml	This file contains definitions for the following components of the connector: IT resource type Custom process form Process task and rule-generator adapters (along with their mappings) Resource object Provisioning process Pre-populate rules that are used with this connector
xml/ GroupwiseXLResourceObject.xml	This XML file contains the configuration for the Xellerate User. You must import this file only if you plan to use the connector in trusted source reconciliation mode.

Note:

The files in the troubleshoot directory are used only to run tests on the connector.

The "Step 2: Copying the Connector Files" section provides instructions to copy these files into the required directories.

Determining the Release Number of the Connector

You can use any one of the following methods to determine the release number of the connector.

Before Deployment

To determine the release number of a connector:

Extract the contents of the xliGroupWise65.jar file. This file is in the following directory on the installation media:
```
Collaboration and Messaging Applications/Novell GroupWise/lib
```
Open the manifest.mf file in a text editor. The manifest.mf file is one of the files bundled inside the xliGroupWise65.jar file.

In the manifest.mf file, the release number of the connector is displayed as the value of the Version property.

Note:

If you maintain a copy of the xliGroupWise65.jar file after deployment, you can use this method to determine the release number of the connector at any stage. After you deploy the connector, it is recommended that you use the "After Deployment" method, which is described in the following section.

After Deployment

To determine the release number of a connector that has already been deployed:

See Also:

Oracle Identity Manager Design Console Guide

Open the Oracle Identity Manager Design Console.
In the Form Designer, open the process form. The release number of the connector is the value of the Version field.