Monday, June 16, 2014

How to Install Zimbra 8.0.2 on Ubuntu 12.04 LTS

Introduction

VMware Zimbra is an enterprise class email, calendar and collaboration suite designed for the cloud, both private and public. The flexibility, scalability and stability of Zimbra make it as a complete email solution that can be deployed in any environment either small or large. Zimbra email server can be accessed from the Zimbra Web Client, Zimbra Desktop offline client, Outlook and a variety of other standards-based email clients and mobile devices.
The three editions of Zimbra are:

1. ZCS Network Edition
2. ZCS hosted email by a Zimbra partner
3. ZCS Open Source Edition (free)

Components included with Zimbra Collaboration Server 8.0.2
  • Postfix - Free Mail Transfer Agent
  • MySQL - Database sofware
  • OpenLDAP - LDAP for User authentication
  • Jetty - Web application server
  • Lucene  - Test and search engine
  • ClamAV  - Antivirus scanner
  • SpamAssassin - Anti-spam software
  • Amavis (amavisd-new) - Content checker
  • Aspell - Spell checker
  • James/Sieve - Email filter

    Installation of Zimbra 8.0.2 Open Source Edition on Ubuntu 12.04 LTS


    System Requirements

    Refer the linkhttps://www.zimbra.com/docs/os/8.0.0/multi_server_install/wwhelp/wwhimpl/common/html/wwhelp.htm#href=ZCS_Multiserver_Open_8.0.System_Requirements_for_VMware_Zimbra_Collaboration_Server_8.0.html&single=true 

    Assumptions

    The configuration is based on the following assumptions:

    Ubuntu server IP - 192.168.1.100
    Ubuntu Server FQDN - mail.mydomain.com
    DNS Server IP - 192.168.1.10 (Internal Windows DNS server) , 8.8.8.8
    Gateway IP - 192.168.1.1
    Domain name - mydomain.com

    A.) Preparing Ubuntu for Zimbra Installation

    1. Install Ubuntu 12.04 LTS on your server (Include openssh-server during package selection)

    2. Login as root user.

    3. Update and upgrade Ubuntu

        #apt-get update
        #apt-get upgrade

    4. Set a static IP for the server

    #vi /etc/network/interfaces

    auth eth0
    iface eth0 inet static
    address 192.168.1.100
    gateway 192.168.1.1
    netmask 255.255.255.0
    network 192.168.1.0
    broadcast 192.168.1.255
    dns-nameservers 192.168.1.10 8.8.8.8
     :wq!

    Now restart networking to make the change effective: /etc/init.d/networking restart

    5. Set a hostname for the server. Latter this will become the name of your Zimbra email server.

    #vim  /etc/hostname

    mail.mydomain.com

    :wq!

    6. DNS Configuration:

    You can either use BIND or your internal DNS server (eg: Windows DNS server).
    Here you can find the configuration of both. In this example I used my Internal Windows DNS server to create A record and MX record.

    a.) For BIND configuration follow the below steps:

    i. Install BIND9 : # sudo apt-get install bind9
    ii. Edit the file : # vi /etc/bind/named.conf
        and remove '//' from forwarders and add DNS server IP address like below:
      
    forwarders {
                  8.8.8.8;
             };


    And add the below lines and save the file:

     zone "mail.mydomain.com" {
              type master;
              file "file.mail.mydomain.com";
    };




    Now create a file "file.mail.mydomain.com" in /var/cache/bind/ directory and add the following inside the file:

    $ttl 38400
    @    IN    SOA    mail.mydomain.com.    mail.mydomain.com. (
                                                                        2011091202
                                                                       10800
                                                                       3600
                                                                       604800
                                                                       38400 )
           IN    NS       ns.mail.mydomain.com
           IN    A         192.168.1.100
           IN    MX     10 mail.mydomain.com


    @     A    192.168.1.100
    ns     A    192.168.1.100

    mail  A   192.168.1.100 


    Then edit /etc/resolv.conf and change nameserver to 192.168.1.100

    Now restart BIND9 services: # /etc/init.d/bind9 restart

    For more info visit http://blog.zimbra.com/blog/archives/2007/06/making-zimbra-bind-work-together.html andhttp://wiki.zimbra.com/wiki/Split_dns

    b.) If it is a Windows DNS Server:

    >Edit  /etc/resolv.conf  and provide the IP address of your Windows DNS server.

    nameserver 192.168.1.10
      
    >Create forward lookup zone (mydomain.com) and add the below records:

    Forward lookup zone name<-> mydomain.com

     A record <->  mail  <-> 192.168.1.100

     MX record <->  mail <-> mail.mydomain.com  <-> priority 10

    Now verify the dns configuration using the code #dig mail.mydomain.com mx (in this example I used windows DNS server)

    ; <<>> DiG 9.8.1-P1 <<>> mail.mydomain.com mx
    ;; global options: +cmd
    ;; Got answer:
    ;; ->>HEADER<<- 37752="" br="" id:="" noerror="" opcode:="" query="" status:="">;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1

    ;; QUESTION SECTION:
    ;mail.mydomain.com.                 IN      MX

    ;; ANSWER SECTION:
    mail.mydomain.com.         3600    IN      MX      10 mail.mydomain.com.

    ;; ADDITIONAL SECTION:
    mail.mydomain.com          3600    IN      A       192.168.1.100

    ;; Query time: 1 msec
    ;; SERVER: 192.168.1.10#53(192.168.1.10)
    ;; WHEN: Thu Feb  4 20:57:38 2013
    ;; MSG SIZE  rcvd: 63

    7. Firewall Configuration (Optional)

    Zimbra recommends us to install ZCS on a sytem without a firewall. If required you can configure a firewall in your Ubuntu 12.04 LTS. For more info refer the documents: http://wiki.zimbra.com/wiki/Firewall_Configuration
    https://help.ubuntu.com/community/IptablesHowTo#Disabling%20the%20firewall  

    8. Installing  prerequisites:

    You have to install the below packages before installing ZCS 8.0.2

    #apt-get install netcat-traditional

    #apt-get install libperl5.14

    #apt-get install libidn11-dev

    #apt-get install libgmp3c2  sysstat  sqlite3

    9. Disable & remove Apparmour

    #sudo /etc/init.d/apparmour stop
    #sudo /etc/init.d/apparmor teardown
    #sudo update-rc.d -f apparmor remove

    B.) Installing Zimbra

    10. Download Zimbra collaboration suite 8.0.2 from Zimbra website :

    #wget http://files2.zimbra.com/downloads/8.0.2_GA/zcs-8.0.2_GA_5569.UBUNTU12_64.20121210115059.tgz

    11. Unpack the downloaded zimbra package:

    #tar -zxvf zcs-8.0.2_GA_5569.UBUNTU12_64.20121210115059.tgz

    12. Go the zimbra package and install it.

    #cd zcs-8.0.2_GA_5569.UBUNTU12_64.20121210115059

    #./install.sh

    Operations logged to /tmp/install.log.1431
    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-convertd...NOT FOUND
        zimbra-memcached...NOT FOUND
        zimbra-proxy...NOT FOUND
        zimbra-archiving...NOT FOUND
        zimbra-cluster...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:
      http://www.zimbra.com/license/zimbra_public_eula_2.1.html

    Do you agree with the terms of the software license agreement? [N] Y

    Oracle Binary Code License Agreement for the Java SE Platform Products

    ORACLE  AMERICA, INC. ("ORACLE"), FOR AND ON BEHALF OF ITSELF AND ITS SUBSIDIARIES AND AFFILIATES UNDER COMMON CONTROL, IS WILLING TO  LICENSE  THE SOFTWARE  TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS  CONTAINED IN THIS BINARY CODE LICENSE AGREEMENT AND SUPPLEMENTAL  LICENSE TERMS (COLLECTIVELY "AGREEMENT").  PLEASE READ THE AGREEMENT  CAREFULLY.  BY SELECTING THE "ACCEPT LICENSE AGREEMENT" (OR THE EQUIVALENT) BUTTON AND/OR BY USING THE SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE READ THE TERMS AND AGREE TO THEM.  IF YOU ARE AGREEING TO THESE TERMS ON BEHALF OF A  COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL  AUTHORITY TO BIND THE LEGAL ENTITY TO THESE TERMS.  IF YOU DO NOT HAVE SUCH  AUTHORITY, OR IF YOU DO NOT WISH TO BE BOUND BY THE TERMS, THEN SELECT THE "DECLINE LICENSE AGREEMENT" (OR THE EQUIVALENT) BUTTON AND YOU MUST NOT USE THE SOFTWARE ON THIS SITE OR ANY OTHER MEDIA ON WHICH THE SOFTWARE IS CONTAINED.

    I.  THIRD PARTY CODE.  Additional copyright notices and license terms applicable to portions of the Software are set forth in the THIRDPARTYLICENSEREADME file accessible at http://www.oracle.com/technetwork/java/javase/documentation/index.html.  In addition to any terms and conditions of any third party opensource/freeware license identified in the  THIRDPARTYLICENSEREADME file, the disclaimer of warranty and limitation of liability  provisions in  paragraphs 4 and 5 of the Binary Code License Agreement shall apply to all Software in this distribution.

    J.  TERMINATION FOR INFRINGEMENT.  Either party may terminate this Agreement immediately should any Software become, or in either party's opinion be likely to become, the subject of a claim of infringement of any intellectual property right.

    K.  INSTALLATION AND AUTO-UPDATE.  The Software's installation and auto-update processes transmit a limited amount of data to Oracle (or its service  provider) about those specific processes to help Oracle understand and optimize them.  Oracle does not associate the data with personally  identifiable  information.  You can find more  information about the data Oracle collects as a result of your Software download at http://www.oracle.com/technetwork/java/javase/documentation/index.html.

    For inquiries please contact:  Oracle America, Inc., 500 Oracle Parkway,
    Redwood Shores, California 94065, USA.

    Last updated May 17, 2011

    Do you agree with the terms of the software license agreement? [N] Y

    Checking for prerequisites...
         FOUND: NPTL
         FOUND: netcat-openbsd-1.89-4ubuntu1
         FOUND: sudo-1.8.3p1-1ubuntu3.3
         FOUND: libidn11-1.23-2
         FOUND: libpcre3-8.12-4
         FOUND: libgmp3c2-2:4.3.2+dfsg-2ubuntu1
         FOUND: libexpat1-2.0.1-7.2ubuntu1.1
         FOUND: libstdc++6-4.6.3-1ubuntu5
         FOUND: libperl5.14-5.14.2-6ubuntu2.2

    Checking for suggested prerequisites...
         FOUND: perl-5.14.2
         FOUND: sysstat
         FOUND: sqlite3
    Prerequisite check complete.

    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
    Found zimbra-memcached
    Found zimbra-proxy


    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

    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

    Removing /opt/zimbra
    Removing zimbra crontab entry...done.
    Cleaning up zimbra init scripts...done.
    Cleaning up /etc/ld.so.conf...done.
    Cleaning up /etc/security/limits.conf...done.

    Finished removing Zimbra Collaboration Server.

    Installing packages

        zimbra-core......zimbra-core_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-ldap......zimbra-ldap_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-logger......zimbra-logger_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-mta......zimbra-mta_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-snmp......zimbra-snmp_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-store......zimbra-store_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-apache......zimbra-apache_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
        zimbra-spell......zimbra-spell_8.0.2.GA.5434.UBUNTU12.64_amd64.deb...done
    Operations logged to /tmp/zmsetup.01222013-154036.log
    Installing LDAP configuration database...done.
    Setting defaults...     MX: mail.mydomain.com (192.168.1.100)

            Interface: 192.168.1.100
            Interface: 127.0.0.1
            Interface: ::1
                    192.168.1.100
    done.
    Checking for port conflicts

    Main menu

       1) Common Configuration:
       2) zimbra-ldap:                             Enabled
       3) zimbra-store:                            Enabled
            +Create Admin User:                     yes
            +Admin user to create:                   admin@mail.mydomain.com
    ******* +Admin Password                  UNSET
            +Anti-virus quarantine user:            virus-quarantine.wn6wiltei@mail.mydomain.com
            +Enable automated spam training:   yes
            +Spam training user:                       spam.6rcnxbksez@mail.mydomain.com
            +Non-spam(Ham) training user:      ham.s6vyicipjc@mail.mydomain.com
            +SMTP host:                                  mail.mydomain.com
            +Web server HTTP port:                 80
            +Web server HTTPS port:              443
            +Web server mode:                        https
            +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://mail.mydomain.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@mail.mydomain.com
            +Version update source email:          admin@mail.mydomain.com

       4) zimbra-mta:                              Enabled
       5) zimbra-snmp:                           Enabled
       6) zimbra-logger:                          Enabled
       7) zimbra-spell:                            Enabled
       8) Default Class of Service Configuration:
       r) Start servers after configuration        yes
       s) Save config to file
       x) Expand menu
       q) Quit

    Address unconfigured (**) items  (? - help) 

    Enter number 3 to configure Admin password.  Set a new password and put r to return and a to apply the configuration.

    Select, or 'r' for previous menu [r] r

    Main menu

       1) Common Configuration:
       2) zimbra-ldap:                             Enabled
       3) zimbra-store:                            Enabled
       4) zimbra-mta:                              Enabled
       5) zimbra-snmp:                            Enabled
       6) zimbra-logger:                           Enabled
       7) zimbra-spell:                             Enabled
       8) Default Class of Service Configuration:
       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? [Yes] Y
    Save config in file: [/opt/zimbra/config.7774]
    The system will be modified - continue? [No] Y
    Operations logged to /tmp/zmsetup.01222013-154036.log
    Setting local config values...
    done.
    Initializing core config...Setting up CA...done.
    Deploying CA to /opt/zimbra/conf/ca ...done.
    Creating SSL zimbra-store certificate...done.
    Creating new zimbra-ldap SSL certificate...done.
    Creating new zimbra-mta SSL certificate...done.
    Installing mailboxd SSL certificates...done.
    Installing MTA SSL certificates...done.
    Installing LDAP SSL certificate...done.
    Initializing ldap...done.
    Setting replication password...done.
    Setting Postfix password...done.
    Setting amavis password...done.
    Setting nginx password...done.
    Creating server entry for mail.mydomain.com...done.
    Setting Zimbra IP Mode...done.
    Saving CA in ldap ...done.
    Saving SSL Certificate in ldap ...done.
    Setting spell check URL...done.
    Setting service ports on mail.mydomain.com...done.
    Adding mail.mydomain.com to zimbraMailHostPool in default COS...done.
    Setting zimbraFeatureTasksEnabled=TRUE...done.
    Setting zimbraFeatureBriefcasesEnabled=FALSE...done.
    Setting MTA auth host...done.
    Setting TimeZone Preference...done.
    Initializing mta config...done.
    Setting services on mail.mydomain.com...done.
    Creating domain mail.mydomain.com...done.
    Setting default domain name...done.
    Creating domain mail.mydomain.com...already exists.
    Creating admin account admin@mail.mydomain.com...done.
    Creating root alias...done.
    Creating postmaster alias...done.
    Creating user spam.6rcnxbksez@mail.mydomain.com...done.
    Creating user ham.s6vyicipjc@mail.mydomain.com...done.
    Creating user virus-quarantine.wn6wiltei@mail.mydomain.com...done.
    Setting spam training and Anti-virus quarantine accounts...done.
    Initializing store sql database...done.
    Setting zimbraSmtpHostname for mail.mydomain.com...done.
    Configuring SNMP...done.
    Setting up syslog.conf...done.
    Starting servers...done.
    Installing common zimlets...
            com_zimbra_proxy_config...done.
            com_zimbra_clientuploader...done.
            com_zimbra_srchhighlighter...done.
            com_zimbra_adminversioncheck...done.
            com_zimbra_attachmail...done.
            com_zimbra_date...done.
            com_zimbra_url...done.
            com_zimbra_tooltip...done.
            com_zimbra_ymemoticons...done.
            com_zimbra_webex...done.
            com_zimbra_attachcontacts...done.
            com_zimbra_bulkprovision...done.
            com_zimbra_cert_manager...done.
            com_zimbra_phone...done.
            com_zimbra_email...done.
    Finished installing common zimlets.
    Restarting mailboxd...done.
    Creating galsync account for default domain...done.

    You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
            The VERSION of zcs installed (8.0.2_GA_5434_UBUNTU12_64)
            The ADMIN EMAIL ADDRESS created (admin@mail.mydomain.com)

    Notify Zimbra of your installation? [Yes] A Yes/No answer is required

    You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
            The VERSION of zcs installed (8.0.2_GA_5434_UBUNTU12_64)
            The ADMIN EMAIL ADDRESS created (admin@mail.mydomain.com)

    Notify Zimbra of your installation? [Yes] Yes
    Notifying Zimbra of installation via http://www.zimbra.com/cgi-bin/notify.cgi?VER=8.0.2_GA_5434_UBUNTU12_64&MAIL=admin@mail.mydomain.com

    Notification complete

    Setting up zimbra crontab...done.

    Moving /tmp/zmsetup.01222013-154036.log to /opt/zimbra/log

    Configuration complete - press return to exit

    12. Check the Zimbra server status:

    #su zimbra

    #zmcontrol status

    Host mail.mydomain.com
            antispam              Running
            antivirus               Running
            ldap                     Running
            logger                  Running
            mailbox                Running
            mta                      Running
            snmp                    Running
            spell                     Running
            stats                     Running
            zmconfigd             Running

    13. Now access the Zimbra admin console using https://192.168.1.100:7071

















    There we finish the installation of Zimbra Collaboration suite 8.0.2 on Ubuntu 12.04 LTS !

    Useful Links

    1. Ubuntu Server download page -http://www.ubuntu.com/download/server
    2. Zimbra Open source edition download page - http://www.zimbra.com/downloads/os-downloads.html
    3. Ubuntu 12.04 LTS Documentation - https://help.ubuntu.com/12.04/index.html
    4. Zimbra Collaboration Server 8.0 Open Source Edition Documentation - http://www.zimbra.com/community/documentation.html
    5. Zimbra Collaboration Server 8.0 Admin guide (Must-Read guide) -http://files.zimbra.com/website/docs/8.0/Zimbra_OS_Admin_Guide_8.0.2.pdf 
    6. ZCS Install guide on Ubuntu 8.04 LTS - http://wiki.zimbra.com/wiki/Ubuntu_8.04_LTS_Server_%28Hardy_Heron%29_Install_Guide
    7. Zimbra Desktop User Guide -http://www.zimbra.com/desktop7/help/en_US/Zimbra_Mail_Help.htm#Getting_Started/Zimbra_User_Help.htm
    8. Advantages of Zimbra - http://web-hosting-talks.blogspot.in/2012/11/why-does-business-need-zimbra.html

    Have a question ? Ask here or visit official Zimbra forum http://www.zimbra.com/forums/forum.php

    --------------
    Source : http://yadhutony.blogspot.com/2013/02/installation-and-configuration-of.html

    0 comments:

    Post a Comment