ZCS Quick Start Installation Guide, Open Source 6.0
Table of Contents Previous Next


Zimbra™ Collaboration Suite Single Server Installation - Open Source : Installing Zimbra Software

Installing Zimbra Software
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/packages/zimbra-apache-6.0.0_xx_5639.RHEL4.20090520025800.i386.rpm
    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. Read the agreement and when Do you agree with the terms of the software license agreement displays, enter Y to continue.
 
IMPORTANT-READ CAREFULLY: BY DOWNLOADING, INSTALLING, OR USING THE SOFTWARE, YOU (THE INDIVIDUAL OR LEGAL ENTITY) AGREE TO BE BOUND BY THE TERMS OF THIS END USER LICENSE AGREEMENT (EULA). IF YOU DO NOT AGREE TO THE TERMS OF THIS EULA, YOU MUST NOT DOWNLOAD, INSTALL, OR USE THE SOFTWARE, AND YOU MUST DELETE OR RETURN THE UNUSED SOFTWARE TO THE VENDOR FROM WHICH YOU ACQUIRED IT WITHIN THIRTY (30) DAYS AND REQUEST A REFUND OF THE LICENSE FEE, IF ANY, THAT YOU PAID FOR THE SOFTWARE.
EVALUATION LICENSE. If You are licensing the Software for evaluation purposes, your use of the Software is only permitted in a non production environment and for the period limited by the Software License Key. Notwithstanding any other provision in this EULA, an Evaluation License of the Software is provided AS-IS without support or warranty of any kind, expressed or implied.
For Software licensed on a Subscription basis, You may create and use for up to the number of Mailbox during the term of the Subscription. Upon expiration or termination of a Subscription, You shall promptly cease use of the Software and product documentation and destroy (and certify to VMware in writing the fact of such destruction), or return to VMware all copies of the Software and product documentation then in Your possession or control.
     FOUND: gmp-4.1.4-3
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.
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.
 
    
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
.
     +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
     +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
     +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
     +Enable version update checks:         TRUE
5) zimbra-snmp:                             Enabled
8) zimbra-convertd:                         Enabled
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.
 
18) Spell server URL:       http://mailhost.example.com:7780/aspell.php
  19  Enable version update checks:             TRUE
  20) Enable version update notifications:      TRUE
  21) Version update notification email:        admin@example.com
  22) Version update source email:              admin@example.com
10.
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.
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.
 
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.
 
convertd                Running
        ldap Running
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
Note: Mac OS X 10.4.x. is supported in ZCS 6.0.x, but Mac OS X 10.5 and Mac OS X 10.6 are not supported.
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.
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.
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 to continue the installation steps.

Zimbra™ Collaboration Suite Single Server Installation - Open Source : Installing Zimbra Software

Table of Contents Previous Next
ZCS Quick Start Installation Guide, Open Source 6.0
Copyright © 2010 Zimbra Inc.