Date: Fri Mar 9 04:38:27 2007
New Revision: 6305
Mentioned difference between pid files in doc.
--- Webware/trunk/WebKit/Docs/InstallGuide.txt (original)
+++ Webware/trunk/WebKit/Docs/InstallGuide.txt Fri Mar 9 04:38:27 2007
@@ -1014,10 +1014,6 @@
WEBWARE_USER the user to run the application server
-Note that the pid file records the pid of the Python application server, not
-the pid of the wrapper script ``AppServer`` which is responsible for the
For security reasons, you shouldn't use ``root`` as the Webware user, but
a user with the least possible permissions, maybe even ``nobody``. By
default, the start script uses the owner of the ``AppServer`` script.
@@ -1039,6 +1035,12 @@
to the working directory, so you have to unset ``LAUNCH_AS_WEBWARE`` if you
want to use the standard system locations for the files instead.
+Note that the application server maintains its own pid file, usually called
+``appserverpid.txt``. You should use a different pid file for the start script,
+although it actually records the same pid, i.e. the pid of Webware's Python
+application server, not the pid of the wrapper script ``AppServer` which is
+responsible for the AutoReload mechanism.
The start script also passes the variable ``PYTHONOPTS`` to the ``AppServer``
script. You can add options ``-U`` for unbuffered output (to the log file)
or ``-O`` if you want to use optimized Python files (i.e. ``.pyo`` instead