= Project control =

== 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/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).
 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/start --cron-tasks::
        Like --cron but doesn't start daemons.

== 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).