Basic zimbra configuration

Zimbra

Installation

1. Zimbra setup can be downloaded from http://www.zimbra.com/downloads/os-downloads.html
2. Verify md5sum and then extract download archive
3. service sendmail stop
4. chkconfig sendmail off
5. Edit /etc/hosts
   1. Ensure that it contains 127.0.0.1 localhost.localdomain localhost and no other aliases for 127.0.0.1
   2. For machines ethernet / public IP it should contain FQDN, followed by hostname, followed by other aliases. For example 10.3.3.241 zimbratest.iiit.ac.in zimbratest lab320-pc9 mfsmaster
6. Create folder /opt/zimbra. Mount partitons/folder in which you want to install zimbra to /opt/zimbra.
7. Go to extracted folder and use './install.sh --platform-override' from root user
8. Agree to license agreement and choose 'Y' for each component to be installed.
9. Choose 'Y' for install anyway and system will be modified prompts.
10. For test setups ignore DNS hostname and MX record errors
11. In the configuration menu
    1. Go to common configuration and setup
       1. Ldap admin password
       2. Correct timezone
    2. Go to ldap configuration and setup
       1. Ldap root password
       2. Ldap replication password
       3. Ldap postfix password
       4. Ldap amavis password
       5. Ldap nginx password
    3. Go to zimbra store and setup
       1. Admin password
       2. Virus quarantine email address
       3. Spam training user
       4. Non-spam training user
    4. Go to Default Class of Service configuration and enable disable features as per requirement
    5. Save config to file - Remember the name of configuration file
    6. Apply configuration ('a')
12. Yes for System will be modified
13. You can choose to notify Zimbra if system is connected to Internet
14. Exit from installation by pressing enter

Relaying mails through other MTA

If test system does not has access to internet then mails can be relayed through other MTA which has access to Internet (Similar to SMART_HOST for sendmail). To configure relay MTA

1. Login in to zimbra administrative console at https://<IP>:7071/ with user admin
2. Go to Configuration -> Global Settings -> MTA
3. Set relay MTA for external delivery appropriately.

Stopping and starting zimbra

1. Login as root
2. Use 'su - zimbra'
3. Use 'zmcontrol' command to check zimbra status, start or stop it.

Firewall configuration

Zimbra firewall configuration can be learned from http://wiki.zimbra.com/index.php?title=Firewall_Configuration

Changing Zimbra http port

We can change zimbra http port using:

1. su - zimbra
2. zmprov ms server.domain.tld zimbraMailPort <http_port> zimbraMailSSLPort <SSL_port>
3. zmmailboxctld restart

Note:

• This does not seems to work for HTTPS port

Backup

Zimbra backup and restore is discussed at http://wiki.zimbra.com/wiki/Backing_up_and_restoring_Zimbra_%28Open_Source_Version%29#Another_option

Debugging

Ldap start issue

If ldap server does not starts and gives this error

Failed to start slapd.  Attempting debug start to determine error.
bdb_db_close: database "": txn_checkpoint failed: Invalid argument (22).
backend_startup_one (type=hdb, suffix=""): bi_db_open failed! (22)
bdb_db_close: database "": alock_close failed

First verify that domain to IP mapping in /etc/hosts file is correct. If domain to IP mapping in /etc/hosts is not correct then Zimbra will not be able to start listening socket on incorrect IP and hence ldap may fail to start. Also zimbra must be stopped before changing machine IP. Then IP should be changed on system and in /etc/hosts. Then zimbra should be started.

If problem is not due to incorrect IP then:

1. Login as root
2. Go to dir '/opt/zimbra/data/ldap/hdb/db'
3. Use command '/opt/zimbra/bdb/bin/db_recover'

Fixing permisssions on zimbra files

If permissions on zimbra directory could be wrong then following can be use to fix permissions:

chown -R zimbra:zimbra /opt/zimbra
/opt/zimbra/libexec/zmfixperms -verbose -extended

Miscellaneous

If you want to store zimbra on mooseFS then storing entire /opt/zimbra on mooseFS will not work. Specially keeping /opt/zimbra/data on moosefs does not works. Hence directories /opt/zimbra/db, /opt/zimbra/index and /opt/zimbra/store can be shifted to other filesystems to preserve space / improve filesystem performance.

Tutorials and documentation related to zimbra are available at http://www.zimbra.com/downloads/os-downloads.html