StartTool

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