ZCS Quick Start Installation Guide Open Source Edition 6.0

Installing Zimbra Software

Verify Zimbra Server Operation

Installing Zimbra Software on a Mac Server

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-convertd...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.

Note:  

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   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        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   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   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.

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.	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 15 to continue the installation steps.

ZCS Quick Start Installation Guide Open Source Edition 6.0