Installing ZCS 5.0.x on openSUSE 10.3 a complete guide

[bigmudcake]

Below is version 4 at combining bits I have gathered throughout the forums into a compact step-by-step guide for installing Zimbra 5.0.4 or later onto openSUSE 10.3.

THESE INSTRUCTIONS WILL NOT WORK FOR VERSIONS EARLIER THAN ZCS 5.0.4.
If you are installing Zimbra 4.5.x on openSUSE 10.2 or 10.3 then click here

This guide has had only limited testing (using ZCS 5.0.4 and 5.0.5) so please reply to this thread if you see any issues or mistakes.

v2 - added advice about AppArmor and Firewall in step 8.
v3 - add --platform-override to running install script.
v4 - subtract and add steps to bring into line with 5.0.4 and later.

Cheers
bigmudcake

1. Make sure the following packages are installed including associated dependencies otherwise the install will probably fail.
   (Note: no need to install compat-openssl097g)
   fetchmail, cURL, libidn, GMP, sudo, compat-libstdc++, libopenssl0_9_8
   
   ITS REALLY IMPORTANT ALL PACKAGES MENTIONED ARE INSTALLED
   
   
2. Remove any packages you do not need to run on your server, this makes your server simpler, faster and less likely to conflict with Zimbra.
   Unless your a Linux Expert, remove AppArmor, Apache, MySQL, OpenLDAP, Amavis, Spamassassin, but make sure Postfix is installed.
   
   
3. Make sure your DNS server is setup correctly with the hostname having A and MX records.
   Also check the /etc/resolv.conf, /etc/host.conf, and /etc/nsswitch.conf files to make sure your DNS server is being accessed correctly.
   Refer to this zimbra blog for help or other references on the web on how to setup a proper DNS server under openSUSE 10.3
   
   
4. Make sure the hostname you wish to use is located in /etc/hosts file as a Fully Qualified Name (FQN).
   
   
5. Download the openSUSE 10.2 zimbra package and unpack using tar xzvf zimbra_package.tgz
   
   
6. Edit the file /etc/syslog-ng/syslog-ng.conf and add the following lines to the end of the file (if they don't already exist) :
   

   # Zimbra logger  
   filter f_local0       { facility(local0); }; # zimbra
   destination zmail { file("/var/log/zimbra.log" owner("zimbra") ); }; # zimbra
   log { source(src); filter(f_mail); destination(zmail); }; # zimbra
   destination local0 { file("/var/log/zimbra.log" owner("zimbra") ); }; # zimbra
   log { source(src); filter(f_local0); destination(local0); }; # zimbra
   filter f_auth       { facility(auth); }; # zimbra
   destination zmauth { file("/var/log/zimbra.log" owner("zimbra") ); }; # zimbra
   log { source(src); filter(f_auth); destination(zmauth); }; # zimbra

7. Turn off any conflicting services you may be running.
   i.e. for Postfix use the following commands:
   service postfix stop
   chkconfig postfix off
   It is recommended you turn off AppArmor and Firewall unless your a Linux expert.
   
   
8. Start the installation process for Zimbra by running the following command from the zcs folder.
   

   ./install.sh --platform-override

9. When the installation process stops at "This platform is UNKNOWN, Install anyway? [N]," press Y and Enter to continue.
   
   
10. When installation is complete, run the following command
    chkconfig --del zimbra
    
    
11. Edit the file /etc/init.d/zimbra and add the following lines below the existing comments at the top of the file.
    

    ### BEGIN INIT INFO
    # Provides: zimbra
    # Required-Start: $network $syslog
    # Required-Stop:
    # Default-Start: 3 5
    # Default-Stop: 0 1 2 6
    # Description: Zimbra mail service
    ### END INIT INFO

12. Run the following commands to get zimbra to startup correctly.
    chkconfig --add zimbra ; chkconfig zimbra on
    
    
13. Edit the file /etc/logrotate.d/zimbra and find the line in the file as:
    

    killall -HUP syslogd 2> /dev/null || true

    modify the line to:
    

    killall -HUP syslog-ng 2> /dev/null || true

14. Run the following commands to restart the zimbra server so post-installation changes can take effect.
    su - zimbra
    zmcontrol stop
    zmcontrol start
    exit
    

All should be complete and operational :-)

[mmorse]

As always thanks - sticked this one as well

[Activity]

thx 4 your post!

very helpfull

thx again^^

[ArcaneMagus]

Thanks for the nice instructions...they are much more coherent than the text file I had cobbled together of how to get Zimbra working on 10, 10.1, 10.2, and now 10.3 versions of openSUSE.

[vavai]

I've successfully installing Zcs 5.0.4 on OpenSUSE 10.3 without any problem.

I don't know it's important or not, but I still run this command :

ln -s /usr/lib/libcurl.so.4.0.0 /usr/lib/libcurl.so.3

to update libcurl.

And another note : command to install :

./install.sh --platform-override

because Zcs designed for OpenSUSE 10.2, not 10.3 .

After reviewing so many deployment and installation in various place, I think this is short list of main problem that frequently appeared while installing Zimbra on OpenSUSE :

1. Minimum specification for Zimbra Deployment
2. Misconfigured DNS setting
3. Firewall and AppArmor Issue

[bigmudcake]

Originally Posted by vavai

I've successfully installing Zcs 5.0.4 on OpenSUSE 10.3 without any problem.

I don't know it's important or not, but I still run this command :

ln -s /usr/lib/libcurl.so.4.0.0 /usr/lib/libcurl.so.3

to update libcurl.

During my testing I found this is not necessary, and I would probably avoid doing this to prevent version issues on the shared libraries.

Originally Posted by vavai

And another note : command to install :

./install.sh --platform-override

because Zcs designed for OpenSUSE 10.2, not 10.3 .

using "--platform-override" was not needed when installing ZCS 5.0.2, but I have since found after installing version 5.0.5 that it is essential otherwise the install script will not continue.

I have updated the instructions accordingly. I am supprised the Zimbra team made a change like this without it being documented in the release notes. Unless I missed it

Originally Posted by vavai

After reviewing so many deployment and installation in various place, I think this is short list of main problem that frequently appeared while installing Zimbra on OpenSUSE :

1. Minimum specification for Zimbra Deployment
2. Misconfigured DNS setting
3. Firewall and AppArmor Issue

I agree that they are always the major issues.

Thanks for your feedback, and it has greatly helped me add to the instructions.

[d4v1dv00]

Hi there, does ZCS can be installed into openSUSE x64 system?

[phoenix]

Originally Posted by d4v1dv00

Hi there, does ZCS can be installed into openSUSE x64 system?

Probably not and we don't provide a build for it. If you specifically want a 64bit build the use one of the supported Zimbra builds.

[johnleboeuf3]

Hello!

We are beginning to do some testing using the Zimbra Open Source e-mail solution. I have followed the guide and loaded the software on a 32-bit version of OpenSuse 10.2. I can access the web interface, admin panel, etc. but I cannot send/receive mail. It appears that it has something to do w/ mta. When I run a zimbra status this is what I receive:

antispam Running
antivirus Running
ldap Running
logger Running
mailbox Running
mta Stopped
postfix is not running
saslauthd is running with pid 17674
snmp Running
spell Running
stats Running

When I do a chkconfig it shows that postfix is definitely running.

The only thing I can think of is that I have not yet setup an MX record in my DNS server. Would this cause the MTA to fail?

Any help would be greatly appreciated. -John

[phoenix]

Originally Posted by johnleboeuf3

The only thing I can think of is that I have not yet setup an MX record in my DNS server. Would this cause the MTA to fail?

Yes, it would. You need valid DNS A & MX records for your zimbra server and a correct hosts file.