Fedora Core 4 - MC3 & Apache, MYSQL, for web hosting Easy Install HOWTO

[Bradleyenator]

I am writing this HowTo because I found it not difficult but tedious to finally get everything working in unison. My motto is "It's easy once you know how!"

If you want Zimbra to run on the same box as your webserver then this is for you.
I am starting from scratch to make things less complex.

Domain Name for this example is: "domain.com"
Local IP Address is: xxx.xxx.xxx.xxx

Step 1: Install Fedora Core 4 with these settings:
+ IP Address xxx.xxx.xxx.xxx
+Hostname: server.domain.com
+Gateway: zzz.zzz.zzz.zzz
+Primary DNS: xxx.xxx.xxx.xxx (self)
+No Firewall
+No SELINUX

Packages:
+X Window (Default)
+GNOME (Default)
+Graphical Internet (Default)
+Server Config Tools (All)
+Web Server (All)
+DNS Server (Default)
+MySQL Server (All)
+Admin Tools (All)

Step 2: Edit hosts file to look like this.
127.0.0.1-------------TAB------localhost.localdomain localhost
xxx.xxx.xxx.xxx------TAB------server.domain.com server

Step 3: Start the DNS Server

Step 4: Install Webmin http://www.webmin.com/

Step 5: Using Webmin install the following by going to "System->Software Packages->Search rpm.net"

Webmin can be access by going to http://server.domain.com:10000/

Search for the following and select the correct package.
libstdc++.so.5
libbind.so.3
fetchmail

Step 6: Download Zimbra "zcs-3.0.0_M3_436.FC4"

Step 7: Extract the package.

Step 8: Install Zimbra by running install.sh in a terminal.
Except all defaults, the only configuration you have to do is set the admin password.

Step 9: Once Zimbra is installed check to see if the admin account got created because in my adventures every time I installed zimbra the admin account didn't get created. Hopefully the bugs already been fixed if it is one.

Open up a terminal and type
"su - zimbra"
then
"zmprov"
then
"gaaa"

You should see "admin@server.domain.com"
If you don't you need to create the account.

Type "ca admin@server.domain.com passwordgoeshere zimbraIsAdminAccount TRUE"
You should see one line of fairly random output don't worry it's like a unique id or something.

Then type "quit" and close that terminal.

Step 10: Now logon to the admin pannel by going to https://server.domain.com:7071/ in Firefox.

You can now create accounts etc and configure as you desire. However the next thing you will probably want to do is create another domain of "domain.com" as "server.domain.com" probably isn't what you want.

Step 11: Open up another terminal and type
"su - zimbra"
then
"zmcontrol stop"
Leave the terminal open

Step 12: Find these two files and open them up in Text Editor.
/opt/zimbra/tomcat/conf/server.conf
/opt/zimbra/tomcat/webapps/service/WEB-INF/web.xml

Find all instances of 80 and replace with 8080 or what ever port you want zimbra to run on.
The admin part of zimbra runs on 7071 and I guess you could change that as well but I haven't got game enough yet.

Step 13: Now go back to that terminal and type
"zmcontrol start"
Now close the terminal.

Step 14: Now you should be able to access the zimbra front end from http://server.domain.com:8080/ instead of http://server.domain.com/

Step 15: Open up webmin and go to Servers->Apache, configure it as needed and then hit start.

Note: When stopping Apache from webmin or Desktop->System Settings->Server Settings->Services it will stop Zimbra's apache as well but when you hit start it does not start Zimbra's apache and thus if you want the Spell checker to work you will have to restart zimbra as well. This is why when editing apache hitting "Apply Changes" will do the job nicely.

Step 16: Now you can also configure MYSQL from webmin but the same thing applys when you stop MYSQL you will stop Zimbras MYsql.

Step 17: Now add in the neccercy zone(s) into BIND from webmin.

I haven't included detailed instruction on how to configure Apache, MYSQL, DNS, etc however I don't mind answering any questions to the best of my abilty.

[KevinH]

Great how-to. With regard to your problem with the admin user are there any errors in /tmp/install.log or /tmp/zmsetup.log that may point to a problem?

[ringnebula]

Also, if you can have multiple ips on the box you don't need to go through the hassle of changing ports in config files. I'm not entirely sure of the extent that zimbra still uses calls to iptables so to be safe zimbra should run on the primary address for simplicity, but then just bind your apache, mysql, whatever else to a pseudo address and all is well so long as you have dns setup properly.

[jvels]

Hi

What about if I only use konsol (install with out GUI)

Does Zimbra install a verison of mysql and apache?

If yes sould I install a version of apache and mysql before install Zimbra?

[bobby]

there is no need to install the gui in order to install and run zimbra.

zcs is a self-contained installation, meaning that all the third-party components are included in the install. it is acceptable to have the standard versions of things (e.g. sendmail, postfix, mysql, etc.) installed but you don't want them running when you install (and run) zimbra.

search the forums for information about running these programs concurrently with zimbra.