Zimbra Connector for Microsoft Outlook Administrator's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Zimbra Connector for Microsoft Outlook Administrator’s Guide ZCO 7.2 April 2012 Legal Notices Copyright ©2005-2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware and Zimbra are registered trademarks or trademarks of VMware, Inc. in the United States and/ or other jurisdiction. All other marks and names mentioned herein may be trademarks of their respective companies. VMware, Inc. 3401 Hillview Avenue Palo Alto, California 94304 USA www.zimbra.com Zimbra Connector for Microsoft Outlook 7.2 April 2012 Table of Contents 1 About ZCO . 5 ZCO Overview . 5 ZCS and Client Requirements . 5 ZCO Configuration Files . 6 Downloading ZCO Installation and Customization Files . 6 2 Preconfiguring and Customizing the Installer . 7 Customizing ZCO . 7 Optional Customization of ZCO . 8 Set the Password Rule. 8 Modify the GAL Sync Mode . 8 Set the Interval for the Automatic Sync to GAL . 9 Create Sync Failure Message . 9 Setting Up the Single Sign-On Option (SSO) . 9 Disabling the Auto-Upgrade Feature . 9 Rebranding ZCO . 9 3 Installing ZCO . 11 Installation Prerequisites . 11 Installing ZCO on Individual Computers . 11 Initial ZCO Synchronization with Outlook . 12 Migrate ZDB Profiles . 12 4 Zimbra Features in Outlook . 15 Personal Email Certificates (S/MIME) . 16 Advanced Settings . 16 Zimbra Feature Differences for Outlook Users . 16 Outlook AutoArchive Disabled for Zimbra Profiles and Folders . 17 5 Troubleshooting ZCO . 19 Common Troubleshooting Issues . 19 Received a Local/Server Failure Notice . 19 Outlook Crashed . 20 My Zimbra Calendar will not Sync . 20 Unable to Access a Shared Item . 20 The .zdb File is Corrupt . 20 Repairing ZCO . 21 Restoring ZCO . 21 Removing ZCO . 21 Resolving Mailbox Sync Problems . 21 Reviewing Sync Issues folders. 22 Enable Logging for Troubleshooting . 22 Zimbra Support Toolbar . 23 View MAPI Properties . 23 Open Original Source. 23 VMware Zimbra Collaboration Server ZCO 7.2 iii Zimbra Connector for Microsoft Outlook Administrator’s Guide View IDs of Zimbra Activities . 23 Set Sync Token . 23 Zimbra Support and Additional Resources . 24 Additional Resources . 24 Contact Zimbra Support . 24 iv ZCO 7.2 VMware Zimbra Collaboration Server 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. Topics in this chapter include: ZCO Overview ZCS and Client Requirements ZCO Configuration Files Downloading ZCO Installation and Customization Files ZCO Overview With ZCO, users can use Microsoft Outlook 2003, 2007, and 2010 (32 bit and 64 bit) to access the VMware Zimbra Collaboration Server (ZCS) and synchronize data with Outlook. Email messages, folders, tags, contacts, personal distribution lists, personal calendars, appointment reminders, and tasks are synchronized with the Outlook client. The ZCS server-side configuration for accounts is enforced for Outlook users. ZCS and Client Requirements Servers must be running ZCS 7.2 or later. Outlook 2003: Client computers must have Microsoft Office Outlook 2003 SP3 or later installed. Outlook 2007: Client computers must have Microsoft Office Outlook 2007 SP2 or later installed. Outlook 2010: 32-bit and 64-bit editions of Microsoft Office are supported. Note: “Click to run” versions of Outlook 2010 are not supported. VMware Zimbra Collaboration Server ZCO 7.2 5 Zimbra Connector for Microsoft Outlook Administrator’s Guide ZCO Configuration Files There are three different files, including the installation and customization files, that can be configured to make the user’s deployment of ZCO quick and easy. Zimbra Connector for Outlook: Users deploy this file (either 32bits or 64bits) on their computer to install ZCO. Zimbra Connector for Outlook MSI Customizer: Used to customize the ZCO .msi file to add basic server information the user needs to install ZCO on their computer. Other variables such as setting up single sign-on and password rules can also be configured. Zimbra Connector for Outlook Branding MSI: Used to customize the ZCO .msi file to replace all instances of the Zimbra product name and logo. Downloading ZCO Installation and Customization Files The ZCO installation and customization files are accessible from the ZCS administration console. 1. From the ZCS administration console, click the Downloads link. 2. Select the ZCO download file appropriate for your version of Outlook. 3. Download the .msi file and user instructions so that you can easily deploy these files to your users. 4. You can copy the .msi file to a directory or URL that users can access and then instruct users how to download the file, or you can use group deployment software. Note: Users must have temporary administrator privileges on their computer to install ZCO. 6 ZCO 7.2 VMware Zimbra Collaboration Server 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.js file which is located in the Zimbra download directory on the administration console. Areas that can be customized include: Configuring the ZCS server name and secure connection options. When users install ZCO they only need to enter their account name and password Single Sign-on options when SPENEGO is configured for ZCS Password rules GAL sync mode Default profile name Disabling automatic upgrading to the latest ZCO version Changing the Zimbra branding to your own brand Note: To see a complete list of customization options, type ZmCustomizeMsi at the command line prompt and press Enter. Customizing ZCO 1. From the administration console, copy the ZmCustomizeMsi.js file and the ZCO .msi file to a computer running the Windows platform. 2. Open the Windows command prompt. 3. Change to the directory where the ZmCustomizeMsi.js file is located. 4. Type the server configuration command all on one line: cscript ZmCustomizeMsi.js <path/msi-filename> -sn <servername.com> -sp <port> - ssl <1 | 0> //nologo VMware Zimbra Collaboration Server ZCO 7.2 7 Zimbra Connector for Microsoft Outlook Administrator’s Guide 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 in the .msi file. port Port number to be configured. For non-secured connections, the default is 80. For a secured connection, the default is 443. Your configuration can be different. 1 | 0 Enter 1 for a secure connection using HTTPS, or enter 0 to use a HTTP connection. 5. Press Enter. The ZCO .msi file is modified. 6. To verify that the modification is correct, run the .msi installer and create a dummy profile. The Zimbra Server Configuration Settings dialog should include the server name, server port, and the check box marked/unmarked for whether to use a secure connection. 7. You can optionally change the .msi file, as described in Optional Customization of ZCO and Rebranding ZCO. You can now deploy the customized ZCO .msi file to users. To install ZCO, users must have administrator privileges on their computer. Optional Customization of ZCO You can make optional changes to the .msi file to add or modify the following functionality: Set the Password Rule 1. To set the password rule, enter as -pw <1|0> Setting the password rule to 0 allows for the single sign-on (SSO) authentication option is used and the password is not saved. When the password rule is set to 1, the ZCO encrypted password is saved in the user’s ZCO profile (default). Modify the GAL Sync Mode 1. To set GAL sync mode, enter as -gsm <2|1|0> 2. Enter 2 to disable GAL sync; 1 to make GAL sync a manual option only, 0 for GAL syncs to occur automatically every x days. The interval is controlled by the -gsr switch. The default is every 30 days. 8 ZCO 7.2 VMware Zimbra Collaboration Server Preconfiguring and Customizing the Installer Set the Interval for the Automatic Sync to GAL 1. To set how often to resync the GAL in days, enter as -gsr <interval> 2. To set the delta GAL sync in minutes, enter as -gsd <interval> The sync consists of a full sync and interval syncs. 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. The server name used in the ZCO profile must match that in the SPNEGO configuration. Make sure that the server name is incorporated into the .msi file prior to installation of ZCO. Set the server name to be the server name configured for SPNEGO, enter -sn <server.example.com> Set the password rule, enter -pw 0 Example: cscript ZmCustomizeMsi.js ZimbraOlkConnector.msi -sn server.example.com -pw 0 For more information, see Appendix B, Configuring SPNEGO Single Sign-On for ZCS in the VMware Zimbra Collaboration Server Administrator’s Guide. Disabling the Auto-Upgrade Feature When a user launches Outlook, ZCO checks ZCS for a newer version of ZCO. If a newer version is available, the user is prompted with the option to upgrade.