Troubleshooting zimbra issues

Home > CentOS > CentOS 6.x > Troubleshooting zimbra issues

ldap fails to start

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'

Complete reinstallation without affecting data

If Zimbra stops working and normal troubleshooting is not working, then we can reinstall zimbra without affecting data using following steps:

1. Download the same version of zimbra and extract the contents.
2. Run './install.sh -s --platform-override' . The '-s' option is used to reinstall zimbra without touching the data.
3. Then run '/opt/zimbra/libexec/zmsetup.pl' script as root to re-initialize the ldap and other settings.
4. If permissions could be incorrect then they can be fixed using

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

The same steps can be used for upgrading Zimbra to a higher version also

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

Incoming email from other domains is not getting delivered to Zimbra

To troubleshoot incoming emails from other domains to Zimbra use following steps:

1. Verify DNS MX entries for domain
2. Verify Zimbra aliases or domains allow incoming emails for given alias or domain
3. Send email to corresponding zimbra user using mail command
4. Look at /var/log/zimbra.log if mail was accepted on Zimbra server. Mail not showing here indicates problem with sender.

In case there is issue with sender do following:

1. Check /var/log/maillog on the sending machine to see if email was accepted for delivery as per sending machine
2. Check "mailq" or "postqueue -p" output
3. Check local user mail or various mail queues of postfix on sender to determine problem
4. One way of accepting email is to add sending IP address in Zimbra Admin -< Configure -< Global Settings -< MTA -< MTATrusted Networks and save

Home > CentOS > CentOS 6.x > Troubleshooting zimbra issues