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

Management Console screen:Directory Connector | Service Settings

The Service Settings screen collects the information the DC service needs to perform its functions. Enter these values to identify servers and programs, and provide the necessary access credentials.

Novell Login Information:

Novell Server: The internet name (e.g., acctg.xyzcorp.com) or IP address of the Novell directory server.
Novell Tree and Novell Context: The Tree and Context values for this connector’s login account, as shown in the Novell login form, on the eDirectory tab of the Advanced section.
Novell Account: Novell account username, by which the connector will access Global Address Book data. For coexistence with GroupWise 2014: This must be a non-admin account (can be any non-admin user).
Novell Password: Password associated with the Novell Account cited above.
Test (optional): Click the Test button to test Novell access by the values entered into these fields. The Management Console will post a dialog box with the test results. Click OK to clear the dialog box.
NOTE: This Test of the credentials will be valid only if you are not already logged into your desktop with the Novell login.

Free/Busy Host (appears only for GroupWise 8 or later): Enter the URL for the host where the Bridge subcomponent of CMG's F/B Connector's resides (or will reside). This value is added to objects written to the GroupWise shared address book, to facilitate GroupWise users' F/B queries to Exchange.

In a typical configuration, the Bridge is installed on the same computer as the Exchange F/B Connector service. (You can enter this value later if CMG's F/B Connector has not yet been installed and configured, or leave the field empty if the F/B Connector will not be used for GroupWise-to-Exchange F/B queries.)

Test (optional): Click the Test button if you want to test the connection to the Free/Busy Host URL entered into the adjacent field. The Management Console will post a dialog box with the test results. Click OK to clear the dialog box.

GroupWise Web Service Settings (appears only for GroupWise 8 or later):

GroupWise Soap Server Url: The URL for the GroupWise SOAP server—the server that runs the web access service for the post office. CMG uses this address to write to GroupWise, so you must have the SOAP web service enabled, and designate the port number used. For example: http://groupwise.xyzcorp.com:7191/soap
Trusted API Key: An authentication code that permits access to CMG shared address books by the Novell Account specified above. This Trusted API Key is associated with a particular Trusted Application Name, specified in the next field below. You can create the key with ConsoleOne (in GroupWise 8.01 SP1 or later), or run a command from the Windows command prompt:
Trusted Application Name: The name of the Trusted Application by which the Novell Account specified above will access CMG shared address books.
Test (optional): Click the Test button if you want to test the Trusted App values entered into these fields. The Management Console will post a dialog box with the test results. Click OK to clear the dialog box.

Directory Connector | SQL Settings

| SQL Settings

CMG’s Directory Connector requires access to a Microsoft SQL database to facilitate data transfers between the source and target directories. The information in this screen tells CMG how your required SQL database is configured, so the Directory Connector and SQL database can communicate.

Most of the information in this screen identifies and characterizes a SQL configuration that exists independently of CMG, and that is saved in a SQL configuration file identified in the Configuration File field here. CMG’s Directory Connector needs this information to communicate with the SQL database.

SQL Server Path: Specify the location of the SQL server (e.g., win7\sqldb).
[  ] Use Existing Configuration: Mark this checkbox if you want to use a previously created SQL configuration file, and enter (or Browse to) the existing Configuration File you want to use for CMG. Leave this checkbox unmarked if you want to create a new SQL config file for use with CMG’s DC, and specify:
Configuration File: The filename to be assigned to this SQL configuration file (e.g., DirectoryConnectorDBConfig).
Configuration Database (unused/grayed-out if using an existing configuration): The name of the SQL server configuration database to use for CMG DC functions (e.g., ConfigDb).
Execution Database (unused/grayed-out if using an existing configuration): The name of the SQL server execution database to use for CMG DC functions (e.g., ExecDb).
[  ] Use Windows Authentication: Mark this checkbox if you want CMG to connect to the SQL database via Windows Authentication, or leave it unmarked if you want CMG to use the SQL Database Account to connect to the SQL database. This checkbox determines which of the following pairs of fields will be active (rather than grayed-out) for you to enter the necessary credentials:
Account Sync Service Uses: Enter the Windows Account name (e.g., mustang\administrator) and Windows Password associated with this account, which CMG will use to connect to the SQL database.
SQL Database Account: Enter the SQL Account name and the Windows Password associated with this account, which CMG will use to connect to the SQL database.
Sync Service: You can click one of these buttons to Stop or Start CMG’s Directory Connector "engine" (the underlying code that DC connectors call to execute their functions).
Set Configuration: Saves the settings on this screen to the SQL Configuration File named above, and renames the DC "engine" service for the specified Windows account (if selected) or network services account. You must click this button to create the new file whenever you create a new configuration file, including whenever you install or upgrade the CMG Directory Connector.
NOTE: An "access to the registry key" error that occurs when clicking Set Configuration can be dismissed with no disruption to the SQL setup by clicking OK in the error dialog box. This appears to be an OS issue that occurs only with Windows Server 2003 R2, and occurs only once.
IMPORTANT: If upgrading from an earlier version of CMG’s Directory Connector: The DC database rebuilds itself when upgrading, and needs a few minutes to complete that step before it will permit connections. This is the likely cause of any "could not connect" error you may encounter upon clicking this Set Configuration button soon after upgrading. In that case, allow 5-10 minutes for the database to rebuild, and then try again.

Connector Creation Wizard

The Connector Creation Wizard lets you configure a DC connector in a series of friendly GUI screens. As noted above, the Management Console and Connector Creation Wizard perform different but related functions as shown in this chart:

The Connector Creation Wizard presents a short series of screens to configure each connector. A connector definition also specifies a schedule for its automatic execution, and lets you specify other DC connectors (previously defined) that must run prior to the execution of this connector. These features let you require a particular order of execution when two or more connectors are defined.

You may define as many connectors as you need for separate directory updates for different administrative entities or geographic locations, etc., and/or for updates among multiple directory servers on either or both sides. The Connector Creation Wizard is run separately for each connector you want to define or edit.

NOTE: Remember, a single DC connector cannot connect to a multi-tree Novell environment with multiple authentication credentials. As a result, a separate DC connector must be defined and configured for each set of authentication credentials required to extract data from each tree.

Starting the Connector Creation Wizard

To start the Connector Creation Wizard to create a new connector (from within the Management Console, on the Connector Settings screen):

Click Add.

To start the Connector Creation Wizard to edit an existing connector:

The Wizard presents the same screens, in the same order, in both the Add and Edit modes. The only difference is that the Edit mode shows the fields already filled with the previously entered values for the selected connector.

To abort a run of the Connector Creation Wizard, and discard any data you may have already entered or changed:

Click the Cancel button from any screen in the Wizard.

The Connector Creation Wizard presents a short series of screens to collect the information it needs to define and schedule a single connector. Since some screens appear only when defining a connector in a particular direction (Exchange-to-GroupWise vs. vice-versa), the Wizard is documented in two separate sections here, one for each direction.

Related Documents