Multiple-Server Installation

The multiple-server installation is straight-forward and easy to run. You run the same installation script on each server, select the component(s) to install, and use the menu to configure the system.

When the server installation is complete after final set-up and server configuration steps are run, the servers are started and the status is displayed.

Order of Installation

{product-abbrev} LDAP server(s)
{product-abbrev} MTA server(s)
{product-abbrev} Proxy server(s)
{product-abbrev} Mailbox server(s) options:
- Zimbra Mailbox Server, which includes the mailstore services and webapp services (mailstore server + UI server)
- Zimbra Web Application Server Split mode, which includes:
  - a Zimbra mailstore server (mailstore server)
  - a Zimbra webapp server (UI server)

Note	Zimbra-proxy is normally installed on the MTA server or you can install it on its own server.

Important

Do not manually create the user ‘zimbra’ before running the {product-abbrev} installation. The installation automatically creates this user and sets up its environment.

Important

Before you start, verify that the system clocks are synced on all servers.

Starting the Installation Process

Important

Before you begin, make sure to:

Confirm you have the latest system requirements and prerequisites for installing {product-name}, as described in System Requirements for {product-name}

For the latest {product-name} software downloads, go to https://www.zimbra.com.
Save the {product-name} tar file to the computer from which you are installing the software.

Note	The screen shots are examples of the {product-name} installation script. The actual script may be different.

Step 1 through step 4 are performed for each server to be installed.

Open an SSH session to the {product-short} server and follow the steps below:

Log in as root to the {product-name} server and cd to the directory where the {product-name} archive file is saved (cd /var/<tmp>). Type the following commands.

tar xzvf [zcs.tgz] to unpack the file
cd [zcs filename] to change to the correct directory. The file name includes the release and build date.
./install.sh to begin the installation.

Note	As the installation proceeds, press Enter to accept the defaults that are shown in brackets [ ] or enter the appropriate answer for your configuration.

root@mailhost:/tmp# tar xzvf zcs.tgz
zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615/
zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615/packages/
.
.
.
zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615/install.sh
zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615/README.txt

root@zimbraiop:/tmp/# cd zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615/
root@zimbraiop:/tmp/zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615# ./install.sh

Operations logged to /tmp/install.log.y1YeCSI5
.
.
.

The install.sh script reviews the installation software to verify that the {product-short} packages are available.
The installation process checks to see whether any of the applications Sendmail, Postfix, MySQL or MariaDB are running.
If any of these applications are running, you are asked to disable them.
Disabling MySQL and MariaDB is optional but highly recommended.
Sendmail and Postfix MUST be disabled for {product-name} to start correctly.

root@zimbraiop:/tmp/zcs-NETWORK-8.8.5_GA_1894.UBUNTU16_64.20171026035615# ./install.sh


Operations logged to /tmp/install.log.y1YeCSI5
Checking for existing installation...
    zimbra-connect...NOT FOUND
    zimbra-drive...NOT FOUND
    zimbra-network-modules-ng...NOT FOUND
    zimbra-ldap...NOT FOUND
    zimbra-logger...NOT FOUND
    zimbra-mta...NOT FOUND
    zimbra-dnscache...NOT FOUND
    zimbra-snmp...NOT FOUND
    zimbra-store...NOT FOUND
    zimbra-apache...NOT FOUND
    zimbra-spell...NOT FOUND
    zimbra-convertd...NOT FOUND
    zimbra-memcached...NOT FOUND
    zimbra-proxy...NOT FOUND
    zimbra-archiving...NOT FOUND
    zimbra-core...NOT FOUND

.
.
.

The {product-short} software agreement displays. Read the agreement and when
Do you agree with the terms of the software license agreement? [N]
displays, enter Y to continue.

Important
The license agreement displays in multiple sections, and you must accept each section of the license agreement.

Use {product-short}'s package repository [Y]
displays, press enter to continue. Your system will be configured to add the {product-short} packaging repository for yum or apt-get as appropriate so it can install the {product-short} 3rd party packages.

Checking for installable packages

Found zimbra-core (local)
Found zimbra-ldap (local)
Found zimbra-logger (local)
Found zimbra-mta (local)
Found zimbra-dnscache (local)
Found zimbra-snmp (local)
Found zimbra-store (local)
Found zimbra-apache (local)
Found zimbra-spell (local)
Found zimbra-convertd (local)
Found zimbra-memcached (repo)


Found zimbra-proxy (local)
Found zimbra-archiving (local)
Found zimbra-connect (repo)
Found zimbra-drive (repo)
Found zimbra-network-modules-ng (local)


Use Zimbra's package repository [Y] y
Configuring package repository

Next, select the packages to be installed on this server.

Note
For the cross mailbox search feature, install the {product-short} Archive package. To use the archiving and discovery feature, contact {product-provider} sales.

The installer verifies that there is enough room to install {product-short}.

Next, the installer checks to see that the prerequisite packages are installed as listed in the Other Dependencies section of the System Requirements for {product-name}

Note	Before the Main menu is displayed, the installer checks to see if the hostname is resolvable via DNS and if there is an error asks you if would like to change the hostname. The domain name should have an MX record configured in DNS.

Installing {product-short} LDAP Master Server

You must configure the {product-abbrev} LDAP Master server before you can install other {product-abbrev} 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 {product-name} servers. See the section on Configuring LDAP Replication

Follow steps 1 through 4 in Starting the Installation Process to open an SSH session to the LDAP server, log on to the server as root, and unpack the {product-abbrev} software.

Type y and press Enter to install the zimbra-ldap package.
The zimbra-mta, zimbra-store and zimbra-logger packages should be marked n.

Install zimbra-ldap [Y] Y

Install zimbra-logger [Y] N

Install zimbra-mta [Y] N

Install zimbra-dnscache [Y] N

Install zimbra-snmp [Y] N

Install zimbra-store [Y] N

Install zimbra-apache [Y] N

Install zimbra-spell [Y] N

Install zimbra-convertd [Y] N

Install zimbra-memcached [Y] N

Install zimbra-proxy [Y] N

Install zimbra-archiving [N] N

Install zimbra-connect [Y] N

Install zimbra-drive [Y] N

Install zimbra-network-modules-ng [Y] N

Checking required space for zimbra-core

Installing:
    zimbra-core
    zimbra-ldap

The system will be modified.  Continue? [N]

Type Y, and press Enter to modify the system. The selected packages are installed on the server.

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.

Note
Values that require further configuration are marked with asterisks (*).

To navigate the Main menu, select the menu item to change. You can modify any of the values. See the section Main Menu options for a description of the Main menu.
Main menu 1) Common Configuration: 2) zimbra-ldap: Enabled 3) Enable default backup schedule: yes s) Save config to file x) Expand menu q) Quit *** CONFIGURATION COMPLETE - press 'a' to apply Select from menu, or press 'a' to apply config (? - help)

Type 1 to display the Common Configuration submenu.

Common configuration

   1) Hostname:                                ldap-1.example.com
   2) Ldap master host:                        ldap-1.example.com
   3) Ldap port:                               389
   4) Ldap Admin password:                     set
   5) Store ephemeral attributes outside Ldap: no
   6) Secure interprocess communications:      yes
   7) TimeZone:                                America/Mexico_City
   8) IP Mode:                                 ipv4
   9) Default SSL digest:                      sha256

Select, or 'r' for previous menu [r]

Type 4 to display the automatically generated LDAP admin password.
Select, or 'r' for previous menu [r] 4 Password for ldap admin user (min 6 characters): [bEyMZxNxq]
You can change this password.
Write down the LDAP password, the LDAP host name and the LDAP port.
LDAP Admin Password _______________________ LDAP Host name _______________________ LDAP Port _______________________
Note
You must configure this information when you install the mailbox servers and the MTA servers.

Type 7 to set the correct time zone.

1 Africa/Algiers
.
.
.
94 Europe/London
.
.
.
109 Pacific/Tongatapu
110 UTC
Enter the number for the local timezone: [110] 94

Type r to return to the Main menu.

From the Main menu, type 2 for zimbra-ldap to view the Ldap configuration settings.

Ldap configuration

   1) Status:                                  Enabled
   2) Create Domain:                           yes
   3) Domain to create:                        ldap-1.example.com
   4) Ldap root password:                      set
   5) Ldap replication password:               set
   6) Ldap postfix password:                   set
   7) Ldap amavis password:                    set
   8) Ldap nginx password:                     set
   9) Ldap Bes Searcher password:              set

Select, or 'r' for previous menu [r]

Type 3 for Domain to create to change the default domain name to the main domain name you want to use for your network, (e.g. example.com).
The passwords listed in the LDAP configuration menu are automatically generated.
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.
Ldap replication password _____________________ Ldap postfix password _____________________ Ldap amavis password _____________________ Ldap nginx password _____________________
Note
You need these passwords when configuring the MTA and the LDAP replica servers. Write them down.
When changes to the LDAP configuration menu are complete:
*** CONFIGURATION COMPLETE - press 'a' to apply Select from menu, or press 'a' to apply config (? - help) a Save configuration data to a file? [Yes] Save config in file: [/opt/zimbra/config.8381] Saving config in /opt/zimbra/config.8381...done
- enter r to return to the main menu.
- Type a to apply the configuration changes.
- When Save configuration data to file appears,
  type Yes and press Enter.
- 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 press Enter.
When The system will be modified - continue? [No] appears,
type y and press Enter.

The server is modified. Installing all the components and configuring the server can take a few minutes. This includes but is not limited to setting local config values, creating and installing SSL certificates, setting passwords, timezone preferences, and starting the servers, among other processes.

When Configuration complete - press return to exit displays, press Enter.

*** CONFIGURATION COMPLETE - press 'a' to apply
Select from menu, or press 'a' to apply config (? - help) a
Save configuration data to a file? [Yes]
Save config in file: [/opt/zimbra/config.8381]
Saving config in /opt/zimbra/config.8381...done.
The system will be modified - continue? [No] y
Operations logged to /tmp/zmsetup.20170302-133132.log
Setting local config values...done.
.
.
.
Starting servers...done.
Skipping creation of default domain GAL sync account - not a service node.
Setting up zimbra crontab...done.


Moving /tmp/zmsetup.20170302-133132.log to /opt/zimbra/log


Configuration complete - press return to exit

The installation of the LDAP server is complete.

Installing the {product-short} Mailbox Server

The zimbra-store package can be installed with the LDAP server, the MTA server, or as a separate mailbox server.

You can have the following configuration options:

The {product-short} Mailbox Server containing mailstore services and webapp services (mailstore server + UI server)

or

The Zimbra Web Application Server Split, which includes:
- Mailstore server providing the backend SOAP/REST functionality
- UI server providing the web UI functionality (static html/js/css content)

You can have more than one of the above configurations. In a web application server split environment, you must have at least one mailstore server and one UI server in your configuration.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

multi-server-install-main.adoc

multi-server-install-main.adoc

Multiple-Server Installation

Starting the Installation Process

Installing {product-short} LDAP Master Server

Installing the {product-short} Mailbox Server

Files

multi-server-install-main.adoc

Latest commit

History

multi-server-install-main.adoc

File metadata and controls

Multiple-Server Installation

Starting the Installation Process

Installing {product-short} LDAP Master Server

Installing the {product-short} Mailbox Server