<h2>
  Installing Prerequisite Packages <a href="http://library.linode.com/LuAkuK"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  Make sure your system is up to date by issuing the following command:
</p>

<pre class="literal-block">yum update<br /></pre>

<p>
  Issue the following command to install several packages required by Zimbra:
</p>

<pre class="literal-block">yum install gmp compat-libstdc++-33 sysstat sudo libidn wget<br /></pre>

<p>
  Depending on the requirements for the current version of Zimbra, you may need to install additional packages later. The install program will notify you if there additional packages are required.
</p></p>

<h2>
  System Files Prerequisites <a href="http://library.linode.com/LnRQia"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  Before proceeding, make sure your /etc/hosts file has valid entries. For reference, your file should resemble the following:
</p>

<p>
  <strong>File:</strong> <em>/etc/hosts</em>
</p>

<pre class="file-block">127.0.0.1     localhost.localdomain     localhost<br />12.34.56.78   hostname.yourdomain.com   hostname<br /></pre>

<p>
  Be sure to replace "12.34.56.78" with your Linode's IP address. Replace "hostname.yourdomain.com" with your Linode's fully qualified domain name. Next, make sure your hostname is set in /etc/hostname by issuing the following commands (insert your one-word hostname in place of "hostname").
</p>

<pre class="literal-block">echo "hostname" > /etc/hostname<br />hostname -F /etc/hostname<br /></pre>

<p>
  Issue the following commands to check your setup:
</p>

<pre class="literal-block">hostname<br />hostname -f<br /></pre>

<p>
  The first command should return only the one-word hostname for your system, while the second command should return the system's FQDN.
</p></p>

<h2>
  Installing Zimbra <a href="http://library.linode.com/FYTwKR"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  Visit the download page for <a href="http://www.zimbra.com/community/downloads.html">Zimbra Open Source Edition</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" /> and copy the link to the current version of the software for RHEL 5 to your clipboard. Issue the following commands on your Linode via the shell to download and unpack the install package. Replace the filenames shown below after wget and tar with the current version.
</p>

<pre class="literal-block">wget http://files2.zimbra.com/downloads/6.0.7_GA/zcs-6.0.7_GA_2473.RHEL5.20100616214455.tgz<br />tar -xzf zcs-6.0.7_GA_2473.RHEL5.20100616214455.tgz<br /></pre>

<p>
  Switch to the install directory and launch the installer with the following commands. The "&#8211;platform-override" directive is necessary to instruct the installer to proceed on CentOS 5, as it is not an officially supported platform.
</p>

<pre class="literal-block">cd zcs-6.0.7_GA_2473.RHEL5.20100616214455<br />./install.sh --platform-override<br /></pre>

<p>
  You may receive a warning similar to the one shown below. Enter "Y" to proceed.
</p>

<pre class="literal-block">You appear to be installing packages on a platform different<br />than the platform for which they were built.<br /><br />This platform is CentOS5<br />Packages found: RHEL5<br />This may or may not work.<br /><br />Using packages for a platform in which they were not designed for<br />may result in an installation that is NOT usable. Your support<br />options may be limited if you choose to continue.<br /><br /><br />Install anyway? [N] Y<br /></pre>

<p>
  Before the install begins, you may receive a warning similar to the one shown below:
</p>

<pre class="literal-block">DNS ERROR resolving MX for archimedes.palegray.net<br />It is suggested that the domain name have an MX record configured in DNS<br />Change domain name? [Yes] No<br /></pre>

<p>
  It is recommended (but not required) that the fully qualified domain name for your system (hostname.domain.tld) have an MX record pointing to it. You may wish to visit your DNS control panel and add such a record now, or proceed if you won't be receiving mail for your FQDN on this system (for example, if you'll be receiving email for your base domain or others).
</p>

<p>
  The install will continue, probably requiring a few minutes to perform various tasks. You'll be asked which components of the Zimbra package you'd like to install. For the purposes of this tutorial, choose the default values for each ("Y" or "N" depending on which letter is in the brackets).
</p>

<p>
  Once the installation has completed, you'll be presented with an admin menu next.
</p>

<pre class="literal-block">Main menu<br /><br />   1) Common Configuration:<br />   2) zimbra-ldap:                             Enabled<br />   3) zimbra-store:                            Enabled<br />        +Create Admin User:                    yes<br />        +Admin user to create:                 admin@archimedes.palegray.net<br />******* +Admin Password                        UNSET<br />        +Enable automated spam training:       yes<br />        +Spam training user:                   spam.pvsjtuws@archimedes.palegray.net<br />        +Non-spam(Ham) training user:          ham.apqv8ks8@archimedes.palegray.net<br />        +Global Documents Account:             wiki@archimedes.palegray.net<br />        +SMTP host:                            archimedes.palegray.net<br />        +Web server HTTP port:                 80<br />        +Web server HTTPS port:                443<br />        +Web server mode:                      http<br />        +IMAP server port:                     143<br />        +IMAP server SSL port:                 993<br />        +POP server port:                      110<br />        +POP server SSL port:                  995<br />        +Use spell check server:               yes<br />        +Spell server URL:                     http://archimedes.palegray.net:7780/aspell.php<br />        +Configure for use with mail proxy:    FALSE<br />        +Configure for use with web proxy:     FALSE<br /><br />   4) zimbra-mta:                              Enabled<br />   5) zimbra-snmp:                             Enabled<br />   6) zimbra-logger:                           Enabled<br />   7) zimbra-spell:                            Enabled<br />   8) Default Class of Service Configuration:<br />   r) Start servers after configuration        yes<br />   s) Save config to file<br />   x) Expand menu<br />   q) Quit<br /><br />Address unconfigured (**) items  (? - help) 3<br /></pre>

<p>
  Enter "3" to enter the zimbra-store menu, which will look similar to the following:
</p>

<pre class="literal-block">Store configuration<br /><br />   1) Status:                                  Enabled<br />   2) Create Admin User:                       yes<br />   3) Admin user to create:                    admin@archimedes.palegray.net<br />** 4) Admin Password                           UNSET<br />   5) Enable automated spam training:          yes<br />   6) Spam training user:                      spam.pvsjtuws@archimedes.palegray.net<br />   7) Non-spam(Ham) training user:             ham.apqv8ks8@archimedes.palegray.net<br />   8) Global Documents Account:                wiki@archimedes.palegray.net<br />   9) SMTP host:                               archimedes.palegray.net<br />  10) Web server HTTP port:                    80<br />  11) Web server HTTPS port:                   443<br />  12) Web server mode:                         http<br />  13) IMAP server port:                        143<br />  14) IMAP server SSL port:                    993<br />  15) POP server port:                         110<br />  16) POP server SSL port:                     995<br />  17) Use spell check server:                  yes<br />  18) Spell server URL:                        http://archimedes.palegray.net:7780/aspell.php<br />  19) Configure for use with mail proxy:       FALSE<br />  20) Configure for use with web proxy:        FALSE<br /><br />Select, or &#39;r&#39; for previous menu [r] 4<br /></pre>

<p>
  You can configure various options here; but, the most important option is the one for setting the administrator password. Enter "4" to set it, choosing a strong password comprised of letters, numbers, and non-alphanumeric characters. After setting the admin password, enter "r" to return to the main menu. You will be asked to apply the new configuration. Type "a" and press enter. You may then allow the program to proceed with the remaining installation steps.
</p>

<p>
  After installation has completed, you'll need to start zimbra with the following command:
</p>

<pre class="literal-block">service zimbra start<br /></pre>

<p>
  To have Zimbra start on every boot, enter the following command:
</p>

<pre class="literal-block">chkconfig zimbra on<br /></pre>

<p>
  you may wish to reboot your Linode to make sure everything comes back up properly. After doing so, visit the Zimbra admin URL in your browser. It will be in the form <span class="pre">https://hostname.yourdomain.com:7071/</span>. You'll need to accept the SSL certificate presented to access the admin panel, which you may then use to continue configuring your new Zimbra server. Enjoy!
</p></p>

<h2>
  Monitor for Software Updates and Security Notices <a href="http://library.linode.com/TQEHLt"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  When running software compiled or installed directly from sources provided by upstream developers, you are responsible for monitoring updates, bug fixes, and security issues. After becoming aware of releases and potential issues, update your software to resolve flaws and prevent possible system compromise. Monitoring releases and maintaining up to date versions of all software is crucial for the security and integrity of a system.
</p>

<p>
  Please monitor the <a href="http://www.zimbra.com/alerts/">Zimbra Updates</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" /> page to ensure that you are aware of all updates to the software and can upgrade appropriately or apply patches and recompile as needed.
</p>

<p>
  When upstream sources offer new releases, repeat the instructions for installing Zimbra and recompile your software when needed. These practices are crucial for the ongoing security and functioning of your system.
</p></p>

<h2>
  More Information <a href="http://library.linode.com/RQQzdN"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
</p>

<ul class="simple">
  <li>
    <a href="http://www.zimbra.com/community/documentation.html">Zimbra Community Documentation</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" />
  </li>
  <li>
    <a href="http://wiki.zimbra.com/index.php?title=Main_Page">Zimbra Wiki</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" />
  </li>
  <li>
    <a href="http://www.zimbra.com/community/developer_zone.html">Zimbra Developer Zone</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" />
  </li>
</ul>

<h2>
  License <a href="http://library.linode.com/pNkeot"><img style="border: medium none; margin: 0px; padding: 0px" src="http://library.linode.com/images/link-icon.png" alt="Link" /></a>
</h2>

<p>
  This guide is licensed under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/">Creative Commons Attribution-No Derivative Works 3.0 United States License</a><img style="border: 0px none; margin: 0px; padding: 0px" src="http://library.linode.com/images/external-link-icon.png" alt="External Link" />. Please feel free to redistribute unmodified copies of it as long as attribution is provided, preferably via a link to this page.
</p></p>