ZCS NE Admin Guide-7.1.2

348 Pages·2011·2.47 MB·English

VMware Zimbra Collaboration Server
Administrator’s Guide
Release 7.1
Network Edition
May 2011
Legal Notices
Copyright ©2005-2011 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
ZCS 7.1
Rev 2 for 7.1.2 July 2011
Table of Contents
1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Zimbra Collaboration Server License . . . . . . . . . . . . . . . . . . . . . . . . . .11
Obtaining a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Available Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Support for Recommended Third-Party Components . . . . . . . . . . . . . .13
Support and Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
2 Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Core Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Zimbra Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
System Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Zimbra Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Backup Process Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Zimbra System Directory Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Example of a Typical Multi-Server Configuration . . . . . . . . . . . . . . . . .23
3 Zimbra Mailbox Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Zimbra Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Incoming Mail Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Disk Layout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Message Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Data Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Index Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Redo Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4 Zimbra Directory Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Directory Services Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
LDAP Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Zimbra Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Account Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Internal Authentication Mechanism . . . . . . . . . . . . . . . . . . . . . . . . . 36
External LDAP and External AD Authentication Mechanism. . . . . . 36
Custom Authentication - zimbraCustomAuth. . . . . . . . . . . . . . . . . . 37
Kerberos5 Authentication Mechanism . . . . . . . . . . . . . . . . . . . . . . . 39
Zimbra Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Company Directory/GAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Flushing LDAP Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Themes and Locales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Accounts, COS, Domains, and Servers. . . . . . . . . . . . . . . . . . . . . . 44
Global Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
VMware Zimbra Collaboration Server Network Edition 7.1 iii
Administrator’s Guide
5 Zimbra MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Zimbra MTA Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Postfix Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
MTA Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
SMTP Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
SMTP Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Relay Host Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
MTA-LDAP Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Account Quota and the MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
MTA and Amavisd-New Integration . . . . . . . . . . . . . . . . . . . . . . . . . 50
Anti-Virus Protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Anti-Spam Protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Receiving and Sending Mail through Zimbra MTA . . . . . . . . . . . . . . . .54
Zimbra MTA Message Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
6 Working with Zimbra Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Zimbra Proxy Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Zimbra Proxy Architecture and Flow . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Customizing Zimbra Proxy Configuration . . . . . . . . . . . . . . . . . . . . . . .58
Zimbra IMAP/POP Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
Zimbra Proxy Ports for POP/IMAP. . . . . . . . . . . . . . . . . . . . . . . . . . 59
Setting up IMAP/POP Proxy after HTTP Proxy . . . . . . . . . . . . . . . . 59
Configuring ZCS HTTP Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Setting up HTTP Proxy after IMAP/POP Proxy is set up. . . . . . . . . 62
Setting Proxy Trusted IP Addresses . . . . . . . . . . . . . . . . . . . . . . . . 64
Configuring Zimbra Proxy for Kerberos Authentication . . . . . . . . . . . . .65
7 Managing Legal Requests for Information . . . . . . . . . . . . . . . . . . . . . . .67
Legal Intercept for Law Enforcement . . . . . . . . . . . . . . . . . . . . . . . . . .67
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Create Mailbox Snapshots for Legal Discovery . . . . . . . . . . . . . . . . . .69
8 Using the Administration Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Changing Administrator Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . .72
About the Administration Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Managing Tasks from the Administration Console. . . . . . . . . . . . . . 75
Tasks Not Available from Administration UI. . . . . . . . . . . . . . . . . . . 75
Creating Message of the Day for Administrators . . . . . . . . . . . . . . . . .76
Checking for ZCS Software Updates . . . . . . . . . . . . . . . . . . . . . . . . . .77
Searching from the Administration Console . . . . . . . . . . . . . . . . . . . . .78
9 Delegated Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
Delegated Administration Terminology . . . . . . . . . . . . . . . . . . . . . . . . .81
How Delegated Administration Rights are Granted . . . . . . . . . . . . . . .82
Selecting Target Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Implementing Delegated Administration . . . . . . . . . . . . . . . . . . . . . . . .89
Creating Administrator Groups and Administrators . . . . . . . . . . . . . 89
Configure Grants on Administrator Accounts or Admin Groups. . . . 93
Granting ACLs to a Target. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
iv Network Edition 7.1 VMware Zimbra Collaboration Server
Revoking Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Viewing Rights Granted to Administrators . . . . . . . . . . . . . . . . . . . . . .94
Predefined Delegated Administrator Role . . . . . . . . . . . . . . . . . . . . . . .94
Domain Administration Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Distribution List Administration Group.. . . . . . . . . . . . . . . . . . . . . . . 96
Specific Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
10 Managing ZCS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
Managing Global Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
General Global Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Global Settings to Block Mail Attachments. . . . . . . . . . . . . . . . . . . 105
Global MTA Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Global IMAP and POP Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Anti-spam Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Anti-virus Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Zimbra Free/Busy Interoperability . . . . . . . . . . . . . . . . . . . . . . . . . 108
Briefcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Customizing Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Global HSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Backup/Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Managing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Global Address List (GAL) Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Authentication Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Virtual Hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Briefcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Free/Busy Interoperability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Zimlets on the Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Customizing Themes for Domains. . . . . . . . . . . . . . . . . . . . . . . . . 118
Setting Account Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Renaming a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Adding a Domain Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Installing a SSL Certificate for a Domain . . . . . . . . . . . . . . . . . . . . 120
Managing Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
General Server Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Services Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
MTA Server Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
IMAP and POP Server Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Volume Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Backup and Restore - selecting the backup mode. . . . . . . . . . . . . 124
Managing Other Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Admin Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Adding Words to ZCS Spell Dictionary. . . . . . . . . . . . . . . . . . . . . . 125
Setting System-wide Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . 125
11 Managing User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Setting up Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
Configuring One Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Configuring Many Accounts at Once . . . . . . . . . . . . . . . . . . . . . . . 129
Managing Aliases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Managing Class of Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
VMware Zimbra Collaboration Server Network Edition 7.1 v
Administrator’s Guide
COS Calendar Preference to Set Default Time Zones. . . . . . . . . . 137
Distributing Accounts Across Servers . . . . . . . . . . . . . . . . . . . . . . 137
Changing Passwords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Directing Users to Your Change Password Page . . . . . . . . . . . . . 138
Setting Polling Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
View an Account’s Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Reindexing a Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Changing an Account’s Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Deleting an Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Moving a Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140
Moving a Mailbox using the CLI command . . . . . . . . . . . . . . . . . . 140
Managing Distribution Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
Manage Access to Distribution Lists . . . . . . . . . . . . . . . . . . . . . . . 141
Enable View of Distribution List Members for AD Accounts. . . . . . 143
Using Distribution Lists for Group Sharing. . . . . . . . . . . . . . . . . . . 143
Managing Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
12 Customizing Accounts, Setting General Preferences and Password Rules 147
Zimbra Web Client Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
Zimbra Messaging and Collaboration Applications . . . . . . . . . . . . . . .148
Email messaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Address Book. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Briefcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Other Configuration Settings for Accounts . . . . . . . . . . . . . . . . . . . . .161
Enabling Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Enable SMS Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Disabling Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Setting Account Quotas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Setting Password Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Setting Failed Login Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Setting Session Timeout Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Setting Email Retention Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Setting Attachment Viewing Options . . . . . . . . . . . . . . . . . . . . . . . 168
Zimbra Web Client UI Themes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Zimbra Mobile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Configuring Zimlets for Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . 170
Other Account Configuration Preferences . . . . . . . . . . . . . . . . . . . 170
13 Managing Zimbra Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Setting Up Mobile Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
Setting up Mobile Device Security Policies . . . . . . . . . . . . . . . . . . . . .175
Setting Mobile Device Policies Attributes. . . . . . . . . . . . . . . . . . . . 176
Users’ Mobile Device Self Care Features . . . . . . . . . . . . . . . . . . . 176
Changing Mobile Device Password Policy . . . . . . . . . . . . . . . . . . . . .177
14 Managing Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
Accessing Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
Default Zimlets included in ZCS. . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Zimlets from the Zimbra Gallery. . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Developing Customized Zimlets. . . . . . . . . . . . . . . . . . . . . . . . . . . 181
vi Network Edition 7.1 VMware Zimbra Collaboration Server
Deploying Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
Deploying a Zimlet from the Admin Console . . . . . . . . . . . . . . . . . 181
Deploying a Zimlet from the CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Adding Proxy Allowed Domains to a Zimlet. . . . . . . . . . . . . . . . . . 183
Adding Proxy Allowed Domains to a Zimlet using the CLI. . . . . . . 183
Deploying a Zimlet and Granting Access to a COS. . . . . . . . . . . . 184
Enabling, Disabling, or Making Zimlets Mandatory . . . . . . . . . . . . . . .184
Default Zimlets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Toggling a Zimlet between Enabling and Disabling. . . . . . . . . . . . 185
Disabling a Zimlet using the CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Undeploying Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
Undeploying a Zimlet using the Admin Console. . . . . . . . . . . . . . . 187
Undeploying a Zimlet using the CLI. . . . . . . . . . . . . . . . . . . . . . . . 188
Configuring Zimlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
Changing Zimlet Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Viewing Zimlet Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
Viewing Zimlet status using the Admin Console . . . . . . . . . . . . . . 189
Viewing Zimlet Status using the CLI. . . . . . . . . . . . . . . . . . . . . . . . 189
Upgrading a Zimlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
Upgrading a Zimlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
15 Monitoring ZCS Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
Zimbra Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
Reviewing Server Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Server Performance Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Generating Daily Mail Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Monitoring Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
Monitoring Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
Monitoring Mail Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
Flushing the Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Monitoring Mailbox Quotas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197
Monitoring Authentication Failures . . . . . . . . . . . . . . . . . . . . . . . . . . .198
Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198
Syslog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Using log4j to Configure Logging. . . . . . . . . . . . . . . . . . . . . . . . . . 200
Logging Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Protocol Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Reviewing mailbox.log Records. . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Reading a Message Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
SNMP Monitoring Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
SNMP Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Errors Generating SNMP Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Checking MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
Checking for Latest ZCS Software Version . . . . . . . . . . . . . . . . . . . . .208
16 Backup and Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Zimbra Backup Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
Standard Backup Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Auto-Grouped Backup Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Directory Structure for Backup Files . . . . . . . . . . . . . . . . . . . . . . . . . .213
Backup and Restore Using the Administration Console . . . . . . . . . . .215
Standard Backup Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
VMware Zimbra Collaboration Server Network Edition 7.1 vii
Administrator’s Guide
Auto-grouped Backup Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Configure Backup from the Admin Console. . . . . . . . . . . . . . . . . . 216
Backup and Restore Using the Command Line Interface . . . . . . . . . .217
Backing up using the Standard Method . . . . . . . . . . . . . . . . . . . . . . .217
Scheduling Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Full Backup Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Incremental Backup Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Finding Specific Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Aborting Full Backup In Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
Backing up using the Auto-Grouped Method . . . . . . . . . . . . . . . . . . .222
Configure Auto-Grouped Backup from the CLI . . . . . . . . . . . . . . . 222
Scheduling Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Backup Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223
Backup Up content Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Backing up MySQL Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Managing Disk Space for Backups . . . . . . . . . . . . . . . . . . . . . . . . . . .224
Restoring Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
Restore Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Stopping a Restore Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Offline Restore Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Restoring Individual Accounts on a Live System. . . . . . . . . . . . . . 228
Selectively Restore Items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Restoring the LDAP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Disaster Recovery for Specific Situations . . . . . . . . . . . . . . . . . . . . . .230
General Steps for Disaster Recovery. . . . . . . . . . . . . . . . . . . . . . . 230
Crash Recovery Server Startup. . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Restore the Zimbra Collaboration Server. . . . . . . . . . . . . . . . . . . . 230
Preparing the New Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Restoring from Different Failure Scenarios . . . . . . . . . . . . . . . . . . 234
Changing Local Configuration Files after Restoring Zimbra. . . . . . 235
Using snapshots to backup and restore . . . . . . . . . . . . . . . . . . . . . . .235
17 Zimbra Archiving and Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
How Archiving Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
How Discovery Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
Installing Archiving Package as an Update to ZCS . . . . . . . . . . . . . . .240
Installing zimbra-archiving in a Single-Server Environment. . . . . . 240
Installing zimbra-archiving in a Multi-Server Environment. . . . . . . 240
Enable archiving on each MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Creating Dedicated Archive COS in a Multi-Server Environment . . . .242
Using the Administration Console . . . . . . . . . . . . . . . . . . . . . . . . . 242
Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Archiving Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244
Attributes configured on users’ account. . . . . . . . . . . . . . . . . . . . . 244
Archive Account Name Templates. . . . . . . . . . . . . . . . . . . . . . . . . 244
Creating Archive Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245
Create an archive mailbox and assign a COS. . . . . . . . . . . . . . . . 245
Create an archive mailbox with no COS or password . . . . . . . . . . 245
Enable archive forwarding to a third-party archiving server. . . . . . 246
Searching Across Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
Cross Mailbox Search from the Administration Console . . . . . . . . 246
Search using the Command Line Interface . . . . . . . . . . . . . . . . . . 247
viii Network Edition 7.1 VMware Zimbra Collaboration Server
18 Changing ZWC Theme Colors and Logo . . . . . . . . . . . . . . . . . . . . . . .249
Customizing Base Theme Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
Replacing the ZWC Logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250
Using Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
Add Your Logos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Changing Theme Colors and Logo from the Admin Console . . . . . . .253
Changing Base Theme Colors. . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Adding Your Logo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Appendix A Command-Line Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
General Tool Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
Zimbra CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
Using non-ASCII Characters in CLIs . . . . . . . . . . . . . . . . . . . . . . . 260
zmprov (Provisioning) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
zmaccts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
zmarchiveconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
zmarchivectl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275
zmarchivesearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275
zmbackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276
zmblobchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
zmcalchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
zmschedulebackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
zmbackupabort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
zmbackupquery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
zmrestore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
zmrestoreoffline (Offline Restore) . . . . . . . . . . . . . . . . . . . . . . . . . . . .288
zmrestoreldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290
zmcontrol (Start/Stop/Restart Service) . . . . . . . . . . . . . . . . . . . . . . . .291
zmmailboxmove (Move Mailbox) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
zmmboxsearch (Cross Mailbox Search) . . . . . . . . . . . . . . . . . . . . . . .294
zmcertmgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
zmgsautil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
zmldappasswd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296
zmlocalconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .297
zmmailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298
zmtlsctl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
zmhsm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
zmlicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
zmmetadump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303
zmmypasswd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
zmplayredo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
zmproxyconfgen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
zmproxypurge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
zmredodump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
zmskindeploy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
zmsoap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
zmstat-chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308
zmstat-chart-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
zmstatctl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
zmthrdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
zmtrainsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
zmtzupdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
zmvolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
VMware Zimbra Collaboration Server Network Edition 7.1 ix
Administrator’s Guide
zmzimletctl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
zmproxyconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314
Appendix B Configuring SPNEGO Single Sign-On for ZCS . . . . . . . . . . . . . .319
Configuration Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319
Create the Kerberos Keytab File . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320
Configure ZCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322
Configure Your Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
Test your setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
Troubleshooting setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
Appendix C ZCS Crontab Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
How to read the crontab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
ZCS Cron Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
Jobs for crontab.store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Jobs for crontab.logger. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Jobs for crontab.mta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Single Server Crontab -l Example . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
Appendix D Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .335
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341
x Network Edition 7.1 VMware Zimbra Collaboration Server