Bug ID 1091866
Summary RN: PostfixAdmin - changed directory layout
Classification openSUSE
Product openSUSE Distribution
Version Leap 15.0
Hardware Other
OS openSUSE 42.3
Status NEW
Severity Normal
Priority P5 - None
Component Release Notes
Assignee sknorr@suse.com
Reporter suse-beta@cboltz.de
QA Contact lnussel@suse.com
Found By Beta-Customer
Blocker ---

The PostfixAdmin package in Leap 15.0 (and also Tumbleweed) comes with a
changed directory layout, which also brings a backwards-incompatible change
(PostfixAdmin will no longer read the config files at the old location).

This especially means users will have to move their config.local.php to
/etc/postfixadmin and (if they did changes to config.inc.php) migrate these
changes, ideally to /etc/postfixadmin/config.local.php.

Users will also need to enable or add the /postfixadmin alias in the apache
config.


Can you please add [something like] the following text to the "Upgrade" section
of the release notes?

-------------------------------------------------------------------------

PostfixAdmin: Changed directory layout

PostfixAdmin 3.2 comes with a changed directory layout. Instead of having
everything in /srv/www/htdocs/postfixadmin/,
- the config files (config.inc.php and config.local.php) are now in 
  /etc/postfixadmin/. (It's recommended to keep config.inc.php unmodified,
  and to add config changes to config.local.php.)
- the PHP code moved to /usr/share/postfixadmin/
- the smarty cache moved to /var/cache/postfixadmin/

Note that /srv/www/htdocs/postfixadmin/config.*.php will _not_ be moved to
/etc/postfixadmin/ automatically on upgrades, so you'll have to migrate your
config changes manually.

Also note that the /postfixadmin alias is _not_ enabled in Apache by default. 

To enable the /postfixadmin alias, run
    a2enflag POSTFIXADMIN && rcapache2 restart
This will make /postfixadmin available on all virtual hosts.

If you want to have the /postfixadmin alias only on a specific virtual host,
add the alias to the config of that vhost.

-------------------------------------------------------------------------

For the Apache config, you can replace the text starting at "To enable..." with
a reference to the comments in /etc/apache2/conf.d/postfixadmin if you think
the text is too long.

Also, feel free to drop the "(It's recommended ...)" sentence if you think it
makes the text too long.


You are receiving this mail because: