Foreword

This wiki serves as the installation and upgrade guide for vMail.Admin 2.0.

The setup helper will assist with setting up the initial application administrator account, also known as the root user, and other basic settings to get you logged in. The database must be created and the relevant SQL schema must imported manually.

As with all installations of vMail.Admin: #You must verify that you are already able to send and receive mail using Postfix (MTA) and Maildrop (MDA). #If you plan on using the SpamAssassin? and/or ClamAV modules, you must verify that SpamAssassin? and/or Clamassassin are tagging headers as expected.

If these conditions are not met, please address them before attempting to install vMail.Admin, or enabling the SpamAssassin? and/or Clamassassin modules.

This wiki uses the generic, default apache webroot. For practical purposes, we have chosen <font color="green">/var/www/localhost/vmailadmin</font> as the working directory to keep things simple and consistant. The working directory can be anywhere on your system as long you have Apache and Sudo configured correctly.

If you find you need assistance with any of the required vMail.Admin packages, please visit the support forums, and/or wiki, for the respective package in question as support for these packages is outside our scope. You may also try posting your question on the vMail.Admin Forums without any guarantee that you will be assisted.

Synopsis

This installation documentation remains up to date with the current version of [[vMail.Admin]]. It assumes the following:

# You have root access to POSIX compliant UNIX/Linux server. # You have ssh access to above mentioned server. # You have met all system and pre-installation requirements. # You have a working Postfix installation that is capable of sending and receiving mail. # You have a working apache installation. # You have created the required user and directories for your virtual mail user. For example: :: User -> vmail :: Home -> /home/vmail

Pre-Installation

Please take a moment to review the [[Requirements|package requirements]], [[Objective|project objective]] and [[CQL|Caveats, Quirks, and Limitations]] before proceeding.

Pre-Upgrade

** NOTE ** Backup your database and all related files before proceeding.

Download

Download the [http://sourceforge.net/project/showfiles.php?group_id=134650