This blog is NOFOLLOW Free!

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

26Mar/103

Syscp to Froxlor Upgrade Guide

In this Howto I will do an upgrade from syscp 1.4.2.1 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 http://files.froxlor.org/releases/froxlor-0.9.3.tar.gz
wget -q http://files.froxlor.org/releases/froxlor-0.9.3.tar.gz.md5
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/userdata.inc.php /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

About kTitan

 
Comments (3) Trackbacks (0)
  1. that file does have windows newlines? interesting, it will be fixed for 0.9.4 so you don’t need to call dos2unix anymore when copying that file directly.
    you have used /srv/www instead of /var/www a few times, you might want to fix that 🙂
    additionally you copy from /var/www/syscp.old but never state that you copy syscp there for backup purposes (its quite obvious that you do anyway, but still 🙂 )

  2. Nice post. It’s nice to see another Froxlor and Gentoo guy on the internet. When we discovered Froxlor we went straight to it and did not mess with SysCP. Are you finding that the devs are better for Froxlor (which is what we have found)?


Leave a comment

Connect with Facebook


No trackbacks yet.