HBench – Installation Instructions

HBench can only be ran on windows with some recent .net version.

  1. You can either clone the latest version directly from the git repository here, or download a reasonably recent version from here. After Unpacking the zip file, run hbench\bin\release\hbench.exe. If you prefer to work from source, open the project in visual studio, compile and run.
  1. Configuration (A): choose one of:
    1. The executable-only route:
      Update the data in the config file via menu/advanced-config.
      This will open an xml file via notepad, so if you prefer a better editor then just edit externally the file:hbench\bin\release\hbench.exe.configThe configuration file is rather self-explanatory, for example, update<add key="log" value="C:\temp\log.txt"/>with the path that you want for the log file.
    1. The compile-from-source route:
      Open the project in visual studio, change app.config as explained in item 2.1 above, and compile.
  1. Configuration (B): Update all the fields in the GUI.
  1. [optional] if you want support for scatter/cactus graph, install cpbm (you can also just download a local copy of cpbm ver 0.5). cpbm was developed by Michael Tautschnig. It requires perl installed and in the path. Check that it works by typing, e.g., “perl make_csv.pl” in the cpbm directory. Change the path to cpbm in the config file.
  1. [optional] if you want to run your program on a remote Linux machine, you will need to set a private/public key pair so the command ssh user@domain <cmd> works without requiring a password. See more information in the short manual.
  1. Preparing your tested executable:HBench collects statistics from stdout, and only lines of the form
    ### <field name> <numeric value>
    (You can change the ### prefix in the config file), while ignoring other lines.So you need to adjust your executable to emit this output. Note that the fields can only be numeric. There is no need to emit the input file name / directory because these are recorded automatically.
  1. Read the short manual. Note that most controls in the GUI are accompanied with a tooltip.