UPGRADE.txt 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  1. #
  2. # Postfix Admin
  3. # by Mischa Peters <mischa at high5 dot net>
  4. # Copyright (c) 2002 - 2005 High5!
  5. # Licensed under GPL for more info check GPL-LICENSE.TXT
  6. #
  7. REQUIRED!!
  8. ----------
  9. - You are using Postfix 2.0 or higher.
  10. - You are using Apache 1.3.27 / Lighttpd 1.3.15 or higher.
  11. - You are using PHP 5.1.2 or higher.
  12. - You are using MySQL 3.23 or higher OR PostgreSQL v7.4+
  13. READ THIS FIRST!
  14. ----------------
  15. This document describes upgrading from an older PostfixAdmin version
  16. (>= v1.5x)
  17. It's recommend that you install Postfix Admin in a new folder and not
  18. on-top of the old install!! (At the very least, make sure you have backups of
  19. the database and relevant filesystem!)
  20. When upgrading Postfix Admin, make sure you backup your database before
  21. running upgrade.php.
  22. 1. Backup the Database
  23. ----------------------
  24. When you install from a previous version make sure you backup your database
  25. first. There are a lot of changes in the database structure since Postfix Admin
  26. 1.5.4.
  27. $ mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql
  28. or
  29. $ pg_dump -ad -u postfix postfix > /tmp/postfixadmin-backup.sql
  30. 2. Unarchive new Postfix Admin
  31. ------------------------------
  32. Make sure that you are in your WWW directory and then unarchive the
  33. Postfix Admin archive (whatever the filename is):
  34. $ tar -zxvf postfixadmin-X.X.tgz
  35. 3. Change permissions
  36. ----------------------
  37. Since the database password is stored in the config.inc.php it's a good idea
  38. to have change the permissions for Postfix Admin.
  39. $ cd /usr/local/www/postfixadmin
  40. $ find -type f -print0 | xargs -0 chmod 640
  41. $ find -type f -print0 | xargs -0 chown root:www
  42. (the last command assumes your Apache is running with group "www")
  43. Since version 2.4 we use smarty templates. That means the templates_c directory
  44. needs to be writeable for your webserver.
  45. $ chown -R www-data templates_c/
  46. (if your Apache runs as user "www-data")
  47. 4. Configure
  48. ------------
  49. Check the config.inc.php file. There you can specify settings that are
  50. relevant to your setup.
  51. Comparing config.inc.php with your previous using "diff" might save you some
  52. time.
  53. You can use a config.local.php file to contain your local settings. These will override any
  54. defined in config.inc.php - and save some time when upgrading to a new version of PostfixAdmin ;-)
  55. 5. Run setup.php
  56. ----------------------------------------
  57. Access setup.php through a web browser.
  58. It will attempt to upgrade your database, and also allow you to create a superadmin user.
  59. (In case the database upgrade fails, you can run setup.php?debug=1 to see the last executed query.)
  60. From version 2.3, you need to specify a setup_password in config.inc.php -
  61. setup.php should guide you through this process. If you do not have a setup_password, type one
  62. into the form, and setup.php will echo out the hashed value (which needs to go into config.inc.php).
  63. The setup_password removes the requirement for you to delete setup.php, and also closes a security hole.
  64. Since version 2.2 of Postfixadmin, setup.php can perform the needed database
  65. updates automatically .
  66. If you update from 2.1 or older, also create a superadmin account using setup.php.
  67. Note that admin/ has been merged into the main directory. Login with the
  68. superadmin account to setup domains and domain admins.
  69. 6. Upgrade your postfix config
  70. ------------------------------
  71. Since version 2.3, PostfixAdmin supports alias domains ($CONF['alias_domain']).
  72. If you want to use them, you have to add some queries to your postfix config -
  73. see POSTFIX_CONF for details.
  74. 7. Done
  75. -------
  76. This is all that is needed. Fire up your browser and go to the site that you
  77. specified to host Postfix Admin.