Professional Documents
Culture Documents
©
2011 Quest Software, Inc.
ALL RIGHTS RESERVED.
This document contains proprietary information protected by copyright. The software
described in this document is furnished under a software license or nondisclosure
agreement. This software may be used or copied only in accordance with the terms of the
applicable agreement. No part of this document may be reproduced or transmitted in any
form or by any means, electronic or mechanical, including photocopying and recording for
any purpose other than the purchaser's personal use without the written permission of
Quest Software, Inc.
If you have any questions regarding your potential use of this material, contact:
Refer to our Web site (www.quest.com) for regional and international office information.
TRADEMARKS
Quest, Quest Software, and the Quest Software logo are trademarks and registered
trademarks of Quest Software, Inc. in the United States of America and other countries.
For a complete list of Quest Software’s trademarks, please see
http://www.quest.com/legal/trademark-information.aspx. Other trademarks and
registered trademarks used in this guide are property of their respective owners.
DISCLAIMER
The information in this document is provided in connection with Quest products. No
license, express or implied, by estoppel or otherwise, to any intellectual property right is
granted by this document or in connection with the sale of Quest products. EXCEPT AS SET
FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT
FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY
EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE
FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL
DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS,
BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR
INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with
respect to the accuracy or completeness of the contents of this document and reserves the
right to make changes to specifications and product descriptions at any time without
notice. Quest does not make any commitment to update the information contained in this
document.
About the CMN
Documentation Suite
The documentation for Quest Coexistence Manager for Notes (CMN) includes:
• Release Notes (HTML): Describes the current CMN release—any new and
enhanced features, resolved issues, and known issues. Also documents minimum
installation requirements, and provides Quest contact information.
• Quick-Start Guide (printable PDF): An orientation to the product's basic
purposes and features, with brief case studies showing how its primary
components are most commonly used within a typical coexistence scenario. Also
documents System Requirements, and explains how to download and install the
software.
• CMN User Guide (printable PDF): Summary of CMN primary components and
features, and process instructions and application notes for configuring, starting
and running the CMN Mail Connector, Free/Busy Connector and Directory
Connector. Also explains how to configure the Domino, Exchange and Active
Directory servers to work with CMN.
• Online Help (compiled Windows Help file): Context-sensitive instructions and
application notes for the various screens and features of CMN’s Configuration
Editor utility.
• CMN Free/Busy Connector Release Notes (HTML): Documents system
requirements for the current release of the Free/Busy Connector (only), and any
new and enhanced features, resolved issues, and known issues pertaining to that
component.
• CMN Free/Busy Connector User Guide (printable PDF): Orientation to the
Free/Busy Connector component of CMN, and process instructions and
application notes for its configuration and administration.
• CMN Free/Busy Connector PowerShell Administration Guide (printable
PDF): Instructions and application notes for using Windows PowerShell cmdlets.
iii
Quest Coexistence Manager for Notes
iv
CONTENTS
ABOUT THE CMN DOCUMENTATION SUITE . . . . . . . . . . . . . . . . . .III
CHAPTER 1
INTRODUCING THE CMN FREE/BUSY CONNECTOR . . . . . . . . . . . . 9
ABOUT CMN’S FREE/BUSY CONNECTOR . . . . . . . . . . . . . . . . .10
HOW THE FREE/BUSY CONNECTOR WORKS . . . . . . . . . . . . . . .10
OUTLOOK USER RETRIEVES
F/B DATA FOR A LOTUS NOTES USER . . . . . . . . . . . . . . .11
NOTES USER RETRIEVES F/B DATA FOR AN OUTLOOK USER . .13
DEPLOYMENT OF F/B CONNECTOR SUBCOMPONENTS . . . . . . . . . .14
INSTALLATION AND CONFIGURATION OVERVIEW . . . . . . . . . .15
CHAPTER 2
INSTALLING AND CONFIGURING THE
F/B CONNECTOR AND ITS HOST ENVIRONMENT . . . . . . . . . . . . . 17
STEP 1:
PLAN YOUR FBC INSTALLATION AND CONFIGURATION . . . . . . . . .18
STEP 2:
INSTALL SUBCOMPONENT SOFTWARE . . . . . . . . . . . . . . . . . . .18
INSTALLATION CHECKLIST . . . . . . . . . . . . . . . . . . . . . . .20
STEP 3:
SYNCHRONIZE EXCHANGE AND DOMINO DIRECTORIES . . . . . . . . .22
STEP 4:
PREPARE YOUR SERVERS FOR CMN’S F/B CONNECTOR . . . . . . . .23
NETWORK LOAD BALANCING . . . . . . . . . . . . . . . . . . . . .23
DOMAIN NAME SYSTEM (DNS) CONFIGURATION . . . . . . . . .23
WEB SERVICES CERTIFICATES . . . . . . . . . . . . . . . . . . . .25
EXCHANGE SERVER CONFIGURATION . . . . . . . . . . . . . . . .28
DOMINO SERVER CONFIGURATION . . . . . . . . . . . . . . . . . .29
STEP 5:
CONFIGURE F/B SUBCOMPONENTS . . . . . . . . . . . . . . . . . . . . .29
STEP 5-1: OPEN POWERGUI. . . . . . . . . . . . . . . . . . . . .29
STEP 5-2: CONFIGURE WEB SERVER AND
LOTUS NOTES COMPONENTS ON THE CMN WEB SERVER . . . .30
v
Quest Coexistence Manager for Notes - Free/Busy Connector
CHAPTER 3
TROUBLESHOOTING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
LOTUS NOTES USERS CANNOT SEE
FREE/BUSY INFORMATION FOR EXCHANGE USERS. . . . . . . . . . . .42
LOTUS USERS CANNOT SEE
FREE/BUSY INFORMATION FOR A LARGE NUMBER OF USERS . .43
OUTLOOK/OWA USERS CANNOT SEE
FREE/BUSY INFORMATION FOR DOMINO USERS . . . . . . . . . . . . .44
OUTLOOK/OWA USERS CANNOT SEE
FREE/BUSY INFORMATION FOR A LARGE NUMBER OF USERS . .46
TROUBLESHOOTING FOREIGN DOMAIN ISSUES . . . . . . . . . . . . . .46
FREE/BUSY REQUESTS DO NOT
ROUTE TO REGISTERED FOREIGN DOMAIN . . . . . . . . . . . . .47
vi
APPENDIX A:
CONFIGURING CMN F/B CONNECTOR USING CMDLETS . . . . . . . . 51
RUNNING CMDLETS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
CONFIGURING THE WEB SERVER COMPONENTS . . . . . . . . . . . . .52
CONFIGURING THE AUTODISCOVER WEB SERVICE . . . . . . . .52
CONFIGURING THE FBC EWS . . . . . . . . . . . . . . . . . . . .53
CONFIGURING THE LOTUS NOTES COMPONENT . . . . . . . . . . . . .53
CONFIGURING THE EXCHANGE SERVER COMPONENT . . . . . . . . . .55
CONFIGURING THE DOMINO SERVER COMPONENT . . . . . . . . . . . .56
GLOSSARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
ABOUT QUEST SOFTWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
CONTACTING QUEST SOFTWARE . . . . . . . . . . . . . . . . . . . . . .63
CONTACTING QUEST SUPPORT . . . . . . . . . . . . . . . . . . . . . . .63
vii
Quest Coexistence Manager for Notes - Free/Busy Connector
viii
1
Introducing the CMN
Free/Busy Connector
• About CMN’s Free/Busy Connector
• How the Free/Busy Connector Works
• Deployment of F/B Connector
Subcomponents
Quest Coexistence Manager for Notes - Free/Busy Connector
In addition to the query, translation and reply functions, both the Exchange and
Domino servers require a service to facilitate the data communications between
themselves and external data sources (e.g., each other). Exchange requires an
Exchange Web Service (EWS) to enable communications between Exchange and
other applications, while Domino requires a similar application for the same
purposes. And finally, Exchange also requires an Autodiscover service to track
and report the location (URL) of the EWS.
10
Introducing the CMN Free/Busy Connector
For technical reasons, QCALCON must be installed on the Domino server, and
Quest strongly recommends that the other four subcomponents be distributed
as shown in the accompanying illustrations, and in the next chapter below.
The following scenario narratives and the accompanying illustrations show the
roles these subcomponents serve within the overall scope of CMN’s Free/Busy
Connector.
The scenario: Sally, an Outlook user, wants to book a meeting with Joe, a Lotus
Notes user. Joe’s email address is joe@dominodomain.com. Exchange resolves
"dominodomain.com" through DNS. DNS has a zone called dominodomain.com
with a host called autodiscover.dominodomain.com. The host name must match
the common name (of the certificate you requested) where CMN is installed.
1. The Exchange server asks the F/B Autodiscover Web Service (at
https://autodiscover.dominodomain.com/autodiscover/autodiscover.
xml): "Where is the EWS that can relay my free/busy query to
Domino?"
2. The F/B Autodiscover Web Service replies with the URL for CMN’s F/B
Connector EWS.
3. The Exchange server addresses its F/B query to CMN’s F/B Connector
EWS, at the designated URL.
11
Quest Coexistence Manager for Notes - Free/Busy Connector
4. The F/B Connector EWS relays the query to the Domino F/B
Connector Service.
5. The Domino F/B Connector Service translates the Exchange query
into Domino form, and passes the query to the Domino server. (The
Domino FBC Service is configured with the Domino Server name,
Directory Server name, ID path, and secure password of the Domino
server.)
6. The Domino server accepts and processes the query, and replies with
Joe’s free/busy information, directed back to the Domino F/B
Connector Service.
7. The Domino F/B Connector Service translates Joe’s Domino F/B data
into Exchange form, and passes the information to the EWS.
8. The F/B Connector EWS receives the inbound F/B data for Joe and
relays it to the Exchange server, where it is passed on to Sally.
12
Introducing the CMN Free/Busy Connector
In this scenario, Joe (a Lotus Notes user) wants to book a meeting with Sally,
an Outlook user, whose email address is sally@exchangedomain.com.
13
Quest Coexistence Manager for Notes - Free/Busy Connector
4. The Exchange server accepts and processes the query, and replies
with Sally’s free/busy information, directed back to the Exchange F/B
Connector Service.
5. The Exchange F/B Connector Service translates Sally’s Domino F/B
data into Exchange form, and passes the information back to the
QCALCON server task.
6. QCALCON relays the F/B information back to the Domino server,
where it is passed on to Joe.
14
Introducing the CMN Free/Busy Connector
It is possible to configure the CMN Exchange FBC Service on the same server
with the Autodiscover, EWS, and CMN Domino FBC Service. This option is more
fully explained and illustrated in chapter 2—see An Alternate Configuration.
Caution: Quest testing indicates that overall F/B Connector performance is
likely to be diminished by this alternate configuration, but it is possible and
may be preferred in certain particular circumstances, usually in smaller
environments with fewer users and a much lighter F/B traffic load.
15
Quest Coexistence Manager for Notes - Free/Busy Connector
16
2
Installing and Configuring
the F/B Connector and Its
Host Environment
• Step 1: Plan Your FBC Installation and
Configuration
• Step 2: Install Subcomponent Software
• Step 3: Synchronize Exchange and Domino
Directories
• Step 4: Prepare Your Servers for CMN’s F/B
Connector
• Step 5: Configure F/B Subcomponents
• Variations to Basic Configuration
Quest Coexistence Manager for Notes - Free/Busy Connector
Step 1:
Plan Your FBC Installation and
Configuration
Review the System Requirements (in the CMN Release Notes or Quick-Start
Guide), scan through the installation and configuration procedures in this
chapter, and think through this process as it will occur in your own environment.
Anticipate any special circumstances or issues, and decide now how you will
handle them when they occur.
Step 2:
Install Subcomponent Software
All CMN Free/BusyConnector subcomponents are installed by the AutoRun utility
that is included in the CMN product kit.
Very Important: CMN's F/B Connector contains five subcomponents that are
installed on different servers. Since the AutoRun installer must be run on the
computer where you want to install a particular component, you must run the
Autorun utility at least twice—or three times for our typical, recommended con-
figuration—on different computers.
For best performance, Quest recommends that you install the four non-
QCALCON components on two different CMN Free/Busy Connector servers,
which will require three runs of the AutoRun installer:
• On the Domino server, to install QCALCON.
• On the CMN FBC Web Server, to install Autodiscover, EWS, and Domino FBC
Service.
• On the CMN Exchange FBC Server, to install the CMN Exchange FBC Service.
18
Installing and Configuring the F/B Connector and Its Host Environment
The Installation Checklist below explains how to install F/B Connector software
subcomponents server-by-server, by the servers on which they will reside. If
you like you may also install the Quest PowerGUI subcomponents at the same
time you install the other Free/Busy subcomponent(s) on each server. Or you
may revisit each server later to install Quest PowerGUI.
To install the Quest PowerGUI subcomponents at the same time as the primary
F/B Connector subcomponents, simply select them all together in the AutoRun
Custom Installation screen. Select both the Quest PowerGUI and the F/B
Connector PowerPack, in addition to whatever F/B subcomponent(s) you want
to install on a given server.
To enable the CMN cmdlets for use with the 32 bit version of PowerShell:
• Open the 32 bit version of PowerShell and type:
Add-PSSnapIn Quest.CMN.FreeBusy
– OR –
• Click the shortcut on the Start menu.
19
Quest Coexistence Manager for Notes - Free/Busy Connector
Installation Checklist
This section documents which CMN subcomponents should be installed on which
servers, to achieve the typical configuration recommended by Quest (as shown
in the illustrations in chapter 1).
Note: The AutoRun installer automatically checks your environment to verify
CMN prerequisites, but you can bypass the prerequisites check by running the
installer from the command line and appending "ignoreprerequisites=1" to the
command before executing.
Quest PowerGUI subcomponents will also be required on this server, and can be
installed from the same CMN AutoRun. You may install Quest PowerGUI now,
after installing QCALCON, or return to the Domino Server later to install
PowerGUI. See About Quest PowerGUI and Free/Busy Connector PowerPack
above for more information.
Run the AutoRun installer on your CMN FBC Web Server, and follow the
Installation Instructions as documented in the CMN Release Notes or Quick-Start
Guide to install the Autodiscover, EWS and Domino FBC Service there. These
subcomponents are installed from the AutoRun Custom Installation screen,
under CMN Free/Busy Connector: Select Web Server Components (for
Autodiscover and EWS) and Lotus Notes Components (for Domino FBC
Service).
Quest PowerGUI subcomponents will also be required on this server, and can be
installed from the same CMN AutoRun. You may install Quest PowerGUI now,
after installing the CMN FBC Web Server subcomponents, or return to the
Domino Server later to install PowerGUI. See About Quest PowerGUI and
Free/Busy Connector PowerPack above for more information.
20
Installing and Configuring the F/B Connector and Its Host Environment
Run the AutoRun installer on your Exchange FBC Server, and follow the
Installation Instructions as documented in the CMN Release Notes or Quick-Start
Guide to install the Exchange FBC Service there. This subcomponent is installed
from the AutoRun Custom Installation screen, under CMN Free/Busy Connector:
Select Exchange Components.
Quest PowerGUI subcomponents will also be required on this server, and can be
installed from the same CMN AutoRun. You may install Quest PowerGUI now,
after installing the Exchange FBC Service, or return to the Domino Server later
to install PowerGUI. See About Quest PowerGUI and Free/Busy Connector
PowerPack above for more information.
If necessary: Run the AutoRun installer on each server that contains a CMN
Free/Busy Connector subcomponent, and follow the Installation Instructions as
documented in the CMN Release Notes or Quick-Start Guide to install PowerGUI
and the F/B Connector PowerPack.
Uninstalling the CMN Free/Busy connector does not uninstall PowerGUI. You
can uninstall PowerGUI separately.
21
Quest Coexistence Manager for Notes - Free/Busy Connector
Step 3:
Synchronize Exchange and Domino
Directories
Before running any of CMN’s Free/Busy Connector subcomponents, you must
synchronize Lotus Notes users on Domino with Exchange contacts, and Outlook
users on Exchange with Domino contacts. For best performance, Quest
recommends you use the CMN Directory Connector for this purpose. The
Directory Connector is another CMN component that you may have already
installed and configured, or that you can install at no additional expense. For
complete documentation of the CMN Directory Connector, see chapter 2 of the
CMN User Guide.
1. Ensure that a Foreign Domain document has been created. For more
information, see To Add a Foreign Domain Document as explained
below.
2. Create a new Person Document using Lotus Notes.
3. Set the mail type to Other Internet Mail.
4. Set the CalendarDomain property to the same value as the
CalendarSystem property of the Foreign Domain document.
This permits configuration of CMN’s Free/Busy Domino server task
(QCALCON).
5. Set the InternetAddress property of the Person Document to the
Exchange SMTP email address.
22
Installing and Configuring the F/B Connector and Its Host Environment
Step 4:
Prepare Your Servers for
CMN’s F/B Connector
Configure domains, permissions and other server parameters and attributes so
they will be able to work with CMN’s Free/Busy Connector.
23
Quest Coexistence Manager for Notes - Free/Busy Connector
If the Domino Server supports one or more subdomains, a DNS host entry is
required to resolve to the CMN Autodiscover Web Service for each subdomain
supported.
On-Premise Exchange
If your Exchange server is on-premise, you can create a host entry so your DNS
can point to the computer where the CMN Autodiscover Web Service is installed.
CREATING A ZONE
You can create a zone so your computer can return the host name when you
query the IP address. The zone must match your SMTP domain.
To create a zone:
1. Locate DNS in Administrative Tools.
2. Right-click Forward Lookup Zone and select New Zone.
3. Select Primary zone and de-select Store the zone in Active
Directory (available only if DNS is a domain controller)
checkbox. Click Next.
4. Enter a zone name (that is, <smtpdomain>), and click Next.
5. Accept the remaining defaults, and click Finish.
6. Repeat steps 2 through 5 for each subdomain supported by the
Domain server.
24
Installing and Configuring the F/B Connector and Its Host Environment
Hosted Exchange
If your Exchange server is hosted, you must register each domain name and
subdomain name (in the form autodiscover.smtpdomain or smtpdomain) with a
public Internet registrar, and assign them to the IP address of the computer on
which the CMN Free/Busy Connector Service is installed. The computer must
have port 443 exposed to the Internet.
The CMN Free/Busy Connector fully supports retrieving free/busy information
for users registered in the hosted Exchange.
For your hosted Exchange users to see free/busy information for your
on-premise Domino users, run the Add-AvailabilityAddressSpace cmdlet on
the hosted Exchange server (see Exchange Server Configuration below).
You can request a certificate using Web enrollment pages. For more
information, see http://support.microsoft.com/kb/931351.
Once you have received the certificate, you must install it on the appropriate
server.
3. Click Next.
25
Quest Coexistence Manager for Notes - Free/Busy Connector
3. Click Next.
4. Select Process the pending request and install the certificate,
and click Next.
5. Browse to the location where you have saved the text file, and click
Next.
6. Leave the default port as 443, and click Next.
7. Review the certificate summary. Click Next, then click Finish.
8. From Internet Information Services (IIS) Manager dialog box,
right-click Default Web Site, and select Properties.
9. From the Directory Security tab, select Edit.
10. Select the Require secure channel check box, and click OK.
26
Installing and Configuring the F/B Connector and Its Host Environment
27
Quest Coexistence Manager for Notes - Free/Busy Connector
To configure the Exchange Server link to the CMN Web Server and verify
that certificates are trusted by Exchange:
1. At the Exchange Server, open Exchange Management Shell and enter
the following cmdlet:
Add-AvailabilityAddressSpace -ForestName <smtpdomain>
-AccessMethod OrgWideFB -UseServiceAccount $true.
... where <smtpdomain> is the name of the Domino domain.
2. Open a Web browser and enter the URL
https://[autodiscover.]<smtpdomain>/autodiscover/
autodiscover.xml to ensure that the Exchange Server resolves it to
the CMN FBC EWS without any certification errors.
3. Ensure the certificate created earlier is trusted by Exchange. If it is
not, see Web Services Certificates.
4. If Domino Server subdomains have been configured, repeat the
above steps for each subdomain.
If you created a self-signed certificate and a certification error appears in the
Web browser:
1. Click the SSL button in the Web browser.
2. Click View Certificates.
3. Right-click the certificate to open the Import Certificate Wizard dialog
box.
4. Install the certificate in Trusted Root Certification Authorities, and click
Next.
5. Click Import, then Finish.
If you requested a certificate from a public CA, the certificate is already
trusted by Exchange.
28
Installing and Configuring the F/B Connector and Its Host Environment
Step 5:
Configure F/B Subcomponents
Identify the participating servers and their locations, register the necessary
account access credentials, set up their logging features, and set other operating
parameters.
Wizards are available to walk you through the configuration of CMN Free/Busy
Connector subcomponents using the PowerGUI. The rest of this chapter explains
how to use the wizards to complete configuration of the F/B subcomponents.
Except where noted otherwise, these procedures assume that subcomponents
are installed as described in the Quest-recommended Deployment of F/B
Connector Subcomponents.
If you prefer, you may instead use cmdlets to configure CMN F/B Connector
subcomponents. For more information about using cmdlets, see Appendix A:
Configuring CMN F/B Connector Using cmdlets.
29
Quest Coexistence Manager for Notes - Free/Busy Connector
30
Installing and Configuring the F/B Connector and Its Host Environment
To configure the CMN Domino FBC Service on the CMN Web Server:
1. From the Navigation Tree, select Configure Web Services and
Lotus Notes Components | Advanced | Domino Free/Busy
Connector.
2. From the Actions Pane, select Set Domino server name.
3. Enter the name of your Domino Server, and click OK.
4. From the Actions Pane, select Set Domino password.
5. Enter the secure password, and click OK.
6. From the Actions Pane, select Set Domino ID file path.
7. Enter the path to your Domino ID file, and click OK.
8. From the Actions Pane, select Set Domino user SMTP domain.
9. Enter the fully qualified SMTP domain of the Domino users sharing
free/busy information, and click OK.
10. From the Actions Pane, select Set listening port.
11. Enter the TCP port the Domino Free/Busy Service Connector Service
should use, and click OK.
12. From the Actions Pane, select Set free/busy cache timeout (in
minutes). Enter the amount of time the free/busy information will
remain cached, and click OK.
13. From the Actions Pane, select Set Domino user fetch interval (in
minutes).Enter the interval to refresh the list of Domino users, and
click OK.
The following parameters are mandatory to configure the Domino Free/Busy
Connector Service:
• -DominoServerName
• -DominoPassword
• -DominoUserSmtpDomains
14. From the Navigation Tree, select Configure Web Services and
Lotus Notes Components | Advanced | Domino Free/Busy
Connector Service.
15. Select whether to modify the name or credentials of the connector
service, or whether to stop, start, restart, suspend, or resume the
service.
31
Quest Coexistence Manager for Notes - Free/Busy Connector
3. Click Next.
4. Enter your preferred Exchange server. Click Next.
The Exchange Web Services URL is automatically populated using the
name of your Exchange server in this form:
https://<preferred Exchange Server name>/EWS/Exchange.asmx
5. Enter the logon credentials needed for the Quest CMN Exchange
Free/Busy Connector Service, and click Next.
6. Review the summary of what you have configured, and click Next
again to apply the changes.
The Results tab appears, showing the table populated with the values
you entered in the wizard. Also, if you select a subcomponent in the
Advanced node in the Navigation Tree, each subcomponent is
populated with the values you entered in the wizard.
32
Installing and Configuring the F/B Connector and Its Host Environment
10. From the Actions Pane, select Show tentative status as busy or
Show tentative status as free to determine how tentative status
from Outlook is shown in Lotus Notes.
The default is to show tentative status as free.
11. If your Exchange is hosted and your domain is registered (see
Hosted Exchange), you must complete the following sub-steps, using
PowerShell cmdlets.
If you are using Microsoft Online Services, sign into Microsoft Online Services
Sign-In before running the Get-CmnExchangeWebServicesUrl cmdlet.
3. Click Next.
4. Enter the name of the Foreign Domain, and the name of the
computer running the CMN Exchange Free/Busy Connector Service.
Click Next, and a summary of your configuration entries appears.
5. Click Next again to apply the changes.
The Results tab appears, showing the table populated with the
values you entered in the wizard. Also, if you select a subcomponent
in the Advanced node in the Navigation Tree, each subcomponent is
populated with the values you entered in the wizard.
33
Quest Coexistence Manager for Notes - Free/Busy Connector
CMN logging for all components is enabled by default, but you may want to
change the location of the log file and/or change the level of detail in the logs.
Logging options are set in a log4net.config configuration file in the F/B Connector
installation directory. The log4net.config file is an XML file that can be opened
and edited with any XML editor.
The values are listed here in ascending order of detail (left to right).
The CMN Free/Busy Connector generates as many as five log files, one for each
of its subcomponents:
34
Installing and Configuring the F/B Connector and Its Host Environment
For more detailed information about the log4net utility and how its log files can
be configured, see the log4net Config Examples at the Apache.org web site.
Note: Any changes to the log4net.config file are immediately applied by the
CMN service when the configuration file is saved.
1. Open the file log4net.config (in the log4net folder) with an XML editor.
2. Find the section <SectionName>, that contains the parameter(s) you
want to edit.
3. Make any desired changes. Values must be enclosed in double
quotation marks and followed by a trailing space and slash character,
like this: <ParameterName="value" />
4. Repeat steps 2 and 3 as often as necessary to make additional
parameter changes.
5. Close and Save the configuration file under the same log4net.config
filename.
35
Quest Coexistence Manager for Notes - Free/Busy Connector
Multi-Domain Support
The CMN can facilitate the exchange of free/busy information between multiple
subdomains supported by both the Exchange and Domino Servers. Specific steps
are required to support subdomains on the Domino side, as noted within the
procedures documented here. Use this checklist to ensure configuration is
complete.
Equivalent Domains
CMN supports equivalent domain names for Express mail users and Domino mail
users. Equivalent domains are mapped to the primary domain in the Express
Server or Domino Server. The following procedures use cmdlets in the CMN
PowerPack to perform this mapping.
36
Installing and Configuring the F/B Connector and Its Host Environment
Domino Clusters
CMN supports a cluster of two Domino Servers (ClusterNode1 and ClusterNode2)
that provide Lotus Notes mail service in an active/standby redundancy
configuration. In this case, only a single CMN Web Server is required to support
both Domino Servers. Follow the procedures below to set up this configuration.
Initially, ClusterNode1 is the active Domino server.
To install and configure CMN’s FBC for the active Domino Server in a
cluster:
1. Ensure that the Domino Admin client installed in the CMN Web
Server is able to connect to both Domino servers.
37
Quest Coexistence Manager for Notes - Free/Busy Connector
38
Installing and Configuring the F/B Connector and Its Host Environment
An Alternate Configuration
The installation and configuration instructions in this chapter are written for the
typical, recommended configuration as summarized in chapter 1 (see
Deployment of F/B Connector Subcomponents). But it is also possible to
configure the CMN Exchange FBC Service on the same server with the
Autodiscover, EWS, and CMN Domino FBC Service, as shown here:
In this case, the CMN Exchange Server is not required. The configuration wizard
customizes the steps required, based on the CMN Free/Busy Connector
subcomponents it detects on the Domino server.
Caution: Quest testing indicates that overall F/B Connector performance is
likely to be diminished by this alternate configuration, but it is possible and
may be preferred in certain particular circumstances, usually in smaller
environments with fewer users and a much lighter F/B traffic load.
39
Quest Coexistence Manager for Notes - Free/Busy Connector
To configure the CMN Exchange FBC Service, see: On CMN Exchange FBC
Server: Install CMN Exchange FBC Service.
40
3
Troubleshooting
• Lotus Notes Users Cannot See Free/Busy
Information for Exchange Users
• Outlook/OWA Users Cannot See Free/Busy
Information for Domino Users
• Troubleshooting Foreign Domain Issues
• Troubleshooting Exchange Free/Busy Errors
• Troubleshooting Domino Free/Busy Errors
• Troubleshooting using PowerGUI
• Accessing SupportLink Knowledgebase
Quest Coexistence Manager for Notes - Free/Busy Connector
• Set the service logon credentials for the Quest CMN Exchange
Free/Busy Connector service (see Step 5-3: Configure the Exchange
FBC Service Component on the CMN Exchange Server).
• Set the exchange credentials using the
Set-CmnExchangeFreeBusyConfig cmdlet.
Try each of these methods if you are seeing errors in your event log
when testing free/busy.
42
Troubleshooting
using the same credentials used by the Exchange service without any
additional credential prompts and without any certificate errors.
•) Ensure the appropriate port is open on the Exchange Free/Busy Connec-
tor service computer for TCP/IP communication.
•) If you see the following error message in the event log:
The underlying connection was closed: Could not establish
trust relationship for the SSL/TLS secure channel.
If you are using Lotus Notes and querying Free/Busy information for an
Exchange user, edit QCALCON.exe.Config file on the Domino server:
43
Quest Coexistence Manager for Notes - Free/Busy Connector
1. Open IIS Manager for IIS 6.0. Expand the Web Site where the CMN
Web services are installed.
2. Right-click Autodiscover and click Properties.
3. On the Virtual Directory tab, click Configuration.
4. On the Mappings tab, click Add.
5. If you are using 32 bit IIS, click the Browse button and locate
%windir%\Microsoft.Net\Framework\v2.0.50727\aspnet_isapi.dll.
– OR –
If you are using 64 bit IIS, click the Browse button and locate
%windir%\Microsoft.Net\Framework64\v2.0.50727\aspnet_isapi.dll
44
Troubleshooting
45
Quest Coexistence Manager for Notes - Free/Busy Connector
If you are using OWA or Outlook and querying Free/Busy information for a
Domino user, edit the Web.Config file in the EWS folder on the CMN Web Server:
46
Troubleshooting
Troubleshooting Exchange
Free/Busy Errors
To troubleshoot errors retrieving Free/Busy Information from Exchange, you can
use the Get-CmnExchangeFreeBusy cmdlet.
This cmdlet will retrieve free/busy information for one or more uses directly from
Exchange using the same code used by the Exchange Free/Busy connector
service.
47
Quest Coexistence Manager for Notes - Free/Busy Connector
This cmdlet can be used to narrow down whether the problem is retrieving
Free/Busy information from Exchange, or the configuration of the QCALCON
Domino Server task or its communication with the Exchange Free/Busy
Connector Service.
This cmdlet will retrieve free/busy information for one or more uses directly from
Domino using the same code used by the Domino Free/Busy connector service.
This cmdlet can be used to narrow down whether the problem is retrieving
Free/Busy information from Domino, or the configuration of the CMN Free/Busy
Web Services and their communication with the Domino Free/Busy connector
service.
48
Troubleshooting
This verifies that the specified host name resolves to the computer
where the Domino server is installed.
49
Quest Coexistence Manager for Notes - Free/Busy Connector
4. Click Test.
This retrieves free/busy information directly from the Exchange
Server for a specified user.
8. From the Actions Pane, select Test Exchange Web Services URL.
A dialog box appears stating that PowerGUI will now launch the
Exchange Web Services URL in Internet Explorer.
9. Click OK.
Internet Explorer opens pointing to the Exchange Services URL.
You can also select Diagnostics and Troubleshooting | Application Event Log
to see if any error messages were logged.
Accessing SupportLink
Knowledgebase
You can access Quest SupportLink to get various knowledgebase articles.
To access SupportLink
1. From the Navigation Tree, select Diagnostics and
Troubleshooting | SupportLink Knowledgebase.
2. From the Actions Pane, select SupportLink Knowledgebase.
SupportLink opens.
50
Appendix A:
Configuring CMN F/B
Connector Using cmdlets
• Running Cmdlets
• Configuring the Web Server Components
• Configuring the Lotus Notes Component
• Configuring the Exchange Server
Component
• Configuring the Domino Server Component
51
Quest Coexistence Manager for Notes - Free/Busy Connector
Running Cmdlets
Note: A PowerShell cmdlet must be run on the same computer as the FBC
subcomponent to which it will be applied.
For more information on PowerShell cmdlets, see the PowerShell
Administrator Guide.
The following cmdlet sets the URL that the Autodiscover Web Service will return
to Exchange:
To see what is already configured for the Autodiscover Web Service, enter:
Get-CmnAutodiscoverConfig
52
Configuring the FBC EWS
The FBC EWS communicates with the Quest CMN Domino Free/Busy Connector
Service to retrieve free/busy information for Domino Users.
Set-CmnAvailabilityConfig -HostName
DominoFreeBusyHost.company.com -PortNumer 8900
To retrieve the current settings for the service, enter the following cmdlet:
• Get-CmnAvailabilityConfig.
53
Quest Coexistence Manager for Notes - Free/Busy Connector
Set-CmnDominoFreeBusyConfig -DominoServerName
CompanyDominoServer.company.com -DominoPassword
$securePassword -DominoUserFetchIntervalInMinutes 20
-DominoUserSmtpDomains DominoSmtpDomain.company.com
-ListeningPort 9800 -FreeBusyCacheTimeoutInMinutes 10
54
Configuring the Exchange Server
Component
The Exchange Server component is the Quest CMN Exchange Free/Busy
Connector service, which retrieves free/busy information from Exchange and
returns it back to the CMN Domino Server Task (QCALCON).
The CMN Exchange Free/Busy Connector Service requires the Exchange Web
Services (EWS) URL for your Client Access Server (CAS). This URL is formatted
as the following:
https://<exchangeservername>/EWS/Exchange.asmx
If you do not know the name of the CAS server to use, or you are using a hosted
Exchange server, you can use the Get-CmnExchangeWebServicesUrl cmdlet to
retrieve the EWS Url.
After running the cmdlet, the $ewsUrl contains the Exchange Web Services URL.
You can use this variable in the Set-CmnExchangeFreeBusyConfig and
Get-CmnExchangeFreeBusy cmdlets, as required in the procedure below.
2. Type:
Set-CmnExchangeFreeBusyConfig [-EwsUrl <String>]
[-ShowTentativeAsBusy <String>][-ListeningPort <UInt32>
[-FreeBusyCacheTimeoutInMinutes <UInt32>] [-Credentials
<PSCredential>] [<CommonParameters>]
... where:
55
Quest Coexistence Manager for Notes - Free/Busy Connector
C:\PS> $mainEnabledDomainUserCredentials
Where:
• ConfigPath is the UNC path to QCalCon.exe.config if it is not installed
locally
56
• ForeignDomainName is the SMTP Domain for the Foreign Domain
Name
• HostName is the TCP host where the Quest CMN Exchange Free/Busy
Connector Service is installed
• PortNumber is the TCP port used by the Quest CMN Exchange
Free/Busy Connector Service is installed
If you did not install the PowerShell SnapIn on the Domino server, you can
modify it from another computer using the -ConfigPath parameter. This
parameter specifies the UNC Path to QCALCON.exe.config file located in the
Domino server directory.
If a UNC path to this directory does not exist, you can manually edit the
Qcalcon.exe.config file.
57
Quest Coexistence Manager for Notes - Free/Busy Connector
<client>
<endpoint name="CMNFreeBusyServiceEndpoint"
address="net.tcp://<HostName>:<Port number>FreeBusyServiceHostLibrary"
binding="netTcpBinding" bindingConfiguration="CMNFreeBusyClientSettings"
contract="Quest.CMN.FreeBusy.FreeBusyServiceHostLibrary.IFreeBusyContract"/>
</client>
</system.serviceModel>
</configuration>
58
Glossary
C
Coexistence Manager for Notes
A service that provides the important "missing pieces" of
a Notes–Exchange coexistence achieved with the Microsoft
Transporter Suite.
Common Name
The identifying name assigned to a directory object,
typically a container. A common name must be unique
within a context.
D
Domain Name System (DNS)
A hierarchical, distributed database that maps domain
names to various types of data, including IP addresses.
Every node on the Internet is identified by a unique,
numerical IP address of the form 255.255.255.255,
although any particular IP address may be associated with
0, 1 or more domain names. The DNS defines the
associations of domain names to their corresponding IP
addresses.
Domino
The name of the applications and messaging server
program for the Lotus Corporation's Lotus Notes product.
For more information, see www.ibm.com.
F
Free/Busy connector service
A service that allows Exchange users to see the availability
of Domino users, and conversely, allows Domino users to
see the availability of Exchange users.
59
Quest Coexistence Manager for Notes - Free/Busy Connector
L
Lotus Notes
An IBM tool that provides World class e-mail, calendar,
scheduling and collaboration capabilities. For more
information, see
http://www-142.ibm.com/software/products/ca/en/
domino.
N
Notes Migrator for Exchange
A migration tool that converts users from Lotus Notes to
Microsoft Exchange and Exchange Online. It migrates
users’ e-mail, calendars, tasks and personal address
books to the users' new mailboxes on the
Exchange/Exchange Online server.
P
PowerGUI
An extensible graphical administrative console for
managing systems based on Windows PowerShell.
PowerShell
A Windows command-line shell and scripting language
designed specifically for system administrators and built on
top of the Microsoft .NET Framework. For more information,
see www.microsoft.com.
S
Server Certificate
An electronic document which uses a digital signature to
bind together a public key with an identity.
60
INDEX F
FBC EWS (CMN)
configuring with cmdlets 53
A foreign domain troubleshooting 46
Autodiscover web service (CMN) Free/Busy Connector
configuring with cmdlets 52 configuring with PowerGUI 30, 32
Availability web service (CMN) introducing 9
configuring with cmdlets 53 uninstalling 21
B H
Binding, creating 27 hosted exchange 25
C I
certificates 25 introducing Free/Busy Connector 9
configuring
DNS 23 L
Domino Server 33 Lotus Notes component (CMN)
Domino server 29 configuring with cmdlets 53
Domino Server clusters 37 Lotus users cannot see free/busy
Exchange server 28 information
for a large number of users 43
D
deployment of F/B Connector M
subcomponents 14, 18 multi-domain support 36
DNS multiple Domino servers 37
configuring 23
Domino clusters 37 O
Domino components (CMN) Outlook users cannot see free/busy
configuring with cmdlets 56 information
Domino Free/Busy for a large number of users 46
troubleshooting 48 for Domino users 44
Domino Server
configuring 33 P
Domino server PowerGUI 18, 19
configuring 29 opening 29
DominoServer troubleshooting with 48
configuring multiple servers 37
Q
E Quest PowerGUI 18, 19
equivalent domains 36
EWS (CMN) R
configuring with cmdlets 53 recommended deployment of F/B
Exchange Free/Busy Connector
troubleshooting 47 subcomponents 14, 18
Exchange server
configuring 28 S
Exchange server component (CMN) subcomponents of F/B Connector,
configuring with cmdlets 55 deployment of 14, 18
SupportLink 63
knowledgebase 50
61
Quest Coexistence Manager for Notes - Free/Busy Connector
T
troubleshooting 41
Domino free/busy 48
Exchange free/busy 47
foreign domain 46
free/busy for Domino users 49
free/busy for Exchange users 49
Lotus users cannot see Free/Busy
for a large number of users 43
Outlook users cannot see
Free/Busy for a large number of
users 46
Outlook users cannot see
Free/Busy for Domino users 44
SupportLink knowledgebase 50
using PowerGUI 48
web services 48
U
uninstalling Free/Busy Connector 21
62
About Quest Software
Now more than ever, organizations need to work smart and improve efficiency.
Quest Software creates and supports smart systems management
products—helping our customers solve everyday IT challenges faster and easier.
Visit www.quest.com for more information.
Refer to our Web site for regional and international office information.
View the Global Support Guide for a detailed explanation of support programs,
online services, contact information, policies and procedures. The guide is
available at: http://support.quest.com.
63
Quest Coexistence Manager for Notes - Free/Busy Connector
64