Zimbra OS Quick Start 8.6.0
Zimbra OS Quick Start 8.6.0
Zimbra OS Quick Start 8.6.0
Legal Notices
Copyright 2005-2014 Zimbra, Inc. All rights reserved. This product is protected by U.S. and
international copyright and intellectual property laws. "Zimbra" is a registered trademark of Zimbra, Inc.
in the United States and other jurisdictions.You may not alter or remove any trademark, copyright, or
other notice from copies of the content. All other marks and names mentioned herein may be trademarks
of their respective companies.
Zimbra, Inc.
3000 Internet Blvd., Suite 200
Frisco, Texas 75034
www.zimbra.com
Table of Contents
29
The Zimbra Collaboration includes the Zimbra MTA, the Zimbra LDAP server,
and the Zimbra mailbox server. In a single-server installation, all components
are installed on one server and require no additional manual configuration.
This installation guide is a quick start guide that describes the basic steps
needed to install and configure Zimbra Collaboration in a direct network
connect environment. In this environment, the Zimbra server is assigned a
domain for which it receives mail, and a direct network connection to the
Internet. When Zimbra Collaboration is installed, you will be able to log on to
the Zimbra administration console to manage the domain and provision
accounts. The accounts you create are able to send and receive external
email.
Topics in this chapter include:
Important Notice About Single Server Installations
Installation Prerequisites
Modifying Operating System Configurations
Overview of Installation Process
Downloading the Zimbra Software
Downloading the Zimbra Software
Basic Configuration
Installing Zimbra Collaboration Software
Final Set-Up
Optional Configurations
Provisioning Accounts
Uninstalling Zimbra Collaboration
Additional Information
Support and Contact Information
Jetty, Postfix, and OpenLDAP. The versions installed have been tested and
configured to work with the Zimbra software. See the Administrators Guide for
a complete list of software.
The following table shows the default port settings when Zimbra Collaboration
is installed.
Zimbra Port Mapping
Port
Remote Queue Manager
22
Postfix
25
HTTP
80
POP3
110
IMAP
143
LDAP
389
HTTPS
443
993
995
Mailboxd LMTP
7025
Important: You cannot have any other web server, database, LDAP, or MTA
server running, when you install the Zimbra software. If you have installed any
of the applications before you install Zimbra software, disable these
applications. During the Zimbra Collaboration installation, Zimbra makes
global system changes that may break applications that are on your server.
Installation Prerequisites
In order to successfully install and run Zimbra Collaboration, ensure your
system meets the requirements described in this section. System
administrators should be familiar with installing and managing email systems.
System Requirements
For the Zimbra Collaboration system requirements see Other Dependencies
in the System Requirements table.
server, including Jetty, which is the servlet container the Zimbra software
runs within. The Zimbra mailbox server includes the following components:
Web application services. The Jetty web application server runs web
applications (webapps) on any store server. It provides one or more web
application services.
Zimbra LDAP. User authentication is provided through OpenLDAP
software. Each account on the Zimbra server has a unique mailbox ID that
is the primary point of reference to identify the account. The OpenLDAP
schema has been customized for Zimbra Collaboration. The Zimbra LDAP
server must be configured before the other servers. You can set up LDAP
replication, configuring a master LDAP server and replica LDAP servers.
Zimbra MTA. Postfix is the open source mail transfer agent (MTA) that
receives email via SMTP and routes each message to the appropriate
Zimbra mailbox server using Local Mail Transfer Protocol (LMTP). The
Zimbra MTA also includes the anti-virus and anti-spam components.
Zimbra Proxy. Zimbra Proxy is a high-performance reverse proxy service
installed on one mailbox server. The Zimbra Logger installs tools for syslog
aggregation and reporting. If you do not install Logger, the server statistics
section of the administration console will not display.
Note: The Logger package must be installed at the same time as the
mailbox server.
Zimbra Spell. Installing the Zimbra Spell package is optional. Aspell is the
is installed.
The Zimbra server configuration is menu driven. The installation menu shows
you the default configuration values. The menu displays the logical host name
and email domain name [mailhost.example.com] as configured on the
computer. You can change any of the values. For single server installs, you
must define the administrators password, which you use to log on to the
administration console.
Basic Configuration
The default configuration installs the Zimbra-LDAP, the Zimbra-MTA with antivirus and anti-spam protection, the Zimbra mailbox server, the SNMP
monitoring tools (optional), Zimbra-spell (optional), the logger tool (optional),
and the Zimbra proxy (optional) on one server.
The menu driven installation displays the components and their existing
default values. You can modify the information during the installation process.
The table below describes the menu options.
Main Menu Options
Main Menu
Description
Description
LDAP port
LDAP Admin
password
Secure interprocess
communications
Time Zone
IP Mode
IPv4 or IPv6.
zimbra-ldap
10
Status
Create Domain
Domain to create
LDAP Replication
password
LDAP Postfix
password
LDAP Amavis
password
Description
zimbra-logger
zimbra-mta
zimbra-snmp (optional)
11
Description
zimbra-store
12
Admin Password
Anti-virus quarantine
user
Enable automated
spam training
Description
SMTP host
Web server HTTP port: 80
Web server HTTPS port: 443
Web server mode Can be HTTP, HTTPS,
Mixed, Both or Redirect.
13
Description
Configure for use with mail proxy. FALSE
Configure for use with web proxy. FALSE
If either or both of these are changed to
TRUE, the proxy setting on the mailbox store
are enabled in preparation for setting up
zimbra proxy.
Enable version update checks. Zimbra
Collaboration automatically checks to see if a new
Zimbra Collaboration update is available. The
default is TRUE.
Enable version update notifications. This
enables automatic notification when updates are
available when this is set to TRUE.
Version update notification email. This is the
email address of the account to be notified when
updates are available. The default is to send the
notification to the admins account.
Version update source email. This is the email
address of the account that sends the email
notification. The default is the admins account.
Note: The software update information can be viewed
from the Administration Console Tools Overview pane.
14
zimbra-spell
Default Class of
Service
Configuration
c) Collapse menu
x) Expand menu
q) Quit
Open an SSH session to the Zimbra server and follow the steps below.
1. Log in as root to the Zimbra server and cd to the directory where the
Zimbra Collaboration archive tar file is saved (cd /var/<tmp>). Type the
following commands:
15
Screenshots in this guide are examples of the Zimbra installation script. The
actual script may be different.
2. The installation process checks to see if Sendmail, Postfix, and MySQL
software are running. If any of these applications are running, you are
asked to disable them. Disabling MySQL is optional but highly
recommended. Sendmail and Postfix must be disabled for the Zimbra
Collaboration to start correctly.
3. Next, the installer checks to see that the prerequisite software is installed.
16
Continue? [N] y
17
Installing packages
zimbra-core......zimbra-core
8.6.0_3107.UBUNTU10_64.20101015011234...done
zimbra-ldap......zimbra-ldap8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-logger......zimbra-logger
8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-mta......zimbra-mta8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-dnscache......zimbra-dnscache8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-snmp......zimbra-snmp8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-store......zimbra-store8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-apache......zimbra-apache8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-spell......zimbra-spell8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-convertd......zimbra-convertd8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-memcached......zimbra-memcached8.6.0__3107.UBUNTU10_64.20101015011234...done
zimbra-proxy......zimbra-proxy8.6.0__3107.UBUNTU10_64.20101015011234...done
Operations logged to /tmp/zmsetup.05202014-131234.log
Installing LDAP configuration database...done.
Setting defaults...
MX: zcs860.us.example.com (xx.xxx.xx.xx)
.
done.
Checking for port conflicts
5. At this point, the Main menu displays showing the default entries for the
Zimbra component you are installing. To expand the menu to see the
configuration values, type X and press Enter. The Main menu expands to
display configuration details for the package being installed. Values that
require further configuration are marked with asterisks (****) to their left.
To navigate the Main menu, select the menu item to change. You can
modify any of the defaults. See Main Menu Options on page 9, for a
description of the Main menu. For a quick installation, accepting all the
defaults, you only need to do the following:
6. If your time zone is not Pacific time, enter 1 to select Main menu 1,
Common Configuration and then enter 6 for TimeZone. Set the correct time
zone.
18
Main menu
1) Common Configuration:
2) zimbra-ldap:
Enabled
3) zimbra-logger:
Enabled
4) zimbra-mta:
Enabled
5) zimbra-dnscache:
Enabled
******* +Master DNS IP address(es):
UNSET
+Enable DNS lookups over TCP:
yes
+Enable DNS lookups over UDP:
yes
+Only allow TCP to communicate with Master DNS: no
6) zimbra-snmp:
Enabled
7) zimbra-store:
Enabled
+Create Admin User:
yes
+Admin user to create:
admin@zcs860.us.example.com
******* +Admin Password
UNSET
+Anti-virus quarantine user:
virusquarantine.yizpgarc@zcs860.us.example.com
+Enable automated spam training:
+Spam training user:
spam.dsh3bzmlte@zcs860.us.example.com
+Non-spam(Ham) training user:
ham.kiax_a52@zcs860.us.example.com
+SMTP host:
+Web server HTTP port:
+Web server HTTPS port:
+Web server mode:
+IMAP server port:
+IMAP server SSL port:
+POP server port:
+POP server SSL port:
+Use spell check server:
+Spell server URL:
yes
zcs860.us.example.com
8080
8443
https
7143
7993
7110
7995
yes
http://zcs860.us.example.com:7780/aspell.php
+Enable version update checks:
TRUE
+Enable version update notifications: TRUE
+Version update notification email:
admin@zcs860.us.example.com
+Version update source email:
admin@zcs860.us.example.com
+Install mailstore (service webapp):
yes
+Install UI (zimbra,example webapps): yes
8) zimbra-spell:
Enabled
9) zimbra-convertd:
Enabled
10) zimbra-proxy:
Enabled
11) Default Class of Service Configuration:
r) Start servers after configuration
yes
s) Save config to file
x) Expand menu
q) Quit
19
Select 1 to disable.
Select 2 to configure the master DNS IP address(es).
9. Type r to return to the Main menu.
10. Enter 7 to select zimbra-store from the Main menu. The Store
Type 4 to set the Admin Password. The password must be six or more
characters. Press Enter.
disabled. Changes you make here are reflected in the default COS
configuration.
14. If no other defaults need to be changed, type a to apply the configuration
changes. Press Enter.
*** CONFIGURATION COMPLETE - press 'a' to apply
Select from menu, or press 'a' to apply config (? - help) a
15. When Save Configuration data to file appears, type Yes and press Enter.
Save configuration data to a file? [Yes] Yes
16. The next request asks where to save the files. To accept the default, press
Enter. To save the files to another directory, enter the directory and then
press Enter.
Save config in file: [/opt/zimbra/config.2910]
Saving config in /opt/zimbra/config.2910...done.
17. When The system will be modified - continue? appears, type Yes and press
Enter.
20
The server is modified. Installing all the components and configuring the
server can take several minutes. Components that are installed include
spam training and documents, (wiki) accounts, time zone preferences,
backup schedules, as well as common Zimlets.
The system will be modified - continue? [No] y
Operations logged to /tmp/zmsetup.07032012-141234.log
Setting local config values...done.
Initializing core config...Setting up CA...done.
Deploying CA to /opt/zimbra/conf/ca ...done.
.
.
Installing webclient skins...
hotrod...done.
lavender...done.
carbon...done.
tree...done.
smoke...done.
.
.
Finished installing webclient skins.
Setting zimbraFeatureIMEnabled=FALSE...done.
Setting zimbraFeatureTasksEnabled=TRUE...done.
.
.
Starting servers...done.
Installing common zimlets...
com_zimbra_email...done.
com_zimbra_url...done.
.
.
Finished installing common zimlets.
Installing network zimlets...
com_zimbra_mobilesync...done.
com_zimbra_hsm...done.
.
.
Finished installing network zimlets.
Restarting mailboxd...done.
Setting up zimbra crontab...done.
Moving /tmp/zmsetup.07032012-144038.log to /opt/zimbra/log
18. When Configuration complete - press return to exit displays, press Enter.
Configuration complete - press return to exit
21
1. Type su - zimbra.
2. Type zmcontrol status. The services status information is displayed. All
22
Final Set-Up
After the Zimbra servers are configured, the following functions must be
configured.
Important: Zimbra Collaboration supports the default syslog of a supported
operating system. Depending on your operating system, the steps contained
in this section might not be correct. See your operating system documentation
for specific information about how to enable syslog.
If logger is installed, set up the syslog configuration files to enable server
Zimbra Collaboration requires access to this account via ssh public key
authentication. On most operating systems this combination is okay, but if
you have modified pam rules to disallow any ssh access to disabled
accounts then you must define a password for the zimbra UNIX account.
This will allow ssh key authentication for checking remote queues. See the
Zimbra wiki article, Mail Queue Monitoring.
Set up the ssh keys. To populate the ssh keys, as Zimbra user (su-zimbra).
Type zmupdateauthkeys and press Enter. The key is updated on
/opt/zimbra/.ssh/authorized_keys.
Enabling Server Statistics Display. In order for the server statistics to display
display statistics.
2. You must enable syslog to log statistics from remote machines.
Optional Configurations
You can configure the following options:
Zimbra Collaboration 8.6
23
Provisioning Accounts
Once the mailbox server is running, open your browser, enter the
administration console URL and log on to the console to provision email
accounts. The administration console URL is entered as:
https://[mailhost.example.com]:7071
Note: To go to the administration console, you must type https, even if you
configured the Web server mode as HTTP.
The first time you log on, a warning may be displayed stating the connection is
untrusted. This only applies the first time you log in. Click I understand the
Risks to be able to connect to the Zimbra administration console. Then click
OK.
Enter the admin user name and password configured during the installation
process. Enter the name as admin@mailhost.example.com.
Provision accounts
You can configure one account at a time with the New Account Wizard or you
can create many accounts at once using the Account Migration Wizard.
Note: Four accounts are listed: admin account, two spam training
accounts, and a global Documents account. These accounts do not
need any additional configuration.
2. Click Add Account. The first page of the New Account wizard opens.
24
3. Enter the account name to be used as the email address and the last
You can migrate users from Microsoft Exchange server email accounts to
Zimbra server accounts.
Zimbra Collaboration Migration Wizard for Domino. Format is an .exe file.
You can migrate users from Lotus Domino server email accounts to Zimbra
server accounts.
PST Import Wizard (User Instructions). Format is an .exe file. Users
download the Import Wizard to their computers and run the executable file
to import their Outlook .pst files to the Zimbra server. Before users run this
utility, Zimbra recommends that they run the Outlook Inbox Repair tool,
scanpst.exe, on their .pst files, to clean up any errors in their file. For more
information about this tool, go to http://support.microsoft.com/kb/287497.
Administrators Account
Initial administrative tasks when you log on for the first time may include
setting up the admin mailbox to include features, aliases, and forwarding
addresses needed for the administrators working environment.
Two aliases for the admin account are created during install:
25
The Zimbra servers are stopped, the existing packages, the webapp
directories, and the /opt/zimbra directory are removed.
4. Type rm -rf [zcsfullfilename] to delete the Zimbra Collaboration directory.
5. Delete the zcs.tgz file.
Additional Information
To learn more about the Zimbra Collaboration, read the Administrators Guide
and Help. The Zimbra guides and release notes in .pdf format can be found in
the opt/zimbra/docs directory and is also available from the administration
console Help button and from the Zimbra Website.
Administrator Guide. This guide describes product architecture, server
about how to add and maintain your servers, domains, and user accounts
from the administration console.
26
problems.
Join the Zimbra Community Forums to participate and learn more about the
Zimbra Collaboration.
Send an email to feedback@zimbra.com to let us know what you like about
the product and what you would like to see in the product. Or, if you prefer,
post your ideas to the Zimbra Forums.
If you encounter problems with this software, visit www.zimbra.com and
submit a bug report. Make sure you provide enough detail so that the bug can
be easily duplicated.
27
28
29
System Requirements
Operating System
Network Edition
Virtualization
Network Edition
Operating System
Open Source Edition
File Systems
30
System Requirements
Other Dependencies
Miscellaneous
31
System Requirements
Administrator
Computers
Note: Other
configurations may work.
Administrator Console
Monitor
32
System Requirements
Minimum
Intel/AMD/Power PC CPU 750MHz
256MB RAM
Recommended
Intel/AMD/Power PC CPU 1.5GHz
512MB RAM
For Zimbra Web Client - Advanced version:
The following operating system/browser combinations
for the advanced Zimbra Web Client are supported:
Windows XP with required updates, Vista,
Windows 7, or Windows 8 with one of the following:
Internet Explorer 8.0 and higher
IE8.x for XP
IE9.x and higher for Vista/Windows 7
IE10 and higher for Windows 8
The latest stable release of:
Firefox
Safari
Google Chrome
Mac OS X 10.5, 10.6, 10.7, or 10.8 with one of the
following:
The latest stable release of:
Firefox
Safari
Google Chrome
Linux (Red Hat, Ubuntu, Fedora, or SUSE) with one of
the following:
The latest stable release of:
Firefox
Google Chrome
33
System Requirements
34
System Requirements
Minimum
Intel/AMD/Power PC CPU 750MHz
256MB RAM
Recommended
Intel/AMD/Power PC CPU 1.5GHz
512MB RAM
Operating system POP/IMAP combinations
Windows XP SP 3, Vista SP 2, Windows 7 with
Outlook Express 6, Outlook 2003, (MAPI),
Thunderbird
Fedora Core 4 or later with Thunderbird
Mac OS X 10.4 or later with Apple Mail
Accessibility and Screen Readers
Zimbra recommends that customers requiring use of
screen readers for accessibility leverage the use of the
Standard Zimbra Web Client (HTML).
Zimbra continues to invest in improving the
accessibility of this interface.
**Recommendation - If users are presently using IE 6,
Zimbra strongly recommends that they upgrade to the
latest version of Internet Explorer for optimal
performance with ZWC.
Exchange Web
Services
EWS Clients
Outlook 2011 (MAC only), Apple Desktop Clients
(OS X, 10.8+)
EWS Interoperability
Exchange 2007+
Monitor
Internet Connection
Speed
35
System Requirements
Windows 8
Windows 7
Vista
Windows XP with required updates
Important! Windows XP is deprecated. The 8.x
series of Zimbra Collaboration is the last release
to support Microsoft Outlook 2003 and Microsoft
Windows XP
Microsoft Outlook
36
System Requirements
37
System Requirements
Available Languages
This section includes information about available languages, including End
User Translations and Administrator Translations.
End User Translations
38
Component
Category
Languages
Zimbra Web
Client
Application/UI
Zimbra Web
Client - Online
Help (HTML)
Feature
Documentation
Zimbra Web
Client - End
User Guide
(PDF)
Feature
Documentation
English
Zimbra
Connector for
Microsoft
Outlook
Installer +
Application/UI
Zimbra
Connector for
Microsoft
Outlook - End
User Guide
(PDF)
Feature
Documentation
English
System Requirements
Administrator Translations
Component
Category
Languages
Zimbra Admin
Console
Application
Zimbra Admin
Console Online
Help (HTML)
Feature
Documentation
English
"Documentation"
Install + Upgrade
/ Admin Manual /
Migration /
Import / Release
Notes / System
Requirements
Guides
English
Zimbra
Connector for
Microsoft
Outlook - Admin
Guide (PDF)
Install +
Configuration
Guide
English
Revision History
Zimbra Collaboration 8.6.0, GA
Released December, 2014
39
System Requirements
------------------Copyright 2005-2014 Zimbra, Inc. All rights reserved. This product is protected by U.S. and
international copyright and intellectual property laws. "Zimbra" is a registered trademark of
Zimbra, Inc. in the United States and other jurisdictions.You may not alter or remove any
trademark, copyright, or other notice from copies of the content. All other marks and names
mentioned herein may be trademarks of their respective companies.
Zimbra, Inc.
3000 Internet Blvd., Suite 200
Frisco, Texas 75034
www.zimbra.com
Zimbra Collaboration 8.6.0
December 2014
40