1 #
2 # Postfix Admin
3 # by Mischa Peters <mischa at high5 dot net>
4 # Copyright (c) 2002 - 2005 High5!
5 # License Info: http://www.postfixadmin.com/?file=LICENSE.TXT
6 #
7 
8 REQUIRED!!
9 ----------
10 - You are using Postfix 2.0 or higher.
11 - You are using Apache 1.3.27 or higher.
12 - You are using PHP 4.1 or higher.
13 - You are using MySQL 3.23 or higher.
14 
15 
16 READ THIS FIRST!
17 ----------------
18 It's recommened that you install Postfix Admin in a new folder and not
19 on-top of the old install!!
20 
21 When you are upgrading from Postfix Admin 1.5x (or older), make sure you
22 backup your database before you run the TABLE_CHANGES.TXT on your database.
23 
24 When you are upgrading from Postfix Admin 2.0.x, please read the BACKUP_MX.TXT.
25 
26 
27 1. Backup the Database
28 ----------------------
29 When you install from a previous version make sure you backup your database
30 first. There are a lot of changes in the database structure since Postfix Admin
31 1.5.4.
32 
33   $ mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql
34 
35 
36 2. Unarchive new Postfix Admin
37 ------------------------------
38 Make sure that you are in your WWW directory and then unarchive the
39 Postfix Admin archive (whatever the filename is):
40 
41   $ tar -zxvf postfixadmin-2.0.0.tgz
42 
43 
44 3. Change permissions
45 ----------------------
46 Since the database  password is stored in the config.inc.php it's a good idea
47 to have change the permissions for Postfix Admin.
48 
49   $ cd /usr/local/www/postfixadmin-2.0.0
50   $ chmod 640 *.php *.css
51   $ cd /usr/local/www/postfixadmin-2.0.0/admin/
52   $ chmod 640 *.php .ht*
53   $ cd /usr/local/www/postfixadmin-2.0.0/images/
54   $ chmod 640 *.gif *.png
55   $ cd /usr/local/www/postfixadmin-2.0.0/languages/
56   $ chmod 640 *.lang
57   $ cd /usr/local/www/postfixadmin-2.0.0/templates/
58   $ chmod 640 *.tpl
59   $ cd /usr/local/www/postfixadmin-2.0.0/users/
60   $ chmod 640 *.php
61   
62 
63 4. Modify the MySQL Tables
64 --------------------------
65 In TABLE_CHANGES.TXT or TABLE_BACKUP_MX.TXT you can find the table structure that you need in order
66 to configure Postfix Admin 2.0.0 and Postfix in general to work with Virtual
67 Domains and Users
68 
69 
70 5. Configure
71 ------------
72 Check the config.inc.php file. There you can specify settings that are
73 relevant to your setup.
74 
75 
76 6. Done
77 -------
78 This is all that is needed. Fire up your browser and go to the site that you
79 specified to host Postfix Admin.