Zimbra Collaboration Suite (ZCS) Open Source Edition v5.0 On Debian Etch - Page 2

7 Install Zimbra

7.1 Start The Installation

Be sure that no other services like sendmail, postfix or mysql are running!

cd /tmp/zcs-5.0.2_GA_1975.DEBIAN4.0.20080130234700
./install.sh -l

Read the license agreement and press "Enter" to continue. Zimbra will now check if all prequisites are installed on the system. The output should look like this:

Checking for prerequisites...
sudo...FOUND sudo-1.6.8p12-4
libidn11...FOUND libidn11-0.6.5-1
fetchmail...FOUND fetchmail-6.3.6-1etch1
libpcre3...FOUND libpcre3-6.7+7.4-2
libgmp3c2...FOUND libgmp3c2-2:4.2.1+dfsg-4
libxml2...FOUND libxml2-2.6.27.dfsg-2
libstdc++6...FOUND libstdc++6-4.1.1-21
openssl...FOUND openssl-0.9.8c-4etch1
libltdl3...FOUND libltdl3-1.5.22-4
Prerequisite check complete.
Checking for standard system perl...
perl-5.8.8...FOUND standard system perl-5.8.8


7.2 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-proxy [N] N

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

Now the packages are being installed - this could take a while.


7.3 Main Menu

After the packages have been installed you'll see the main menu. It should look like this:

Main menu

1) Common Configuration:
2) zimbra-ldap: Enabled
3) zimbra-store: Enabled
+Create Admin User: yes
+Admin user to create: admin@server1.example.com
******* +Admin Password UNSET
+Enable automated spam training: yes
+Spam training user: spam.m0bqyoayc@server1.example.com
+Non-spam(Ham) training user: ham.ygch0qyz1@server1.example.com
+Global Documents Account: wiki@server1.example.com
+SMTP host: server1.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://server1.example.com: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)

Points that are marked with asterisks to their left have to be configured manually. As you can see you have to set the admin password. Enter "3" (without the quotes) and press "Enter" to switch to the corresponding submenu. The output should look like this:

Store configuration

1) Status: Enabled
2) Create Admin User: yes
3) Admin user to create: admin@server1.example.com
** 4) Admin Password UNSET
5) Enable automated spam training: yes
6) Spam training user: spam.m0bqyoayc@server1.example.com
7) Non-spam(Ham) training user: ham.ygch0qyz1@server1.example.com
8) Global Documents Account: wiki@server1.example.com
9) SMTP host: server1.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://server1.example.com:7780/aspell.php

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

Enter "4" (without the quotes) and press "Enter" to modify the admin password. Now you'll be asked for the new password.

Password for admin@server1.example.com (min 6 characters): [TR9Fm7uD]

Enter a desired password and press "Enter". Afterwards press "Enter" to switch back to the main menu. The configuration is now complete and the output should look like this:

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)

Enter "a" (without the quotes) and press "Enter" to apply the configuration. You'll be asked a few questions - answer them as follows.

Save configuration data to a file? [Yes] Enter
Save config in file: [/opt/zimbra/config.5422]
Saving config in /opt/zimbra/config.5422...done.
The system will be modified - continue? [No] Y

Now Zimbra configures itself with the given configuration. This could take a while - the output should look like this:

Operations logged to /tmp/zmsetup.02062008-135354.log
Setting local config values...done.
Setting up CA...done.
Creating SSL certificate...done.
Initializing ldap...done.
Setting replication password...done.
Setting Postfix password...done.
Setting amavis password...done.
Deploying CA to /opt/zimbra/conf/ca ...done.
Creating server entry for server1.example.com...done.
Setting spell check URL...done.
Setting service ports on server1.example.com...done.
Adding server1.example.com to zimbraMailHostPool in default COS...done.
Installing skins...
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 server1.example.com...done.
Creating user admin@server1.example.com...done.
Creating postmaster alias...done.
Creating user wiki@server1.example.com...done.
Creating user spam.m0bqyoayc@server1.example.com...done.
Creating user ham.ygch0qyz1@server1.example.com...done.
Setting spam training accounts...done.
Initializing store sql database...done.
Setting zimbraSmtpHostname for server1.example.com...done.
Initializing logger sql database...done.
Initializing mta config...done.
Configuring SNMP...done.
Setting services on server1.example.com...done.
Setting up zimbra crontab...done.
Setting up syslog.conf...done.

After all you'll be asked if you want to notify Zimbra of your installation. Press "Enter" if you want to do that, or enter "N" (without the quotes) and press "Enter" if you disagree to that. Afterwards the system will be initialized - it should look like this:

Starting servers...done.
Checking for deprecated zimlets...done.
Installing zimlets...
Initializing Documents...done.
Restarting mailboxd...done.

Moving /tmp/zmsetup.02062008-135354.log to /opt/zimbra/log

Press "Enter" to exit. Let's look if all Zimbra services are running proper - switch to the Zimbra account ...

su - zimbra

... and enter the command:

zmcontrol status

The output should look like this:

Host server1.example.com
antispam Running
antivirus Running
ldap Running
logger Running
mailbox Running
mta Running
snmp Running
spell Running
stats Running

If one or more services have not been started, enter the command:

zmcontrol start

Switch back to the root account via:


Share this page:

6 Comment(s)

Add comment


From: Anonymous at: 2008-10-23 12:06:42

Hi, thanks for the how-to.

On a fresh etch you also need the "file" package, or you will have problems with the mail delivery.

From: Luís Miguel Silva at: 2009-01-19 00:05:59

Great How to :o)

 I just wanted to let you guys know that i also had to install libperl5.8!



From: Jasent at: 2009-07-24 22:05:28

I made two thing so the istalation to pass on debian 5 /lenny:

1. canged temporary /etc/debian_version from 5.0 to 4.0

2.Runing this to downgrade perl. 10



wget http://ftp.at.debian.org/debian/pool/main/p/perl/perl-modules_5.8.8-7etch6_all.deb
wget http://ftp.at.debian.org/debian/pool/main/p/perl/perl_5.8.8-7etch6_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/p/perl/perl-base_5.8.8-7etch6_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/p/perl/libperl5.8_5.8.8-7etch6_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/d/db4.4/libdb4.4_4.4.20-8_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libs/libsocket6-perl/libsocket6-perl_0.19-1_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libt/libterm-readkey-perl/libterm-readkey-perl_2.30-3_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libl/liblocale-gettext-perl/liblocale-gettext-perl_1.05-1_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libt/libtext-iconv-perl/libtext-iconv-perl_1.4-3_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libt/libtext-charwidth-perl/libtext-charwidth-perl_0.04-4_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libn/libnet-ssleay-perl/libnet-ssleay-perl_1.30-1_i386.deb
wget http://ftp.at.debian.org/debian/pool/main/libn/libnet-libidn-perl/libnet-libidn-perl_0.07-1_i386.deb

dpkg -i perl-modules_5.8.8-7etch6_all.deb perl-base_5.8.8-7etch6_i386.deb
        perl_5.8.8-7etch6_i386.deb libperl5.8_5.8.8-7etch6_i386.deb
        libdb4.4_4.4.20-8_i386.deb libsocket6-perl_0.19-1_i386.deb
        libterm-readkey-perl_2.30-3_i386.deb liblocale-gettext-perl_1.05-1_i386.deb
        libtext-iconv-perl_1.4-3_i386.deb libtext-charwidth-perl_0.04-4_i386.deb
        libnet-ssleay-perl_1.30-1_i386.deb libnet-libidn-perl_0.07-1_i386.deb

From: Anonymous at: 2009-03-04 21:39:01

To install Zimbra on a debian 5.0 Squeeze you'll have to modify those files:


        grep "5.0" /etc/debian_version > /dev/null 2>&1
        if [ $? = 0 ]; then
            echo "DEBIAN4.0${i}"
            exit 0

 and the debian version:



From: at: 2008-05-26 19:33:53

Nice guide. However, installing file might get added to the list of Needed Packages in order to get Amavis working properly. My installation on Debian 4.0r1 ended up with a bunch of mails in the deferred list until I installed file and restarted Zimbra.

From: kdclaver at: 2008-12-24 11:34:48


I'm please to congratulate you for this plaisant howto.I have just installed ZCS-5 on Debian Etch. Regrettably I have error messages below:

zimbra@zimbra:~$ zmcontrol start
Host zimbra.kdclaver.net
        Starting logger...Done.
        Starting mailbox...Done.
        Starting antispam...Done.
        Starting antivirus...Done.
        Starting snmp...Done.
        Starting spell...Done.
        Starting mta...Done.
        Starting stats...Done.

Error messages

message 1:
Rubriques : Monitoring --> Server state : The data of state of the server are not available. It is possible that the service " logger " is not activated

message 2:
Mail : system failure: server zimbra.kdclaver.net zimbraRemoteManagementPrivateKeyPath (/opt/zimbra/.ssh/zimbra_identity) does not exist Code d'erreur : service.FAILURE Method: GetMailQueueInfoRequest Détails :soap:Receiver

message 3:
Mail : system failure: server zimbra.kdclaver.net zimbraRemoteManagementPrivateKeyPath (/opt/zimbra/.ssh/zimbra_identity) does not exist Code d'erreur : service.FAILURE Method: GetMailQueueInfoRequest Détails :soap:Receiver

Can you help me to correct them  and prepare the training of my users on this product about which we said to me a lot of goods.

Thank you infinitely for your care