THIS IS A DISCUSSION DOCUMENT AND IS NOT IMPLEMENTED YET - IT WON'T WORK TODAY

There may be times that you wish to influence the building and testing carried out on your change. You might for example be fixing an issue that affects a particular distribution or combination of distributions, for this reason you can change the tests carried out by indicating in the commit message the changes you require.

To do this place the following comments with name value pairs in your commit message

Test-parameters: n=v x=y

To cater for multiple requirements we might allow for lists of requirements, which is entry being a separate test.

Test-parameters: x=y c=e
Test-parameters: e=z r=e

The values today with permissible Test-parameters: entries are;

Name

Description

Valid Values

ostcount

Number of OSTs to test against

1..10

clientprofile

Cobbler profile to use for clients

test

serverprofile

Cobbler profile to use for clients

test

clientdistro

Distribution to use for clients

el5, el6, sl11, ub10

serverdistro

Distribution to use for clients

el5, el6, sl11

clientarch

Architecture to use for clients

i686, x86_64, ppc

serverarch

Architecture to use for servers

i686, x86_64

nettype

Network type to use

tcp, o2ib

clientcount

Number of clients to use

2-4

no_virtualization

Set True if testing must not be virtualized

true

testgroup

Test group to test with

review, regression, quick, full

tests

Comma separated list of test names to run in place of a standard test group

sanity,conf_sanity,mmp etc

You do not need to specify all the values only those values important for your requirements, the test system will use your request to alter a regular test. Also to ensure that you all reviews are fully tested to a known standard. The test system will run a regular, unmodified test set as well as the special request.

Here is an example:

LU-1234 recovery: handle swabbing during recover

Handle byte swabbing of requests properly during recovery.  There were
problems with the handling of replayed creates that sent the requests
with client-endian order but a little-endian LOV EA.

Test-parameters: clientdistro=el5 clientarch=ppc serverarch=x86_64 ostcount=10 nettype=tcp tests=conf-sanity,replay-single
Test-parameters: clientdistro=sl11 serverdistro=rh6 clientarch=ppc serverarch=x86_64 nettype=o2ib tests=conf-sanity,replay-single

Signed-off-by: Random J Developer <random@developer.example.org>
Change-Id: Ica9ed1612eab0c4673dee088f8b441d806c64932