wiki:StartTool

Version 4 (modified by davea, 9 years ago) (diff)

--

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