Ajcody-Client-Topics: Difference between revisions

Line 34: Line 34:

==Section 508 And Accessibility==
==Section 508 And Accessibility==
* [http://www.vmware.com/files/pdf/vpat/Zimbra_VPAT.pdf VMware Collaboration Product VPATs For Zimbra]

About section 508 and Accessibility:
About section 508 and Accessibility:

Revision as of 07:28, 27 March 2011

Attention.png - This article is NOT official Zimbra documentation. It is a user contribution and may include unsupported customizations, references, suggestions, or information.

Client Topics

Actual Client Topics Homepage

Please see Ajcody-Client-Topics

Official End User Guides And How-To's

Please see the following:



Small Screen Resolution Issues - 800x600

Please see the following:

Section 508 And Accessibility


About section 508 and Accessibility:

Various Zimbra RFE's related to topic:

Zimbra Web Client

Conversation Views

Here's an RFE I made you might want to check out:

Read & Delivery Confirmation Receipt

Please see RFE:

Web Client Search

The webclient offers a powerful search tool, the problem is knowing how to use it.

Please see this to learn the proper syntax's to get your searches right:

[Web Client Search - Power tip]

[Search Tips]

Is some particular state [ unread, read, flagged, unflagged, sent, draft, received, replied, unreplied, forwarded, unforwarded, anywhere [show messages anywhere], local, sent, solo [haven't replied, without a conversation] ]:


In A Folder (Inbox):


Unread and in Inbox:

In:Inbox is:uread

To someone:


From someone:


CC'd reference:


Subject reference:


Has something [attachment , phone , url]


A particular 'something':


Size of mesage [{larger,smaller} : ## "b","kb","mb"]


By tag:


Email To Attachment Or Saved To Desktop

Send Email As Attachment

You can do a "forward" on an email and then in the new window, select "Options". This drop down will give you the options to "Include Orginal As Attachment".

Attachments Saved To Desktop And Other Options

Some RFE's are more expansive functionality:

A non-support zimlet that could be used:

General CALDAV Issues

Only Seeing 1 Month Back and 1 Year Ahead In CalDAV

Please see this bug:


Lightning & Thunderbird

News Bugs/RFE's To Track That Might Update Situation As Described Below

Lightning does not support Caldav + Free/Busy

Free/Busy support is only available for the Sun Cal Server.

Maybe we could "fake" this out within our Ldap configuration. Like RFE for Apple OD:


Address/username lookup doesn't occur within a new appointment

Unfortunately, I've not figured a way around this at this time.

Zimbra CalDav doesn't allow user to dismiss alarms from lightning

Please see bug from Mozilla:


Ajcody Apple Mac Issues

   KB 2495        Last updated on 2011-03-27  

(0 votes)
24px ‎  - This is Zeta Alliance Certified Documentation. The content has been tested by the Community.

Actual Apple/Mac Issues Homepage

Please see Ajcody-Apple-Mac-Issues

App To Help Enable Debugging Options

You might want to check out this app:

Outlook 2011 For Mac And EWS Setup

Follow these steps to set up Outlook to sync using Exchange Web Services:

  • Open Outlook.
  • Open the Outlook menu and select Preferences.
  • Click the Accounts icon under the Person Settings section.
  • Click the Exchange icon which will open a new window.
  • Enter your email address in the E-mail address field.
  • Set the Method to "User Name and Password."
  • Enter your full email address (e.g. user@example.com) as the username.
  • Enter your password in the password field.
  • Uncheck the "Configure automatically" check-box.
  • In the Server field, enter Zimbra Collaboration Server's hostname - (e.g. mail.example.com)
  • Click Add Account.

Note, if you end up customizing the other elements be aware of the following:

  • ZimbraEWS uses BASIC Auth for validating the user request.

With Screenshots

Please see Ajcody-Outlook_2011_For_Mac_And_EWS_Setup#Outlook_2011_For_Mac_And_EWS_Setup_With_Screenshots

Contact Related Items

EWS Configuration And ZCS 8.5+

Example is from OS X 10.9.5 . The ZCS server must be licensed for EWS and your account needs to have the EWS feature enabled. This can be enabled in the admin console either checking the box for EWS under Features in the COS that is set for the account or under the individuals user configuration for Features. It can also be set on the CLI - zimbraFeatureEwsEnabled TRUE [COS or user].

Note - ZCS 8.5 targeted EWS support ONLY with Outlook for Mac's. There was no testing or expectation that the native mac apps would work with the EWS configuration type.

  • Launch Contacts.app
  • Click on "Contacts" from the menu screen at the top of your screen.
  • Select "Add Account.."
  • Select "Exchange" and then "Continue"
  • Name : your full name
  • Email Address : user@domain
  • Password : your password
  • Once filled out, click "Continue" . You'll need move onto another configuration screen.
  • Description : I would recommend filling this out to avoid any confusion from other accounts you might setup.
  • Server Address : the FQDN/hostname of your ZCS server. You can also use an ip address here.
  • Once filled out, click "Continue" .
  • You should now see a summary of your configuration, click "Continue".
  • You'll now be asked to select what apps to use, your choices will be:
    • Mail
    • Contacts
    • Calendar
    • Notes
    • Reminders
  • Once you've checked the ones you want, click "Done".

This will create two resources within Contacts.app. You'll see a header called "Exchange" with your account contact folders under it [ZCS defaults will be - Contacts, Emailed Contacts] and also a line that says "All Exchange". There will also be a section now called "Directories", listed under it will be "All Directories" and "Exchange Global Address List".

Verify Certificate Prompts

If the ZCS server isn't using commericial certificates, you'll end up getting a pop up window on your Mac called "Verify Certificate". To get rid of this pop up window, you'll want to do the following.

Click on the "Show Certificate" button. You'll then have an option to check a box for "Always trust ....". Then click on the "Continue" button.

Log Event Showing EWS

Possible log files to check for in /opt/zimbra/log/ are below with some examples from my logging into Contacts.App and creating a new contact. You can increase the logging details if needed , please see Using_log4j_to_Configure_mailboxd_Logging#Predefined_log4j_Categories_in_ZCS  :

  • access_log.[date] -  -  [10/Oct/2014:16:01:30 +0000] "POST /EWS/Exchange.asmx HTTP/1.1" 200 907 "-" "Mac OS X/10.9.5 (13F34); 
  ExchangeWebServices/4.0 (193); Contacts/8.0 (1371.2)" 16 -  -  [10/Oct/2014:16:05:55 +0000] "GET /home/user1@mail2.zimbra.DOMAIN.com/Contacts?fmt=cf&t=2&all=all 
  HTTP/1.1" 200 - "" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) 
  Chrome/37.0.2062.124 Safari/537.36" 42 -  -  [10/Oct/2014:16:28:11 +0000] "POST /EWS/Exchange.asmx HTTP/1.1" 401 0 "-" "Mac OS X/10.9.5 (13F34); 
  ExchangeWebServices/4.0 (193); Contacts/8.0 (1371.2)" 7
  • audit.log
2014-10-10 12:01:28,976 INFO  [qtp509886383-107:] [] security - cmd=Auth; 
  account=user1@mail2.zimbra.DOMAIN.com; protocol=zsync;
2014-10-10 12:05:50,227 INFO  [qtp509886383-113:] 
  [name=user1@mail2.zimbra.DOMAIN.com;oip=;ua=zclient/8.5.0_GA_3042;] security - cmd=Auth; 
  account=user1@mail2.zimbra.DOMAIN.com; protocol=soap;
  • ews.log
2014-10-10 12:28:11,361 INFO  [qtp509886383-117:]
   [] ews - Start syncFolderHierarchy
2014-10-10 12:28:11,371 INFO  [qtp509886383-117:] 
  [] ews - User: user1 has been successfully authorized.
2014-10-10 12:28:11,371 INFO  [qtp509886383-117:]
  ews - The account: 7277b33a-c7ee-4b03-bb4b-f24814c7cea3is true
2014-10-10 12:28:11,371 INFO  [qtp509886383-117:] 
  ews - Folder Id was not provided with request, defaulting to 1
2014-10-10 12:28:11,427 INFO  [qtp509886383-117:] 
  ews - End syncFolderHierarchy
2014-10-10 12:28:11,449 INFO  [qtp509886383-118:] [] 
  ews - Start createItem version 1.0.01
2014-10-10 12:28:11,450 INFO  [qtp509886383-118:] [] 
  ews - Start: createItem
2014-10-10 12:28:11,457 INFO  [qtp509886383-118:] [] 
  ews - User: user1 has been successfully authorized.
2014-10-10 12:28:11,457 INFO  [qtp509886383-118:] 
  ews - The account: 7277b33a-c7ee-4b03-bb4b-f24814c7cea3is true
2014-10-10 12:28:11,580 INFO  [qtp509886383-118:] 
  ews - End:  createItem
2014-10-10 12:28:11,580 INFO  [qtp509886383-118:] 
  ews - End createItem
  • mailbox.log
2014-10-10 12:28:11,522 INFO  [qtp509886383-118:] 
  [name=user1@mail2.zimbra.DOMAIN.com;ip=;ua=MacOSX/(F)ExchangeWebServices/()Contacts/();] mailop - 
  adding contact test2@domain.com: id=269, folderId=7, folderName=Contacts.
  • trace_log.[date]
12:28:11.323:qtp509886383-117: REQUEST POST null; 
  Mac OS X/10.9.5 (13F34); ExchangeWebServices/4.0 (193); Contacts/8.0 (1371.2)
12:28:11.330:qtp509886383-117: RESPONSE 401 text/xml; charset=UTF-8
12:28:11.354:qtp509886383-117: REQUEST POST null; 
  Mac OS X/10.9.5 (13F34); ExchangeWebServices/4.0 (193); Contacts/8.0 (1371.2)
12:28:11.429:qtp509886383-117: RESPONSE 200 text/xml; charset=UTF-8
12:28:11.446:qtp509886383-118: REQUEST POST null; 
  Mac OS X/10.9.5 (13F34); ExchangeWebServices/4.0 (193); Contacts/8.0 (1371.2)
12:28:11.581:qtp509886383-118: RESPONSE 200 text/xml; charset=UTF-8


Logging-Debug for Addressbook

First shutdown Addressbook app.

Launch terminal app.

defaults write com.apple.addressbook ABShowDebugMenu -bool true

Turn it off by just reversing it:

defaults write com.apple.addressbook ABShowDebugMenu -bool false


Contact Groups
10.6 - Snow Leopard Notes
Basic Setup Notes

Some notes I have against testing CardDAV I shared on a case. The following was done with CardDAV [OSX 10.6.4] & Addressbook [Version 5.0.2 (870)] .

Primary references I found related to :

To setup, launch Addressbook.

  • Addressbook > Preferences
    • Accounts > click on + sign to add new account
      • Account type = CardDav
      • User Name = user
        • bug/rfe's mentions the use of user@domain vs. just user will most likely cause Addressbook to attempt a DNS SRV record lookup.
      • Password = accounts password
      • Server Address = http://servername:80 or https://servername:443
        • might need to adjust that for proxy setup or if you have load balancers/F5's/etc..
Additional Details And Troubleshooting Steps - Proxy Issues Most Likely

I was able to get my carddav account to work using my virtual hostname that points to my two servers that run ldap/proxy/mta . I have them setup in DNS as well.

$ host rr608.zimbra.DOMAIN.com
rr608.zimbra.DOMAIN.com has address
rr608.zimbra.DOMAIN.com has address
rr608.zimbra.DOMAIN.com mail is handled by 10 rr608.zimbra.DOMAIN.com.

One thing I did hit though, was the way OSX handles it's odd resolution stuff. For example, initially it failed when I had just modified the /etc/resolv.conf to use my internal DNS. Doing :

host rr608.zimbra.DOMAIN.com

resolved properly but doing:

ping rr608.zimbra.DOMAIN.com

was resolved to the external ip and was being hampered by my firewall. Once host and ping were resolving correctly, the carddav account work.

The whole reason I mention this is that I think we should walk our way back from the mailstore hostname in the configuration.

First, setup a carddav account using the mailstore name and confirm it works and then close/exit the Address Book. Then do the following. In a terminal, be in the users home directory and cd to this subdirectory - for example:

$ pwd
/Users/[username]/Library/Application Support/AddressBook/Sources/

Do a ls there and find the most recent directory that was made and cd into it, for example:

$ ls -latr
total 0
drwx------  7 ajcody  staff  238 Nov 17 06:50 000C3E7F-3DE5-40C8-8820-AF96214D6AF0
drwx------  4 ajcody  staff  136 Nov 17 06:58 .
drwx------  6 ajcody  staff  204 Nov 17 07:07 56892F5B-9F55-437E-9890-A8489A63EDAA
drwx------@ 8 ajcody  staff  272 Nov 17 07:07 ..
Adams-MacBook-Pro:Sources username$ cd 56892F5B-9F55-437E-9890-A8489A63EDAA/
Adams-MacBook-Pro:56892F5B-9F55-437E-9890-A8489A63EDAA username$ ls
AddressBook-v22.abcddb        Configuration.plist        Metadata                SyncLockFile

We can now manually edit the Configuration.plist file with various test hostnames/ip addresses.

The two keys we're interested in will be like this:



What I'd like you to attempt is adjusting the line for the servername using a hostname/ip address that will bypass the F5 if possible. You'll modify the file and save it. Launch Address Book and confirm/deny if the new hostname/ip address works.

  1. Use a static ip address of one of the zcs proxy servers. Please confirm it is pingable from the machine first.
  2. Use the hostname of the actual host of the same proxy server.

I'm assuming you can't use [your mailstore hostname] without going first to the F5, if the test above work you might want to setup a test BIND server you could use with the mac machine to resolve the [your mailstore hostname] using the various hostnames/ip's of the zcs proxy servers.

Use LDAP directory from ZCS for Mac Addressbook / Mail.App / iCal for Mac 10.4

Setting Up LDAP With Authentication - ZCS 8+

As an example, you would fill out the setup fields in the client to be like :

Username: uid=joe,ou=people,dc=abccompany,dc=com password: _zimbra_password_ Authentication Type: simple

Changing uid=joe to match the users email address [joe@abccompany] . You would also adjust the dc=abccompany above to match the users domain name in their email address.

To see and test what type of returns this setup will give, you can do the following from the ZCS server's CLI:

ldapsearch -x -H ldap://ldap.abccompany.com:389 -D uid=joe,ou=people,dc=abccompany,dc=com -w supp0rt -LLL -b 'ou=people,dc=abccompany,dc=com'

You would adjust the uid= , dc= , strings to match the user@domain for the user and also adjust "-w supp0rt" to be the user's password.

Older Reference Prior To ZCS 8

This is generally for those that aren't using Z-iSync.

First, test on shell that you have ldap connectivity.

ldapsearch -x -H ldap://ZCSserver-name:389 "uid=ajcody"

That returned successfully.

Then Addressbook Preferences

LDAP  + (for new)
Name: anything really
Server: ip/hostname that was used successfully in the ldapsearch string
Search Base:  [leave blank]
Port: 389
Scope: Subtree
No auth needed
* Save

I have no idea what the "Auto Update LDAP Cards" does.

Then setup Mail.App for IMAP to the Zimbra server. Check preferences to use LDAP - it will use the Address Book configuration that you did prior and it should auto-resolve to a username when you do a new message.

iCal will only use address that are in the LOCAL addressbook when you use the attendee field for a new event.

One way around this is to do a wildcard search in the Addressbook and drag those items to the local addressbook.

Goto to Address Book, selected Directories my ldap server and put in the below for the search field:


This search result can then be dragged to the "All" folder in the Group column. It creates a "Last Import" item in the Group column now - it might warn about updating entries that all ready match.

Entourage And Calendars

Can't Sync Calendars Between Entourage and Zimbra

Bug/RFE filed to correct current public documents on issue:

Bug/RFE filed to include comment in Release Notes:

Summary of the situation:

Update [05/2010] : Many of the bugs/rfe's filed against iSync will now reference this:

We are EOL'ing support for iSync in ZCS 7.0. See bug 42448 for more details,
but support of CalDav and CardDav with MacOSX 1.6+ for ZSC 6.0.x+ will be the
solution going forward.

  • MacOS 10.4
    • MacOS 10.4 still has the iSync/Entourage integration. Entourage integration worked via iSync rather than CalDAV (10.4 can't use CalDAV, only iSync). It would create a local calendar called Entourage within iCal and then the iSync service (via Zimbra Connector) would post updates to the users Zimbra calendar called Calendar (the default). I believe it would also check the box in Entourage under Preferences > Sync Services > Synchronize events and tasks with iCal and .Mac
  • MacOS 10.5
  • Forum thread
For The Stubborn - Getting Old Z-iSync Connector

Please don't kill the messenger, I'm putting this up here for those that are desperate and would rather deal with the iSync bugs on their own versus moving to the iCal + CalDAV supported option. Don't expect support for this configuration. There's an internal discussion about making the latest connector available directly - I'll update this page depending on the outcome. Until that discussion is resolved, I don't feel comfortable posting the individual connector by itself.

Grab the 5.0.5 tar ball from here:


The connectors are in the zimbra-store*.rpm , you'll find it in the packages directory once you untar the zimbra tarball.

Copy this over to temp. Find the path of the file. Extract it.

mkdir /tmp/isync
cp packages/zimbra-store*.rpm /tmp/isync/
cd /tmp/isync
rpm2cpio zimbra-store*.rpm | cpio -iv --make-directories `rpm2cpio zimbra-store*.rpm | cpio -t | grep -i zimbra-isync`

You'll see the new directories and within them you'll see the dmg file for the connector.

iCal General Issues

Clearing iCal cache

Make and run script:

rm -rf ~/Library/Application\ Support/SyncServices/Local/clientdata/com.apple.iCal
rm -rf ~/Library/Calendars
rm -rf ~/Library/Preferences/com.apple.iCal.plist
rm -rf ~/Library/Preferences/IcalExternalSync.plist
rm -rf ~/Library/Preferences/ByHost/com.apple.iCal.helper.*
rm -rf ~/Library/Caches/com.apple.iCal
rm -rf ~/Library/Caches/Metadata/iCal
Clearing ALL of iCal

Careful, This Will Remove All Calendar Data. Have all iSync related programs shutdown [addressbook, ical, iMail]

You will also need to redo your CalDAV account setup for the Zimbra iSync Connector. It might also be necessary to uninstall and reinstall the Zimbra Connector. Make and run script:

rm -rf ~/Library/Application\ Support/SyncServices/Local
rm -rf ~/Library/Application\ Support/SyncLocalCopy
rm -rf ~/Library/Application\ Support/iSync/SyncLocalCopy
rm -rf ~/Library/Application\ Support/iCal
rm -rf ~/Library/Calendars
rm -rf ~/Library/Preferences/com.apple.iCal.*
rm -rf ~/Library/Preferences/IcalExternalSync.plist
rm -rf ~/Library/Preferences/ByHost/com.apple.iCal.helper.*
rm -rf ~/Library/Caches/com.apple.iCal
rm -rf ~/Library/Caches/Metadata/iCal

Can't see items in shared Calendar

You might be seeing this:


Comment #30 give some instructions on a case they can reproduce.

zmprov gd <your domain name> zimbraPublicServiceHostname
zmprov gs <your server name> zimbraServiceHostname

If zimbraPublicServiceHostname is not set, or set to a different name (such as an alias of the machine or a load balancer), you are hitting this issue.

Calendar events are displaying the wrong time

Apple expects the year of 1971 for the DTSTART variable within an ICS file. There is no standard that dictates this.

Zimbra (prior to version 5.0.5) was using 1601, this is in /opt/zimbra/conf/timezones.ics .

Please see bug for more details (resolved 5.0.5):


Alarm & Calendar Notification Issues with iCal

These issues are getting worked out for the 5.0.7 release.

Please review:


Some more details:



iCal calendar color changing modifies calendar name and/or doesn't retain color

Fixed in 5.0.5 . See bugs for details:



Colors for Calendar & Appointments (Non-client specific)

Here's some RFE's/Bugs you might be interested in:

Calendar Ordering Issues

Please see RFE I made.

Directory Access configuration on Macs

File that configures [system wide] for Address Book resolution


Calendar Invites can't be imported into iCal

If you look at the ics file, you might see an extra return character at the end.

You'll see this if an Outlook client send an invite to a user using a Mac with a thick client [Mail.app/Entourage].

This was resolved in the 5.0.5 release. Please see bug for more details:


Mac clients cause spamming of invitation events when they adjust calendar events

This, at it's root, is caused by other bugs listed here. Usually this will get resolved with the proper upgrades that the bugs require (ZCS 5.0.5+)

There is a RFE/Bug though that will also resolve this, by allowing the "action" of an appointment to be set.

Please see bug for details [scheduled for 5.0.7]:


Calendar.app 10.9.5 With ZCS 8.5+

EWS - Exchange Account Topics

Configuring EWS And Calendar.app

Note - currently, with ZCS 8.5 it is not working with calendars. See the following bug:

Configuring an EWS account on a Mac gives you the option to enabled multiple services. See EWS Configuration And ZCS 8.5 on setting this up.

CalDAV Account Topics

Delegate Issues

iCal 10.5 - CalDAV Issues

Logging-Debug for CalDAV+iCAL

If you are using CalDAV account with ZCS, please help us investigating this problem. On your Mac please do the following and gather some data.

First shutdown iCal app.

Launch terminal app.

You can turn on the debug options in iCal by:

defaults write com.apple.iCal IncludeDebugMenu 1

Turn them off by just reversing it:

defaults write com.apple.iCal IncludeDebugMenu 0

Furthermore, you can log all of the HTTP transaction to the console via:

defaults write com.apple.iCal LogHTTPActivity yes

Turn them off by just reversing it:

defaults write com.apple.iCal LogHTTPActivity no

Logging will show up in /var/log/system.log

Launch iCal app.

Select the shared folder, right click, refresh.

Only Seeing 1 Month Back and 1 Year Ahead In CalDAV

Please see this bug: http://bugzilla.zimbra.com/show_bug.cgi?id=28713

Set to be resolved in 5.0.9

Not seeing Calendar's In iCAL/CALDAV

Space In Calendar Name's And Other "Special Characters"

For space's in Calendar names, this is resolved for the 5.0.7 release. (Need bug # for this)

There have also been reports in the forums that "special characters" can cause an issue where Calendars aren't displayed - even those without the special character name. Note, in one case, the "special character" where Norwegian character.

See: http://www.zimbra.com/forums/isync-caldav/20076-isync-calendars-not-working-after-upgrade-5-0-7-a.html

Server's With Multiple Domains - Effect Users Are In Default Domain

Bug filed:


  • Conditions:
    • On ZCS 5.0.7
    • Mac Clients using Zimbra Connector (provided from ZCS 5.0.7) and setting up iCal/CalDAV via the Connector.
    • ZCS has multiple domains
  • Error:
    • Default domain accounts can't see calendars
  • Reproduce:
    • Clear iCal with no Accounts configured (CALDAV)
    • Setup Accounts via Zimbra Connector
    • User username@defaultdomain.com as format for the User Name Field
  • Work Around:
    • Clear iCal with no Accounts configured (CALDAV)
    • Setup Accounts via Zimbra Connector
    • User username as format for the User Name field
  • Non-Default Domains - Works As:
    • Clear iCal with no Accounts configured (CALDAV)
    • Setup Accounts via Zimbra Connector
    • User username@domain.com as format for the User Name Field
      • Note, these accounts need @domain, will not work with just username.

iCal And Entourage Use for Calendars - Leopard/10.5 users

Update The 5.0.6+ Connectors will no longer work with Entourage. Your only option for Calendars will be using CalDAV with iCal.App. You still will see an option about Entourage in the Connector but it will be grayed out.

Because of some core issues with Apples SyncServices, we recommend that Entourage and iCal users use iCALv3 (Mac 10.5) configured for CALDAV. Please use the Zimbra Connector instructions to setup iCal for CALDAV.

For Entourage, this recommendation stems from the fact that Microsoft decided to use WebDAV rather than CALDAV. If MS decides later to include CALDAV support for Entourage, we'll have another option.

Please see bug for details:

Snow Leopard , Outlook/Entourage , Exchange Web Services

There is no target milestone for it as of today [2010/02/23]. This topic applies to the following references or terms: Exchange auto discovery feature, Exchange Autodiscover service or anything else that relies on Exchange Web Services [ EWS ] on the Mac. Another Apple reference on the topic [pdf warning] : Mac OS X Snow Leopard: Integrating the Mac into an Exchange 2007 Environment .

Please see the following in regards to Zimbra's work and stance on the issue:

Can't see Calendars after configuring Z-iSync for CALDAV - 10.5 users

You didn't follow the directions most likely. Goto iCal Preferences Accounts.

There should be NO configured accounts prior to configuring Z-iSync for CALDAV.

Remove the current Account listed in iCal and redo configuration for CALDAV with Z-iSync.

Trick to work around address lookup for the Attendee field in iCal Events

Configure the Addressbook using one of the other recommendations on this page.

You can now drag entries from your Addressbook into the Attendee field of iCal.

Attendee Lookups for iCALv3/MacOS10.5

iCal3 [webdav] needs to use the Apple Directory Access utility for attendees (It's on 10.5). It will only work against Apple OD/CAL servers.

RFE filed to include necessary LDAP attributes to provide ical oattendee lookups

See bug [scheduled for 5.0.7]:


Free/Busy Lookup not working as expected

The Free/Busy lookup requires auto-attendee lookup to be working.

This requires bug 26619 [ http://bugzilla.zimbra.com/show_bug.cgi?id=26619 ] to be resolved for iCalv3/Mac 10.5.

iCal-CalDAV - server doesn't retain color information from iCal

Summary of issue: Zimbra only supports the preset colors on iCal, which are blue, green, red, orange, pink, and purple.

Please see the following:

  • "CalDAV: server does not retain color information from iCal"
    • http://bugzilla.zimbra.com/show_bug.cgi?id=26627
    • I've added a private comment to this to see if another RFE is needed to expand this and if there's any show stopper reasoning with why it can't be done. I'll update this here when I hear back on it.

New Calendars Made With iCal-CalDAV Are Being Shared Out

I created a bug for this issue, please see:

Can't Select Which Calendars To Sync - I Could With 10.4 Though

This is because of the change from iSync to CalDAV. iCal always syncs all the calendars in a given CalDAV account together. The CalDAV spec allows syncing each Calendar, but iCal chooses to sync them all.

There is no known work around at this time. Nor is there an RFE made because the dev's have stated it's an iCal issue. If this changes, I'll update this entry.

iTunes & iPhone configuration for CALDAV

Please see main wiki page on iPhone http://wiki.zimbra.com/index.php?title=IPhone

If you follow the instructions about configuring the Zimbra iSync Connector for CALDAV use, there should be no issues about sync'ing with your iPhone.

At this time, new events created on a iPhone/CALDAV setup will write the event to a local calendar in iCal.app . There's no way around this yet. It's a limitation at this time with Apple's software. You can change the events calendar assignment though later via iCal.app.

Please see Screenshot of iTunes & iPhone

iPhone 3.0 will use port 8443 as default when setting up Caldav, you most likely need to change this to 443.

iCal 10.4 - iSync Issues

Attendee Lookup for iCal/Mac 10.4

iCal.app on Mac 10.4 only uses local entries in Apples Addressbook for address/username lookup for new appointments.

Addressbook+LDAP configuration requires a copy of an "all/*" search in ldap into the local addressbook. Sync doesn't seem to work.

Please see this bug comment and the 10.4 section for more details:


New Calendars don't sync unless you select "all". Mac 10.4/Z-isync

Please see bug for details:


Sync To Do/Tasks Items in Leopard

RFE filed, please see http://bugzilla.zimbra.com/show_bug.cgi?id=12917

No target date, please vote for this RFE.

Verified Against: Zimbra Collaboration 8.5, 8.0 Date Created: 04/16/2014
Article ID: https://wiki.zimbra.com/index.php?title=Ajcody-Client-Topics Date Modified: 2011-03-27

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »


General Outlook Issues

Getting Older ZCO Versions

You can download previous release here:

The connector are in the zimbra-store package. For example:

[root@mail59 zimbra]# find . -name *.msi -print

[root@mail59 zimbra]# rpm -qf ./jetty-6.1.22.z6/webapps/zimbra/downloads/ZimbraOlkConnector-6.0.6_GA_2324_6.0.5902.6.msi

With a rpm based distro, you'll do something like the following reference shows to extract the files from the rpm using rpm2cpio & cpio vs. needing to "install" the rpm:

Basic gist:

[root@mail59 zimbra]# pwd
[root@mail59 zimbra]# cp /path/to-untar-zcstarball/packages/zimbra-store* /tmp/zco-rpm/
[root@mail59 zimbra]# rpm2cpio zimbra-store*.rpm | cpio -iv --make-directories `rpm2cpio zimbra-store*.rpm | cpio -t | grep -i zimbraolkconnector`

Import & Export Of Outlook Categories As Zimbra Tags

Under ZCO

Older versions of ZCO documentation had:

  • "If categories have been assigned to messages and contacts, these are converted to tags in the user’s Zimbra mailbox."

Newer ZCO releases and documentation now state:

  • "Zimbra Tags are synchronized with Outlook Categories"

Import & Export Notes & Journal

Notes & Journal Via PST

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. This would need to be done prior to installing and configuring the Zimbra Outlook Connector. Also, this "import" is via the normal Outlook pst process - NOT via the Zimbra pst import tool.

Related Bugs And Resources

Into Zimbra Documents

Notes can be exported from Outlook to a CSV file. You can the manipulate this with Excel/Word to a format that would work for you within Zimbra Documents.

In Excel - Add borders to the cells, Adjust fonts, Adjust text spacing and then highlight the data. Ctrl+C .

In Zimbra web client - Goto Documents > New .

Click in body of New Document and Ctrl+V . You should see your Notes now in a Table.

Upload HTML


Following above example except you format your old Notes to become a HTML file. You could export/save-as using whatever application you like.

Then, in Zimbra web client - Goto Documents > New Drop Down Arrow and select Upload File

This, unfortunately, will get saved under "Briefcase"

Upload File Type For Conversion To Zimbra Documents

Update - This Will Be True For Upcoming Releases

See (Zimbra Employees) - On DF

  • "import/export word/excel to documents"
    • Internal (Private) RFE - 10124

Notes can be exported from Outlook to a CSV file. Open this file with Excel and make any adjustments you would like and then save as an Excel file.

From the Zimbra webclient, log in with your account details.

Goto the Documents tab.

Click on Import. You'll be able to select Excel files as an import option.

Into Zimbra Tasks?

Initial thoughts.

If one does something like this : http://ZIMBRASERVER/home/ajcody/Tasks

It will give you your tasks in an ics format (iCal). Here's what one tasks would look like:

TZID:(GMT-05.00) Eastern Time (US & Canada)
SUMMARY:Tasks Exporting
DESCRIPTION:These are my notes I'm putting in for my task. \n
ORGANIZER;CN=Adam J. Cody:mailto:ajcody@mail3.internal.homeunix.com

As you can see, it would be a difficult task [no pun intended] to convert the data from Outlook Notes into ics format to allow importing to Zimbra Tasks.

If you do find a way, the import process from CLI would be:

curl -u USERNAME:password --data-binary @/tmp/Tasks.ics http://server/service/home/USERNAME/Tasks?fmt=ics

See User_Migration for more details.

ZCO Zimbra Outlook Connector

Supported Versions Of Windows, Outlook, ZCO

I created the following RFE:

Current document for this would be:

ZCO 5.0.10 Release

Local Failure Notice In My Inbox

This is new with this release of the ZCO.

What To Do When You Get This If You Want To Contact Support

Add these details/steps to the creation of your support case.

  1. Send us the failure messages.
    • Easiest way is to create a temp folder on your desktop, drag all these messages to the folder. (This will create .msg files inside the folder.) Then zip up the folder and send the zip file to us through a support case.
  2. For each type of errors with an id, get the "Show Original" of one of the failures.
If You Want To Turn This Feature Off

Just create a DWORD value in the registry of HKEY_LOCAL_MACHINE\SOFTWARE\Zimbra\turnOffInboxFailures and set it to 1. Then the local failures won't go to the Inbox. They'll just go to the local failures folder, as before.

ZCO 5.0.7+

ZCO 5.0.7 and higher have new features and also should only be used with ZCS server 5.0.7 or higher.

Check The ZCO 5.0.6 Bug Backport Binary

Login to the support portal and check Zimbra Utility and Beta Downloads.

Or try this direct url:


It will list out the bugs that were back ported.

The complete troubling-shooting guide (dev info requests)

  1. Reproduce
  2. ZCO install logs
    • msiexec /i zco-installer.msi /lv 00022083-zco-install.log
  3. Get zco logs
  4. Check for core dumps - mandatory for all crashes
  5. Winhttp trace (issues where they can&amp;amp;amp;amp;amp;#39;t connect - check zco logs first). Run this on the machine with Outlook.
  6. Are there any local failures/server failures?
  7. Winmsd (dump of the local environment configuration)
    • Start Run winmsd
      • This might take awhile to bring up the application
      • From app [System Information titled] , File Export
    • What about msinfo32.exe ?
  8. External factors (add-ins, other mapi clients)
  9. Network topology (firewall, proxy, etc)
  10. Server topology (single/multi-node, clustering, nginx, 3rd party lb)
  11. Search bugzilla
  12. Search old support cases
  13. Can we get remote access?
  14. Can we get an account on the server?
  15. Can we access the account in question?
  16. Get the id of the item
    • get the original of the item from the server (mime representation)
    • get the .msg of the item from outlook
  17. Quick analysis of zco logs
    • sync - change record creation - CHANGE RECORD
    • follow soap requests, look for soap faults
    • look for the word - exception
    • follow soap traces
    • ignore MAPI_E_NOT_FOUND

Performance Issues






The skinny is this, [per Microsoft]

  • ...recommended max OST size (2GB)
  • ...we strongly recommend storing no more than 5,000 items in core folders, such as the Inbox and Sent Items folders. Creating more top-level folders, or subfolders underneath the Inbox and Sent Items folders, greatly reduces the costs associated with this index creation, so long as the number of items in any one folder does not exceed 5,000.

Can't Send Via Send To -> Mail Recipient

Please see this bug:


You shouldn't have this problem with connectors from 5.0.6+

Saving Current Profile Out To Then Re-Import

With Outlook closed/shutdown, you can then copy/rename the *.zdb file under your profile to a .pst file.

Then you can later run the PST Import Wizard to import the file into a new Zimbra profile you setup. One of the options on the Import Wizard let's you import only mail after a specified date - to avoid duplications.

Thunderbird , Lightning, Firefox

Debug Logging For Thunderbird

To create a log file with all POP, SMTP, or IMAP traffic in Mozilla Thunderbird:

For Windows

  • Make sure Mozilla Thunderbird is not running.
    • Select All Programs | Accessories | Command Prompt from the Start menu.
    • Type "set NSPR_LOG_MODULES=" followed immediately by
      • "POP3:4" for POP,
      • "IMAP:4" for IMAP and
      • "SMTP:4" for SMTP
  • Press Enter.
    • You can enable logging for multiple protocols by separating them with commas (',').
      • To log both POP and SMTP traffic, for example, type "set NSPR_LOG_MODULES=POP3:4,SMTP:4" (excluding the quotation marks).
      • To log only IMAP traffic, type "set NSPR_LOG_MODULES=IMAP:4", for instance.
  • Type "set NSPR_LOG_FILE=%HOMEDRIVE%%HOMEPATH%\Desktop\tbird_log.txt".
  • Press Enter.
  • Type "start thunderbird".
  • Press Enter again.
  • Perform the desired email actions in Mozilla Thunderbird.
  • Quit Mozilla Thunderbird and take a look at "tbird_log.txt" on your Desktop.

For Mac OS X

  • Open a Terminal window.
  • Type "set NSPR_LOG_MODULES=" followed immediately by
    • "POP3:4" for POP,
    • "IMAP:4" for IMAP and
    • "SMTP:4" for SMTP
  • Press Enter.
    • You can enable logging for multiple protocols by separating them with commas (',').
    • To log both POP and SMTP traffic, for example, type "set NSPR_LOG_MODULES=POP3:4,SMTP:4" (excluding the quotation marks).
    • To log only IMAP traffic, type "set NSPR_LOG_MODULES=IMAP:4", for instance.
  • Type "set NSPR_LOG_FILE=~/Desktop/tbird.log".
  • Press Enter.
  • Now type "/Applications/Thunderbird.app/Contents/MacOS/thunderbird-bin".
  • Press Enter again.
  • Perform the desired email actions in Mozilla Thunderbird.
  • Quit Mozilla Thunderbird and take a look at "tbird.log" on your Desktop.

For Linux

  • Open a Terminal window.
  • Type "set NSPR_LOG_MODULES=" followed immediately by
    • "POP3:4" for POP,
    • "IMAP:4" for IMAP and
    • "SMTP:4" for SMTP
  • Press Enter.
    • You can enable logging for multiple protocols by separating them with commas (',').
    • To log both POP and SMTP traffic, for example, type "set NSPR_LOG_MODULES=POP3:4,SMTP:4" (excluding the quotation marks).
    • To log only IMAP traffic, type "set NSPR_LOG_MODULES=IMAP:4", for instance.
  • Type "set NSPR_LOG_FILE=~/tbird.log.txt".
  • Press Enter.
  • Type "thunderbird".
  • Press Enter again.
  • Perform the desired email actions in Mozilla Thunderbird.
  • Quit Mozilla Thunderbird and take a look at "tbird.log.txt" in your Home directory.

Thunderbird Contact Sync for Zimbra

Please see the following as a possible solution:


Gnome Evolution And KDE Kontact

Some RFE's I've made:

Zimbra Desktop [ZD]

ZD References

IM - Instant Messaging Clients


Please see:


Don't believe this will currently work. I'm still investigating it though.

RFE I made in the meantime:

Please see:

Setting Up Apache For The crossdomain.xml File

Ok, this is just down and dirty. You'll need to handle security issues yourself.

mkdir /opt/zimbra/spark-web
vi /opt/zimbra/spark-web/crossdomain.xml

Putting in this,

<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM

<allow-access-from domain="*" to-ports="5222" />

Set permissions:

chown -R zimbra:zimbra /opt/zimbra/spark-web

Let's configure apache to server this file out and listen on port 5229.

Note, you could also set this up within a Virtual Hosts.

vi /opt/zimbra/conf/httpd.conf Towards the start of the file, add another Listen line for port 5229 under the Listen 80

Listen 5229

Towards the end, add the following to include spark-web directory

Include /opt/zimbra/httpd/conf/extra/spark-web.conf

Let's now make the apache conf file for zmstat-chart.conf

vi /opt/zimbra/httpd/conf/extra/spark-web.conf

Alias /zmstat-chart "/opt/zimbra/spark-web"
<Directory "/opt/zimbra/spark-web">
  Options Indexes
  IndexOptions FancyIndexing VersionSort
  AllowOverride None
  Order allow,deny
  Allow from all

Restart apache so the changes take effect:

zmapachectl stop
zmapachectl start

To test your changes, with a web browser goto:


You should see the xml file you made.

Now setup the spark-web software on the same box. SparkWeb HOW-TO will guide you but use the /opt/zimbra/spark-web directory you already setup. I'll leave the particulars to this to the HOW-TO referenced. Just remember that when you setup the spark-web client you'll modify it's config file like below.Don't forget to put in your IM servers hostname for "youropenfireserver":

<script type="text/javascript">
function jive_sparkweb_getConfig()
     return {
          server: "youropenfireserver",
          connectionType: "socket",
          port: "5222",
          autoLogin: "false",
              policyFileURL: "xmlsocket://youropenfireserver:5229"

Pidgin - Formally GAIM

Please see Pidgin_and_Zimbra

Pidgin Groupchat

Configure For Chat Room:

  • Buddies
  • Join A Chat
  • Account = Zimbra IM Account
  • Room
    • Either A New One - which will prompt you for setup. Check persistent if you want it to be.
    • Enter An Existing Conference Room Name
  • Server
    • Enter conference.SERVERNAME , Example: conference.example.com
      • conference is a default variable that will be added to the primary zimbra hostname/domainname.

See Public Chat Rooms Listed:

  • Buddies
  • Join A Chat
  • Account = Zimbra IM Account
  • Server
    • Enter conference.SERVERNAME , Example: conference.example.com
      • conference is a default variable that will be added to the primary zimbra hostname/domainname.
  • Click On The "Room List" button


Please see Adium_and_Zimbra

Adium Groupchat

Configure For Chat Room:

  • File
  • Join Group Chat
  • Set Account To Your Zimbra XMPP/Jabber Account
  • Chat Room Name
    • Either A New One - which will prompt you for setup. Check persistent if you want it to be.
    • Enter An Existing Conference Room Name
  • Server
    • Enter conference.SERVERNAME , Example: conference.example.com
      • conference is a default variable that will be added to the primary zimbra hostname/domainname.

See Public Chat Rooms Listed:

  • File
  • Highlight Your Zimbra Account until the options show on the right.
  • Discovery Browser


Just discovered this project, though I haven't used it much. Might be worth checking out. It's available for Windows [Beta] and coming "soon" for Mac and Linux. Does IM, Email notification, and Social Networking stuff.

  • Digsby Home Page
    • http://www.digsby.com/
      • Features:
        • digsby is a multiprotocol IM client that lets you chat with all your friends on AIM, MSN, Yahoo, ICQ, Google Talk, and Jabber with one simple to manage buddy list.
        • digsby is an email notification tool that alerts you of new email and lets you perform actions such as 'Delete' or 'Report Spam' with just one click.
        • digsby is a social networking tool that alerts you of events like new messages and gives you a live Newsfeed of what your friends are up to.
    • Items to Notes:
      • Where is group chat?
        • We had some bugs with group chat so we launched Digsby beta without it. However, we will bring it back in the near future.
      • Requires account setup with Digsby. This might not be acceptable for some customers for security reasons.


Please see Empathy_and_Zimbra

Other Topics

PGP , GPG , Domain Keys, Encryption

Just references as I find them:

Jump to: navigation, search