Tutorial Active Harmony

Active Harmony TutorialJuly 8, 2009Active Harmony is based on a client-server model. The client is the \harmonized" applica-tion, which sends performance numbers to the server. The server makes application tuningand adaptation decisions based on the numbers reported by the client.The Harmony system consists of three main components: the Harmony parameter API(implemented in C++), the Resource Speci cation Language (RSL) (Tcl implementation)and parameter tuning/optimization algorithms (Tcl implementation). Harmonization of anapplication is done using the Harmony API. The RSL is used to communicate betweenthe tunable programs (e.g., application or library) and the Harmony tuning server. Theparameter tuning algorithms explore the optimization space of the application and adjustthe parameter values based on observed performance.This document will provide build instructions, steps needed to \harmonize" an applicationand will also describe key components of the tuning system.21 Build InstructionsListing 1 provides instructions on how to build and run the software.Listing 1 Build Steps$ tar -zxvf harmony.tgz$ cd build$ makeTo run the server:$ cd ../bin$ ./hserverTo run the example client you have to setup the environment variables:with bash:$ export HARMONY_S_HOST=localhost$ HARMONY_S_PORT=1977with csh/tcsh:$ setenv HARMONY_S_HOST localhost$ HARMONY_S_PORT 1977localhost is put just for demo purposes. You should set that variableto whatever ...