ZCS Quick Start Installation Guide Network Edition 6.0

Installing Zimbra Software

Verify Zimbra Server Operation

Installing Zimbra Software on a Mac Server

Installing Zimbra Proxy package

For servers other than Mac servers, open an SSH session to the Zimbra server and follow the steps below.

For Macs, see Installing Zimbra Software on a Mac Server.

1.	Log in as root to the Zimbra server and cd to the directory where the Zimbra Collaboration Suite archive tar file is saved (cd /var/<tmp>). Type the following commands:

•	tar xzvf [zcsfullfilename.tgz], to unpack the file

•	cd [zcsfullfilename] to change to the correct directory.

•	./install.sh, to begin the installation

The install.sh script reviews the installation software to verify that the Zimbra packages are available.

 

[root@infodev]# tar xzvf zcs.tgz zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800/ zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800/packages/ zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800/packages/zimbra-apache-6.0.0_xx_5639.RHEL4.20090520025800.i386.rpm . . zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800/util/addUser.sh [root@infodev]# cd zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800/ [root@infodev zcs-NETWORK-6.0.0_xx_5639.RHEL4.20090520025800]# ./install.sh   Operations logged to /tmp/install.log.14405 Checking for existing installation... zimbra-ldap...NOT FOUND zimbra-logger...NOT FOUND zimbra-mta...NOT FOUND zimbra-snmp...NOT FOUND zimbra-store...NOT FOUND zimbra-apache...NOT FOUND zimbra-spell...NOT FOUND     zimbra-memcached...NOT FOUND zimbra-proxy...NOT FOUND zimbra-archiving...NOT FOUND     zimbra-convertd...NOT FOUND     zimbra-cluster...NOT FOUND     zimbra-core...NOT FOUND

Screenshots in this guide are examples of the Zimbra installation script. The actual script may be different.

2.

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.

3.	The Zimbra software agreement is displayed and includes a link to the license terms for the Zimbra Collaboration Suite. Please read the agreement and press Enter to continue.

 

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.   License Terms for the Zimbra Collaboration Suite: http://www.zimbra.com/license/zimbra_network_eval_license.pdf   Press Return to continue   Checking for prerequisites... FOUND: NPTL FOUND: sudo-1.6.7p5-30.1.3 FOUND: libidn-0.5.6-1      FOUND: gmp-4.1.4-3 FOUND: compat-libstdc++-296-2.96-132.7.2 FOUND: compat-libstdc++-33-3.2.3-47.3 FOUND: libtool-libs-1.5.6-4 FOUND: /usr/lib/libstdc++.so.5 Checking for suggested prerequisites... FOUND: perl-5.8.5 Prerequisite check complete.   Checking for installable packages

4.

Next, the installer checks to see that the prerequisite software is installed. If the prerequisite software packages are not installed, the install process stops. You must fix the problem and start the installation over. See Other Dependencies in System Requirements for Zimbra Collaboration Suite 6.0

5.	Select the services to be installed on this server. To install Zimbra Collaboration Suite on a single server, enter Y for the ldap, logger, mta, snmp, store, and spell packages. If you use IMAP/POP Proxy, enter Y for the Zimbra proxy package.

Note: For the cross mailbox search feature, install the Zimbra Archive package. To use the archiving and discovery feature, contact Zimbra sales.

The installer verifies that there is enough room to install ZCS. If there is not, the installation stops.

6.	Type Y and press Enter to modify the system.

•	Selected packages are installed on the server.

•	Checks to see if MX record is configured in DNS. The installer checks to see if the hostname is resolvable via DNS. If there is an error, the installer asks if you would like to change the hostname. We recommend that the domain name have an MX record configured in DNS.

•	Checks for port conflict.

 

Select the packages to install   Install zimbra-ldap [Y] Y Install zimbra-logger [Y] Y Install zimbra-mta [Y] Y Install zimbra-snmp [Y] Y Install zimbra-store [Y] Y Install zimbra-apache {Y}Y Install zimbra-spell [Y] Y Install zimbra-memcached [N] N Install zimbra-proxy [N] N Install zimbra-archiving [N] N Install zimbra-convertd [Y] Y   Checking required space for zimbra-core checking space for zimbra-store   Installing: zimbra-core zimbra-ldap zimbra-logger zimbra-mta zimbra-snmp zimbra-store zimbra-apache zimbra-spell     zimbra-convertd   The system will be modified. Continue? [N] Y

7.

At this point, the Main menu displays showing 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 (****) to their left

.

Main menu   1) Common Configuration:      +Hostname: mailhost.example.com      +Ldap master host: mailhost.example.com      +Ldap port: 389      +Ldap Admin password: set      +Require secure interprocess communications:yes      +TimeZone: America/Los_Angeles   2) zimbra-ldap: Enabled      +Create Domain: yes      +Domain to create: mailhost.example.com      +Ldap root password: set      +Ldap replication password: set      +Ldap postfix password: set      +Ldap amavis password: set      +Ldap nginx password:                  set   3) zimbra-store: Enabled      +Create Admin User: yes      +Admin user to create:                 admin@mailhost.example.com      +Admin Password set      +Enable automated spam training: yes      +Spam training user:                 spam.rstn2r@mailhost.example.com      +Non-spam(Ham) training user:        ham.bvjx1w@mailhost.example.com      +Global Documents Account:             wiki@mailhost.example.com      +SMTP host: mailhost.example.com      +Web server HTTP port: 80      +Web server HTTPS port: 443      +Web server mode: http      +IMAP server port: 143      +IMAP server SSL port: 993      +POP server port: 110      +POP server SSL port: 995      +Use spell check server: yes      +Spell server URL:        http://mailhost.example.com:7780/aspell.php      +Configure store for use with reverse mail proxy: FALSE      +Configure store for use with reverse web proxy: FALSE      +License filename:                      UNSET   4) zimbra-mta: Enabled 5) zimbra-snmp:                             Enabled 6) zimbra-logger: Enabled 7) zimbra-spell: Enabled 8) zimbra-convertd:                         Enabled 9) Default Class of Service Configuration: 10) Enable default backup schedule: yes r) Start servers after configuration yes s) Save config to file x) Expand menu q) Quit

To navigate the Main menu, select the menu item to change. You can modify any of the defaults. See Table 2, for a description of the Main menu.

For a quick installation, accepting all the defaults, you only need to do the following:

8.	If your time zone is not Pacific time, enter 1 to select Main menu 1, Common Configuration and then enter 5 for TimeZone. Set the correct time zone.

9.	Enter 3 to select zimbra-store from the main menu.

 

Store configuration   1) Status: Enabled 2) Create Admin User: yes 3) Admin user to create: admin@mailhost.example.com ** 4) Admin Password UNSET 5) Enable automated spam training: yes 6) Spam training user: spam@mailhost.example.com 7) Non-spam(Ham) training user: ham@mailhost.example.com 8) Global Documents Account: wiki@mailhost.example.com 9) SMTP host: mailhost.example.com 10) Web server HTTP port: 80 11) Web server HTTPS port: 443 12) Web server mode: http 13) IMAP server port: 143 14) IMAP server SSL port: 993 15) POP server port: 110 16) POP server SSL port: 995 17) Use spell check server: yes 18) Spell server URL:       http://mailhost.example.com:7780/aspell.php   19) Configure store for use with reverse mail proxy: FALSE   20) Configure store for use with reverse web proxy: FALSE **21) License filename: UNSET   Select, or 'r' for previous menu [r]

10.	Select the following from the store configuration menu:

•	Type 4 and type the admin password. The password must be six or more characters. Press Enter.

•	Type 21 for the License filename and type the directory and file name for the Zimbra license. For example, if you saved to the tmp directory, you would type /tmp/ZCSLicense.xml. If you do not have the license, you cannot proceed. See Zimbra License Requirements for ZCS Network Edition.

11.	Type r to return to the Main menu.

12.	If you want to change the default Class of Service settings for new features that are listed here, type 8 Default Class of Service Configuration. Then type the number for the feature to be enabled or disabled. Changes you make here are reflected in the default COS configuration.

 

*** CONFIGURATION COMPLETE - press 'a' to apply Select from menu, or press 'a' to apply config (? - help) a Save configuration data to a file? [Yes] y Save config in file: [/opt/zimbra/config.20644] Saving config in /opt/zimbra/config.20644...done. The system will be modified - continue? [No] y   Setting zimbraFeatureIMEnabled=FALSE...done. Setting zimbraFeatureTasksEnabled=TRUE...done. . . .   Installing common zimlets... com_zimbra_bulkprovision...done. com_zimbra_date...done. com_zimbra_email...done. com_zimbra_cert_manager...done. com_zimbra_url...done. com_zimbra_local...done. com_zimbra_ymemoticons...done. com_zimbra_phone...done. . . . Moving /tmp/zmsetup.10222008-134611.log to /opt/zimbra/log   Configuration complete - press return to exit

13.	If no other defaults need to be changed, type a to apply the configuration changes. Press Enter.

14.	When Save Configuration data to file appears, type Yes and press Enter.

15.	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 then press Enter.

16.	When The system will be modified - continue? appears, type Yes and press Enter.

The server is modified. Installing all the components and configuring the server can take several minutes. Components that are installed include spam training and documents (wiki) accounts, time zone preferences, backup schedules, licenses, as well as common zimlets

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

Verify Zimbra Server Operation

When Configuration complete! appears, the installation is finished and the server has been started.

To verify that the server is running:

1.	Type su - zimbra.

2.	Type zmcontrol status. The services status information is displayed. All services should be running.

 

[zimbra@example ~]$ zmcontrol status Host example.com antispam Running antivirus Running convertd                Running         ldap Running logger Running mailbox Running mta Running snmp Running spell Running stats Running [zimbra@example ~]$

Note: If services are not running, type zmcontrol start.

See the Administration Guide, Appendix A: Command-Line Utilities for more zmcontrol commands.

The installation is complete and the servers are started. You can start adding accounts.

Installing Zimbra Software on a Mac Server

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.	The 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. Select the 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.

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

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.

11.

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 (****).

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

Installing Zimbra Proxy package

The open source nginx proxy is bundled as part of the zimbra-proxy package, and this package can be installed on ZCS servers or on their own independent servers. When the zimbra-proxy package is installed, the proxy feature is enabled.

The Zimbra Proxy includes the following:

•	Nginx. A high performance IMAP/POP3 proxy server which handles all incoming POP/IMAP requests.

•

Memcached. This is a high performance, distributed memory object caching system contained in a separate package called zimbra-memcached. Route information is cached for further use in order to increase performance. There must be at least one memcached server installed for NGINX to function. It is not necessary for nginx and memcached to be on the same system, and you can have multiple nginx installations with only a single memcached installation.

•

Zimbra Proxy Route Lookup Handler. This is a servlet located on the ZCS mailbox server. This servlet handles queries for the user account route information (the server and port number where the user account resides). When the proxy server is configured, the service ports on backend Zimbra mailbox servers are changed to alternate ports. The proxy now services the standard ports for these protocols. This change is applied even if the proxy services are run on their own independent hosts, in order to distinguish and avoid confusion between the services.

ZCS Quick Start Installation Guide Network Edition 6.0