Home

Kloxo Installation Guide

Prerequisites

1) A dedicated or virtual server (Xen/OpenVZ/Virtuozzo) running CentOS or Red Hat EL (versions 5.1+). At present, only 32bit versions of these operating systems are officially supported and development of a x86_64 compatible Kloxo is in progress.
2) At least 256 MB of RAM (total). Once installed, Kloxo can be tweaked to use as little as 33 MB of RAM (total - including the panel, web, mail, dns, db and OS services). Special attention must be given if your server have no swap (usually the case of OpenVZ VMs).
3) At least 2 GB of free disk space for Kloxo and related services.
4) If you partitioned your disks manually, make sure you have a large /tmp. Kloxo uses /tmp to create and store backups temporarily and it will fail if there is not enough space.

Before we begin...


You have to disable SELinux by editing /etc/sysconfig/selinux and changing the line to selinux=disabled. This will keep SELinux from being enabled on your server next boot.

Then you must run the following command as root to disable SELinux for the current session:

# su - root
# setenforce 0


If you are unsure this procedure worked, you can run /usr/sbin/sestatus to check its status. Failure to correctly disable SELinux will render your Kloxo install useless and an OS reload may be required to properly reinstall it.
Also, make sure the ports 7778/tcp and 7777/tcp are open in your server firewall or you won't be able to connect to Kloxo web panel when the install completes.

Installing Kloxo


Kloxo installation consists of downloading either kloxo-install-master.sh or kloxo-install-slave.sh from download.lxlabs.com and executing them as root. They will download all the required files and install them for you. In case you are presented with a question/menu from yum/up2date, you may press .


If you don't have MySQL server already installed, you must run:

# su - root
# wget http://download.lxcenter.org/download/kloxo/production/kloxo-install-master.sh
# sh ./kloxo-install-master.sh


If you already have MySQL installed and set a root password, you must run:

# su - root
# wget http://download.lxcenter.org/download/kloxo/production/kloxo-install-master.sh
# sh ./kloxo-install-master.sh --db-rootpassword=PASSWORD


Once kloxo is installed, you can connect to http://YOUR_SERVER_IP:7778 and you will be presented with a login screen. Login as admin with password admin and once you are in, Kloxo will explicitly force you to change the password to a secure one.

Home page: www.lxcenter.org