document suffixtags and fix handling of empty suffixtag

deploy/runtools/workload.py

@@ -106,12 +106,16 @@ class WorkloadConfig:
 
         self.post_run_hook = workloadjson.get("post_run_hook")
 
+        appendsuffix = ""
+        if suffixtag != "":
+            appendsuffix = "-" + suffixtag
+
         # we set this up as an absolute path to simplify later use
         self.job_results_dir = """{}/results-workload/{}-{}{}/""".format(
                                                             os.getcwd(),
                                                             launch_time,
                                                             self.workload_name,
-                                                            "-" + suffixtag)
+                                                            appendsuffix)
 
         #import code
         #code.interact(local=locals())

deploy/sample-backup-configs/sample_config_runtime.ini

@@ -48,3 +48,4 @@ readrate=0
 [workload]
 workloadname=linux-uniform.json
 terminateoncompletion=no
+suffixtag=

docs/Advanced-Usage/Manager/Manager-Configuration-Files.rst

@@ -224,6 +224,18 @@ Set this to ``no`` if you want your Run Farm to keep running once the workload
 has completed. Set this to ``yes`` if you want your Run Farm to be TERMINATED
 after the workload has completed and results have been copied off.
 
+
+``suffixtag``
+""""""""""""""""""""""""""
+
+This allows you to append a string to a workload's output directory name,
+useful for differentiating between successive runs of the same workload,
+without renaming the entire workload. For example, specifying
+``suffixtag=test-v1`` with a workload named ``super-application`` will result
+in a workload results directory named
+``results-workload/DATE--TIME-super-application-test-v1/``.
+
+
 .. _config-build:
 
 ``config_build.ini``