Zimbra Collaboration Server Single Server Installation Guide
Zimbra Collaboration Server Single Server Installation Guide
Zimbra Collaboration Server Single Server Installation Guide
, and
MySQL
. The versions installed have been tested and configured to work with
the Zimbra software. See the Administration Guide for a complete list of
software.
The following table shows the default port settings when the ZCS is installed.
6 Open Source Edition 8.0 Zimbra Collaboration Server
Single Server Installation
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 ZCS installation, Zimbra makes global system
changes that may break applications that are on your server.
Installation Prerequisites
In order to successfully install and run ZCS, 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 ZCS system requirements see Other Dependencies in the System
Requirements table.
Note: To find SSH client software, go to Download.com at http://
www.download.com/ and search for SSH. The list displays software
that can be purchased or downloaded for free. An example of a free
SSH client software is PuTTY, a software implementation of SSH for
Win32 and Unix platforms. To download a copy go to http://putty.nl
Modifying Operating System Configurations
ZCS runs on one of several operating systems, including Ubuntu
LTS, Red
Hat
Linux Enterprise.
Zimbra Port Mapping
Port
Remote Queue Manager 22
Postfix 25
HTTP 80
POP3 110
IMAP 143
LDAP 389
HTTPS 443
Mailboxd IMAP SSL 993
Mailboxd POP SSL 995
Mailboxd LMTP 7025
Zimbra Collaboration Server Open Source Edition 8.0 7
Performing a ZCS Single Server Installation
Installation modifications for frequently used operating systems are described
in individual configuration documents found on the ZCS documentation
website, such as Installation Modifications for ZCS with Ubuntu LTS, or
Installation Modifications for ZCS with Red Hat. Other operating systems may
require similar modifications, and you can use the information contained in
these documents as a reference to gauge whether your operating system
might need to be modified.
A full default installation of the Linux distribution that you select is required.
For more information, refer to the System Requirements document for
information on hardware and software configurations supported by ZCS.
Note: Zimbra recommends that the operating systems you use are updated
with the latest patches that have been tested with ZCS. See the latest
release notes to see the operating systems patch list that has been
tested with ZCS.
Configure DNS
In order to send and receive email, the Zimbra MTA must be configured in
DNS with both A and MX records. For sending mail, the MTA uses DNS to
resolve hostnames and email-routing information. To receive mail, the MX
record must be configured correctly to route the message to the mail server.
During the installation process, ZCS checks to see if you have an MX record
correctly configured. If it is not, an error is displayed suggesting that the
domain name have an MX record configured in DNS.
You must configure a relay host if you do not enable DNS. After ZCS is
installed, go to the Global Settings>MTA tab on the administration console and
uncheck Enable DNS lookups. Enter the relay MTA address to use for external
delivery.
Note: Even if a relay host is configured, an MX record is still required if the
ZCS server is going to receive email from the Internet.
Overview of Installation Process
When you run the install script, the Zimbra install verifies that the correct
prerequisite packages are available to be installed.
Zimbra Core installs the libraries, utilities, and monitoring tools.
Zimbra LDAP installs the OpenLDAP software, which provides open source
LDAP directory services.
Zimbra Store installs the mailbox server, including Jetty, the servlet
container for the Zimbra server.
8 Open Source Edition 8.0 Zimbra Collaboration Server
Single Server Installation
Zimbra MTA installs the Postfix open source MTA, the Clam AntiVirus
antivirus engine, the SpamAssassin junk mail filter, and the Amavisd-New
content filter.
Zimbra SNMP installs the SNMP package for monitoring. This package is
optional.
Zimbra Logger installs tools for syslog aggregation and reporting. If you do
not install Logger the server statistics are not captures, and the server
statistics section of the administration console does not display.
Zimbra Spell installs the Aspell open source spelling checker.
Zimbra Apache is installed automatically when Zimbra Spell 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.
Downloading the Zimbra Software
For the latest Zimbra software download, go to www.zimbra.com. Save the
ZCS archive file to the computer from which you will install the software.
Basic Configuration
The default configuration installs the Zimbra-LDAP, the Zimbra-MTA with anti-
virus and anti-spam protection, the Zimbra mailbox server, the SNMP
monitoring tools (optional), Zimbra-spell (optional), the logger tool (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
Common Configuration - These are common settings for all servers
Hostname The host name configured in the operating system
installation
LDAP master host The LDAP host name. On a single server installation,
this name is the same as the hostname.
LDAP port The default port is 389
Zimbra Collaboration Server Open Source Edition 8.0 9
Performing a ZCS Single Server Installation
LDAP Admin
password
This is the master LDAP password.
Secure interprocess
communications
The default is YES. Secure interprocess
communications requires that connections between
the mail store, and other processes that use Java, use
secure communications. It also specifies whether
secure communications should be used between the
master LDAP server and the replica LDAP servers for
replication.
Time Zone Select the time zone to apply to the default COS. The
time zone that should be entered is the time zone that
the majority of users in the COS will be located in. The
default time zone is PST (Pacific Time).
IP Mode IPv4 is the default. (IPv6 is ZCS 8.0 Beta only).
zimbra-ldap
Status The default is Enabled. For replica LDAP servers, the
status can be changed to Disabled if the database is
manually loaded after installation completes.
Create Domain You can create one domain during installation.
Additional domains can be created from the
administration console.
Domain to create The default domain is the fully qualified hostname of
the server. If you created a valid mail domain on your
DNS server, enter it now. In most cases, you will
accept the default.
LDAP Root password The root LDAP password for internal LDAP
operations.
LDAP Replication
password
This is the password used by the LDAP replication
user to identify itself to the LDAP master and must be
the same as the password on the LDAP master server.
LDAP Postfix
password
This is the password used by the postfix user to
identify itself to the LDAP server and must be
configured on the MTA server to be the same as the
password on the LDAP master server.
LDAP Amavis
password
This is the password used by the amavis user to
identify itself to the LDAP server and must be
configured on the MTA server to be the same as the
password on the LDAP server.
zimbra-store
Main Menu Options
Main Menu Description
10 Open Source Edition 8.0 Zimbra Collaboration Server
Single Server Installation
Create Admin User The administrator account is created during
installation. This account is the first account
provisioned on the Zimbra server and allows you to log
on to the administration console.
Admin user to create The user name assigned to the administrator account.
Once the administrator account has been created, it is
suggested that you do not rename the account as
automatic ZCS notifications might not be received.
Admin Password You must set the admin account password. The
password is case sensitive and must be a minimum of
six characters. The administrator name, mail address,
and password are required to log in to the
administration console.
Anti-virus quarantine
user
A virus quarantine account is automatically created
during installation. When AmivisD identifies an email
message with a virus, the email is automatically sent
to this mailbox. The virus quarantine mailbox is
configured to delete messages older than 7 days.
Enable automated
spam training
By default, the automated spam training filter is
enabled and two mail accounts are created.
1. Spam Training User to receive mail notification
about mail that was not marked as junk, but should
have been.
2. Non-spam (HAM) Training User to receive mail
notification about mail that was marked as junk, but
should not have been.
These addresses are automatically configured to work
with the spam training filter. The accounts created
have a randomly selected name. To recognize what
the account is used for, you may want to change this
name.
Main Menu Options
Main Menu Description
Zimbra Collaboration Server Open Source Edition 8.0 11
Performing a ZCS Single Server Installation
The default port
configurations are
shown
SMTP host
Web server HTTP port: 80
Web server HTTPS port: 443
Web server mode Can be HTTP, HTTPS,
Mixed, Both or Redirect.
Mixed mode uses HTTPS for logging in and
HTTP for normal session traffic
Both mode means that an HTTP session
stays HTTP, including during the login phase,
and an HTTPS session remains HTTPS
throughout, including the login phase.
Redirect mode redirects any users
connecting via HTTP to an HTTPS
connection.
All modes use SSL encryption for back-end
administrative traffic.
IMAP server port: 143
IMAP server SSL port: 993
POP server port: 110
POP server SSL port: 995
Use spell checker server, default Yes (if installed)
Spell server URL: http://<example.com>:7780/
aspell.php
Enable version update checks. ZCS
automatically checks to see if a new ZCS 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.