|
|
|
#
|
|
|
|
# Postfix Admin
|
|
|
|
# by Mischa Peters <mischa at high5 dot net>
|
|
|
|
# Copyright (c) 2002 - 2005 High5!
|
|
|
|
# Licensed under GPL for more info check GPL-LICENSE.TXT
|
|
|
|
#
|
|
|
|
|
|
|
|
REQUIRED!!
|
|
|
|
----------
|
|
|
|
- You are using Postfix 2.0 or higher.
|
|
|
|
- You are using Apache 1.3.27 / Lighttpd 1.3.15 or higher.
|
|
|
|
- You are using PHP 4.1 or higher.
|
|
|
|
- You are using MySQL 3.23 or higher.
|
|
|
|
|
|
|
|
|
|
|
|
READ THIS FIRST!
|
|
|
|
----------------
|
|
|
|
|
|
|
|
Note: !!This document describes upgrading from v1.5x to 2.0. Only
|
|
|
|
items 3 and 5 apply to general PostfixAdmin installs!! See SVN.TXT
|
|
|
|
for how to update versions 2.1.0 and higher.
|
|
|
|
|
|
|
|
It's recommened that you install Postfix Admin in a new folder and not
|
|
|
|
on-top of the old install!!
|
|
|
|
|
|
|
|
When you are upgrading from Postfix Admin 1.5x (or older), make sure you
|
|
|
|
backup your database before you run the DOCUMENTS/TABLE_CHANGES.TXT on your database.
|
|
|
|
|
|
|
|
When you are upgrading from Postfix Admin 2.0.x, please read the DOCUMENTS/BACKUP_MX.TXT.
|
|
|
|
|
|
|
|
|
|
|
|
1. Backup the Database
|
|
|
|
----------------------
|
|
|
|
When you install from a previous version make sure you backup your database
|
|
|
|
first. There are a lot of changes in the database structure since Postfix Admin
|
|
|
|
1.5.4.
|
|
|
|
|
|
|
|
$ mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql
|
|
|
|
|
|
|
|
|
|
|
|
2. Unarchive new Postfix Admin
|
|
|
|
------------------------------
|
|
|
|
Make sure that you are in your WWW directory and then unarchive the
|
|
|
|
Postfix Admin archive (whatever the filename is):
|
|
|
|
|
|
|
|
$ tar -zxvf postfixadmin-2.0.0.tgz
|
|
|
|
|
|
|
|
|
|
|
|
3. Change permissions
|
|
|
|
----------------------
|
|
|
|
Since the database password is stored in the config.inc.php it's a good idea
|
|
|
|
to have change the permissions for Postfix Admin.
|
|
|
|
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0
|
|
|
|
$ chmod 640 *.php *.css
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0/admin/
|
|
|
|
$ chmod 640 *.php .ht*
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0/images/
|
|
|
|
$ chmod 640 *.gif *.png
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0/languages/
|
|
|
|
$ chmod 640 *.lang
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0/templates/
|
|
|
|
$ chmod 640 *.tpl
|
|
|
|
$ cd /usr/local/www/postfixadmin-2.0.0/users/
|
|
|
|
$ chmod 640 *.php
|
|
|
|
|
|
|
|
|
|
|
|
4. Modify the MySQL Tables
|
|
|
|
--------------------------
|
|
|
|
In TABLE_CHANGES.TXT or TABLE_BACKUP_MX.TXT you can find the table structure that you need in order
|
|
|
|
to configure Postfix Admin 2.0.0 and Postfix in general to work with Virtual
|
|
|
|
Domains and Users. You can find these in DOCUMENTS/
|
|
|
|
|
|
|
|
|
|
|
|
5. Configure
|
|
|
|
------------
|
|
|
|
Check the config.inc.php file. There you can specify settings that are
|
|
|
|
relevant to your setup.
|
|
|
|
|
|
|
|
|
|
|
|
6. Done
|
|
|
|
-------
|
|
|
|
This is all that is needed. Fire up your browser and go to the site that you
|
|
|
|
specified to host Postfix Admin.
|