How To – Instalar Zimbra Collaboration Suite (ZCS) en Ubuntu Server 6.06

Version 1.0
Author: Falko Timme <ft [at] falkotimme [dot] com>

Citado desde varias Fuentes:

http://www.howtoforge.com/installing_zimbra_collaboration_suite_on_ubuntu

http://www.diotto.net/2008/04/17/instalando-o-zimbra-no-ubuntu/

http://www.genbeta.com/web/zimbra-correo-y-calendario-libres-al-mas-puro-estilo-gmail

Zimbra es un cliente/servidor de correo y calendario, al estilo del Yahoo! Mail en cuanto contenido y al estilo de Gmail en cuanto a velocidad. Para hacer un interfaz tan rápido han usado, al igual que Gmail, del lenguaje AJAX (Javascript + XML) que almacena parte de la página en el cliente, por lo que gran parte de la comunicación entre el cliente y el servidor se reduce inversamente proporcional a la velocidad.

No sólo puedo decir que Zimbra es uno de los mejores clientes web/servidores de correo y calendario, sino que además es código libre, gratuito y descargable, tanto su cliente como el servidor. Mientras lo leía no me lo podía creer…

Se nota que Zimbra a tomado como referencia algunas funcionalidades de Gmail como vista normal / vista del hilo, etiquetas (pero añadiendo iconos con código de color) para los correos,… además de un completo gestor de calendario/agenda.

Zimbra ha sido desarrollado en Java, complementado con AJAX, del que, como he comentado, se dispone el código fuente completo (y binarios para distribuciones Red Hat Linux como Fedora y RHEL), documentación, herramientas de migración (para Exchange, por ejemplo), entre otros. Y si pensabas que ya era increible, Zimbra soporta acceso POP, acceso IMAP, entre otros; e incluye protección anti-spam y antivirus.

1 Preliminary Note

Please download the Ubuntu 6.10 or 6.06 server CD from http://www.ubuntu.com/download and install a basic Ubuntu system with it. Don’t install/enable any services (e.g. like LAMP or DNS) – if you do, you’ll have to disable them later on as they might interfere with Zimbra!

After the installation of the base system, we’ll do some additional configuration, e.g. enable the root account, install an SSH daemon, apply a static IP address and a hostname to the system.

I will use the hostname mail.example.com in this tutorial together with the IP address 192.168.0.110. Adjust this to your needs, but make sure that mail.example.com has a valid MX record in DNS (Zimbra needs this!). I assume you want to create email accounts for example.com instead of mail.example.com, so you should have an MX record for example.com as well.

In this example the Zimbra server is in a local network (192.168.0.110 is a private IP address) behind a router, so make sure you use the router’s public IP address (1.2.3.4 in this example) in the DNS records – of course this IP address should be static. If you have a dynamic IP address, you could use a service such as DynDNS.org, but keep in mind that most public IP addresses are blacklisted nowadays.

So if you use BIND on the authoritative name server for example.com, you should have something like this in example.com’s zone file:

[...] mail.example.com. A 1.2.3.4 mail.example.com. MX 0 mail.example.com. example.com. MX 0 mail.example.com. [...]

If your Ubuntu server is behind router, make sure that you forward at least port 25 from your router to your Ubuntu server.

If your Ubuntu server is in a data center, it most likely has a static public IP address and a hostname, so you can skip chapter 1.3, but still you must make sure that this hostname has a valid MX record.

1.1 Enable The root Account

To enable the root account, run

sudo passwd root

and specify a password for root.

Afterwards, become root by running

su

All following commands in this tutorial are executed as root (unless something else is written)!

1.2 Install The SSH Daemon

Just run

apt-get install ssh openssh-server

to install the SSH daemon.

1.3 Apply A Static IP Address And Hostname

Edit /etc/network/interfaces and adjust it to your needs (in this example setup I will use the IP address 192.168.0.110):

# 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 192.168.0.110
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1

vi /etc/network/interfaces

# 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 192.168.0.110 netmask 255.255.255.0 network 192.168.0.0 broadcast 192.168.0.255 gateway 192.168.0.1

Then restart your network:

/etc/init.d/networking restart

Then edit /etc/hosts. Make it look like this:

vi /etc/hosts

127.0.0.1 localhost.localdomain localhost 192.168.0.110 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

Now run

echo mail.example.com > /etc/hostname

and reboot the system:

shutdown -r now

Afterwards, run

hostname
hostname -f

Both should show mail.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 from this tutorial.

1.4 Disable The Ubuntu CD In /etc/apt/sources.list

I like to install all packages over the internet instead of from the Ubuntu CD, therefore I disable the Ubuntu CD in /etc/apt/sources.list now:

vi /etc/apt/sources.list

On Ubuntu 6.10 (“Edgy Eft”), comment out this line:

[...] #deb cdrom:[Ubuntu-Server 6.10 _Edgy Eft_ - Release i386 (20061025.1)]/ edgy main restricted [...]

On Ubuntu 6.06 (“Dapper Drake”), it’s this line:

[...] #deb cdrom:[Ubuntu-Server 6.06 _Dapper Drake_ - Release i386 (20060531)]/ dapper main restricted [...]

Then update the packages database by running

apt-get update

after update

apt-get upgrade for udpate the complete distribution

1.5 Disable Services

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.

Install Zimbra

First let’s install some prerequisites for Zimbra:

apt-get install curl fetchmail libpcre3 libgmp3c2 libexpat1 libxml2 libtie-ixhash-perl

Afterwards, go to http://www.zimbra.com/community/downloads.html and download the Ubuntu 6 (.tgz) package to /usr/src, 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.)

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:

WARNING: ZCS is currently only supported on Ubuntu Server 6.06 LTS.
You are attempting to install on Ubuntu 8.04 which may not work.
Support will not be provided if you choose to continue.

Do you wish to continue? [N] y

Operations logged to /tmp/install.log.928
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-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

Press Return to continue

Checking for prerequisites…
NPTL…FOUND
sudo…FOUND sudo-1.6.9p10-1ubuntu3
libidn11…FOUND libidn11-1.1-1
fetchmail…FOUND fetchmail-6.3.8-10ubuntu1
libpcre3…FOUND libpcre3-7.4-1ubuntu2
libgmp3c2…FOUND libgmp3c2-2:4.2.2+dfsg-1ubuntu2
libexpat1…FOUND libexpat1-2.0.1-0ubuntu1
libxml2…FOUND libxml2-2.6.31.dfsg-2ubuntu1
libstdc++6…FOUND libstdc++6-4.2.3-2ubuntu7
libstdc++5…FOUND libstdc++5-1:3.3.6-15ubuntu4
openssl…FOUND openssl-0.9.8g-4ubuntu2
libltdl3…FOUND libltdl3-1.5.26-1ubuntu1
Prerequisite check complete.
Checking for standard system perl…
perl-5.8.7…Unable to find expected perl-5.8.7. Found version 5.8.8-12 instead.

###WARNING###

The suggested version of one or more packages is not installed.
This could cause problems with the operation of Zimbra.

Do you wish to continue? [N] y

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

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]

Install zimbra-proxy [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

You appear to be installing packages on a platform different
than the platform for which they were built.

This platform is UBUNTUUNKNOWN
Packages found: UBUNTU6
This may or may not work.

Using packages for a platform in which they were not designed for
may result in an installation that is NOT usable. Your support
options may be limited if you choose to continue.

Install anyway? [N] Y

The system will be modified. Continue? [N] Y

Removing /opt/zimbra
Installing packages

zimbra-core……zimbra-core_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-ldap……zimbra-ldap_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-logger……zimbra-logger_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-mta……zimbra-mta_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-snmp……zimbra-snmp_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-store……zimbra-store_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-apache……zimbra-apache_5.0.4_GA_2101.UBUNTU6_i386.deb…done
zimbra-spell……zimbra-spell_5.0.4_GA_2101.UBUNTU6_i386.deb…done
Operations logged to /tmp/zmsetup.04172008-203856.log
Setting defaults…

DNS ERROR resolving MX for marcelo.diotto.net
It is suggested that the domain name have an MX record configured in DNS
Change domain name? [Yes] Yes
Create Domain: [marcelo.diotto.net] marcelo.diotto.net

Interface: 143.106.243.123
Interface: 127.0.0.1

DNS ERROR – none of the MX records for marcelo.ceset.unicamp.br
resolve to this host
It is suggested that the MX record resolve to this host
Re-Enter domain name? [Yes] No
done.
Checking for port conflicts

After we arrive to main menu for to do some configurations. Now is showed a menu with some options for to configure the features. The most importante here is to set the admin password for to access via web to administration interface. For to do that we have to choose the option 3 or 4.

Main menu

1) Common Configuration:
2) zimbra-ldap: Enabled
3) zimbra-store: Enabled
+Create Admin User: yes
+Admin user to create: admin@marcelo.diotto.net
******* +Admin Password UNSET
+Enable automated spam training: yes
+Spam training user: spam.hfzbzl2ydz@marcelo.diotto.net
+Non-spam(Ham) training user: ham.nwj9yezlz0@marcelo.diotto.net
+Global Documents Account: wiki@marcelo.ceset.unicamp.br
+SMTP host: marcelo.diotto.net
+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://marcelo.diotto.net:7780/aspell.php
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)

When the admin password has been set, we must now press “a” in the keyboard for to apply the configurations and choose YES when you need save these configurations. Zimbra will finish doing the respective configurations and it will start the services.

*** CONFIGURATION COMPLETE – press ‘a’ to apply
Select from menu, or press ‘a’ to apply config (? – help) a
Save configuration data to a file? [Yes] Yes
Save config in file: [/opt/zimbra/config.4577]
Saving config in /opt/zimbra/config.4577…done.
The system will be modified – continue? [No] Yes
Operations logged to /tmp/zmsetup.04172008-203856.log

Setting local config values…done.
Setting up CA…done.
Deploying CA to /opt/zimbra/conf/ca …done.
Creating SSL certificate…done.
Installing SSL certificates…done.
Initializing ldap…done.
Setting replication password…done.
Setting Postfix password…done.
Setting amavis password…done.
Saving CA in ldap …done.
Creating server entry for marcelo.diotto.net…done.
Setting spell check URL…done.
Setting service ports on marcelo.diotto.net…done.
Adding marcelo.diotto.net to zimbraMailHostPool in default COS…done.
Installing skins…
hotrod
waves
steel
bare
beach
sky
lavender
sand
bones
yahoo
lemongrass
done.
Setting zimbraFeatureIMEnabled=FALSE…done.
Setting zimbraFeatureTasksEnabled=TRUE…done.
Setting zimbraFeatureBriefcasesEnabled=TRUE…done.
Setting zimbraFeatureNotebookEnabled=TRUE…done.
Setting MTA auth host…done.
Setting TimeZone Preference…done.
Creating domain marcelo.diotto.net…done.
Creating user admin@marcelo.diotto.net…done.
Creating postmaster alias…done.
Creating user wiki@marcelo.diotto.net…done.
Creating user spam.hfzbzl2ydz@marcelo.diotto.net…done.
Creating user ham.nwj9yezlz0@marcelo.diotto.net…done.
Setting spam training accounts…done.
Initializing store sql database…done.
Setting zimbraSmtpHostname for marcelo.diotto.net…done.
Initializing logger sql database…done.
Initializing mta config…done.
Configuring SNMP…done.
Setting services on marcelo.diotto.net…done.
Setting up zimbra crontab…done.
Setting up syslog.conf…done.

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 (5.0.4_GA_2101_UBUNTUUNKNOWN)
The ADMIN EMAIL ADDRESS created (admin@marcelo.diotto.net)

Notify Zimbra of your installation? [Yes] Yes
Notifying Zimbra of installation via http://www.zimbra.com/cgi-bin/notify.cgi?VER=5.0.4_GA_2101_UBUNTUUNKNOWN&amp;amp;amp;MAIL=admin@marcelo.diotto.net

Notification complete

Starting servers…done.
Checking for deprecated zimlets…done.
Installing zimlets…
com_zimbra_url
com_zimbra_local
com_zimbra_phone
com_zimbra_date
com_zimbra_email
com_zimbra_cert_manager
done.
Initializing Documents…done.
Restarting mailboxd…done.

Moving /tmp/zmsetup.04172008-203856.log to /opt/zimbra/log

Configuration complete – press return to exit

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.

The Zimbra Web Interface

Zimbra comes with a web interface for the administrator (https://mail.example.com:7071/zimbraAdmin) and normal users (http://mail.example.com).

The Administration Console

You can now open a browser and open the Zimbra Administrator web interface. The URL is https://mail.example.com:7071/zimbraAdmin. Log in with the username admin and the password you specified during the Zimbra installation:

This is how the admin panel looks like:

You can find all pre-configured email addresses under Accounts:

If you want to add a new domain (e.g. example.com because you want email addresses of the form user@example.com instead of user@mail.example.com), click on Domains and then on New:

Create example.com:

Afterwards, example.com is listed in the domains list:

To create a new user, go to Accounts and click on New:

Follow the wizard to create a new email account. Take care that you select the right domain (example.com vs. mail.example.com):

Afterwards, mark the new account in the accounts list and click on Edit:

Specify a password for the new account on the General Information tab and click on Save:

// <![CDATA[
document.write('

');
// ]]>

// <![CDATA[
if (typeof ord=='undefined') {ord=Math.random()*10000000000000000;}
document.write('');
// ]]>// <![CDATA[
document.write('');
// ]]>// // <![CDATA[
document.write('

');
// ]]>

The User Webinterface

Now that you’ve created a normal user account, you can log out of the admin panel and go to http://mail.example.com. Log in with the email address and the password of the new account:

This is how the user webinterface looks like. You have tabs to manage your emails, address book, calendar, documents, etc.

Uninstall Zimbra

If you want to uninstall Zimbra, do it like this:

Go the the Zimbra installation directory (I hope you didn’t delete it):

cd /usr/src/zcs

Then run

./install.sh -u

and delete the Zimbra installation directory afterwards:

cd /usr/src
rm -rf zcs

Reference Links

• Zimbra: http://www.zimbra.com
• Zimbra Documentation: http://www.zimbra.com/community/documentation.html
• Zimbra Wiki: http://wiki.zimbra.com
• Ubuntu: http://www.ubuntu.com