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/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 control files to notice new 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).