[Swift-commit] r8257 - SwiftApps/subjobs

[ketan at ci.uchicago.edu]

Author: ketan
Date: 2014-09-29 10:14:31 -0500 (Mon, 29 Sep 2014)
New Revision: 8257

Modified:
   SwiftApps/subjobs/README.txt
   SwiftApps/subjobs/setup
Log:
READMe and setup


Modified: SwiftApps/subjobs/README.txt
===================================================================
--- SwiftApps/subjobs/README.txt	2014-09-29 14:53:02 UTC (rev 8256)
+++ SwiftApps/subjobs/README.txt	2014-09-29 15:14:31 UTC (rev 8257)
@@ -3,25 +3,46 @@
 
 Introduction
 ------------
-Sub-block jobs is a mode of running jobs on BlueGene systems wherein one can
-allocate a larger block of compute nodes and repeatedly submit jobs of smaller
-sized sub-blocks to this larger allocation.
+This document describes an approach to run relatively smaller jobs over a
+single large block on BlueGene systems. The technique, called sub-block jobs
+lets users submit multiple, independent, smaller jobs within a single larger
+cobalt block. Sub-block jobs is a mode of running jobs on BlueGene systems
+wherein one can allocate a larger block of compute nodes and repeatedly submit
+jobs of smaller sized sub-blocks to this larger allocation.
 
-This package provides tools and scripts to run Swift applications in sub-block mode over the BlueGene resources.
+This package provides tools and scripts to run Swift applications in sub-block
+mode over the BlueGene resources. The benefit of this approach is that the
+user does not have to invoke the sub-block specific routines involving the
+details of the underlying node interconnect hardware. The approach
+transparently allow user to run jobs directly via Swift. Additionally, users
+can run multiple 'waves' of jobs asynchronously and in parallel without
+restarting the outer block.
 
 Swift sub-block jobs
 ---------------------
 
-To set up environment:
+To download the package, checkout the code as follows:
 
 ----
+svn co https://svn.ci.uchicago.edu/svn/vdl2/SwiftApps/subjobs
+----
+
+followed by:
+
+----
+cd  subjobs
+----
+
+To set up the environment:
+
+----
 source setup
 ----
 
 To run an example application
 
 ----
-./runswift
+./runswift.sh
 ----
 
 sub-block jobs from bash

Modified: SwiftApps/subjobs/setup
===================================================================
--- SwiftApps/subjobs/setup	2014-09-29 14:53:02 UTC (rev 8256)
+++ SwiftApps/subjobs/setup	2014-09-29 15:14:31 UTC (rev 8257)
@@ -1,4 +1,6 @@
 #!/bin/bash
 
+#put bg.sh in path
+
 export PATH=$PWD:$PATH