git clone https://github.com/intel/lkp-tests.git
cd lkp-tests
make install
lkp help
# browse and select a job you want to run, for example, jobs/hackbench.yaml
ls lkp-tests/jobs
# install the common dependencies for lkp
# Note: lkp doesn't support ruby >= 3.0, default ruby version should be 2.x
lkp install
lkp split-job lkp-tests/jobs/hackbench.yaml
# output is:
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-process-1600%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-process-1600%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-threads-1600%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-threads-1600%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-process-100%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-process-100%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-threads-100%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-threads-100%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-process-50%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-process-50%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-pipe-8-threads-50%.yaml
# lkp-tests/jobs/hackbench.yaml => ./hackbench-socket-8-threads-50%.yaml
# install the remaining dependencies for the splited job
lkp install ./hackbench-socket-8-threads-50%.yaml
# or add -f option to force to install all dependencies
lkp install -f ./hackbench-socket-8-threads-50%.yaml
lkp run ./hackbench-socket-8-threads-50%.yaml
Specify disk partitions by defining hdd_partitions/sdd_partitions in host file named with local hostname and then lkp split-job will write the disk partitions information to split job file automatically.
Please note that disk partitions may be formatted/corrupted to run job.
echo "hdd_partitions: /dev/sda /dev/sdb" >> lkp-tests/hosts/$(hostname | sed -r 's/-[0-9]+$//g' | sed -r 's/-[0-9]+-/-/g')
lkp split-job lkp-tests/jobs/blogbench.yaml
# output is:
# lkp-tests/jobs/blogbench.yaml => ./blogbench-1HDD-ext4.yaml
# lkp-tests/jobs/blogbench.yaml => ./blogbench-1HDD-xfs.yaml
# ...
lkp install ./blogbench-1HDD-ext4.yaml
lkp run ./blogbench-1HDD-ext4.yaml
To run your own benchmarks that are not part of lkp-tests, you can use mytest job.
lkp split-job lkp-tests/jobs/mytest.yaml
# output is:
# jobs/mytest.yaml => ./mytest-defaults.yaml
lkp run ./mytest-defaults.yaml -- <command> <argument> ...
lkp result hackbench
# create new scripts or rename hidden template scripts in the directory
echo "echo result_root: \$RESULT_ROOT" > post-run/print-result-root
lkp run ./ebizzy-10s-1x-200%.yaml
# output is:
# ...
# result_root: /lkp/result/ebizzy/10s-1x-200%/shao2-debian/debian/defconfig/gcc-6/5.7.0-2-amd64/1
Most test cases should install/run well in
- Debian sid
- Archlinux
- CentOS7
There is however some initial support for:
- OpenSUSE:
- jobs/trinity.yaml
- Fedora
- Clear Linux(>=22640)
As for now, lkp-tests still needs to run as root.
If you want to add support for your Linux distribution you will need an installer file which allows us to install dependencies per job. For examples look at: distro/installer/* files.
Since packages can have different names we provide an adaptation mapping for a base Ubuntu package (since development started with that) to your own distribution package name, for example adaptation files see: distro/adaptation/*. For now adaptation files must have the architecture dependent packages (ie, that ends with the postfix :i386) towards the end of the adaptation file.
You will also want to add a case for your distribution on sync_distro_sources() on the file lib/install.sh.
Refer to https://github.com/intel/lkp-tests/wiki
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request