The multiple-server installation is straight-forward and easy to run. You run the same install script on each server, select the component(s) to install, and use the menu to configure the system.
For the latest Zimbra software download, go to www.zimbra.com. Save the Zimbra Collaboration Suite
tar file to the computer from which you are installing the software.
|
1.
|
Log in as root to the Zimbra server and cd to the directory where the Zimbra Collaboration Suite archive file is saved (cd /var/<tmp>/var). Type the following commands.
|
|
•
|
cd [zcs filename] to change to the correct directory. The file name includes the release and build date.
|
zimbra-archiving...NOT FOUND
zimbra-convertd...NOT FOUND
zimbra-cluster...NOT FOUND
|
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE. ZIMBRA, INC. ("ZIMBRA") WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.
|
|
1.
|
Click on the dmg file to open the file and 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.
|
|
5.
|
The Easy Install ... dialog displays. Select the services to be installed on this server.
|
To select which services to install, click Customize. Deselect those packages you do not want installed. See
“Planning for the Installation” 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.
|
8.
|
Type cd /opt/zimbra/libexec.
|
|
9.
|
Type ls to see the packages in the directory.
|
|
10.
|
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.
|
You must configure the Zimbra Master LDAP server before you can install other Zimbra servers. You can set up LDAP replication, configuring a master LDAP server and replica LDAP servers, either configuring all LDAP servers now or after you set up the initial ZCS servers. See
Configuring LDAP Replication.
|
2.
|
Type Y and press Enter to install the zimbra-ldap package. The MTA, Store and Logger packages should be marked N. In the following screen shot example, the package to be installed is emphasized.
|
|
3.
|
Type Y, and press Enter to modify the system. The selected packages are installed on the server.
|
3) Enable default backup schedule: yes
r) Start servers after configuration yes
|
|
4.
|
Type 1 to display the Common Configuration submenus.
|
1)Hostname: ldap-1.example.com
2)Ldap master host: ldap-1.example.com
4)Ldap Admin password: set
5)Require secure interprocess communications Yes
6)TimeZone: (GMT-08.00) Pacific Time (US & Canada)
|
|
5.
|
Type 4 to display the automatically generated LDAP admin password. You can change this password. Write down the LDAP password, the LDAP host name and the LDAP port. You must configure this information when you install the mailbox servers and MTA servers.
|
|
6.
|
Type 6 to set the correct time zone, if your time zone is not Pacific Time.
|
|
7.
|
Type r to return to the Main menu.
|
5) Ldap Replication password: set
6) Ldap Postfix password: set
7) Ldap Amavis password: set
8) Ldap Nginx password: set
|
|
•
|
Type 3, Domain to create, to change the default domain name to the domain name, (example.com).
|
|
•
|
The passwords listed in the LDAP configuration menu are automatically generated. You need these passwords when configuring the MTA and the LDAP replica servers. Write them down. If you want to change the passwords for LDAP root, LDAP replication, LDAP Postfix, LDAP Amavis, and LDAP Nginx, enter the corresponding number 4 through 8 and change the passwords.
|
|
10.
|
When Save Configuration data to file appears, type Yes and press Enter.
|
|
12.
|
When The system will be modified - continue? appears, type y and press Enter.
|
|
13.
|
When Configuration complete - press return to exit displays, press Enter.
|
The zimbra-store package can be installed with the LDAP server, the MTA server, or as a separate mailbox server. You can have more than one mailbox server and new mailbox servers can be added at any time.
|
2.
|
Type Y and press Enter to install the zimbra-logger (optional and only on one mailbox server), zimbra-store, and zimbra-spell (optional) packages. When zimbra-spell is installed, the zimbra-apache package also gets installed. In the following screen shot example, the packages to be installed are emphasized.
|
|
3.
|
Type Y, and press Enter to modify the system. The selected packages are installed on the server.
|
+Configure store for use with reverse mail proxy: FALSE
+Configure store for use with reverse web proxy: FALSE
+Enable Instant Messaging Feature: Disabled
7) Enable default backup schedule: yes
|
|
4.
|
Type 1 and press Enter to go to the Common Configuration menu.
|
1)Hostname: mailstore-1.example.com
2)Ldap master host: mailstore-1.example.com
4)Ldap Admin password: set
5)Require secure interprocess communications Yes
6)TimeZone: (GMT-08.00) Pacific Time (US & Canada)
|
|
•
|
Type 2, press Enter, and type the LDAP host name. (ldap-1.example.com in this example.)
|
|
•
|
Type 4, press Enter, and type the LDAP password.
|
|
•
|
Type 6 to set the correct time zone, if your time zone is not Pacific Time.
|
|
5.
|
Type r to return to the Main menu.
|
13) Enable POP/IMAP proxy: no
21) Configure store for use with reverse mail proxy: FALSE
22) Configure store for use with reverse web proxy: FALSE
|
|
•
|
Type 4 and set the password for the administrator account. The password is case sensitive and must be a minimum of six characters. During the install process, the admin account is provisioned on the mailbox store server. You log on to the administration console with this password.
|
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 a HTTPS connection.
|
7.
|
Type r to return to the Main menu.
|
|
10.
|
When Save Configuration data to a file appears, press Enter.
|
|
12.
|
When The system will be modified - continue? appears, type y and press Enter.
|
|
13.
|
When Configuration complete - press return to exit displays, press Enter.
|
When zimbra-mta is installed, the LDAP host name and the Zimbra LDAP password must be known to the MTA server. If not, the MTA cannot contact the LDAP server and is not able to complete the installation.
|
2.
|
Type Y and press Enter to install the zimbra-mta package. The other packages should be marked N. In the following screen shot example, the package to be installed is emphasized.
|
|
3.
|
Type Y, and press Enter to install the selected package(s).
|
+Require secure interprocess communications: yes
5) Enable default backup schedule: yes
|
1)Hostname: mta-1.example.com
2)Ldap master host: mta-1.example.com
4)Ldap Admin password: set
5)Require secure interprocess communications Yes
6)TimeZone: (GMT-08.00) Pacific Time (US & Canada)
|
|
•
|
Type 2, press Enter, and type the LDAP host name. (ldap-1.example.com in this example.)
|
|
•
|
Type 4, press Enter, and type the LDAP password.
|
|
•
|
Type 6 to set the correct time zone, if your time zone is not Pacific Time.
|
|
5.
|
Type r to return to the Main menu.
|
|
6.
|
Type 2 to go to the Mta menu.
|
3) Enable Spamassassin: yes
5) Notification address for AV alerts: admin@mta-1.example.com
|
|
•
|
Type 2 to set the MTA Auth host. This is the MTA authentication server host name and is set to one of the Zimbra mailbox server’s hostname.
|
|
•
|
You can change 5, AV alerts notification address. This should be an address on the domain, such as the admin address. (admin@example.com)
|
|
•
|
Type 6 and enter the postfix password.
|
|
•
|
Type 7 and enter the amavis password.
|
|
7.
|
Type r to return to the Main menu.
|
|
9.
|
When Save Configuration data to a file appears, press Enter.
|
|
11.
|
When The system will be modified - continue? appears, type y and press Enter.
|
|
12.
|
When Installation complete - press return to exit displays, press Enter.
|
Installing the zimbra-proxy package is optional, but recommended for scalable multi-server deployment. Zimbra proxy is normally installed on the MTA server or can be configured on a separate server. Zimbra proxy can be installed on more than one server.
Important: If you are moving from a non-proxy environment (for example, single server to multi-server environment), additional steps are necessary for the mailbox server and proxy configuration. After you complete the proxy installation, reconfigure the mailbox server as described in the ZCS Administration Guide, Zimbra Proxy chapter.
|
•
|
The Bind password for Nginx ldap user is configured when the LDAP server was installed. This is set when the MTA connected to the LDAP server. This is not used unless the Kerberos5 authenticating mechanism is enabled. Note: Setting the password even though GSSAPI auth/proxy is not set up does not cause any issues.
|
2) Enable POP/IMAP proxy: TRUE
7) Bind password for Nginx ldap user (Only required for GSSAPI auth): set
8) Enable HTTP[S] Proxy: FALSE
|
The LDAP host name and the Zimbra LDAP password must be known to the proxy server. If not, the proxy server cannot contact the LDAP server and the installation fails.
|
2.
|
Type Y and press Enter to install the zimbra-proxy package. The other packages should be marked N. In the following screen shot example, the package to be installed is emphasized.
|
|
3.
|
Type Y, and press Enter to install the selected package.
|
|
•
|
Type 2, press Enter, and type the LDAP host name. (ldap-1.example.com, in this example.)
|
|
•
|
Type 4, press Enter, and type the LDAP password.
|
|
•
|
Type 6 to set the correct time zone, if your time zone is not Pacific Time.
|
|
5.
|
Select Proxy Configuration menu. You can modify any of the values.
|
|
•
|
The Bind password for Nginx ldap user is configured when the LDAP server was installed. This is set when the MTA connected to the LDAP server. This is not used unless the Kerberos5 authenticating mechanism is enabled. Note: Setting the password even though GSSAPI auth/proxy is not set up does not cause any issues.
|
2) Enable POP/IMAP proxy: TRUE
7) Bind password for Nginx ldap user (Only required for GSSAPI auth): set
8) Enable HTTP[S] Proxy: FALSE
|
|
6.
|
Type r to return to the Main menu.
|
|
8.
|
When Save Configuration data to a file appears, press Enter.
|
|
10.
|
When The system will be modified - continue? appears, type y and press Enter.
|
|
11.
|
When Installation complete - press return to exit displays, press Enter.
|
Installing the zimbra-SNMP package is optional, but if you use SNMP monitoring, this package should be installed on each Zimbra server.
+Enable SNMP notifications: yes
+SNMP Trap hostname: example.com
+Enable SMTP notifications: yes
+SMTP Source email address: admin@example.com
+SMTP Destination email address: admin@example.com
|
|
•
|
ZCS ships a default zimbra user with a disabled password. ZCS 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.
|
To populate the ssh keys, on each server, as Zimbra user (
su-zimbra). Type
zmupdateauthkeys and press
Enter. The key is updated on
/opt/zimbra/.ssh/authorized_keys.
In order for the server statistics to display on the administration console, the syslog configuration files must be modified.
When Configuration complete - press return to exit is displayed, the installation is finished and the server has been started. Before going to the next server, you should verify that the server is running.
Use the CLI command, zmcontrol status, to verify that each server is running.
|
3.
|
Type zmcontrol status. The services status information is displayed. All services should be running.
|
To log on to the administration console, open your browser, type the administration console URL and log on to the console. The administration console URL is entered as
https://[example.com]:7071/zimbraAdmin.
The first time you log on, a certificate authority (CA) alert may be displayed. Click
Accept this certificate permanently to accept the certificate and be able connect to the Zimbra administration console. Then click
OK.
Once the Zimbra Collaboration Suite is installed, you can log on to the administration console and configure additional domains, create Classes of Service, and provision accounts. See the Zimbra Administrator’s Guide.
A default Class of Service (COS) is automatically created during the installation of Zimbra software. The COS controls mailbox quotas, message lifetime, password restrictions, attachment blocking and server pools. You can modify the default COS and create new COSs to assign to accounts according to your group management policies.
In an environment with multiple mailbox servers, COS is used to assign the new accounts to a mailbox server. The COS server pool tab lists the mailbox servers in your Zimbra environment. When you configure the COS, select which servers to add to the server pool. Within each pool of servers, a random algorithm assigns new mailboxes to any available server.
|
2.
|
Click New. The first page of the New Account Wizard opens.
|
|
4.
|
You can click Finish at this point, and the account is configured with the default COS and global features.
|
You can provision up to 500 accounts on once using the Bulk Account Wizard from the administration console. The wizard takes you through the steps to upload a .csv file with the account information and then provisions the user accounts. These accounts are configured with a user name, display name and password (optional). The accounts are automatically assigned the domain default COS.
Zimbra’s migration and import tools can be used to move users’ email messages, calendars, and contacts from their old email servers to their accounts on the Zimbra server. When the user’s files are imported, the folder hierarchy is maintained. These tools can be accessed from the administration console Download page and instruction guides are available from the Administration Console Help Desk.
|
3.
|
When Completely remove existing installation? is displayed, type Yes.
|
Note: For Mac, type cd /;/opt/zimbra/libexec/installer/install-mac.sh - u.
