How to Install the Zimbra Collaboration Suite (ZCS) on Ubuntu Server Systems

Step-by-Step Guide

1. 1

   Step 1: Enable the root account

        For eg. if you use the hostname abc.example.com with the ip address
   27.251.168.3. adjust this as per your requirement, but make sure that choose hostname (abc.example.com) has a valid mail exchange record (mx) record in domain name system (dns). if you want to create email accounts for xyz.example.com instead of abc.example.com, so you should have an mx details for xyz.example.com as well.     If you have the zimbra email server is in a local network (27.251.168.3, a private ip address) behind a router, so make sure you use the router's public ip address (e.g.
   7.8.9.0) in the dns records.     If you have a dynamic ip address, you could use a service of dyndns.org, but ensure that the elected public ip address is not blacklisted.
2. 2

   Step 2: install an ssh daemon and apply a static ip address and a host-name to the system.

   Afterwards, become root by running “su”  ,, in the screen you will see as below:         # this file describes the network interfaces available on      your system    # and how to activate them. for more information, see      interfaces(5).         # the loopback network interface    auto lo    iface lo inet loopback         # the primary network interface    auto eth0    iface eth0 inet static            address
   27.251.168.3            netmask
   255.255.255.0            network
   27.251.0.0            broadcast
   27.251.0.255            gateway
   27.251.0.1,, this is done by typing “vi/etc/hosts”. on the screen you will see as below:        
   127.0.0.1         localhost.localdomain     localhost   
   27.251.168.3    mail.example.com         mail   The following lines are desirable for ipv6 capable hosts    ::1     ip6-localhost ip6-loopback    fe00::0 ip6-localnet    ff00::0 ip6-mcastprefix    ff02::1 ip6-allnodes    ff02::2 ip6-allrouters    ff02::3 ip6-allhosts ,, They both should show abc.example.com.     From now on, you can use an ssh client such as putty and connect from your workstation to your ubuntu server and follow the remaining steps. ,, If this is no fresh system and you have some services already running (such as postfix, apache, openldap), you must disable them first before installing zimbra. otherwise      zimbra will fail to install.     For example, to disable postfix on your system, run         "/etc/init.d/postfix stop    update-rc.d
   -f postfix remove"     The commands for the other services are similar. , therefore we do this:         rm
   -f /bin/sh    ln
   -s /bin/bash /bin/sh     If you don't do this, you will most likely get an error like this during the zimbra installation:         creating ssl certificate...done    initializing ldap...tls: error:02001002:system      library:fopen:no such file or directory bss_file.c:352    tls: error:20074002:bio routines:file_ctrl:system lib      bss_file.c:354    tls: error:140b0002:ssl      routines:ssl_ctx_use_privatekey_file:system lib      ssl_rsa.c:648    main: tls init def ctx failed:
   -1    error
   - failed to start slapd     Failed (1)     On ubuntu dapper drake, /bin/sh points to /bin/bash by default, so everything is ok.,         afterwards, unpack the zimbra .tgz file and start the      installer:         tar xvfz zcs-4.5.3_ga_733.ubuntu6.tgz    cd zcs/    ./install.sh         The installer will ask a few questions. answer them like      this:         operations logged to /tmp/install.log.4416    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          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:
   Click Here  http:         install zimbra-ldap <-- <enter>         install zimbra-logger <-- <enter>         install zimbra-mta <-- <enter>         install zimbra-snmp <-- <enter>         install zimbra-store <-- <enter>         install zimbra-spell <-- <enter>         The system will be modified.  continue? <-- y     Main menu: 1)hostname:                               abc.example.com 2) ldap master list:                       abc.example.com       3) ldap port:                               389       4) ldap password:                           set       5) zimbra-ldap:                             enabled       6) zimbra-store:                            enabled            +create admin user:                    yes            +admin user to create:                      [email protected]    ******* +admin password                        unset            +enable automated spam training:       yes            +spam training user:                        [email protected]            +non-spam(ham) training user:               [email protected]            +global documents account:                  [email protected]            +smtp host:                                 abc.example.com            +web server http port:                 80            +web server https port:                443            +web server mode:                      http            +enable pop/imap proxy:                no            +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:         main menu            1) hostname:                                     abc.example.com       2) ldap master host:                             abc.example.com       3) ldap port:                               389       4) ldap password:                           set       5) zimbra-ldap:                             enabled       6) zimbra-store:                            enabled       7) zimbra-mta:                              enabled       8) zimbra-snmp:                             enabled       9) zimbra-logger:                           enabled      10) zimbra-spell:                            enabled       r) start servers after configuration        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)      <-- a    save configuration data to a file? <-- <enter>    save config in file: <-- <enter>    saving config in /opt/zimbra/config.5762...done    the system will be modified
   - continue? <-- y         you have the option of notifying zimbra of your      installation.    this helps us to track the uptake of the zimbra      collaboration suite.    the only information that will be transmitted is:            the version of zcs installed (4.5.3_ga_733_ubuntu6)            the admin email address created      ([email protected])         notify zimbra of your installation? <-- configuration complete
   - press return to exit <-- <enter>         that's it already. to test if all zimbra services are      running, become the zimbra user:         su
   - zimbra         and run         zmcontrol status         the output should look like this:         zimbra@mail:~$ zmcontrol status    host mail.example.com            antispam             running            antivirus              running            ldap                    running            logger                 running            mailbox               running            mta                     running            snmp                   running            spell                    running         if not all services are started, run         "zmcontrol start"         Type "exit" to become root again
3. 3

   Step 3: Enable the root account:     To enable the root account

4. 4

   Step 4: run “sudo passwd root” and specify a password for root.

5. 5

   Step 5: Install the ssh daemon:     Just run “apt-get install ssh openssh-server” to install the ssh daemon.

6. 6

   Step 6: Apply a static ip address and hostname:     Edit /etc/network/interfaces and adjust it to your needs by using code “vi /etc/network/interfaces”.

7. 7

   Step 7: Restart your network by typing “/etc/init.d/networking restart”.

8. 8

   Step 8: Edit /etc/hosts.

9. 9

   Step 9: Run "echo mail.example.com > /etc/hostname” and reboot the system by typing command "shut-down -r now".

10. 10

    Step 10: Run     "hostname    hostname -f".

11. 11

    Step 11: Disable the ubuntu CD in /etc/apt/sources.list     If you'd like to install all packages over the internet instead of from the ubuntu cd

12. 12

    Step 12: disable the ubuntu cd in /etc/apt/sources.list now: “vi /etc/apt/sources.list”     On ubuntu 6.10 ("edgy eft")

13. 13

    Step 13: comment out this line:                 “#deb cdrom:/ edgy main restricted            ”On ubuntu 6.06 ("dapper drake")

14. 14

    Step 14: it's this line:                 "#deb cdrom:/ dapper main restricted            "     Then update the packages database by running “apt-get update”

15. 15

    Step 15: Disable services.

16. 16

    Step 16: Change the default shell (ubuntu 6.10 edgy eft only)          If you are on ubuntu edgy eft

17. 17

    Step 17: most probably /bin/sh is a symlink to /bin/dash

18. 18

    Step 18: however we need /bin/bash

19. 19

    Step 19: not /bin/dash.

20. 20

    Step 20: Install zimbra         First let's install some prerequisites for zimbra:         apt-get install curl fetchmail libpcre3 libgmp3c2 libexpat1 libxml2 libtie-ixhash-perl         Afterwards

21. 21

    Step 21: go to http://www.zimbra.com/community/downloads.html and download      the ubuntu 6 (.tgz) package to /usr/src

22. 22

    Step 22: for example like      this:         cd /usr/src    wget      http://kent.dl.sourceforge.net/sourceforge/zimbra/zcs-4.5.3_     ga_733.ubuntu6.tgz         (replace the download url with the one you get from      sourceforge.)

Detailed Guide

About the Author