slackbuilds_ponce/network/cherokee/README
Matteo Bernardini a51e47323f network/cherokee: Updated for version 1.2.101.
Also forced /var/log/cherokee and run with a dedicated user,
various cleanups and additions to the README.

Signed-off-by: Matteo Bernardini <ponce@slackbuilds.org>
2012-09-08 17:27:21 -05:00

63 lines
2.7 KiB
Text

Cherokee is a very fast, flexible and easy to configure Web Server
written by Alvaro Lopez Ortega <alvaro@alobbs.com>.
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.
If you are installing a high load http server, you will probably need
a zero-downtime process of log rotation. To achieve this, I strongly
recommend you to take a look to this cookbook:
* http://www.cherokee-project.com/doc/cookbook_managing_logs.html
If need to get popular web applications working or fine tune your
server, follow the cherokee's cookbooks page:
* http://www.cherokee-project.com/doc/cookbook.html
ffmpeg is an optional dependency (for video streaming - BROKEN ATM).
Notes about using this SlackBuild
---------------------------------
1) To specify the WWW root directory pass WWWROOT=/path/to/www/root
to the script, like this:
WWWROOT=/var/www/htdocs-cherokee ./cherokee.SlackBuild
2) If you want to enable IPv6 support, pass IPV6=yes to the script.
3) If you want to disable the Cherokee-admin installation, pass
ADMIN=no to the script.
4) This script builds Cherokee with support for MySQL client library
by default. If you want to avoid the dependency on MySQL client
library, or just build Cherokee without this support, pass MYSQL=no
to the script.
5) If you want to build Cherokee with debugging options, enable trace
facility by passing TRACE=yes to the script.
6) The $WWWGROUP group and the $WWWUSER user account are set to cherokee.
To run cherokee as a different user/group specify them passing the
options WWWUSER/WWWGROUP to the slackbuild, like
WWWUSER=cherokee WWWGROUP=cherokee ./cherokee.SlackBuild
You want to create first a dedicated user/group.
groupadd -g 299 cherokee
useradd -u 299 -g cherokee -d /var/www/htdocs-cherokee cherokee
See http://slackbuilds.org/uid_gid.txt for current reccomendations (if any)
7) If you want to use it with php, remember to add your user to the
apache group, so that it can use /var/lib/php, like
gpasswd -a cherokee apache
Comments, suggestions or bug reports
------------------------------------
If you have anything to say about this SlackBuild, even reporting a
bug, don't hesitate to contact me at pablosaro@gmail.com
(be aware that pablo might not know that I wrecked his build
script for 1.2.101, ndponce <matteo.bernardini@gmail.com>)