This blog is NOFOLLOW Free!

The magic space of the IT find what you seek or get lost


Syscp to Froxlor Upgrade Guide

In this Howto I will do an upgrade from syscp to the fork froxlor in the current revision of 0.9.3. I hope to cover all fall sticks. But overall the upgrade is very painless and easy. Thanks a lot to guys of froxlor!
I do this as always on a gentoo host. Its your choice to use the good ebuild to install froxlor or to download it by hand. Here I will cover the manual steps.

First start with the basic stuff (download, uncompress, ...)

cd /tmp
wget -q
wget -q
md5sum -c froxlor-0.9.3.tar.gz.md5
# froxlor-0.9.3.tar.gz: OK
tar xfz froxlor-0.9.3.tar.gz -C /var/www

Now froxlor is installed to /var/www/froxlor and we only have to correct the permission. I asume that you have an syscp user already created in the syscp installation. Because of this the ownership can differ (also if you use mod_fcgid), so please look in your syscp installation. I try to copy the ownership with this command. If it fails do it by yourself.

chown `ls -al /var/www/syscp/index.php | awk '{print $3":"$4}'` /var/www/froxlor

The good thing is that we only have to copy the user data file over, because it has not changed.

cp -p /var/www/syscp/lib/ /var/www/froxlor/lib/

Now it would a good time to disable the syscp cronjobs and do a backup the database. (The databasename will not be changed by upgrading to froxlor)

rm /etc/cron.d/syscp
mysqldump --opt -p syscp > /tmp/mysqldump_syscp.sql

Because of the new docroot we have to change the pathes in the vhost. I use apache and my vhost file is called 95_syscp-admin.conf

sed -i 's|/var/www/syscp|/var/www/froxlor|g' /etc/apache2/vhosts.d/95_syscp-admin.conf
/etc/init.d/apache2 reload

Now you have to connect to your syscp/froxlor vhost, where you already should greeted with the nice froxlor logo. Please log in and let it do the needed database upgrades (done automatically). After that you can continue here.

Froxlor also changes the name of generated include file for bind. If you use it, you have to do this:

sed -i 's|syscp_bind.conf|froxlor_bind.conf|g' /etc/bind/named.conf
rm /etc/bind/syscp_bind.conf

You will find the same thing for awstats. You will see a failure immediatly if forget to do this, at the first run of cron.

mv /etc/awstats/awstats.model.conf.syscp /etc/awstats/awstats.model.conf.froxlor

Now we should move the aps things from syscp to froxlor.

mv /var/www/syscp/packages/* /var/www/froxlor/packages/
mv /var/www/syscp/temp/* /var/www/froxlor/temp/

I find it saver to do the first froxlor cron run by myself, to check for generated failures.

/usr/lib/php5/bin/php -q /var/www/froxlor/scripts/froxlor_master_cronjob.php

If everything was ok, you can now add the froxlor cron. The dos2unix line should not be needed anymore, because Dessa fixed the bug in the 0.9.4 release.

cp /var/www/froxlor/templates/misc/configfiles/gentoo/cron/etc_cron.d_froxlor /etc/cron.d/froxlor
dos2unix /etc/cron.d/froxlor
chmod +x /etc/cron.d/froxlor

And that was it! Have fun with your new froxlor installation. If you have comments or more snares, please give me a info.

IMHO: I find it very good that the old syscp developers has started this fork, and has fixed many many many bugs already 🙂

Changelog of this guide

Fatal error: Call to undefined function the_flattr_permalink() in /srv/www/webs/aschneider/magicspace_eu/htdocs/wp-content/themes/lightword-custom/single.php on line 23 Call Stack: 0.0001 235624 1. {main}() /srv/www/webs/aschneider/magicspace_eu/htdocs/index.php:0 0.0003 238584 2. require('/srv/www/webs/aschneider/magicspace_eu/htdocs/wp-blog-header.php') /srv/www/webs/aschneider/magicspace_eu/htdocs/index.php:17 0.3262 54684584 3. require_once('/srv/www/webs/aschneider/magicspace_eu/htdocs/wp-includes/template-loader.php') /srv/www/webs/aschneider/magicspace_eu/htdocs/wp-blog-header.php:19 0.3314 55083048 4. include('/srv/www/webs/aschneider/magicspace_eu/htdocs/wp-content/themes/lightword-custom/single.php') /srv/www/webs/aschneider/magicspace_eu/htdocs/wp-includes/template-loader.php:74