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 Build-parameters: a=b
You can place more than one name value pair on a line separated by spaces (e.g. a=b f=g). For lists of values, separate them with a comma (e.g. n=x,y,x). To cater for multiple requirements we might allow for lists of requirements, which is entry being a separate test.
Test-parameters: x=y,z c=e Test-parameters: e=z r=e Build-parameters: a=b f=g
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 |
The valid values for Build-parameters:
entries are:
Name |
Description |
Valid Values |
---|---|---|
clientdistro |
Distribution to build for clients |
none, el5, el6, sl11, ub10 |
serverdistro |
Distribution to build for servers |
none, el5, el6, sl11 |
clientarch |
Architecture to use for clients |
none, i686, x86_64, ppc |
serverarch |
Architecture to use for clients |
none, i686, x86_64 |
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. Specifying a Build-parameters:
arch or distro of none
means that the client or server will not be built, equivalent to --disable-client
or --disable-server
configure params.
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. Build-parameters: clientdistro=el5,sl11 clientarch=ppc serverdistro=rh6 serverarch=x86_64 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