Tutorial¶
In this tutorial, you will learn how to run the StashCache tester.
Requirements¶
StashCache Tester requires HTCondor in order to run tests. StashCache submits tests to HTCondor as a DAG.
Additionally, it requires the HTCondor Python Bindings.
Installing¶
The StashCache tester is distributed as a python package in PyPi. It is recommended that you install the tester inside a virtual enviornment.
The setps to install are:
$ virtualenv tester
$ . tester/bin/activate
$ pip install --upgrade setuptools
$ pip install stashcache_tester
The pip installation could take a while. It requires the compilation and installation of several packages including matplotlib and numpy.
Running StashCache¶
StashCache comes with an executable script, stash-test
which will begin the submission of test jobs. A configuration file is required by stash-test
. An example configuration file is located in etc/stashcache-tester/tester.conf
. You can test with this configuration:
$ stash-test -c tester/etc/stashcache-tester/tester.conf run
This will submit the DAG to the cluster.
Debugging StashCache Tester¶
A log file is produced that will contain the debugging and error messages.