Rendering of reStructured text is not possible, please install Docutils.

(a copy of MAINTAIN.txt from lp:~linaro-toolchain-dev/cbuild/tools)

cbuild maintenance tasks
========================

Users
-----
 * cbuild - pulls keys from http://launchpad.net/~cbuild

Things to watch
---------------

Disks:

 * / for free space
 * /space for free space

`~/var/snapshots/gcc-4.8?svn*`:

 * Youngest is no more than 3 days old
 * Check cbuild-tools/launcher.sh on fault

`~/var/tcwg-web/*.pickle`:

 * No more than four hours old
 * Check lib/tcwg-web/update.sh on fault

Common tasks
------------

Where have all my directories gone?

 * ~/lib/cbuild
 * ~/var/snapshots
 * ~/public_html/build

How do I spawn a release build via the shell?

 * Use gcc-release-process.sh! else:
 * scp gcc-linaro-4.7-2012.12.tar.bz2 cbuild@toolchain64.lab:~/var/snapshots
 * ssh cbuild@toolchain64.lab
 * ~/lib/cbuild-tools/spawn.sh ~/var/snapshots/gcc-linaro-4.7-2012.tar.bz2

A fault with frequent tasks like merge reqeusts, tip builds or data
being out of date?

 * Check ~/lib/cbuild-tools/cron-often.sh

A fault with daily tasks like upstream builds?

 * Check ~/lib/cbuild-tools/launcher.sh

A fault with one of the helpers?

 * sudo service tcwg-web stop
 * cd lib/tcwg-web
 * Uncommet 'development = True' in twg-web.ini
 * python index.py
 * Run the request, see the backtrace

Version out of date on one of the upstream builds?

 * Edit launcher.sh

Want to build/track a new upstream?

 * git clone upstream-url  ~/repos/decent-name
 * Add a new dow line to launcher.sh

Want to track a new Linaro series?

 * cd ~/repos/gcc-linaro
 * bzr branch lp:gcc-linaro/4.8
 * Add a new line to cron-often.sh
 * Consider pushing a new gcc-linaro-4.8+bzr12345.{tar,tar.xz} to ~/var/snapshots/base

Want to propogate a cbuild update to the slaves?

 * cd ~/lib/cbuild
 * bzr pull

Want to add a new build queue?

 * cd ~/var/scheduler/queue
 * mkdir queue-name
 * echo host1 host2 host3 > queue-name/hosts.txt
 * echo config-fragments-if-any > queue-name/template.txt
 * cd ../spawn/default
 * ln -s ../../queue/queue-name

Want to delete a job from the queue?

 * cd ~/var/scheduler/queue
 * `rm */job-name.job`

WorkingGroups/ToolChain/CBuild/Maintenance (last modified 2012-12-02 22:50:34)