ZCS Multi_Server Installation Guide, Open Source 4.5
Table of Contents Previous Next Index


Planning for the Installation

Planning for the Installation
This chapter describes the components that are installed and reviews the configuration options that can be made when you install the Zimbra Collaboration Suite.
Zimbra Packages
Zimbra architecture includes open-source integrations using industry standard protocols. The third-party software has been tested and configured to work with the Zimbra software. The following describes the Zimbra packages that are installed.
Zimbra Core. This package includes the libraries, utilities, monitoring tools, and basic configuration files. Zimbra Core is automatically installed on each server.
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 the Zimbra Collaboration Suite. 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 Store. The Zimbra store includes the components for the mailbox server, including Apache Tomcat, which is the servlet container the Zimbra software runs within. The Zimbra mailbox server includes the following components:
Data store. The data store is a MySQL® database.
Message store. The message store is where all email messages and file attachments reside.
Index store. Index and search technology is provided through Lucene. Index files are maintained for each mailbox.
Zimbra SNMP. Installing the Zimbra SNMP package is optional. If you choose to install Zimbra-SNMP for monitoring, this package should be installed on every Zimbra server.
Zimbra Logger. Installing the Zimbra Logger package is optional*. If you install the Logger package, it must be installed on the first mailbox server. The Zimbra logger installs tools for syslog aggregation, reporting, and message tracing. If you do not install Logger, you cannot use the message trace feature. In addition, the server statistics are not captured, and the server statistics section of the administration console will not display.
*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 open source spell checker used on the Zimbra Web Client. When Zimbra-spell is installed, the Zimbra-apache package is also installed.
The Zimbra server configuration is menu driven. The installation menu displays the default configuration values. The menu displays the logical host name and email domain name [example.com] as configured for the computer.
Configuration Examples
Zimbra Collaboration Suite can be easily scaled for any size of email environment, from very small businesses with fewer than 25 email accounts to large businesses with thousands of email accounts. The following table shows examples of different configuration options.
 
All ZCS components installed on one server.
See the Zimbra Installation Quick Start for installation instructions.
Zimbra LDAP and Zimbra message store on one server
Zimbra MTA on a separate server.
Possibly include additional Zimbra MTA servers
Zimbra LDAP on one server
Multiple Zimbra mailbox servers
Multiple Zimbra MTA servers
Zimbra Master LDAP server
Multiple Zimbra mailbox servers
Multiple Zimbra MTA servers
Downloading the Zimbra Software
For the latest Zimbra software download, go to www. Zimbra.com. Save the Zimbra Collaboration Suite download file to the computers from which you will install the software.
When the Zimbra Collaboration Suite is installed, the following Zimbra applications are saved to the Zimbra server:
Zimbra Collaboration Suite Migration Wizard for Exchange .exe file to migrate Microsoft® Exchange server email accounts to the Zimbra server.
Zimbra Collaboration Suite Migration Wizard for Domino .exe file to migrate Lotus Domino server email accounts to the Zimbra server.
Zimbra Collaboration Suite Import Wizard for Outlook .exe file to allow users to import their Outlook .pst files to the Zimbra server.
Supporting documentation can be found on the administration console Help Desk page or at www.zimbra.com
Menu-Driven Configuration
The menu driven installation displays the components and their existing default values. During the installation process you can modify the default values. Only those menu options associated with the package being installed are displayed.
The table below describes the Main menu options.
Server Configured
The host name configured in the operating system installation
The LDAP master host name. This LDAP host name is configured on every server.
The root LDAP password for the host. This LDAP password is configured on every server.
Zimbra LDAP Server
Create Domain - Yes. You can create one domain during installation and 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 n
Status - Enabled. For replica LDAP servers the status is changed to Disabled.
Zimbra Mailbox Server
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 default is admin@[mailhost.example.com].
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.
By default, the automated spam training filter is enabled and two mail accounts are created.
Spam Training User to receive mail notification about mail that was not marked as junk, but should be.
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.
The spam training filter is automatically added to the cron table and runs daily.
Zimbra Mailbox Server
zimbra-store (continued)
Web server mode - Can be http, https, mixed. Mixed mode uses HTTPS for logging in and HTTP for normal session traffic. All modes use SSL encryption for back-end administrative traffic. Note: selecting Both will set it to Mixed.
Use spell checker server: yes (if installed)
Spell server URL: http://<example.com>:7780/aspell.php
MTA Auth host. This is configured automatically if the MTA authentication server host is on the same server, but must be configured if the authentication server is not on the MTA. The MTA Auth host must be one of the mailbox servers.
Enable Spamassassin. Default is enabled.
Enable ClamAV. Default is enabled.
Notification address for AV alerts. Sets the notification address for AV alerts. You can either accept the default or create a new address. If you create a new address, remember to provision this address from the admin console. Note: If the virus notification address does not exist and your host name is the same as the domain name on the Zimbra server, the virus notifications queue in the Zimbra MTA server and cannot be delivered.
All servers, if installed
Installing SNMP is optional, but if installed it must be on all servers.
Enable SNMP notifications. The default is No. If you enter yes, you must enter the SNMP Trap hostname.
Enable SMTP notification - The default is No.
SMTP Source email address - If you enter yes for SMTP notification, you must enter the SMTP source email address and SMTP Destination email address - destination email address.
Installed on one mailbox server
If installed, it is automatically enabled. Logs from all the hosts are sent to the mailbox server where the logger package is installed. This data is used to generate the statistics graphs and is used for message tracing, and reporting.
If installed, it is automatically enabled. When composing messages in the Zimbra Web Client, spell check can be run.
When the installation and configuration is complete, if this is set to Yes, the Zimbra server is automatically started.
At any time during the installation, you can save the configuration to a file.
Quit can be used at any time to quit the installation.
Configuring IMAP and POP Proxy Server
Use of an IMAP/POP proxy server allows mail retrieval for a domain to be split across multiple Zimbra servers on a per user basis.
When ZCS is installed on a Zimbra server, the IMAP/POP Proxy server feature can be enabled so that IMAP and POP users connect to a proxy server and are redirected to a specific mail server. When you configure the Zimbra server, from the Main menu select zimbra-store. Then select 9) Enable POP/IMAP proxy. This sets the feature to yes.
When the proxy server is configured, the default POP and IMAP ports are configured for the proxy server. ZCS designates the Zimbra server port numbers. These port numbers cannot be changed. When you enable a proxy server on any Zimbra server, servers that do not have the proxy server enabled, must be configured with appropriate server port number listed in Table 3.
 
When an IMAP or POP user enters his email address and password, the IMAP/POP proxy server searches the LDAP directory server to find which Zimbra server host the account is created on and then passes the authenticating through to the appropriate mailbox server. The proxy server does not contain any data.
After the initial installation, you can edit the global and server configuration from the administration console.
Configuring for Virtual Hosting
You can configure multiple virtual hostnames to host more than one domain name on a server. When you create a virtual host, users can log in without have to specify the domain name as part of their user name.
Virtual hosts are configured from the administration console Domains>Virtual Hosts tab. The virtual host requires a valid DNS configuration with an A record.
When users log in, they enter the virtual host name in the browser. For example, https://mail.example.com. When the Zimbra logon screen displays, users enter only their user name and password. The authentication request searches for a domain with that virtual host name. When the virtual host is found, the authentication is completed against that domain.
Load Balancing on ZCS
You can deploy a load balancer for the Zimbra server so that all users can log in using the same address/name instead of having to remember which server their mailbox is on.
For example, you set up a virtual hostname of mail.example.com and configure four mail servers, mail1.example.com to mail4.example.com.
When users log on to mail.example.com, the load balancer directs the user to any one of the mail servers to verify the log on information. After successfully logging on, users are redirected to the actual server their mail is stored on. While they are logged on, all subsequent requests go directly to their server.
How to set up
In order to configure load balancing for ZCS,
1.
2.
3.
You must turn on the following localconfig setting on each mail server,
zmlocalconfig -e zimbra_auth_always_send_refer=true
 
 

Planning for the Installation

Table of Contents Previous Next Index
ZCS Multi_Server Installation Guide, Open Source 4.5
Copyright © 2007 Zimbra Inc.