Phoronix Test Suite

An Automated, Open-Source Testing Framework

Latest Release: Phoronix Test Suite 5.0.1

Home Downloads Features Documentation Contact OpenBenchmarking.org Forum Support

Getting Started

View the Phoronix Test Suite PDF documentation for complete usage details.

The Phoronix Test Suite can be rapidly deployed across most operating systems that support PHP 5 CLI, including Linux, FreeBSD, NetBSD, OpenBSD, Mac OS X, OpenSolaris, and Windows. After you have downloaded the Phoronix Test Suite (download page) and have installed the necessary dependencies, you can immediately begin using this software.

If you have downloaded the source package to the Phoronix Test Suite, you can run it locally after extracting the compressed file or use the generic installation script. Running the install-sh file within the phoronix-test-suite/ directory will install the Phoronix Test Suite files to /usr/bin/phoronix-test-suite, /usr/share/doc/phoronix-test-suite/, and /usr/share/phoronix-test-suite/ by default. The installation prefix can be adjusted as the first argument sent to this installer (i.e. install-sh /usr/local). If you are using one of the distribution packages, once installing it you should be able to run phoronix-test-suite from the terminal. For more detailed installation instructions, view the included documentation.

To see all available tests, run phoronix-test-suite list-tests. When finding a test you are interested in using, run phoronix-test-suite info <test name> to view more information. When you are ready to use this test, run phoronix-test-suite benchmark <test name>. The benchmark option will proceed to install the test and then execute the test and display the results.

The Phoronix Test Suite will automatically download all needed test files. In addition, on supported platforms it will also use the distribution's package management system for installing the needed test dependencies. However, for the software being tested that may be installed already on the system by the user, the Phoronix Test Suite will ignore those installations. The Phoronix Test Suite installs all tests within its configured environment to improve the reliability of the testing process. This ensures all tests being used are at the same version, being run or built from the same source packages, and minimizes outside changes such as patches or build-time optimizations that may be specific to a single distribution or environment. This does, however, result in additional download time and extra disk space needed. If installing a large test suite, it may consume several gigabytes of disk space. Once the files have been downloaded, however, you can run phoronix-test-suite make-download-cache to generate a backup of these files at ~/.phoronix-test-suite/download-cache/. This allows you to quickly and easily transfer these files to other PCs.

The Phoronix Test Suite will then prompt you for any test options and whether you would like to save these files.

When the testing is complete, the results will be displayed and you will be prompted to upload these results to Phoronix Global. For more information and to see all of the options for the Phoronix Test Suite, view the full Phoronix Test Suite documentation. Should you run into any problems there is the community forums for support.