www-apps/postfixadmin

This wiki page is about a gentoo ebuild. Include any information about how to install it (emerge it), potential problems and how to resolve them. Be bold and improve it!

If you have any questions or experience any problem related to this ebuild, don't hesitate to open a new ticket and we'll do our best to assist you.

* (config) htdocs/config.inc.php
* (info) /var/tmp/portage/www-apps/postfixadmin-3.1/files/postinstall-en-2.3.txt (lang: en)
*
* The 'vhosts' USE flag is switched ON
* This means that Portage will not automatically run webapp-config to
* complete the installation.
*
* To install postfixadmin-3.1 into a virtual host, run the following command:
*
*     webapp-config -h <host> -d postfixadmin -I postfixadmin 3.1
*
* For more details, see the webapp-config(8) man page

See https://linux.overshoot.tv/app-admin/webapp-config
* vhosts USE flag not set - auto-installing using webapp-config
* This is an installation
* postfixadmin-3.1 is not installed - using install mode
* Running /usr/sbin/webapp-config -h localhost -u root -d /postfixadmin -I postfixadmin 3.1
*   Creating required directories
*   Linking in required files
*     This can take several minutes for larger apps
*   Files and directories installed

=================================================================
POST-INSTALL INSTRUCTIONS
=================================================================

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:

  /var/www/localhost/htdocs/postfixadmin/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:

  ['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://localhost//postfixadmin/setup.php

Postfix Admin contains 3 views of administration:
  1. Site Admin view, located at http://localhost//postfixadmin/admin/.
  2. Domain Admin view, located at http://localhost//postfixadmin/.
  3. User Admin View, located at http://localhost//postfixadmin/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://localhost//postfixadmin/setup.php

==============================... Install completed - success

* Running /usr/sbin/webapp-cleaner -p -C www-apps/postfixadmin
* Nothing to clean
* /var/spool/vacation/vacation.pl symlink was updated to:
* /var/spool/vacation/vacation.pl-3.1

Troubleshooting

templates_c directory doesn't exist

ERROR: the templates_c directory doesn't exist or isn't writeable for the webserver

Simply create the directory and make the web server the owner of the directory:

# mkdir /var/www/localhost/htdocs/postfixadmin/templates_c
# chgown apache /var/www/localhost/htdocs/postfixadmin/templates_c/

This is assuming that postfixadmin is installed in /var/www/localhost/htdocs/postfixadmin/ and that the apache user is apache. On some distros, the apache user is www-data.

External resources