wiki:StartTool

Version 3 (modified by Nicolas, 15 years ago) (diff)

Improve reread_db docs.

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