PostFix Admin upgrade from to 2.3.3

Posted on 2011-05-04
Last Modified: 2012-05-11
Good day

I have to upgrade PostFix Admin from to 2.3.3
Was searching on WEB, did not find much
It is a production PostFix server with MySql to store all settings
Step-by-step plan would be highly appreciated

Thank you
Question by:mattyinteractive

    Accepted Solution

    # Postfix Admin
    # by Mischa Peters <mischa at high5 dot net>
    # Copyright (c) 2002 - 2005 High5!
    # Licensed under GPL for more info check GPL-LICENSE.TXT

    - You are using Postfix 2.0 or higher.
    - You are using Apache 1.3.27 / Lighttpd 1.3.15 or higher.
    - You are using PHP 5.1.2 or higher.
    - You are using MySQL 3.23 or higher OR PostgreSQL v7.4+


    This document describes upgrading from an older PostfixAdmin version
    (>= v1.5x)

    It's recommend that you install Postfix Admin in a new folder and not
    on-top of the old install!! (At the very least, make sure you have backups of
    the database and relevant filesystem!)

    When upgrading Postfix Admin, make sure you backup your database before
    running upgrade.php.

    1. Backup the Database
    When you install from a previous version make sure you backup your database
    first. There are a lot of changes in the database structure since Postfix Admin

      $ mysqldump -a -u root -p > /tmp/postfixadmin-backup.sql
      $ pg_dump -ad -u postfix postfix > /tmp/postfixadmin-backup.sql

    2. Unarchive new Postfix Admin
    Make sure that you are in your WWW directory and then unarchive the
    Postfix Admin archive (whatever the filename is):

      $ tar -zxvf postfixadmin-X.X.tgz

    3. Change permissions
    Since the database password is stored in the it's a good idea
    to have change the permissions for Postfix Admin.

      $ cd /usr/local/www/postfixadmin
      $ find -type f -print0 | xargs -0 chmod 640
      $ find -type f -print0 | xargs -0 chown root:www

    (the last command assumes your Apache is running with group "www")

    4. Configure
    Check the file. There you can specify settings that are
    relevant to your setup.

    Comparing with your previous using "diff" might save you some

    You can use a config.local.php file to contain your local settings. These will override any
    defined in - and save some time when upgrading to a new version of PostfixAdmin ;-)

    5. Run setup.php

    Access setup.php through a web browser.

    It will attempt to upgrade your database, and also allow you to create a superadmin user.
    (In case the database upgrade fails, you can run setup.php?debug=1 to see the last executed query.)

    From version 2.3, you need to specify a setup_password in -
    setup.php should guide you through this process. If you do not have a setup_password, type one
    into the form, and setup.php will echo out the hashed value (which needs to go into
    The setup_password removes the requirement for you to delete setup.php, and also closes a security hole.

    Since version 2.2 of Postfixadmin, setup.php can perform the needed database
    updates automatically .

    If you update from 2.1 or older, also create a superadmin account using setup.php.

    Note that admin/ has been merged into the main directory. Login with the
    superadmin account to setup domains and domain admins.

    6. Upgrade your postfix config

    Since version 2.3, PostfixAdmin supports alias domains ($CONF['alias_domain']).
    If you want to use them, you have to add some queries to your postfix config -
    see POSTFIX_CONF for details.

    7. Done
    This is all that is needed. Fire up your browser and go to the site that you
    specified to host Postfix Admin.


    Author Closing Comment

    I had found it, so other folks can find the solution

    Write Comment

    Please enter a first name

    Please enter a last name

    We will never share this with anyone.

    Featured Post

    Want to promote your upcoming event?

    Is your company attending an event or exhibiting at a trade show soon? Are you speaking at a conference? Spread the word by using a promotional banner in your email signature. This will ensure your organization’s most important contacts are in the know.

    This short article will present "How to import ICS Calendar onto Office 365 Calendar". I was searching for free (or not free) tools to convert ICS to CSV without success. The only tools I found & working well were online tools...this was too hard to…
    Resolve Outlook connectivity issues after moving mailbox to new Exchange 2016 server
    Familiarize people with the process of utilizing SQL Server stored procedures from within Microsoft Access. Microsoft Access is a very powerful client/server development tool. One of the SQL Server objects that you can interact with from within Micr…
    To show how to create a transport rule in Exchange 2013. We show this process by using the Exchange Admin Center. Log into Exchange Admin Center.: First we need to log into the Exchange Admin Center. Navigate to the Mail Flow >> Rules tab.:  To cr…

    779 members asked questions and received personalized solutions in the past 7 days.

    Join the community of 500,000 technology professionals and ask your questions.

    Join & Ask a Question

    Need Help in Real-Time?

    Connect with top rated Experts

    16 Experts available now in Live!

    Get 1:1 Help Now