No description, website, or topics provided.
C C++ Shell Perl Assembly Lua Other
Clone or download
Latest commit fd27c37 Jul 19, 2018
Permalink
Failed to load latest commit information.
Documentation Tarball support for HTX installation on linux distros is added Apr 26, 2017
bin sctu overflow workaround Jul 19, 2018
cleanup Make all makefiles and config less executable Apr 6, 2016
equaliser_cfgs equaliser enhancement Feb 8, 2017
etc Merge pull request #135 from open-power/cmvc_code_merge_htxd Jul 18, 2018
inc Merge pull request #127 from open-power/vp_git Jul 18, 2018
lib Merge pull request #127 from open-power/vp_git Jul 18, 2018
mdt Make all makefiles and config less executable Apr 6, 2016
packaging HTX tarball installer script is overwritting .bash_profile contents i… Jul 24, 2017
pattern Make all makefiles and config less executable Apr 6, 2016
rules Merge pull request #132 from open-power/legacy_cpu_rules Jul 18, 2018
runcleanup Adding hxediag exerciser source Nov 24, 2016
runsetup Integration of tlbie exerciser in to htx nest framework Apr 17, 2017
setup Merge pull request #134 from open-power/hxetape_code_updation Jul 18, 2018
.bash_profile Adding LICENSE, NOTICE and README files Mar 28, 2016
.bashrc Adding Apache 2.0 license statement to source files Mar 16, 2016
.gitignore Update gitignore with more build files Apr 6, 2016
.htx_profile Adding LICENSE, NOTICE and README files Mar 28, 2016
.htxrc Adding Apache 2.0 license statement to source files Mar 16, 2016
.travis.yml Enable travis-ci Apr 29, 2016
Dockerfile Enable travis-ci Apr 29, 2016
LICENSE Move runcleanup and runsetup files from exer bin dir to respective di… Mar 30, 2016
Maintainers.txt Adding new exerciser (hxecorsa) for testing PCIe g3 GZip FPGA adapter Feb 1, 2016
Makefile bootme update, warning removal May 8, 2017
NOTICE Move runcleanup and runsetup files from exer bin dir to respective di… Mar 30, 2016
README.md Fixing format issues Apr 27, 2017
htx.mk equaliser enhancement Feb 8, 2017
htx_diag.config Adding hxediag support to test new adapters/drivers Dec 9, 2016
htx_eq.cfg Make all makefiles and config less executable Apr 6, 2016
hxsscripts Initial HTX commit version 1.0 Jan 11, 2016
run_htx_cmdline.sh Initial HTX commit version 1.0 Jan 11, 2016

README.md

HTX README

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.

Documentation

Please refer Documentation dir.

Building HTX from source tree

Download the source from github.

Edit htx.mk file to point TOPDIR to downloaded HTX source.

Also set HTX_RELEASE variable to appropriate distro for which you are building HTX source for. Possible values are:

  • htxubuntu
  • htxrhel72le
  • htxrhel7
  • htxsles12,
  • htxfedora
  • htxfedorale

Build instructions:

In Debian/Ubuntu

  1. install git to download source code
    apt-get install git
  2. download HTX source code
    git clone https://www.github.com/open-power/HTX
  3. 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"
  4. 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)
  5. 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.

Other targets:

  • To clean: make clean

Install

Please refer HTX Users manual at Documentation/HTX_user_manual.txt for details.

License

Apache License, Version 2.0. For full details see LICENSE.

Contributing

If you want to add your own test program as part of HTX. Please refer HTX Programmer's manual at Documentation/HTX_developers_manual.txt.