~bzr-pqm/bzr/bzr.dev

Running tests in parallel

-------------------------

 

Bazaar can use subunit to spawn multiple test processes.  There is

slightly more chance you will hit ordering or timing-dependent bugs but

it's much faster::

 

  $ ./bzr selftest --parallel=fork

 

Note that you will need the Subunit library

<https://launchpad.net/subunit/> to use this, which is in

``python-subunit`` on Ubuntu.

 

 

Running tests from a ramdisk

----------------------------

 

The tests create and delete a lot of temporary files.  In some cases you

can make the test suite run much faster by running it on a ramdisk.  For

example::

 

  $ sudo mkdir /ram

  $ sudo mount -t tmpfs none /ram

  $ TMPDIR=/ram ./bzr selftest ...

 

You could also change ``/tmp`` in ``/etc/fstab`` to have type ``tmpfs``,

if you don't mind possibly losing other files in there when the machine

restarts.  Add this line (if there is none for ``/tmp`` already)::

 

  none           /tmp            tmpfs  defaults        0       0

 

With a 6-core machine and ``--parallel=fork`` using a tmpfs doubles the

test execution speed.

 

 

 

Manual testing

==============

 

Generally we prefer automated testing but sometimes a manual test is the

right thing, especially for performance tests that want to measure elapsed

time rather than effort.

 

Simulating slow networks

------------------------

 

To get realistically slow network performance for manually measuring

performance, we can simulate 500ms latency (thus 1000ms round trips)::

 

  $ sudo tc qdisc add dev lo root netem delay 500ms

 

Normal system behaviour is restored with ::

 

  $ sudo tc qdisc del dev lo root

 

A more precise version that only filters traffic to port 4155 is::

 

    tc qdisc add dev lo root handle 1: prio

    tc qdisc add dev lo parent 1:3 handle 30: netem delay 500ms 

    tc qdisc add dev lo parent 30:1 handle 40: prio

    tc filter add dev lo protocol ip parent 1:0 prio 3 u32 match ip dport 4155 0xffff flowid 1:3 handle 800::800

    tc filter add dev lo protocol ip parent 1:0 prio 3 u32 match ip sport 4155 0xffff flowid 1:3 handle 800::801

 

and to remove this::

 

    tc filter del dev lo protocol ip parent 1: pref 3 u32

    tc qdisc del dev lo root handle 1:

 

You can use similar code to add additional delay to a real network

interface, perhaps only when talking to a particular server or pointing at

a VM.  For more information see <http://lartc.org/>.