StartTool

Project control scripts

The following Python scripts control a project:

bin/start :: Start the project: start all daemons, and remove the stop_sched and stop_daemon files (see below). bin/stop:: Stop the project (create the stop_sched and stop_daemon files) bin/start --cron:: If the project is started, perform all periodic tasks that are past due, and start any daemons that aren't running. Otherwise do nothing. bin/status:: Show whether the project is stopped. Show the status of all daemons. Show the status of all periodic tasks (e.g., when they were last executed).

Trigger files

The following files (in the project root directory) can be used to turn off various parts of a project.

stop_sched :: Have the scheduler return 'project down' messages. stop_daemons:: Tell all daemon process to exit. stop_web:: Have the web site return 'project down' messages for all functions that require database access. stop_upload:: Have the file upload handler return transient error messages to clients (they'll back off and retry later). reread_db:: Have the feeder reread the database to notice new applications, app versions, or changes to how work is assigned.

The presence of a file triggers the function. For example, to turn off data-driven web pages, type

touch stop_web

and to turn them back on, type

rm stop_web

If the first three files are all present, no database access will occur. You should do this during most maintenance functions (such as upgrading software).