CMG’s Directory Connector requires a non-admin GroupWise user account (for GroupWise 2014) or a GroupWise admin account (for any other GroupWise version) with valid Internet Address and Name attributes, and sufficient permissions to:
For multiple GroupWise servers, one such account is required for each server.
CMG requires replication of this attribute to the Global Catalog so that ou=users will appear in the source list of OUs in the Connector Creation Wizard, when creating an Exchange-to-GroupWise connector. The procedure:
2 |
3 |
4 |
Select Replicate this attribute to the Global Catalog checkbox. |
1 |
Find and open the Directory Connector configuration file, in CMG’s \Directory Connector\ folder (named Configuration.xml by default). |
IMPORTANT: The CMG Management Console must be closed before you open this configuration file. When you select File|Save in the Management Console, the Console saves all of its open data to the Configuration.xml file, and this will overwrite any manual changes to the file that may have been saved while the Console was open. |
2 |
Find the <ServicePort>####</ServicePort> parameter, usually at or near the end of the <DirectoryConnectorSettings> section. |
CAUTION: Be very careful when manually entering or editing values in the Configuration.xml file, where incorrect syntax or even a single-character typo could disable a connector or the DC service altogether. |
3 |
Change the value of the <ServicePort>####</ServicePort> parameter to the port number you want to designate as the CMG Directory Connector communications port. |
The Console asks you to designate a GroupWise Username as the "owner" of all new shared address books that CMG will create for Exchange-to-GroupWise connectors. The Username you specify will be identified as the sender of the emails GroupWise will generate to invite other users to share the address books. For connections with GroupWise 2014 (only), note that this account must not be a GroupWise admin account (use any non-admin user for this purpose).
To prevent such delays during your organization’s routine work day, consider manually creating all of the shared address books you will need before you run any of CMG’s DC connectors. You could, for example, create your new shared address books after hours some evening, so the invitations would be generated during off hours, and in that way preempt the need for the Directory Connector to create them when the connectors are running.
Note that every Exchange-to-GroupWise connector is defined with a shared address book name, which must be unique. CMG will not let you assign a given shared address book to more than one DC connector.
For many organizations the easiest solution is to create multiple connectors (one for each source SMTP domain) with separate subdomains for each, and then define object filters for the different connectors (see Advanced Settings tab: object filtering features later in this chapter). Use the object filters to have each connector pull users only from the specified SMTP domain. This will allow a different subdomain to be used for each source SMTP domain and eliminate any chance of address conflicts between domains.
By default, CMG is installed with the log42net utility to generate log files of CMG components’ system activity. This information is critical to diagnosing any problems that may arise. Logging is enabled by default for all CMG components.
The log42net utility may be configured to work a particular way with each CMG component. The default configurations will be suitable for most organizations and circumstances, but you can customize logging features if you like. Configuration instructions are nearly identical from one component to another, so we present the instructions separately, in Appendix C of the User Guide.
Use CMG’s DC Management Console and its Connector Creation Wizard to define and manage the connectors that will update the directories you want to keep current, and to schedule the connectors to run.
Note that this step alone does not start the Directory Connector service, and that the defined connectors will run only if the Directory Connector service is running. See Running and stopping the Directory Connector service later in this chapter.
The <AppendAttributes> parameter lets you specify a list of one or more target attributes whose values will be appended to, rather than replaced by, a connector running in Update mode. That is, for each object in the directory, the value of each designated attribute in the source will be added to any existing value in the target.
This parameter is optional, and is configured separately for each DC connector in the connector's section of the DC Configuration.xml file. To designate the attribute(s) that should function this way in Update mode for a particular connector, find (or add) the <AppendAttributes> tags for the connector, and enter the names of the target attributes separated by a pipe character ("|") between the tags, like this:
If a GwXxxxAttributeList parameter is unspecified, the connector copies all attributes for that object type by default. But if particular attributes (one or more) are unnecessary for a particular object type, these parameters let you specify which attributes to include for a particular connector. (Any attribute not listed for the parameter will be excluded.)
The parameters are set in the Configuration.xml file for the Directory Connector (in CMG's DC subfolder), and are set (or not) separately for each defined connector. For each connector, enter the parameter name with a list of all attributes to be included, all in one continuous line and separated by pipe characters ("|"), with no spaces between. For example:
To create a suitable list of attributes for the parameter value:
1 |
Open the file Directory Connector\attributes\groupwiseConnector_XXX, where XXX is the object type (user or group or resource). The attributes in this file appear listed one attribute per line. |
2 |
Copy all the attributes from the file into a text editor. In the text editor, delete the lines for attributes you want to exclude from the connector's operations. |
3 |
For the remaining attributes in the list (the ones you want to include), replace all the hard returns with pipe characters ("|"), to produce a single-line continuous list (no spaces) of attributes separated by pipe characters. |
Then you can insert that list as the parameter value in the DC configuration.xml file:
1 |
Find the section for the connector you want to modify by this parameter, and its <ConnectorSettings> section, and add a new line for the <GwXxxxAttributeList>...</GwXxxxAttributeList> parameter. |
2 |
© 2021 Quest Software Inc. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy