How to Update ISPConfig 3
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.
mysqldump -u root -p dbispconfig > dbispconfig.sql
this is an error should be:
mysqldump -u root -p dbispconfig > dbispconfig.sql
I don’t see any errors. Everything is clear.
lol they’r exactly the same
They are !
The first one is dbisponfig(colon)sql
The second one is dbispconfig(period)sql
Look Closely !
nope they are both dots man. (look below at my other comment)
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…
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.
How do I restore my backup ?
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.
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.
ISPConfig 2 and 3 are completely different software packages. ISPConfig 2 can not be updated to ISPConfig 3.
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
You may use any port that you like as long as it is not already in use by another application.
This artical should start with the “Backup before updates” part..
Better for the beginners to know you alway backup first.
I see the backup process doesn’t back up e-mails. How would you back up and restore e-mails?
tar pcfz vmail.tar.gz /var/vmail/
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.
How do you backup and restore websites?
Put the backup instructions on top of the document, I notices the backup advice after the backup script did run.
Luckily successfully.
Perfect, job done!
Thanks a million, for 3.0.3 version!
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.
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.
Hi, I need to update 2 to 3. Anyone can help me? Thanks.
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.
Can someone please help me. How do I do a full Server backup ISPConfig.
Please see here for a full backup script for ispconfig 3:
http://www.howtoforge.com/forums/showthread.php?t=41609
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
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
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.
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
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.
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
Please ask support questions directly in the ISPConfig Forum http://www.howtoforge.com/forums/
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.
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
would that restore the files to their desired directories, or would i have to specify that manually?
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
What happened to the ISPConfig Update Button? It’s replaced with some manual help text now.
It was my favourite part of ISPconfig3.
Please see release notes:
http://bugtracker.ispconfig.org/index.php?do=details&task_id=1897