Zimbra Collaboration Suite 7.0

Quick Start Installation Guide

Open Source Edition

Installing Zimbra Software

 

Important: Before you begin, make sure to: • Confirm you have the latest system requirements and prerequisites for installing ZCS, as described in System Requirements for Zimbra Collaboration Suite 7.0 on page 65.

Open an SSH session to the Zimbra server and follow the steps below.

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@mailhost tmp]# tar xzvf zcs.tgz zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20100916012803/ zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20100916012803/packages/ zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20100916012803/packages/zimbra-apache_7.0.0_GA_2834.UBUNTU10_64_amd64.deb . . zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20101015012627/install.sh zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20101015012627/README.txt . [root@mailhost tmp]# cd zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20101015012627 [root@mailhost tmp/zcs-NETWORK-7.0.0_GA_2834.UBUNTU10_64.20101015012627# ./install.sh . . Operations logged to /tmp/install.log.3833 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-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.

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

 

Checking for prerequisites... FOUND: NPTL FOUND: sudo-1.7.2p1-1ubuntu5.2 FOUND: libidn11-1.15-2 FOUND: libpcre3-7.8-3build1 FOUND: libgmp3c2-2:4.3.2+dfsg-1ubuntu1 FOUND: libexpat1-2.0.1-7ubuntu1 FOUND: libstdc++6-4.4.3-4ubuntu5 FOUND: libperl5.10-5.10.1-8ubuntu2 Checking for suggested prerequisites... FOUND: perl-5.10.1 FOUND: sysstat Prerequisite check complete.

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.The installer verifies that there is enough room to install ZCS. If there is not, the installation stops.

 

 

Checking for installable packages   Found zimbra-core Found zimbra-ldap Found zimbra-logger Found zimbra-mta Found zimbra-snmp Found zimbra-store Found zimbra-apache Found zimbra-spell   Select the packages to install   Install zimbra-ldap [Y] Install zimbra-logger [Y] Install zimbra-mta [Y] Install zimbra-snmp [Y] Install zimbra-store [Y] Install zimbra-apache [Y] Install zimbra-spell [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

4.	Next, 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.

 

The system will be modified. Continue? [N] y Installing packages     zimbra-core......zimbra-core_7.0.0_GA_2729.UBUNTU10_64_amd64.deb...done zimbra-ldap......zimbra-ldap_7.0.0_GA_2729.UBUNTU10_64_amd64.deb...done zimbra-logger......zimbra-logger_7.0.0_GA_2729.UBUNTU10_64_amd64.deb...done zimbra-mta......zimbra-mta_7.0.0_GA_2729.UBUNTU10_64_amd64.deb...done zimbra-snmp......zimbra-snmp_7.0.0_GA_2729.UBUNTU10_64_amd64.deb...done . . . Operations logged to /tmp/zmsetup.09162010-120613.log Installing LDAP configuration database...done. Setting defaults...   DNS ERROR - resolving MX records for mailhost.example.com It is suggested that the domain name have an MX record configured in DNS Change domain name? [Yes] n done. Checking for port conflicts

5.

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.

To navigate the Main menu, select the menu item to change. You can modify any of the defaults. See “Main Menu Options,” on page 7, for a description of the Main menu.

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

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

.

Main menu 1) Common Configuration: +Hostname:                           mailhost.example.com +Ldap master host:     mailhost.example.com +Ldap port:                          389 +Ldap Admin password:     set +Secure interprocess communications: yes +TimeZone:                           America/Los_Angeles 2) zimbra-ldap:                          Enabled         +Status                             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         +Status                               Enabled         +Create Admin User:                   yes +Admin user to create:                admin@mailhost.example.com ******* +Admin Password                       UNSET +Anti-virus quarantine user:          virus-quarantine.zodi72xmm6@mailhost.example.com +Enable automated spam training:      yes +Spam training user           spam.vviwu_izoj@mailhost.example.com +Non-spam(Ham) training user: ham.unsbogyzer@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 for use with mail proxy: FALSE +Configure for use with web proxy: FALSE +Enable version update checks: TRUE +Enable version update notifications: TRUE +Version update notification email:   admin@mailhost.example.com +Version update source email:         admin@mailhost.example.com    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   c) Collapse menu   r) Start servers after configuration     yes    s) Save config to file  q) Quit

 

7.	Type r to return to the Main menu.

8.	Enter 3 to select zimbra-store from the Main menu. The Store configuration menu displays.

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

•	Enable version update checks and Enable version update notifications are set to TRUE. ZCS automatically checks for the latest ZCS software updates and notifies the account that is configured in Version update notification email. You can modify this later from the administration console.

 

Store configuration   1) Status: Enabled 2) Create Admin User:                     yes 3) Admin user to create:                  admin@mailhost.example.com ** 4) Admin Password UNSET 5) Anti-virus quarantine user:            virus-quarantine.zodi72xmm6@mailhost.example.com 6) Enable automated spam training: yes 7) Spam training user: spam.vviwu_izoj@mailhost.example.com 8) Non-spam(Ham) training user: ham.unsbogyzer@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 for use with mail proxy: FALSE 20) Configure for use with web proxy: FALSE 21) Enable version update checks: TRUE 22) Enable version update notifications:    TRUE   Select, or 'r' for previous menu [r] 4   Password for admin@mailhost.example.com (min 6 characters): [2LPoBSob] zimbra

10.	Type r to return to the Main menu.

11.	If you want to change the default Class of Service settings for new features that are listed here, type 9 for 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.

12.	If no other defaults need to be changed, type a to apply the configuration changes. 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] y Save config in file: [/opt/zimbra/config.6585] Saving config in /opt/zimbra/config.6585...done.

 

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

 

Save configuration data to a file? [Yes] y Save config in file: [/opt/zimbra/config.6585] Saving config in /opt/zimbra/config.6585...done.

 

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

 

Save config in file: [/opt/zimbra/config.6585] Saving config in /opt/zimbra/config.6585...done.

 

15.	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, as well as common zimlets.

 

The system will be modified - continue? [No] y Operations logged to /tmp/zmsetup.10152010-084228.log Setting local config values...done. Setting up CA...done. Deploying CA to /opt/zimbra/conf/ca ...done. . . Installing webclient skins... hotrod...done. lavender...done. carbon...done. tree...done. smoke...done. . . Finished installing webclient skins. Setting zimbraFeatureIMEnabled=FALSE...done. Setting zimbraFeatureTasksEnabled=TRUE...done. . . Starting servers...done. Installing common zimlets... com_zimbra_email...done. com_zimbra_url...done. . . Finished installing common zimlets. Installing network zimlets... com_zimbra_mobilesync...done. com_zimbra_hsm...done. . . Finished installing network zimlets. Restarting mailboxd...done. Setting up zimbra crontab...done.   Moving /tmp/zmsetup.09162010-120613.log to /opt/zimbra/log

 

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

 

Configuration complete - press return to exit