Kloxo SVN Install

ATTENTION: This is for development and testing purposes. Do NOT use SVN code in production servers. If you encounter a bug, report it in the Development forums and not in the bug-tracker.


Before anything, you must install Kloxo manually or use a "Host-in-a-box" OS template. This is necessary to create the initial databases, init scripts, kloxo scripts and install required services among other things. Also note ALL shell commands hereon must be run as root unless stated otherwise.

Make sure Kloxo installed correctly, change the admin password and stop the service:

# su - root
# /script/resetpassword master your_new_admin_password
# /etc/init.d/kloxo stop

Next, we must install a few things to be able to compile the back-end and grab Kloxo source from the Subversion repository:

# yum groupinstall 'Development Tools'
# yum install openssl-devel sudo
# rpm -Uhv http://rpmforge.sw.be/redhat/el5/en/i386/extras/RPMS/subversion-1.6.15-0.1.el5.rfx.i386.rpm

Rename /usr/local/lxlabs/kloxo to something else:

# cd /usr/local/lxlabs
# mv kloxo kloxo.bck

Next, download the svn code as user lxlabs:

# sudo -H -u lxlabs svn checkout http://svn.lxcenter.org/svn/kloxo/trunk/kloxo

Overwrite your admin password hash from your old Kloxo install:

# cp kloxo.bck/etc/conf/kloxo.pass kloxo/etc/conf/kloxo.pass

Create some log and pid that Kloxo presently can not.

# sudo -H -u lxlabs mkdir kloxo/log
# cd kloxo/log
# sudo -H -u lxlabs touch `ls -x /usr/local/lxlabs/kloxo.bck/log`
# sudo -H -u lxlabs mkdir ../pid
# cd ../pid
# sudo -H -u lxlabs touch `ls -x /usr/local/lxlabs/kloxo.bck/pid`

# cd ../src
# make

You may now start Kloxo, fresh from SVN:

# /etc/init.d/kloxo start

If you only wish to test, the debug messages can be really annoying and actually prevent you from doing some things.

Fortunately, you can disable it:

# echo -1 > /usr/local/lxlabs/kloxo/httpdocs/commands.php
# /etc/init.d/kloxo restart

To enable debug info again, change the value back to "2".

Also note Kloxo presents itself as "hostname Kloxo Single Server Development VERSION Stable". To switch to "Production" mode, you must remove .svn folders recursively:

# cd /usr/local/lxlabs
# rm -rf 'find . -type d -name .svn'

Another tip is to change the version number contained in /usr/local/lxlabs/kloxo/httpdocs/lib/sgbl.php to something higher and prevent the Kloxo code from being overwritten if you update the panel.

• Español

A script of the above commands, that can be used to install the newest kloxo just before it is released, mainly to test it and report last minute bugs.

---