With the Zimbra™ Collaboration Suite Connector for Outlook (ZCO), users can use Microsoft
® Outlook
® 2003 and 2007 to access the Zimbra Collaboration Suite server and synchronize data with Outlook for offline use. ZCO is a MAPI service provider that is installed on users’ computers.
Email messages, address books, tasks, personal calendars, and tags are synchronized with the Outlook 2003/2007 client. Zimbra Collaboration Suite server-side configuration for accounts is enforced for Outlook users.
The ZCO .msi file and user instructions can be downloaded from the ZCS administration console, Downloads page. The install program for ZCO is in the Windows Installer .msi format so that it can be easily deployed to individual computers using your group policy software deployment process. Alternately, you can copy the .msi file to a directory that users can access and instruct your users to download the file directly.
When ZCO is installed, the server name, port, and whether to use a secure connection must be set for every user. Users enter this information when they create their profile.
Optionally, administrators can customize the ZCO .msi file, adding the server, port, and connection information to the install script. If the .msi file is customized, end users only need to enter their email address and password.
To modify the .msi file, Zimbra created a Java Script file that runs under the Windows Scripting Host. This file, called
ZmCustomizeMSI.js, can be found in the Zimbra download directory on the administration console.
|
1.
|
Copy the ZmCustomizeMSI.js file and the ZCO .msi file to a computer running the Windows platform.
|
Press Enter and the ZCO .msi file is modified.
The cscript command includes the following:
|
•
|
Whether User Secure Connection should be checked. Enter 1 for the secure connection using a HTTPS connection or enter 0 to use a HTTP connection. (1 | 0)
|
It only takes a few minutes for users to install ZCO on their computers and configure the connection to the Zimbra server. The user’s Zimbra account must be created, but no specific changes are required on the Zimbra server. Installing ZCO creates a mail profile named Zimbra and designates it as the default profile in Outlook.
|
•
|
Whether to check Use Secure Connection (SSL). This box is checked to establish a secure connection to that port.
|
The following describes the installation and configuration steps that are performed on each computer. User instructions can be downloaded from the administration console Download page. Save the user pdf file to a directory that users can access before they install ZCO.
|
•
|
Server Name. This is the Zimbra server domain name (DNS).
|
|
•
|
Server Port. Enter the port number for the server. For non secured connections, the standard port is 80. For secured connection, the standard port is 443. Your configuration can be different.
|
|
5.
|
They click OK and the installation and configuration of ZCO is complete. The Zimbra profile is created.
|
Users can now log on and use Outlook. The first time users work within Outlook’s mail, calendar, tasks, or contacts folders, Outlook automatically syncs with the Zimbra server. If users have been using the Zimbra Web Client and have email messages, tags, address books with contacts, and calendar appointments on the Zimbra server, this information is synchronized with their Zimbra profile in Outlook. The initial synchronization can take a few minutes.
If users create the default Zimbra profile, their synchronized files are saved in the
zimbra.zdb file located in the user’s
Local Settings\Application Data\Microsoft\Outlook folder. In Outlook 2007, this data is stored in the user’s
Application Data\Microsoft\Outlook folder.
If users used Notes and Journal in Outlook, these items will be lost when an initial sync is performed. In order to keep their Notes and Journal entries, users should save these Outlook items in pst format before syncing and then import the pst file after the initial sync is performed.
Note: If you are running McAfee® Security On-Delivery E-mail Scanner feature, the initial sync is very slow. We recommend that this option be turned off for the initial sync with the Zimbra server.
Users can click Tools>Send/Receive>Send/Receive All (shortcut key F9) to update Outlook and the Zimbra server with changes made since the last sync.
ZCO supports relocating a ZDB file, also known as a roaming profile, as well as ZDB file compaction. You must be logged in on the user’s account to configure their ZDB settings. Further instructions for configuring a user’s ZDB settings are in the How to Install and Use Zimbra Connector for Outlook end user guide.
You can use the same version of the ZCO .msi file to repair the ZCO software on individual computers. When the .msi file is opened after ZCO is installed, it automatically opens with the options to repair the connector or to remove the software.
|
•
|
Repair will reinstall the software again.
|
Removing ZCO does not remove the profile or .zdb files. Users will need to delete these items manually.
|
1.
|
Users must delete the .zdb file.The .zdb file includes all the Outlook data from the Zimbra server. The file is usually in the user’s Local Settings\Application Data\ Microsoft\ Outlook folder. In Outlook 2007, this is in the user’s Application Data\Microsoft\Outlook folder.
|
|
2.
|
Users must delete their Zimbra profile. If users accept the defaults when they installed ZCO, a profile called Zimbra was created. To delete this file:
|
|
b.
|
Click Show Profiles. The General tab lists all the profiles on the computer.
|
|
5.
|
Go to the Control Panel, select Add and Remove Programs and remove the ZCS Connector for Outlook program.
|
If the Outlook client is not synchronizing with the Zimbra server or if Outlook is not working correctly, several options are available to troubleshoot the problem:
When ZCO is installed, a Sync Issues folder with subfolders is created in the user’s Folder List. If errors are found when Outlook with the Zimbra server, messages with attachments are automatically added to these folders. Users can tell when messages are in these folders if the folder is bold and the number of unread messages is displayed.
If users are having problems using Outlook and continuously receiving errors, the messages in these folders should be forwarded to sync_issues@ zimbra.com. These messages are created to help Zimbra technical support and engineering debug and fix errors.
If users encounter problems when logged on to Outlook, you can have them enable debug logging using the ZCS Connector for Outlook Logging Control. Logging Control should be used for all troubleshooting. Once you have enabled logging and have recreated the issue, you can then send this log to Zimbra Support for analysis.
ZCOLogCtl.exe is installed when ZCO is installed. Logging Control is in the local ID directory, \
Program files\Common Files\System\MSMAPI\1033.
If users encounter problems with synchronization, such as not receiving their mail, system crashes, or other unusual behavior, you should direct users to open Logging Control and select
Enable Logging in order to log internal API calls and communication between Outlook and the Zimbra Server.
Note: Enable Logging should be unchecked to disable logging when not being used for troubleshooting. If logging is on continuously, performance may be affected. Additionally, using options such as
Verbose Logging and
Keep Logging may adversely affect performance and disk space.
|
•
|
HTTP Logging. Enabling HTTP logging will log any HTTP connections.
|
|
•
|
Verbose Logging. Enabling verbose logging will create more detailed logs, but may affect performance.
|
|
•
|
Keep Logging. When you enable this option, ZCO logging saves more than one backup log file. By default, only one backup log file is saved.
|
|
•
|
Log File Path. In this field, you can specify in what directory log files should be saved.
|
|
•
|
Maximum Log File Size. You can indicate the maximum size of a log file. The default log file size is 10 megabytes. When the size of the log reaches the limit, the current log is set aside and a second log is created.
|
After enabling logging from the Logging Control dialog, direct users to restart Outlook. When users restart Outlook, all their activities are logged. Users should attempt to recreate activities that are causing the problems.
Installing the connector does not remove any email accounts. It creates a separate new mail profile, by default called Zimbra, which does not conflict with any existing profiles/accounts. To see existing account profiles, navigate to
Start>ControlPanel>Mail>Show Profiles.
Zimbra Collaboration Suite offers account configuration by Class of Service and by account. When the client uses Outlook, many of the features and options configured for the Zimbra account are not enforced in Outlook. Only restrictions that are controlled by the server are enforced.
When you view an account’s mailbox from the administration console, the view is from the Zimbra Web Client and may not contain files in Outlook that have not been synchronized.
|
•
|
If the Maximum size of an uploaded file (KB) field is set to 0 in the ZCS Global Settings>MTA tab, messages sent through Outlook cannot be delivered.
|
Copyright © 2007 Zimbra Inc.
