?TableOfContents(2)
general info
piuparts runs on piuparts.cs.helsinki.fi aka piatti.debian.org and just like lintian and linda should be run on every developer machine before uploading
piuparts logs (currently outdated) are available at [http://piatti.debian.org http://piatti.debian.org]
#debian-qa is the irc-channel to coordinate work on irc, piuparts-devel is the project name on alioth.
how to run piuparts on piatti
the piuparts stuff is partly in the piupartsm account (master end, including debmirroring), and partly in the piuartss account (the slave, which actually runs piuparts)
run piuparts-slave.py as piupartss and watch it run via screen. the slave starts the master when it needs it, you don't need to start it manually
also read http://liw.iki.fi/liw/debian/piuparts-logfile-processing-howto
If you want to help, please don't bother liw, h01ger has access too and you should bother him.
... to be continued! ...
machine info
hosted at [http://cs.helsinki.fi/index.en.html Department of Computer Science, University of Helsinki]
donated by [http://hp.com/go/debian/ HP]
- dual AMD Opteron(tm) Processor 275, 2.2 Ghz
- 4GB RAM
- 465 GB physical volume for data
- 50 GB for /home for piatti
- 90 GB for mirror
- 10 GB for xenu1 (testdomain)
4 GB and 128 MB swap for test.my.piuparts (testdomain2
- X GB piuparts slave
- Y GB developer test environtments
- planned: 50 GB for svn-buildstat
- 2 IPs
troubleshouting/maintainance
Sometimes the chroot tarballs in /home/piupartss/ need to be removed, currently there are sid.tar.gz and sarge.tar.gz
see /etc/piuparts/piuparts-slave.conf
developing piuparts
- alioth project
http://wiki.debian.org/SummerOfCode2007/PiupartsImprovements
todo
machine related
install xen-shell & tools
- put all scripts and configs into svn
- set up xenu domains with fai
- use the same documentation for fai as for debian-community
- IMO every member of the piuparts alioth group should have the right to commit configuration for the XENU domains (no extra repo/access control)
- only a few people can commit that config to a machine (sudoers)
- root access for XENU domains for DDs and non-DDs (like goneri if needed, or other qa members), via debian ud-ldap (for DDs) or local accounts (for non-DDs)
- discuss this with DSA
- XENU domain for svn-buildstat (min 30gb hd space, he'll get 50)
[http://wiki.debian.org/svnbuildstat#head-9e8eb0f99ba9ff07787c9168839f52553909b6bd setup howto for svnbuildstat]
- goneri (non-DD) needs ssh access and be able to restart Apache and to 'su' to the postgres user
- mirror proposed updates and security updates too
- run two piuparts slaves to make use of the two cpus
finish aide configuration - http://wiki.debian.org/Teams/DSA/MachineSetup (but: <buxy> h01ger: AFAIK, aide is not consistently used (and is known to break on merkel currently), so you can probably skip that part for now)
- drop Joey a note so that all users are replicated via ldap
backup /etc and /org via http://wiki.debian.org/Teams/DSA/DaBackup
- also use the machine to run svnbuildstat.debian.net
- also use the machine to run vlosuts
done:
- apt-get install debian.org aide nagios-nrpe-server lvm2
- apt-get install -t etch-backports xen-shell xen-tools
codebase related
- split /fails/ into more directories
<liw> (at some point) you may want to run the bin/mirror-debian script as user piupartsm
- look at the irssi_away script to see how to monitor screen sessions, to notify when piuparts is hanging
piuparts and pts integration suggestion
In order for the PTS to be able to display piuparts testing status for a package, and link to its log file, Piuparts could generate a set of static files that will be visible via http:
%s = source package name %v = source package version %p = piuparts version /source/%s -> index page /source/%s/%v -> a particular log /source/%s/latest -> log for latest version /source/%s/piuparts-%p/%v -> a particular log from a version of piuparts similar for /binary-$ARCH/ /%s -> /source/%s For PTS integration: one file with results for all source packages: /results-per-source.txt %s pass $MATCHINGLOG %s fail $MATCHINGLOG
documentation
split this wiki page into subpages, so that the piuparts documentation can be mainained in the wiki, by exporting as docbook.
suggested structure:
- /piuparts - index page, just a table of contents
- /piuparts/about - what is piuparts
- /piuparts/devel - information how to participate in piuparts development
- /piuparts/doc/software - piuparts documentation
- /piuparts/doc/piatti - documenation about piuparts.cs.helsinki.fi
- /piuparts/todo - todo list