Personal tools

Kloxo Installation Guide

From LxCenter Wiki

Jump to: navigation, search

Kloxo Installing Guide

Prerequisites

  • A dedicated or virtual server running CentOS or Red Hat EL 5.x. CentOS 6.x is not currently supported.
  • At least 256 MB of RAM (enough to run Yum).
  • At least 2 GB of free disk space for Kloxo and related services.
  • If you partitioned your disks manually, make sure you have a large /tmp. Kloxo uses /tmp to create and store backups temporarily and the process 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 kloxo-installer.sh from download.lxcenter.org and executing it as root. The script will present you with a few questions and sometimes ask for a password (enter your root password).

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

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

To install as Master (Default Single Server):

# sh ./kloxo-installer.sh --type=master

To install as Slave:

# sh ./kloxo-installer.sh --type=slave

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

# su - root
# yum install -y wget
# wget http://download.lxcenter.org/download/kloxo/production/kloxo-installer.sh
# sh ./kloxo-installer.sh --type=<master/slave> --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 ask you to change the default password to a secure one.

Packages installed

The Following tables represend the packages installed initially for the kloxo hosting panel.

Web Services Function
apache (2.x) The Apache HTTP Server is a powerful, efficient, and extensible web server.
php (5.2.x) PHP is an HTML-embedded scripting language.
pure-ftpd Pure-FTPd is a fast, production-quality, secure and standard-comformant FTP server especially designed for modern Linux and FreeBSD kernels.
awstats Web Statistics
Mail Services Function
qmail-toaster qmail is a small, fast, secure replacement for the sendmail package, which is the program that actually receives, routes, and delivers electronic mail
courier-imap-toaster Courier-IMAP is an IMAP server for Maildir mailboxes.
vpopmail vpopmail is a collection of programs and a library to automate the creation and maintence of virtual domain email for qmail installations.
Roundcube Webmail (Ajax)
DNS Services Function
bind BIND (Berkeley Internet Name Domain) is an implementation of the DNS (Domain Name System) protocols.
courier-imap-toaster Courier-IMAP is an IMAP server for Maildir mailboxes.
bind-chroot Secures BIND server
Database Service Function
bind BIND (Berkeley Internet Name Domain) is an implementation of the DNS (Domain Name System) protocols.
mysql-server MySQL is a multi-user, multi-threaded SQL database server.

You are able to switch services after install at the web panel. Apache/Lighttpd; BIND/djbdns; spamassassin/bogofilter; etc.

Troubleshooting

If you cannot connect to you Kloxo Control Panel, please check if Kloxo is running and your server firewall is not blocking access to ports 7777/tcp and 7778/tcp. You may temporarily disable it by running /etc/init.d/iptables stop and if that is the cause you may be interested in the ((How to secure your Kloxo with IPTABLES|firewall script)) example contributed by Kloxo users.

If you still cannot access your panel, go to our forums at http://community.lxcenter.org and request help (you may want attach the file /root/kloxo-install/kloxo-linux/kloxo_install.log for easier troubleshooting).

Final Considerations

  1. Keep in mind that Kloxo will not manage your server firewall (iptables rules). For that, you may want to install third-party firewall management scripts such as CSF or APF and its complements to detect and block threats like brute-force attacks and unauthorized processes and users.
  2. If you are not familiar with the command line (shell), you might want to try Webmin for basic system administration tasks. It should not conflict with Kloxo as long as you avoid managing the services listed before with it.
  3. Kloxo will never update your OS (CentOS/Red Hat) automatically. It's up to you to monitor security bulletins for your Operating System and update as necessary.
  4. Kloxo will never update itself by default. You can set Auto-Update Kloxo within the GUI. The Auto update will run at the 10th day each month and you as "Admin" will be notified by email. To update manualy, click the Update home button from the web panel OR run on the shell (as root) /script/upcp. At the web panel, you are presented with release notes that describe what's changed in the newer versions so you can act at your own discretion.