gjdwebserver-overlay/www-apps/postfixadmin/files/postinstall-en-2.3.txt

48 lines
1.8 KiB
Plaintext

First Time Installation
=======================
PostfixAdmin can use either MySQL or PostgreSQL. It is up to you, or your
database administrator, to provide a database and a user with full access to
the database for use by PostfixAdmin.
If you are unfamiliar with MySQL or PostgreSQL, we have some good starting
guides:
* http://www.gentoo.org/doc/en/mysql-howto.xml
* https://wiki.gentoo.org/wiki/PostgreSQL
Once the database and user have been allocated, you will need to provide the
details of this database and the associated user within the configuration file:
${MY_INSTALLDIR}/config.inc.php
In the same configuration file, check for other settings that are relevant to
your setup. Once you're finished with your changes, make sure you set:
$CONF['configured'] = true;
To use Virtual Vacation, please read VIRTUAL_VACATION_INSTALL.
Finally you should be able to complete the installation of postfixadmin by
pointing your browser at:
http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/setup.php
Postfix Admin contains 3 views of administration:
1. Site Admin view, located at http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/admin/.
2. Domain Admin view, located at http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/.
3. User Admin View, located at http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/users/.
In order to do the initial configuration you have to go to the Site Admin view.
Upgrading
=========
When updating from older version of PostfixAdmin, make sure you backup your
database before you run the update script on your database.
* mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql
* pg_dump -U postgres -d postgres -C -f pa-db-backup.sql postfixadmin_db
For update from version 1.5.x of PostfixAdmin:
1. Please read the DOCUMENTS/UPGRADE.TXT
2. Run: http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/setup.php