You are on page 1of 8

0-on-debian-etch Zimbra Collaboration Suite (ZCS) Open Source Edition v5.0 On Debian Etch Version 1.0 Author: Oliver Meyer <o [dot] meyer [at] projektfarm [dot] de> Last edited 02/06/2008 This document describes how to set up the Zimbra Collaboration Suite (ZCS) Open Source Edition v5.0 on Debian Etch. The resulting system provides a full feature d collaboration-suite with many features that I can't list all here - please hav e a look at the feature list. It also comes with a nice (themeable) AJAX web int erface for administration and user access. This howto is a practical guide without any warranty - it doesn't cover the theo retical backgrounds. There are many ways to set up such a system - this is the w ay I chose. 1 Preparation Install a standard Debian Etch system and update it. I used a network installati on (only standard system). 2 Hostname You have to assign the hostname to the server ip. It is very important that the fqdn entry appears before the hostname. vi /etc/hosts It should look like this: localhost.localdomain localhost server1

# 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

Afterwards insert the hostname into the hostname file ... echo > /etc/hostname ... and reboot the system. reboot When the system is up again, the output of the both commands ... hostname

.com 3 DNS You need a running DNS server in your LAN that contains a valid A & MX record fo r this server . It should look like this: nameserver 192. apt-get install libc6-i686 sudo libidn11 curl fetchmail libgmp3c2 libexpat1 libg etopt-mixed-perl libxml2 libstdc++6 libpcre3 libltdl3 ssh 6 Get Zimbra Please take a look at http://www.0.DEBIAN4.zimbra.10 0) running mydns for this The nameserver on your LAN has to be the first entry.html to see whic h is the latest version. and .2_GA_1975.example.0./install. apt-get remove --purge exim4 exim4-base exim4-config exim4-daemon-light 5 Needed packages Let's install some needed packages (maybe some of these packages are already ins talled on your system).tgz tar xvfz zcs-5.0. Download and unpack it.100 nameserver -l Read the license agreement and press "Enter" to continue.2_GA_1975.otherwise Zimbra won't 7 Install Zimbra 7.0. cd /tmp/ wget http://files.168.0.2_GA_1975.2 4 Exim Deinstall Exim .Zimbra comes with it's own mailserver.2008 0130234700. should be: server1.20080130234700 . postfix or mysql are running! cd /tmp/zcs-5.DEBIAN4. I used another server (192.20080130234700. Add the nameserver's IP to the resolve configur ation: vi /etc/resolv.1 Start The Installation Be sure that no other services like sendmail. hostname -f . Zimbra will now check .zimbra.0.

3.example.FOUND libpcre3-6.3 Main Menu After the packages have been installed you'll see the main menu.8.this could take a while.dfsg-2 libstdc++6. Checking for standard system perl.FOUND libltdl3-1.4-2 libgmp3c2.m0bqyoayc@server1.6-1etch1 +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 ...example.9..7+7.FOUND fetchmail-6...example.FOUND libxml2-2.FOUND libstdc++6-4.8p12-4 libidn11....FOUND libgmp3c2-2:4...FOUND standard system perl-5.FOUND +SMTP host: server1....1-21 openssl. NPTL..5-1 fetchmail..8c-4etch1 libltdl3.... The output should look like this : Checking for prerequisites.8 7.1+dfsg-4 libxml2. 7.5.6.... perl-5.FOUND sudo-1.2.6..FOUND libidn11-0.if all prequisites are installed on the system...example.8. 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 Password UNSET +Enable automated spam training: yes +Spam training user: spam... Continue? [N] Y Now the packages are being installed . Prerequisite check complete.2 Select The Packages To Install Install Install Install Install Install Install Install Install zimbra-ldap [Y] Y zimbra-logger [Y] Y zimbra-mta [Y] Y zimbra-snmp [Y] Y zimbra-store [Y] Y zimbra-apache [Y] Y zimbra-spell [Y] Y zimbra-proxy [N] N The system will be +Non-spam(Ham) training user: ham.27.ygch0qyz1@server1.FOUND +Global Documents Account: wiki@server1.

example.example. The configuration is now complete and the output should lo ok like this: Main menu 1) 2) 3) 4) 5) 6) Common Configuration: zimbra-ldap: Enabled zimbra-store: Enabled zimbra-mta: Enabled zimbra-snmp: Enabled zimbra-logger: Enabled . Enter "3" (without the qu otes) and press "Enter" to switch to the corresponding 9) SMTP host: 4) 5) 6) 7) 8) r) s) x) q) zimbra-mta: Enabled zimbra-snmp: Enabled zimbra-logger: Enabled zimbra-spell: Enabled Default Class of Service Configuration: Start servers after configuration yes Save config to file Expand menu Quit Address unconfigured (**) items (? .com ** 4) Admin Password UNSET 5) Enable automated spam training: yes 6) Spam training user: spam. As you can see you have to set the admin 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: 8) Global Documents Account: wiki@server1. The output shoul d look like this: Store configuration 1) Status: Enabled 2) Create Admin User: yes 3) Admin user to create: admin@server1.example. Password for 7) Non-spam(Ham) training user: ham. or 'r' for previous menu [r] Enter "4" (without the quotes) and press "Enter" to modify the admin Points that are marked with asterisks to their left have to be configured manual ly. Afterwards press "Enter" to switch b ack to the main menu.ygch0qyz1@server1.m0bqyoayc@server1.example.example.example.example.php Select.+Use spell check server: yes +Spell server URL: http://server1.example. N ow you'll be asked for the new (min 6 characters): [TR9Fm7uD] Enter a desired password and press "Enter".

Setting zimbraFeatureBriefcasesEnabled=TRUE.. Creating SSL certificate..m0bqyoayc@server1.. Setting up CA.done..example..done.. Initializing ldap.done.example. Adding server1. Setting service ports on Setting amavis password. Creating user wiki@server1... Save configuration data to a file? [Yes] Enter Save config in file: [/opt/zimbra/config.done.done. Creating server entry for server1. or press 'a' to apply config (? . Creating domain Setting spam training accounts.log Setting local config values. hotrod lavender waves steel sky bones yahoo sand lemongrass beach bare done.continue? [No] Y Now Zimbra configures itself with the given configuration. Installing skins... This could take a whi le . You 'll be asked a few questions output should look like this: Operations logged to /tmp/zmsetup. Setting replication password.done.done.done.. Setting Postfix password. Setting spell check URL.. Setting TimeZone Preference.done..done. Creating user admin@server1...done.done.done.5422] Saving config in /opt/zimbra/config........done. Creating user spam. Creating postmaster alias.done.done..done. Creating user ham..answer them as follows.. Setting zimbraFeatureIMEnabled=FALSE.done.. Setting Enter "a" (without the quotes) and press "Enter" to apply the configuration..5422.done. Deploying CA to /opt/zimbra/conf/ca .example. The system will be modified Setting zimbraFeatureNotebookEnabled=TRUE. Setting MTA auth 'a' to apply Select from to zimbraMailHostPool in default 8) r) s) x) q) zimbra-spell: Enabled Default Class of Service Configuration: Start servers after configuration yes Save config to file Expand menu Quit *** CONFIGURATION COMPLETE ....done.example...

. Installing zimlets.02062008-135354.zimbra ..done. Initializing Documents.done.done.example.done.....done.done. Afterwards the system will be initialized . Configuring 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... Pre ss "Enter" if you want to do that. Setting up s hould look like this: Starting servers.. Setting zimbraSmtpHostname for server1. Let's look if all Zimbra services are running proper .conf. Moving /tmp/zmsetup. Initializing logger sql database.done. Restarting mailboxd.done.log to /opt/zimbra/log Press "Enter" to exit.. su .example. Setting services on Checking for deprecated zimlets. or enter "N" (without the quotes) and press " Enter" if you disagree to that. enter the command: zmcontrol start Switch back to the root account via: exit ......sw itch to the Zimbra account After all you'll be asked if you want to notify Zimbra of your installation.. Initializing mta config. Setting up zimbra crontab...done... and enter the command: zmcontrol status The output should look like this: Host server1.example.Initializing store sql database. com_zimbra_date com_zimbra_url com_zimbra_cert_manager com_zimbra_phone com_zimbra_search com_zimbra_local com_zimbra_email done.

com . Click to enlarge Log out and proceed with the next step. 8.8 Zimbra Web Interface I'll show you some screenshots.example.the possible settings are too extensive. Click to enlarge A wizard will guide you through the creation of the new account. set the domain status t o active and click on "Finish".example. but no detailed information about the usage of t he web interface . . Click to enlarge If you want to have mail adresses like $user@example. 8. Log in with the username "admin" (without the quotes) and th e password that you assigned to this account at step instead of $user@server 1. Note: I chose "howtoforge" (without the quotes) as 7071/zimbraAdmin/ .com" (without the quotes) as domain name.1. Click to enlarge Afterwards mark the new account in the accounts-list and click on "Edit".2 User Access Open http://server1. Take care that you select the right domain (example.1 Administration Console You can access the administration web interface via you have to create a new within your browser and log in with the user acc ount that you created at step 8. Welcome to the administration console .3.make yourself familar with it. Please have a look a t the admin guide and the wiki.example. Click to enlarge Enter a desired password for the new account (Tab "General Information") and cli ck on "Save" in the window menu. Click on "Domains" in the main me nu on the left side and afterwards on "New" in the window menu (Manage Domains).com) for this account. Click to enlarge Click to enlarge Click on "Accounts" in the main menu on the left side and afterwards on "New" in the window menu (Manage Accounts) to create a new user. Note: I created the account olli@example. Click to enlarge Enter "example.

.Make familar with the web interface.