Chat now with support
Chat with Support

Coexistence Manager for GroupWise 1.7 - User Guide

About the CMG documentation suite Introduction CMG Directory Connector
Directory Connector overview Installation and configuration DC Management Console Connector Creation Wizard Connector Advanced Settings Running and stopping the Directory Connector service
CMG Mail Connector CMG Free/Busy Connector The Log Viewer Appendix A: Known limitations Appendix B: Troubleshooting Appendix C:Configuring CMG logging

Connector Advanced Settings

Connector Advanced Settings

Most of a connector’s configuration settings are entered and edited in the Connector Creation Wizard, as described in the preceding section, but a few other settings can be entered in a separate Advanced Settings dialog box. CMG’s Directory Connector lets you fine-tune the attribute mappings, object-selection filters, and attribute associations (for source-target object matching)—individually for each defined connector.

Typically these Advanced Settings control connector functions whose default settings are suitable for most environments, but may be modified as needed for your own local circumstances.

For any selected connector, the Advanced Settings let you:

Enable or disable the Provision (add), Update (edit) and/or Delete functions of the designated connector.
For each object type (Users, Contacts, Groups and Resources):
Attribute Mapping Features: Define how directory attributes in the source correspond to attributes in the target.
Object Filtering Features: Define object selection filters that tell a connector which objects to include when provisioning, updating or deleting objects.
Object Association Features: Define how a connector matches objects in the source directory to their corresponding objects in the target.

The Advanced Settings dialog box can contain any number and combination of six tabbed panels (all six shown here), depending on which objects you have selected for processing by this connector. Also, the Address Book tab appears only for an Exchange-to-GroupWise 8 or GroupWise 2012 connector.

The Advanced Settings dialog box is launched from the Connectors table in the Connector Settings screen of the Management Console. From that Connectors table: Right-click on the connector whose Advanced Settings you want to edit, and click Advanced Settings to open the dialog box.

NOTE: Remember that Advanced Settings are entered and/or edited for one connector at a time — only for the single connector that was selected when you opened the Advanced Settings.

Advanced Settings tab: General

The General tab lets you modify any or all of these connector configuration functions, as necessary:

Exclusion Mapping Value: The search string used with the Exchange exclusion attribute to prevent looping of objects during a directory update — if your expected actual use of the attribute would collide with the default setting. The default string appears here, but can be changed if it collides with other uses of the attribute.
[  ] Provision — [  ] Update — [  ] Delete: These three checkboxes let you enable or disable the Provision (add), Update (edit), and/or Delete objects functions for the selected connector. These functions are enabled and disabled independently for each connector:
[  ] Provision: If enabled [X], and no object in the target corresponds to an object in the source, the connector will create the new object in the target.
[  ] Update: If enabled [X], and an existing object in the target corresponds to an object in the source but the object’s attribute data differs, the connector will overwrite target object data with corresponding source object data— or—will append source data to target data for some attribute(s) if so configured by the <AppendAttributes> parameter for the connector (as described in step 1 of the Installation and configuration instructions above).
[  ] Delete: If enabled [X], and the connector sees no object in the source that had been in the source at the last connector update, it will delete the object in the target. For example, if User XYZ is copied from source to target, and then is deleted from the source, the next run of the same connector will remove User XYZ from the target.
Overwrite Object Names (checkbox, enabled only if the Update function is selected for this connector): If marked, the connector will overwrite object names on corresponding objects discovered in the target. By default, object names are not overwritten (checkbox is unmarked).
IMPORTANT: If you are upgrading from an earlier version connector and attempting to update Users as well as Contacts: You must also remove the filter condition that excludes user objects from the Update function. See the instructions below on the Update Filters tab of Advanced Settings.
Enable Add/Delete Verification (applies only for a GroupWise-to- Exchange connector): Use these two checkboxes to trap probable error conditions that might otherwise cause inadvertent object additions or deletions during a directory update.
For example: Sometimes the source system does not return all objects on a query, and these "missing" objects are then presumed to have been deleted from GroupWise. In that case, a G-to-E connector in Delete mode would delete those objects from Active Directory, trying to match the apparent state of the GroupWise source. But such inadvertent deletions can be avoided by setting a limit on the number of objects that may be deleted. This feature assumes that if the limit number is reached, an error has likely occurred, so the connector will abort the process without deleting any objects. Add Verification works similarly for object additions in a target directory.
Enable Add Verification: Mark this box to set a limit on the number of objects that can be added to AD during a directory update. If the number to be added exceeds this threshold, the add operation is canceled and the update is aborted. Default = 2 billion.
Enable Delete Verification: Mark this box to set a limit on the number of objects that can be deleted from AD during a directory update. If the number to be deleted exceeds this threshold, the delete operation is canceled and the update is aborted. Default = 25.
Update LDAP Attributes: [ Update Source ] and [ Update Target ]: These buttons let you query the source and target directories (respectively) for lists of their current, actual attributes— which CMG’s DC needs to know if either or both directories contain any customized attributes. CMG can establish the initial connections with its known lists of default attributes, but thereafter must know the actual attributes for any of the attribute mapping, object filtering or object association features available in a connector’s Advanced Settings.

Advanced Settings tab: Address Book

The Address Book tab appears only for an Exchange-to-GroupWise 8 connector. This tab lets you define, for each DC connector, how GroupWise 8 should handle invitations to users to share address books copied from Exchange to GroupWise during a connector update. Remember that these invitation emails will work only in the native GroupWise client; GroupWise web clients are not supported.

When a CMG directory update copies an address book from Active Directory to GroupWise 8, GroupWise tries to recreate the access rights from AD by inviting the end users with access to the original AD address book to also share the copy in GroupWise. GroupWise sends an invitation to those users who had access to the list in Exchange, and the invitation appears in each user’s GroupWise Inbox. The invitation opens as a dialog box, with buttons that let the recipient either Accept or Decline the invitation.

The fields on the Address Book tab ask you to specify how GroupWise should handle these invitations:

Address Book Sharing limit: Maximum number of users to include in a share list (GroupWise users to be invited to share the address book). If a share list exceeds the number specified here, GroupWise will divide the list into two or more separate lists. The valid range is 10–5000. The default is 5000, which is the maximum GroupWise 8 will allow in a share list, but the Exchange ACL list may be larger.
Invitation Subject: Text of the invitation Subject line.
Invitation Body: Text of the invitation message. GroupWise will insert this text into the Message portion of its invitations.

Many organizations find it helpful to users to include these instructions in the Invitation Body:

1
In your GroupWise email application, select Tools menu option Address Book.
2
In the Address Book window, select File menu option Name Completion Search Order.
3
In the Name Completion Search Order dialog box:
a
Select the name of the CMG shared address book in the Available books list (left), and click the Add button to add it to the Selected books list (right).
b
Select the CMG shared address book in the Selected books list, and click Up as often as necessary to move it to the top of the list.

Advanced Settings tabs for object types

The other four tabs in the Advanced Settings dialog box (other than the General and Address Book tabs) let you modify the attribute mappings, object-selection filters, and object-match associations for managing each of the four directory object types: Users, Contacts, Groups and Resources. The four tabbed panels all look the same and work the same, but the information they contain is applied to the different object types separately.

Each object-type tab in turn presents several "sub-tabs" for various features:

For each object type, the sub-tabs offer features that let you define:

Source Scope, Provision Filters and Update Filters: Determine which objects in the source directory should be included/excluded by the connector for processing. The Source Scope feature selects objects from the source system for processing, for all three primary connector functions: provisioning (adding new), updating (editing) and deleting objects in the target. The Provision Filters and Update Filters tabs may then further refine the scope for those functions, respectively.
Name Rules: Determines how newly created (provisioned) directory objects will be named in the target directory.
Provision Attributes and Update Attributes: Determine how attributes in the source directory should correspond to attributes in the target directory when the connector is provisioning (adding new) or updating (editing) objects in the target.
Association: Determines how the connector will associate objects in the source with their corresponding objects in the target — typically by comparing the values of a particular attribute in the source with the values of a particular attribute in the target.

These four categories of features are described separately below.

Related Documents