The ISPConfig update script is a easy way to update a ISPConfig 3 installation. If you want to create a manual backup of ISPConfig, take a look at the instructions at the end of the article.

To update ISPConfig 3, login as root user on the shell of your server and run the command:

ispconfig_update.sh

>> Update

Please choose the update method. For production systems select 'stable'.
The update from svn is only for development systems and may break your current setup.

Select update method (stable,svn) [stable]:

You should always select "stable" on a production system. The "svn" version is only suitable for ISPConfig 3 development.

The updater will then check the version of your system, download the latest update and starts the update process.

This application will update ISPConfig 3 on your server.

Shall the script create a ISPConfig backup in /var/backup/ now? (yes,no) [yes]:

You should choose "yes" here. This will create a backup of the ISPConfig scripts (/usr/local/ispconfig), the /etc directory and the ISPC0nfig MySQL database in the directory /var/backup/

Creating backup of "/usr/local/ispconfig" directory...
Creating backup of "/etc" directory...
Checking ISPConfig database .. OK
Starting incremental database update.

The update script will then start to install incremental database updates for ISPConfig, if required.

Reconfigure Permissions in master database? (yes,no) [no]:

If this is a slave server in a multiserver setup, then choose "yes" here on at least one of the slave servers. For single server installations, choose 'no'. Then you were asked if the services shall be reconfigured:

Reconfigure Services? (yes,no) [yes]:

You should choose "yes" here, only if you modified your system configuration manually, it might be better to choose no. But in this case, new features in ISPConfig might not work or functions might stop working until you adjusted the config files manually. So its always a good choice to select 'yes' here. In the next step, select the ispconfig port:

ISPConfig Port [8080]:

Port 8080 is the default, if you have not changed it, press enter. Otherwise enter the port number and then press enter. As the last step, you wre asked if the crontab shall get reconfigured, you can select yes here by just pressing return.

Create new ISPConfig SSL certificate (yes,no) [no]:

If your SSL certificate for the ISPConfig interface has been expired and you want to renew it or if you want to enable SSL encryption for the ISPConfig interface, then choose "yes". If you dont need a new SSL certificate, take the default (no).

Reconfigure Crontab? (yes,no) [yes]:

The ISPConfig updater will then update the ispconfig files and restart services, if the configuration has been changed.

Backup before updates

(This backup procedure is now integrated into the ISPConfig updater and gets executed automatically when you choose to create a backup during update)

Before you update a software, it is always a good idea to backup all relevant data. This enables you to restore the software version that you had before in case of an error. The steps to create a backup of the ispconfig software and settings are:

Create a backup folder:

mkdir /home/backup
chmod 700 /home/backup
cd /home/backup

Backup the database

mysqldump -u root -p dbispconfig > dbispconfig.sql

Backup the ISPConfig software

tar pcfz ispconfig_software.tar.gz /usr/local/ispconfig

Backup the configuration files in /etc

tar pcfz etc.tar.gz /etc

This backup does not include the emails and website data.

How to Update ISPConfig 3
Tagged on:

76 thoughts on “How to Update ISPConfig 3

  • Permalink

    mysqldump -u root -p dbispconfig > dbispconfig.sql
    this is an error should be:
    mysqldump -u root -p dbispconfig > dbispconfig.sql

    Reply
        • Permalink

          They are !

          The first one is dbisponfig(colon)sql

          The second one is dbispconfig(period)sql

          Look Closely !

          Reply
          • Permalink

            nope they are both dots man. (look below at my other comment)

    • Permalink

      You probably wanted to say that
      mysqldump -u root -p dbispconfig > dbispconfig.sql
      in the text above ist with a html > (>)
      while it should show the corresponding > (greater than) sign to symbolize that the output should be postet to the file dbispconfig.sql…

      Reply
      • Permalink

        However in the comments the > got converted into a > 😉 funny stuff if you can’t properly code a comment form on faqforge.
        try to htmlencode that stuff… and ignore html code here please.

        Reply
        • Permalink

          I just spent 10 minutes scratching my head over that :o| I need to read comments more thoroughly before bashing out commands.

          Reply
    • Permalink

      The SQL dump can be restored with e.g. phpmyadmin. The tar backup can be extracted with “tar pcfz backupfile.tar.gz” and then copy or move the complete directory tree or the files that you need back to their original location.

      Reply
  • Permalink

    HI, I have Fedora 5, and I have installed ISPConfig 2, you can upgrade to the 3.0 version of ISPConfig .. I await your response.

    Reply
  • Permalink

    ISPConfig 2 and 3 are completely different software packages. ISPConfig 2 can not be updated to ISPConfig 3.

    Reply
  • Permalink

    I am still getting errors when entering the port number. ISPConfig Port [8080]:

    Any help if my port is a different one that “standard?” We had it in a lab doing some testing and I dont know who did what to it. Cheers

    Reply
    • Permalink

      You may use any port that you like as long as it is not already in use by another application.

      Reply
  • Permalink

    This artical should start with the “Backup before updates” part.. 😉

    Better for the beginners to know you alway backup first.

    Reply
  • Permalink

    I see the backup process doesn’t back up e-mails. How would you back up and restore e-mails?

    Reply
  • Permalink

    Upgrade from 3.0.2.2 to 3.0.3 went good for me with the “ispconfig_update.sh” command.
    Using Debian (Leny) provided by OVH Kimsufi.
    Only things is I have now to login through HTTP instead of HTTPS.

    Reply
  • Permalink

    Put the backup instructions on top of the document, I notices the backup advice after the backup script did run.
    Luckily successfully.

    Reply
  • Permalink

    The backup in the doc does not include emails and website database backups

    the following is for the emails; tar pcfz vmail.tar.gz /var/vmail/
    I need to backup website database, We are moving everything to a new server with a new installation.

    Reply
    • Permalink

      These backup intructions are for a backup that contains all data that gets overwritten by a ispconfig update, it is not meant as a full server backup.

      Reply
  • Permalink

    Hi, I need to update 2 to 3. Anyone can help me? Thanks.

    Reply
    • Permalink

      ISPConfig 2 and 3 are completely different software packages which have different system requirements. ISPConfig 2 is based on linux system users while ISPConfig 3 uses virtual users for Email and FTP. So ISPConfig 2 can not be updated to ISPConfig 3.

      Reply
  • Permalink

    Can someone please help me. How do I do a full Server backup ISPConfig.

    Reply
  • Permalink

    Hello,
    we have 1 server in master and some other server in slave config. They run 3.0.1 and 3.0.2 . Should we upgrade the master, will it be necessary to upgrade also the slaves? And would the procedure be the same you described above with same script?

    thanks
    Eddison

    Reply
  • Permalink

    hi …
    i have installed ISPconfig 3.0.3.2 … when i try to update it to 3.0.3.3 with ispconfig_update.sh i get this response : “This software cannot be installed on a server wich runs ISPConfig 2.x.” … !!!
    any help anyone ?
    George

    Reply
    • Permalink

      I guess you use one of the ispconfig 2 install folders on your server. Ensure that there is no folder /home/admispconfig or /root/ispconfig on your system.

      Reply
  • Permalink

    Hi, i have this errors, why ? update for 3.0.3.2 3.0.3.3, Debian Lenny

    Operating System: Debian Lenny or compatible

    This application will update ISPConfig 3 on your server.

    Warning: mysql_connect(): Access denied for user ‘root’@’localhost’ (using password: YES) in /tmp/ispconfig3_install/install/lib/mysql.lib.php on line 78

    Fatal error: Cannot use string offset as an array in /tmp/ispconfig3_install/install/lib/update.lib.php on line 98

    Reply
    • Permalink

      You use the wrong mysql root password. Most likely you changed the root password after you installed ispconfig without chaning it in /usr/local/ispconfig/lib/mysql_clientdb.conf file too.

      Reply
  • Permalink

    i had installed ispconfig 3 and the mail pop and smtp is showing turned off and phpmyadmin not getting installed.. can some one help. we have a centos 5.5

    Reply
  • Permalink

    I backed up the server as per the instructions given in the main article. I now have the following files in my /home/backup folder:-

    -rw-r–r– 1 root root 203424 Oct 9 12:35 dbispconfig.sql
    -rw-r–r– 1 root root 1163693 Oct 9 12:35 etc.tar.gz
    -rw-r–r– 1 root root 2760087 Oct 9 12:35 ispconfig_software.tar.gz
    -rw-r–r– 1 root root 77090 Oct 9 12:36 vmail.tar.gz

    I have lately messed up with file and folder permissions and ownership on the server’s root with recursive option. Would a restore of these files get the server functional again?

    How do i go about restoring these files? and where do I restore them.

    Thanks.

    Reply
    • Permalink

      The backup contains only the ispconfig files, database and the files from /etc/. Backups that you create with tar pcfz can be unpacked with tar xfz filename.tar.gz

      Reply
      • Permalink

        would that restore the files to their desired directories, or would i have to specify that manually?

        Reply
  • Permalink

    I’m running 3.0.1.4 on a production server with many clients and Domains.
    I would like to try out the new features like Invoice and such but am not in the mood for any f-ups and down time that might happen with an update. I know I need to backup first but I was just wondering what the error quota is on updating to 3.0.4? Can I do this this quickly and smoothly w/o probs or should I just never change a running system?
    Any pitfalls to look out for?

    Sanks ferry matsch 🙂

    Reply
  • Permalink

    What happened to the ISPConfig Update Button? It’s replaced with some manual help text now.
    It was my favourite part of ISPconfig3.

    Reply
  • Permalink

    Update instructions worked just fine for me. Thanks a lot. Nice tutorial.

    Reply
  • Permalink

    For Ubuntu 10.04
    Apache/2.2.14 (Ubuntu)
    MySQL client version: 5.1.61

    Note: If you have a password with a $ in it then specify that in the password text like this:
    “MyPa$$word” would become “MyPa\$\$word”. Otherwise it fails.

    Also, mysql has a virtual db called “information_schema” – mysqldump wil not work on this so change the code in the backup script from this:

    Ad a variable in the user vars section:
    mschema = “information_schema”

    Line 311–
    Change this:
    log “Starting mysqldump $i”
    `mysqldump -u$dbuser -p$dbpassword $i –allow-keywords –comments=false –add-drop-table > $tmpdir/db-$i-$FDATE.sql`
    $TAR $ARG $BACKUPDIR/$MDATE/db-$i-$FDATE.tar.bz2 -C $tmpdir db-$i-$FDATE.sql
    rm -rf $tmpdir/db-$i-$FDATE.sql
    log “Dump OK. $i database saved OK!”
    —————-
    to this::
    —————-
    log “Starting mysqldump $i”
    if [ “$i” != “$mschema” ] ; then
    `mysqldump -u$dbuser -p$dbpassword $i –allow-keywords –comments=false –add-drop-table > $tmpdir/db-$i-$FDATE.sql`
    $TAR $ARG $BACKUPDIR/$MDATE/db-$i-$FDATE.tar.bz2 -C $tmpdir db-$i-$FDATE.sql
    rm -rf $tmpdir/db-$i-$FDATE.sql
    log “Dump OK. $i database saved OK!”
    fi

    Reply
  • Permalink

    Thx for the nice how to update! Work’s quite fine for me on Debian squeeze

    Reply
  • Permalink

    Update didn’t work good from 3.0.2 to 3.0.4. Users couldn’t get their emails, because the users were unknown. Websites worked. What did I do wrong? Where do I get the 3.0.3 version? I just entered the standard settings above in FAQ.

    Reply
    • Permalink

      The update works fine from 3.0.2 to 3.0.4 here with the instructions above, so it must be a issue specific to your installation. Please post in the ispconfig forum to get support:

      http://www.howtoforge.com/forums/

      Reply
  • Permalink

    Klasse!
    Das Update funktioniert problemlos. (Debian6)
    Im Terminal “ispconfig_update.sh” eingeben, die Fragen sorgfältig abarbeiten, – das war’s.
    Und die Erstellung von SSL-Zertifikaten ist in das Update-Script auch gleich mit eingearbeitet.
    Alles in Allem eine halbe Stunde Arbeit. – Ein richtig gutes Update-Script. – Respekt.

    Reply
  • Permalink

    Perfect! Thanks for this great article from germany. *like*

    Reply
  • Permalink

    I have ISPConfig 3.0.4 installed on 2 VPS systems as Cluster.
    Now i want to update to ISPConfig 3.0.5 do i have to use the updater on both VPS Servers?

    Kindly regards,

    P. Sopacua

    Reply
    • Permalink

      Yes, the updater has been executed on both servers. You sgould start on the master and choose to update permissions in master server when the updater asks.

      Reply
  • Permalink

    Hi,

    ISPConfig 3.0.5.3

    What version of php provided with MySQL?

    Reply
  • Permalink

    When try to upgrade to ISPConfig 3.0.5.4 beta following this post: http://www.ispconfig.org/blog/1/entry-124-ispconfig-3054-beta-released/

    PHP Parse error: syntax error, unexpected ‘[‘ in /usr/local/ispconfig/server/plugins-available/mongo_clientdb_plugin.inc.php on line 253

    My System;

    Debian GNU/Linux 7.1

    mongod version v2.4.6 – Thu Mar 27 01:13:17.570 git version: b9925db5eac369d77a3a5f5d98a145eaaacd9673

    PHP 5.3.3-7+squeeze14 with Suhosin-Patch (cli) (built: Aug 6 2012 14:18:06)
    Copyright (c) 1997-2009 The PHP Group
    Zend Engine v2.3.0, Copyright (c) 1998-2010 Zend Technologies
    with XCache v1.3.0, Copyright (c) 2005-2009, by mOo
    with Suhosin v0.9.32.1, Copyright (c) 2007-2010, by SektionEins GmbH

    Reply
  • Permalink

    I have 2 ISPCpnfig running servers.
    I can not update to the latest release.

    PHP Parse error: syntax error, unexpected T_VARIABLE, expecting T_FUNCTION in /tmp/ispconfig3_install/install/dist/lib/fedora.lib.php on line 247

    I get this on both of them.

    Reply
  • Permalink

    I just make last update. Worked fine until I do not restart server. After that no ISPconfig3 working and Squirrelmail as well. All other function of my email server, DNS, Nginx, Apache works…. Just cannot reach ISPConfig and Squirremail

    Anybody help me please.

    Reply
    • Permalink

      If you need help, then please post in the ISPConfig forum.

      Reply
  • Permalink

    The update worked fine from 3.0.2 to 3.0.4 , thank you for this article.

    Reply
  • Permalink

    My update at my master ISPCONFIG 3 server stops at /etc auto backup. There´s plenty disk space yet and I dunno why it doesn´t update. All of my slaves are updated without any problems. Debian Wheezy here. :/

    Reply
    • Permalink

      Though that should also mention:
      This Version: 3.0.5.4p5

      Upgrading to:
      New Version : 3.0.5.4p8

      Operating System: Debian 7.0 (Wheezy/Sid) or compatible

      This application will update ISPConfig 3 on your server.

      Shall the script create a ISPConfig backup in /var/backup/ now? (yes,no) [yes]:

      Creating backup of “/usr/local/ispconfig” directory…
      Creating backup of “/etc” directory…
      root@webservices01:/#

      It quits just like that. no error no log no nothing.

      Reply
  • Permalink

    The article should start with paragraph “Backup before updates”. You really shouldn’t place it at the end. #justsaying 🙂

    Reply
  • Permalink

    Before I embark on this, does the update mess with the php version(s) at all? I have one site that still clunking along on php5.2, which I had to add manually (with much difficulty) and I do NOT want to upset that apple cart. I can’t upgrade it because the crappy software used isn’t compatible, but the client won’t switch. Thanks!

    Reply
  • Permalink

    Hi,

    I got these error lines end of update:

    /usr/local/ispconfig/server/scripts/update_from_tgz.sh: line 21: -d: command not found
    /usr/local/ispconfig/server/scripts/update_from_tgz.sh: line 26: syntax error near unexpected token `else’
    /usr/local/ispconfig/server/scripts/update_from_tgz.sh: line 26: `else’
    /usr/local/bin/ispconfig_update.sh: line 4: -d: command not found

    Reply
  • Permalink

    So i update ispconfig to 3.1, and my mail no longer works

    Reply
    • Permalink

      Me too.. after restore from backups, files and db everything works again

      Reply
  • Permalink

    I have a multiserver ispconfig 3.0.5.4p5 (two mailservers, two webservers), all at debian 7 with apache and php 5.4 (whole configuration has been inherited from previous company). I would like to upgrade to 3.1, than install 3rd webserver with php 7 (debian 8). What upgrade scenario do you prefer. Will this be able to work alltogether?

    Reply
  • Permalink

    I ran the update script and now my jobqueue is stalled. Cron doesn’t seem to be working anymore. I didn’t update cron when it did the update. Should I?

    Reply
    • Permalink

      For secure reasons, any kind of Data, include Cron Jobs etc., etc. should be backed up!

      Reply
  • Permalink

    I got an error here:

    Restarting services …
    PHP Warning: mysqli_connect(): Headers and client library minor version mismatch. Headers:50553 Library:100030 in /tmp/update_stable.sh.On8x89hlwv/ispconfig3_install/install/lib/mysql.lib.php on line 204
    Update finished.

    However things seem to be working ok so far. I don’t know if it’s a major issue or not.
    I’m on Debian 8.1 x64.

    Reply
  • Permalink

    After many, many search cannot find how to simply restore ispconfig from backup? I updated and after update all WordPress sites show 500 error and PHP-FM apparently no longer working correctly.

    Just need to restore back I made so can at least get sites back online.

    Please help:), thanks!

    Susan

    Reply
    • Permalink

      An ISPConfig update does not alter the vhost or PHP config of existing sites, so it is very unlikely that your problem is related to an ISPConfig update and therefore a restore of the previous version will not fix it. Go to the ISPConfig forum at howtoforge and post your issue there to get help. A 5oo PHP error indicates a problem in the PHP code of that website and you can see the reason for the error in the error.og of the site. Beside that, an ISPConfig backup is restored by unpacking the tar.gz file and copying it#s cntent back to the original place, in this case /usr/local/ispconfig.

      Reply
      • Permalink

        Thank you for reply.

        All I know is immediately after the update all sites started displaying 500 error with no changes to them. Perhaps I did something wrong during the update? since I have php7 installed maybe that is were I went wrong.

        Reply
        • Permalink

          If you like to get help, then post in the forum as I suggested.

          Reply
          • Permalink

            Was not asking for help, was only stating that the issue happened after following the instructions here:)

            If I could ask one more related question for future reference, please:

            I followed the instructions above to the tee. On step “Reconfigure Services? (yes,no) [yes]:” I answered yes. Since system has PHP7 is there something else I should do?

            Reason I ask, is just reinstalled PHP7 and sites started working. Thinking maybe not fully understanding the procedure.

            Thanks again for your input.

          • Permalink

            Your problem is not related to the ISPConfig update, it is just a timely coincidence, that’s all. You probably installed Linux updates as well before and these broke your custom PHP version by exchanging some libraries. You recognized that at the time you updated ISPConfig as the ISPConfig updater restarts Apache. So there is nothing wrong with the above update procedure and your problem is not related to the ISPConfig update, it was caused by a Linux system update. Recompiling PHHP fixed it because the newly compiled PHP uses the new Linux Libraries.

Leave a Reply

Your email address will not be published. Required fields are marked *

*