01/04/2008 Internet

The Zimbra Collaboration Suite 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 the Zimbra Collaboration Suite 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 the Zimbra Collaboration Suite 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 will be able to send and receive external email.



1. Click on the dmg file to open the file and then click ZCS.mpkg to open the Zimbra install package. The Apple installer opens and verifies that the server is ready to install the Zimbra Collaboration Suite. Click Continue.

2. Welcome screen appears, click Continue.

3. The Zimbra Software License Agreement is displayed. Read the agreement and click Continue. A popup screen appears asking that to continue the install you must accept the terms of the license agreement. Click Agree.

4. Select the destination volume to install the software. Click Continue.

5. The Easy Install dialog displays. Now you select which services to be installed on this server. To install all service packages on a single server, click Install.

To select which services to install, click Customize. Deselect those packages you do not want installed. See "Overview of Installation Process" for information about the packages. Click Install to proceed.

A progress bar shows the Zimbra packages being installed. When The software was successfully installed dialog displays, click Close.

6. Open the Apple Terminal and log on as root. Type sudo /bin/bash. Enter your root password, if asked.

To install the Zimbra license file during the ZCS install, copy the ZCSLicense.xml file to /opt/zimbra/conf.

7. Type cd /opt/zimbra/libexec

8. Type ls to see the packages in the directory.

9. Type ./zmsetup.pl. This starts the ZCS configuration. A temporary log file is created and the server port configurations are checked for conflicts. 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 Suite to start correctly.

10. If no conflicts are found, the Main menu displays 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 (****).

11. Go to Step 6 on 16 to continue the installation steps.

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 MTA installs the Postfix open source MTA, the Clam AntiVirus antivirus engine, the SpamAssassin junk mail filter, and the Amavisd-New content filter.

- Zimbra Store installs the mailbox server, including Jetty, the servlet container for the Zimbra server.

- Zimbra Spell installs the Aspell open source spelling checker. When Zimbra spell is installed, Zimbra-Apache is also installed.

- Zimbra SNMP installs the SNMP package for monitoring. This package is optional.

- Zimbra Logger installs tools for syslog aggregation, reporting, and message tracing. If you do not install Logger, you cannot use the message trace feature, the server statistics are not captures, and the server statistics section of the administration console does not display.

- Zimbra Proxy installs the proxy feature. Using an IMAP/POP proxy server allows mail retrieval for a domain to be split across multiple Zimbra servers on a per user basis.

Zimbra Archiving installs the Zimbra Archiving and Discovery feature. This is an optional feature for ZCS Network Edition that offers the ability to store and search all messages that were delivered to or sent by ZCS. When this package is installed on the mail server, the cross mailbox search function is enabled. Using the Archiving and Discovery feature can trigger additional mailbox license usage. To find out more about Zimbra Archiving and Discovery, contact Zimbra sales.

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 administrator¡¯s password, which you use to log on to the administration console, and you specify the location of the Zimbra license xml file.