Zimbra Connector for Microsoft Outlook Administrator’s Guide ZCS 8.
Legal Notices Copyright ©2005-2013 Telligent Systems, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. “Telligent” and “Zimbra” are registered trademarks or trademarks of Telligent Systems, Inc. in the United States and other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Telligent Systems, Inc. d/b/a Zimbra Software, LLC www.zimbra.com ZCS 8.
Table of Contents 1 About ZCO ................................................5 Use ZCO with the Correct Version of ZCS . . . . . . . . . . . . . . . . . . . . . . . 5 Supported Versions of Microsoft Operating System . . . . . . . . . . . . . . . . 5 Supported Versions of Microsoft Outlook . . . . . . . . . . . . . . . . . . . . . . . . 5 ZCO Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Downloading ZCO Installation and Customization Files . . . . . . .
Zimbra Connector for Microsoft Outlook - Administrator’s Guide View MAPI Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Open Original Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 View IDs of Zimbra Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Set Sync Token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Zimbra Support and Additional Resources . . . . . . . . . . . . . .
1 About ZCO This chapter includes information about prerequisites for installing Zimbra Connector for Microsoft® Outlook® (ZCO) and how to download the ZCO installation file. With ZCO, users can use Microsoft Outlook and synchronize data such as email messages, folders, tags, contacts, personal calendars, appointment reminders, and tasks with the Outlook client. The ZCS server-side configuration for accounts is enforced for Outlook users.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide Outlook 2013: 32-bit and 64-bit editions of Microsoft Office are supported. Outlook 2010: 32-bit and 64-bit editions of Microsoft Office are supported. Note: “Click to run” versions of Outlook 2010 are not supported. Outlook 2007: Client computers must have Microsoft Office Outlook 2007 SP2 or later installed. Outlook 2003: Client computers must have Microsoft Office Outlook 2003 SP3 or later installed.
2 Preconfiguring and Customizing the Installer When ZCO is installed, the information needed to complete the installation is the ZCS server name and whether to use a secure connection. Users enter server information when they install ZCO and create their default profile. This chapter includes information about how to preconfigure and customize the ZCO .msi installation file. To customize the installer with your specific configuration details, you modify the ZmCustomizeMsi.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide 4. Type the server configuration command all on one line: cscript ZmCustomizeMsi.js -sn -sp -ssl <1 | 0> //nologo Command Description ZmCustomizeMsi.js Name of the js file path/msi-filename Directory path and the ZCO .msi filename. servername.com Zimbra server domain name (DNS) to be configured. port Port number to be configured. For non-secured connections, the default is 80.
Preconfiguring and Customizing the Installer Create Sync Failure Message 1. To create sync failure message in the sync folder and/or the Inbox folder, enter as -ifo <1|0> Use 1 to create sync failure messages only in the Sync Issues folders. Use 0 to create the sync failure messages in the Sync Issues folders and in the user’s Inbox. Setting Up the Single Sign-On Option (SSO) Note: To use SSO, SPNEGO must be configured on ZCS. SSO works with a specific server.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide Hiding GAL Aliases An email alias is an email address that redirects all mail to a specified mail account. If an address has an alias, by default the alias is shown as a separate entry when the GAL contents are displayed in Outlook. If you do not want aliases to appear in the GAL, you can disable this option. Modify the ZmCustomizeMsi.js file before installation and select the --galsync-disablealiases 1 option.
Preconfiguring and Customizing the Installer DocumentLink The Click here for documentation link on the ZCO About dialog. This normally links to a Zimbra PDF document but can be redirected to your own web documents. (maximum of 260 characters) 4. Run this script on the ZCO .msi file that users will use to install ZCO: cscript ZimbraBrandMsi.vbs ZimbraOlkConnector.msi If ZCO has been previously installed on the target machine, uninstall ZCO before running the newly branded installation.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide 12 ZCO 8.
3 Installing ZCO This chapter provides information about what server configuration information the user needs to install ZCO, what takes place when ZCO is installed on individual computers, and what happens during the initial synchronization of ZCO and Outlook. Note: Examples in this guide refer to Outlook 2007. In Outlook 2010, equivalent ZCO features are accessed from the Zimbra ribbon.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide Panel>Mail>Show Profiles. Mail profiles can combine a Zimbra account with an IMAP, Exchange, or POP account. To add a new profile, users select Add on the Show Profiles dialog and follow the prompts. Note: Users cannot add more than one Zimbra account to a profile. Users can customize the name of the profile created during the installation using the “profile name” customization option available from the installation file.
Installing ZCO For more information about ZCO synchronization, see the Zimbra Connector for Microsoft Outlook User Guide. Migrate ZDB Profiles ZCO supports relocating a ZDB file, ZDB file compaction, and migration of ZDB profiles. You can migrate ZDB profiles, including user files and settings, from one machine to another. To compact roaming profiles and ZDB files, you must be logged in to the user’s account to configure the ZDB settings.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide 16 ZCO 8.
4 Zimbra Features in Outlook Zimbra features have been incorporated into Outlook menus. The ZCO User Guide, which is available from the ZCO About page describes these features, which include Feature Location in Outlook Zimbra Personas Available in Outlook under Tools > Options > Personas. Zimbra Mail Filters Available in Outlook under Tools > Zimbra Server Rules. Out-of-Office Reply Available in Outlook under Tools > Zimbra Out of Office Assistant.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide Feature Description Connection Timeouts. Configure HTTP connection settings. The default settings for connect, send, receive and option/receive are 900000 milliseconds, or 15 minutes. These settings are configurable. GAL Sync Optimizations Set GAL sync time, including sleep time, and sleep after.
Zimbra Features in Outlook Users can configure their own Outlook preferences. These are not synchronized with the Zimbra server. Free/Busy Lookup in ZCO If the ZCS server CA certificate is self-signed, free/busy lookup in Outlook fails with the error "An error occurred reading Internet free/busy data. General failure." To fix this issue, add the CA certificate to Internet Explorer's Trusted Root Certification Authorities.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide 20 ZCO 8.
5 Troubleshooting ZCO Note: Disable logging when not being used for troubleshooting. If logging is on continuously, performance might be affected.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide based on the message, submit the messages with a support case to Zimbra Support. When ZCO is installed, a Sync Issues folder with subfolders are created in the user’s Outlook Folder List. Copies of the Local/Server Failure messages is saved to the Sync Issues folder. Users can tell when new messages are in a folder when the folder is bold and the number of unread messages is displayed beside the folder name.
Troubleshooting ZCO a. Locate the scanpst.exe tool in Windows (Start>Search>For files or folders). b. Type the path and the filename of the personal folders (PST or ZDB) file, or click Browse to locate the file by using the Windows file system. c. Click Start. Repairing ZCO 1. Locate the ZCO .msi used to install ZCO and download the file to your computer. 2. Click the file to open. Note: To find out which version of ZCO is installed, open Outlook and go to Help>About Zimbra Connector for Outlook.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide In some cases, it might be necessary to uninstall the .msi file, delete the profile and .zdb, and start over. Reviewing Sync Issues folders When ZCO is installed, a Sync Issues folder with subfolders is created in the user’s Outlook Folder List. If errors are found when Outlook syncs with the server, a sync failure notification is sent to both the user’s Inbox and the Sync Issues folder.
Troubleshooting ZCO To resolve some problems, it might be necessary to configure the types of event logged by clicking Advanced Log Settings. Zimbra Support will advise if this is necessary. Zimbra Support Toolbar When ZCO is installed, the Zimbra Support Toolbar is added to the Outlook Views list. If users are having issues with specific emails or folders, you can use this toolbar to collect information to help debug the issue. To display the Zimbra Support Toolbar, select View>Toolbars>Zimbra Support.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide To resync an item and update the user’s Outlook client with the most information, the Sync Token must be set to before the request that failed. Note: In some cases, sync failures might not be resolved unless the Sync Token number is set back several tokens before the failed sync. To set the sync token and attempt to resync an item that failed to sync, click Set Sync Token in the Zimbra Support Toolbar. The Update Sync Token dialog opens.
Troubleshooting ZCO msiexec /i ZimbraOlkConnector-5.0.6_GA_2314_5.0.2635.6.msi /lv case00012345-zco-install.log Sync error messages. If users are experiencing issues with syncing, include any relevant error messages. You can find sync error messages in the Local Failures and Server Failures folders, located in the Sync Issues mail folder. For more information about the Sync Issues folder, see Reviewing Sync Issues folders on page 24. Core files.
Zimbra Connector for Microsoft Outlook - Administrator’s Guide 28 ZCO 8.