Troubleshooting zimbra issues

<yambe:breadcrumb>Zimbra server configuration|Zimbra</yambe:breadcrumb>

Troubleshooting zimbra issues

ldap fails to start

Zimbra ldap may fail to start if domain to IP address mapping is incorrect. Ensure that if primary domain in example.com then example.com to IP address mapping is present in DNS or in /etc/hosts.

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