Cherokee is a very fast, flexible and easy to configure Web Server. It supports the widespread technologies nowadays: FastCGI, SCGI, PHP, CGI, SSI, TLS and SSL encrypted connections, Virtual hosts, Authentication, on the fly encoding, Load Balancing, Apache compatible log files, Data Base Balancing, Reverse HTTP Proxy, Traffic Shaper, Video Streaming and much more.
A user friendly interface called cherokee-admin is provided for a no-hassle configuration of the server. Check out the benchmarks and documentation to learn more, and give it a try to squeeze your hardware to the fullest!
In this tutorial we will show you how to install Cherokee Web server in CentOS/Fedora/Redhat.
I – Install cherokee
To install and start Cherokee in Fedora/centos or Fedora based distro, under a root terminal type :
yum install cherokee
chkconfig cherokee on
/etc/init.d/cherokee start
open browser and type: http//:ip or http://localhost
How to access the cherokee admin panel :
under a root terminal type:
# cherokee-admin -b
Login:
User: admin
One-time Password: FEPeJXBMj4sygJ3e
Web Interface:
URL: http://localhost:9090/
Cherokee Web Server 0.99.17 (Jun 14 2009): Listening on port ALL:9090, TLS disabled, IPv6 disabled, using epoll, 1024 fds system limit, max. 505 connections, caching I/O, single thread
Open your browser to http://localhost:9090/
with username: admin and password FEPeJXBMj4sygJ3e
The WWW root directory is /var/www/cherokee.
—————————————————————-
To install cherokee webserver from source on Centos (on a fresh install)
.:: install dependencies ::.
yum install wget gcc gcc-c++ libtool bind mysql-server mysql-devel php-mysql
.:: download cherokee package ::.
mkdir download
cd download
wget http://www.cherokee-project.com/cherokee-latest-tarball
tar -xzvf cherokee-0.99.35.tar.gz
(the version will change over time so make note of the version you use when untarring and cd’ing to the directory)
.:: compiling and install cherokee ::.
cd cherokee-0.99.35
./configure --localstatedir=/var --prefix=/usr --sysconfdir=/etc --with-wwwroot=/var/www
make && make install
.:: configure cherokee ::.
You can start cherokee web server daemon with cherokee command line.
cherokee &
and stop this daemon with command killall cherokee
killall cherokee
If you want start and stop the cherokee web server daemon with cherokee script, you can accomplish this under the /etc/ init.d/ directory.
You can use this script to start and stop cherokee web server daemon.
vi /etc/init.d/cherokee
If the file is not there, vi/m will create it.
#!/bin/sh
#
# Contrib to RedHat Fedora Based Systems by: [EMAIL PROTECTED]
# chkconfig: 2345 95 05
# description: Starts and stops the Cherokee ligth Web Server system
#
# Source function library
. /etc/rc.d/init.d/functions
NAME=cherokee
BASE=/usr/sbin/$NAME
DAEMON="-d"
CONF="/etc/cherokee/cherokee.conf"
PIDFILE="/var/run/$NAME.pid"
# Check that $BASE exists.
[ -f $BASE ] || exit 0
# Source networking configuration.
. /etc/sysconfig/network
# Check that networking is up.
[ ${NETWORKING} = "no" ] && exit 0
RETVAL=0
# See how we were called.
case "$1" in
start)
if [ -n "`/sbin/pidof $NAME`" ]; then
echo -n $"$NAME: already running"
echo ""
exit $RETVAL
fi
echo -n "Starting Cherokee service: "
$BASE -C $CONF $DAEMON pidfile $PIDFILE
sleep 1
action "" /sbin/pidof $NAME
RETVAL=$?
[ $RETVAL -eq 0 ] && touch /var/lock/subsys/cherokee
;;
stop)
echo -n "Shutting down Cherokee service: "
killproc $BASE
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/cherokee
;;
restart|reload)
$0 stop
$0 start
RETVAL=$?
;;
status)
status $BASE
RETVAL=$?
;;
*)
echo "Usage: $NAME {start|stop|restart|reload|status}"
exit 1
esac
exit $RETVAL
save the file using ” :wq ”
chmod 755 /etc/init.d/cherokee
.:: start and stop cherokee daemon ::.
/etc/init.d/cheroke start
/etc/init.d/cheroke stop
.:: cherokee admin daemon ::.
The cherokee-admin daemon used for configure and manage cherokee web server can be found using this daemon service (zeus-admin) over port 9090.
To start this service you can do (localhost only) :
cherokee-admin
Login:
User: admin
One-time Password: bmS5wq3DibxdPpPP
Web Interface:
URL: http://127.0.0.1:9090/
Cherokee Web Server 0.99.15 (Jun 10 2009): Listening on port ALL:9090, TLS disabled, IPv6 disabled, using epoll, 1024 fds system limit, max. 505 connections, caching I/O, single thread
or you can do this for all of the interfaces on your box :
cherokee-admin -b
Login:
User: admin
One-time Password: FppPAKbumPbtAwWq
Web Interface:
URL: http://localhost:9090/
Cherokee Web Server 0.99.15 (Jun 10 2009): Listening on port ALL:9090, TLS disabled, IPv6 disabled, using epoll, 1024 fds system limit, max. 505 connections, caching I/O, single thread
password cherokee-admin changed after you start this daemon.
.:: testing ::.
You can access cherokee interface, via your web browser on url:
http://yourdomain.tld
for the web based cherokee-admin interface for your webserver you can access on url:
http://yourdomain.tld:9090