[Swift-commit] r6332 - trunk/docs/userguide

[ketan at ci.uchicago.edu]

Author: ketan
Date: 2013-03-05 22:25:34 -0600 (Tue, 05 Mar 2013)
New Revision: 6332

Modified:
   trunk/docs/userguide/site_catalog
Log:
scratch tag

Modified: trunk/docs/userguide/site_catalog
===================================================================
--- trunk/docs/userguide/site_catalog	2013-03-06 03:03:15 UTC (rev 6331)
+++ trunk/docs/userguide/site_catalog	2013-03-06 04:25:34 UTC (rev 6332)
@@ -11,7 +11,6 @@
 The sites file is formatted as XML. It consists of <pool> elements,
 one for each site that Swift will use.
 
-
 Pool element
 ~~~~~~~~~~~~
 Each pool element must have a handle attribute, giving a symbolic
@@ -25,7 +24,6 @@
 a remote working directory. Optionally, profile settings can
 be specified.
 
-
 File transfer method
 ~~~~~~~~~~~~~~~~~~~~
 Transfer methods are specified with either the <gridftp> element or
@@ -158,6 +156,20 @@
 be used for execution. A shared cluster scratch filesystem is
 appropriate for this.
 
+Scratch
+~~~~~~~
+
+The scratch element takes in a value of a directory on a shared filesystem. For example:
+
+----
+<scratch>/work/01739/ketan/lab/swift/myscratch</scratch>
+----
+
+The scratch element specifies that the underlying Swift wrapper will copy the
+input files into the scratch directory and the job will be run from that
+directory. In the absence of scratch tag, Swift will run the job from
+workdirectory by creating symlinks to input files in a shared directory.
+
 Profiles
 ~~~~~~~~
 Profile keys can be specified using the <profile> element.