titanofold 15/02/25 15:04:10 Modified: postinstall-en-2.3.txt Log: Abstracted post-install instructions so that they are database agnostic. Fixes bug 387773. (Portage version: 2.2.14/cvs/Linux x86_64, signed Manifest commit with key D1BBFDA0)
Revision Changes Path 1.2 www-apps/postfixadmin/files/postinstall-en-2.3.txt file : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/www-apps/postfixadmin/files/postinstall-en-2.3.txt?rev=1.2&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo-x86/www-apps/postfixadmin/files/postinstall-en-2.3.txt?rev=1.2&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/www-apps/postfixadmin/files/postinstall-en-2.3.txt?r1=1.1&r2=1.2 Index: postinstall-en-2.3.txt =================================================================== RCS file: /var/cvsroot/gentoo-x86/www-apps/postfixadmin/files/postinstall-en-2.3.txt,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- postinstall-en-2.3.txt 16 Mar 2010 19:15:32 -0000 1.1 +++ postinstall-en-2.3.txt 25 Feb 2015 15:04:10 -0000 1.2 @@ -1,47 +1,47 @@ -You will need to provide a database for your postfixadmin installation. +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. -This assumes you have some knowledge of MySQL, and already have it -installed and configured. If not, please refer to the Gentoo MySQL -guide at the following URL: +If you are unfamiliar with MySQL or PostgreSQL, we have some good starting +guides: -http://www.gentoo.org/doc/en/mysql-howto.xml + * http://www.gentoo.org/doc/en/mysql-howto.xml + * https://wiki.gentoo.org/wiki/PostgreSQL -Log in to MySQL, and create a new database as well as a user with full -access to this database. After that you will need to provide the details -of this database and the associated user within the file +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 + ${MY_INSTALLDIR}/config.inc.php -Make sure you also set +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; -in this file. +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 +Finally you should be able to complete the installation of postfixadmin by +pointing your browser at: http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/setup.php - -Updating from older version of Postfix Admin: - * When you are upgrading from an older Postfix Admin version, make sure you - * backup your database before you run the update script on your database. - * mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql - - For update from version 1.5.x of Postfix Admin: - 1. Please read the DOCUMENTS/UPGRADE.TXT - 2. Run: http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/setup.php - - -To use Virtual Vacation, please read VIRTUAL_VACATION_INSTALL. - -Check the config.inc.php file. There you can specify settings that are -relevant to your setup. - 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
