Platform Specific

From Zimbra :: Wiki

Jump to: navigation, search
   Icon-Archive.png  - This is archive documentation, which means it is not supported or valid for recent versions of Zimbra Collaboration.

Admin Article

Article Information

This article applies to the following ZCS versions.
  ZCS 6.0 Article  ZCS 6.0
  ZCS 5.0 Article  ZCS 5.0
  ZCS 4.5 Article  ZCS 4.5


Virtual Machine

Red Hat

Zimbra 4.5 64bit requires installation of both i386 (32bit) and x86_64 versions of the compat-libstdc++-33 and compat-libstdc++-296 libraries.

Without the 32bit version you'll see an error like this from Note the /usr/lib, not /usr/lib64:


You can check what architectures you have installed like this:

# rpm -qa --queryformat "%{name}.%{version}.%{arch}\n" |grep compat

To install compat-libstdc++33 for x86_64 with up2date:

# up2date --install compat-libstdc++-33 --arch=x86_64


Fedora Core 5 x86_64

This is an install of zcs-4.5.0_RC2_566.RHEL4_64.tgz and also zcs-NETWORK-4.5.0_GA_612.RHEL4_64.tgz on FC5 x86_64. Is there a FC5 x86_64 build in the works? The RHEL4 version seems to work fine.

You need to have the following installed:

  • compat-db for zimbra-spell
  • openssl097a for zimbra-ldap
  • compat-libstdc++-296
  • compat-libstdc++-33 for kvfilter and imapsync - however, see "convertd" below

Below is the change required to make the installer happy with the prerequisites and to allow all services to start up. This is only tested on FC5. I've opened bug 13632 on the issue.

The script previously checked for FC5 so that it could use instead of, but if you were on FC5_64, the check failed to match and you were left with an unresolved depenancie for

--- zcs.dist/util/   2007-01-15 20:58:18.000000000 -0800
+++ zcs/util/        2007-01-17 10:11:39.000000000 -0800
@@ -1207,10 +1207,13 @@
     elif [ $PLATFORM = "MANDRIVA2006" ]; then
       PREREQ_PACKAGES="sudo libidn11 curl fetchmail libgmp3 libxml2 libstdc++6 openssl"
-    elif [ $PLATFORM = "FC4" -o $PLATFORM = "FC5" -o $PLATFORM = "FC3" ]; then
-      PREREQ_PACKAGES="sudo libidn curl fetchmail gmp bind-libs vixie-cron"
-      if [ $PLATFORM = "FC5" ]; then
+    elif [ "`echo $PLATFORM | cut -c1-2`" = "FC" ]; then
+      PREREQ_PACKAGES="sudo libidn curl fetchmail gmp bind-libs vixie-cron compat-db compat-libstdc++-296 compat-libstdc++-33 openssl097a"
+      if [ "`echo $PLATFORM | cut -c1-3`" = "FC5" ]; then
+        if [ "`echo $PLATFORM | cut -d_ -f2`" = "64" ]; then
+          PREREQ_LIBS="$PREREQ_LIBS /usr/lib64/"
+        fi


I did not notice this problem with the Opensource Edition of 4.5RC2, but on an eval Network version 4.5GA, I guess that's because you can't search attachments in the Opensource version.

I'm seeing convertd crash and restart repeatedly while running imapsync. Here is the error:

2007-01-17 09:54:48,466 INFO  [Convertd-2] [] convert - Processing command 'x' from client on port 39220
2007-01-17 09:54:48,494 INFO  [Convertd-2] [] convert - Extracting text from image001.jpg.  docId=jazIjFJND+VI3MEYRHvxGreFNJw=_2
2007-01-17 09:54:48,515 FATAL [Convertd-2] [] system - Fatal error occurred while handling connection
java.lang.UnsatisfiedLinkError: /opt/zimbra/verity/FilterSDK/bin/ /opt/zimbra/verity/FilterSDK/bin/ wrong ELF class: ELFCLASS32
        at java.lang.ClassLoader$NativeLibrary.load(Native Method)
        at java.lang.ClassLoader.loadLibrary0(
        at java.lang.ClassLoader.loadLibrary(
        at java.lang.Runtime.loadLibrary0(
        at java.lang.System.loadLibrary(
        at com.verity.api.filter.Filter.<clinit>(Unknown Source)
        at com.zimbra.cs.convertd.VerityEngine.extract(
        at com.zimbra.cs.convertd.TransformationHandler.doTextExtraction(
        at com.zimbra.cs.convertd.TransformationHandler.processCommand(
        at com.zimbra.cs.tcpserver.ProtocolHandler.processConnection(
        at EDU.oswego.cs.dl.util.concurrent.PooledExecutor$ Source)
2007-01-17 09:54:49,695 INFO  [main] [] convert - Starting convertd
2007-01-17 09:54:49,760 INFO  [main] [] convert - convertd is ready

I'm seeing this error even with i386 and x86_64 versions of the compat libs.

[root@localhost log]# rpm --queryformat "%{name}.%{version}.%{arch}\n" -qa |grep compat

Fedora Core 6 x86

The Fedora Core 5 binaries will install on FC6 with a few kludges;

zimbra script will barf on, so create a link:

# ln -s /usr/lib/ /usr/lib/ 

Also, ldap at least is started via sudo from the script, so you will need to edit the sudoers file with visudo to get rid of the requiretty line;

# Defaults    requiretty

Then the install script should *just work*

Actually, the better fix is to scroll up, grab that patch, and add FC6 where you see FC5. Symlink is not needed.

Fedora 7 x86

The Fedora 5 binaries will install on Fedora 7 using zimbra script without any error messages. The following command will say is missing, which will stop MTA from starting:

# ldd /opt/zimbra/cyrus-sasl-

If so, install the curl-dev package and create a soft link to the

# yum install curl-devel
# ln -s /usr/lib/ /usr/lib/

Fedora 8

No binary download for FC8 yet, but there was a report that entries for syslog do not reside in /etc/syslog.conf rather /etc/rsyslog.conf.

Fedora 7 version of ZCS GA v5.0.5 (Community/Open Source edition) installs and runs great under a basic Fedora 8 install! The only caveat with the change to /etc/syslog.conf being renamed, simply using the command "ln -s /etc/rsyslog.conf /etc/syslog.conf" will fix the Zimbra syslog problem. This change will also fix other apps needing access to the old filename. (Hopefully the Fedora team will change the filename back or put in a symbolic link into the package installer for rsyslogd).

Without this subtle change, nothing will get logged under /var/log/zimbra.log.

After the change /etc/rsyslog restart will reflect the changes.



If the mta won't start, make sure that the libraries are being found:

 postfix start

If you get errors like:

 /opt/zimbra/postfix-2.2.5/sbin/postsuper: error while loading shared libraries: cannot open shared object file: No such file or directory
 /opt/zimbra/postfix-2.2.5/sbin/postalias: error while loading shared libraries: cannot open shared object file: No such file or directory
 /opt/zimbra/postfix-2.2.5/sbin/postfix: error while loading shared libraries: cannot open shared object file: No such file or directory

Verify that /etc/ contains:


then run ldconfig (as root).


OpenSuse 10


Debian 5 i386 - Zimbra 6

Install Debian 5

Install required packages

# aptitude install sudo libidn11 libpcre3 libexpat1 libstdc++5 sysstat

Edit the host file

# vi /etc/hosts       hostname.domain.tld      hostname

Download Zimbra 6

# wget http://.../zcs-6.0...DEBIAN5...tgz

Extract the archive

# tar xzf zcs-6.0...DEBIAN5...tgz

Install Zimbra 6

# ./install

Mac OS X

Mac OS X ships with Java (so Zimbra does not include it for Mac releases), but the default version - even if 1.5 is installed - is 1.4.

Check the default: ls -l /usr/bin/java.

Check whether 1.5 is installed here: /System/Library/Frameworks/JavaVM.framework/Versions/.

If not, download it from Apple. Once it's installed, you can specify the preferred order of the versions in the Java Application Settings of the Java Preferences utility found in /Applications/Utilities/Java/J2SE 5.0.

You can also make /usr/bin/java a symlink to /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Commands/java but this may break any apps using 1.4.

You can verify that java 1.5 is available to zimbra like this:

su - zimbra
java -version


Ubuntu 10

Installation exits if it does not find libperl5.10. Add libperl-dev.

apt-get install libperl-dev

Ubuntu 8

Installation exits if it cannot find libltdl3. Add libperl-dev.

apt-get install libperl-dev

Keywords: compat , libraries , requirements , 64-bit, x86_64

Verified Against: unknown Date Created: 3/5/2006
Article ID: Date Modified: 03/25/2015
Personal tools