cherokee at cherokee-project
Oct 14, 2009, 5:16 AM
Post #1 of 1
(76 views)
Permalink
|
|
[3703] cherokee/trunk/doc: Contribution documenting some errors
|
|
Revision: 3703
http://svn.cherokee-project.com/changeset/3703
Author: taher
Date: 2009-10-14 14:16:40 +0200 (Wed, 14 Oct 2009)
Log Message:
-----------
Contribution documenting some errors
Modified Paths:
--------------
cherokee/trunk/doc/Makefile.am
cherokee/trunk/doc/index.txt
cherokee/trunk/doc/other.txt
Added Paths:
-----------
cherokee/trunk/doc/other_errors.txt
Modified: cherokee/trunk/doc/Makefile.am
===================================================================
--- cherokee/trunk/doc/Makefile.am 2009-10-14 02:06:56 UTC (rev 3702)
+++ cherokee/trunk/doc/Makefile.am 2009-10-14 12:16:40 UTC (rev 3703)
@@ -110,6 +110,7 @@
other_goodies.html \
other_signals.html \
other_community.html \
+other_errors.html \
dev.html \
dev_debug.html \
dev_cherokee.conf.html \
Modified: cherokee/trunk/doc/index.txt
===================================================================
--- cherokee/trunk/doc/index.txt 2009-10-14 02:06:56 UTC (rev 3702)
+++ cherokee/trunk/doc/index.txt 2009-10-14 12:16:40 UTC (rev 3703)
@@ -124,6 +124,7 @@
. link:other_goodies.html[Cherokee Goodies]: Interesting Cherokee features.
. link:other_signals.html[Signals]: Signals supported by Cherokee.
. link:other_community.html[Community]: More information sources.
+ . link:other_errors.html[Common errors]: Some typical production errors and their cause.
*********************************
link:dev.html[Development info]: Things of interest to developers
Modified: cherokee/trunk/doc/other.txt
===================================================================
--- cherokee/trunk/doc/other.txt 2009-10-14 02:06:56 UTC (rev 3702)
+++ cherokee/trunk/doc/other.txt 2009-10-14 12:16:40 UTC (rev 3703)
@@ -4,3 +4,4 @@
. link:other_goodies.html[Cherokee Goodies]: Interesting Cherokee features.
. link:other_signals.html[Signals]: Signals supported by Cherokee.
. link:other_community.html[Community]: More information sources.
+ . link:other_errors.html[Common errors]: Some typical production errors and their cause.
Added: cherokee/trunk/doc/other_errors.txt
===================================================================
--- cherokee/trunk/doc/other_errors.txt (rev 0)
+++ cherokee/trunk/doc/other_errors.txt 2009-10-14 12:16:40 UTC (rev 3703)
@@ -0,0 +1,53 @@
+== link:index.html[Index] -> link:other.html[Other information]
+///////////////////////////////////////////////////////////////////
+Last checked:
+* Cherokee 0.99.25
+
+This document will be obsoleted as soon as the new error reporting
+system is put in place.
+///////////////////////////////////////////////////////////////////
+
+Most common production server errors with Cherokee
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- *Page 500*
+
+ The most common cause of an Internal Server Error within Cherokee is
+ problem of invalid headers. If your cgi script for some reason does
+ not send out a headerless (eq. Content-type: text/html) streams, you
+ will hit this bug. Check scripts, error log etc. to find out what
+ causes it.
+
+- *Page 503*
+
+ When an information source is unavailable, the server will return a
+ 503 for that request. Cherokee will constantly try to find a new
+ information sources, but it will take (as most) the total amount of
+ defined sources in request to find back a working information
+ source. If a 503 stays present, you can safely assume Cherokee is
+ unable to start an interpreter or connect to the remote host that
+ has the information source defined.
+
+- *CLI*: Can't bind() socket (port=80, UID=1000, GID=1000)
+
+ Most likely Cherokee is unable to start because you are not
+ root. And you want to bind the webserver to a privileged port (80).
+
+- *CLI*: Can't bind() socket (port=80, UID=0, GID=0)
+
+ When you are root and get this message. There is a running Cherokee
+ instance. The most efficient way to get rid of it:
++
+----
+ killall -s KILL cherokee
+ killall -s KILL cherokee-worker
+----
+
+Restarting
+~~~~~~~~~~
+
+- If you just want to restart the webserver, this will do:
++
+----
+ killall -s HUP cherokee
+----
|
