The Hardware Test Executive (HTX) is a suite of test tools for hardware validation of OpenPOWER system.
The HTX stress tests the system by exercising all or selected hardware components concurrently to uncover any hardware design flaws and hardware-hardware or hardware-software interaction issues.
The HTX consists of test programs (a.k.a exercisers) to test processor, memory and IO subsystem of POWER system.
The HTX runs on PowerKVM guests (Linux distributions like Ubuntu, SuSE and Redhat), and OPAL-based distributions (like Ubuntu) and on Linux host machine. HTX supports two types of control interfaces to exercisers, user interactive and command line.
Building HTX from source tree
Download the source from github.
Edit htx.mk file to point
TOPDIR to downloaded HTX source.
HTX_RELEASE variable to appropriate distro for which you are
building HTX source for. Possible values are:
- install git to download source code
apt-get install git
- download HTX source code
git clone https://www.github.com/open-power/HTX
- install other packages needed to compile HTX
apt-get install gcc make libncurses5 g++ libdapl-dev libcxl1
3.1 for Ubuntu 14.04 there is no libdapl-dev package, so have to download and compile dapl separately from https://www.openfabrics.org/downloads/dapl/
3.2 install following packages needed to compile dapl
apt-get install libibverbs-dev librdmacm-dev
3.3 cd into dapl directory and "./configure" "make" and then "make install"
- For libcxl dependency, try following:
4.1 apt-get install libcxl1.
4.2 If unable to install, download libcxl source from "https://github.com/ibm-capi/libcxl"
compile and place libcxl1.so under /usr/lib (for ubuntu) or under /lib64/power8/ (for RHEL7 LE)
- back in HTX directory do a "make all" to compile
5.1 After compiling to create debian package do "make deb" which will create a htxubuntu.deb package in top level dir.
5.2 To create HTX tarball with installer, do "make tar". HTX tarball by name "htx_package.tar.gz" will be created in top dir.
Note that HTX assumes you are building on a PowerPC distribution.
- To clean: make clean
Please refer HTX Users manual at
Apache License, Version 2.0. For full details see LICENSE.
If you want to add your own test program as part of HTX. Please refer HTX
Programmer's manual at