[Swift-commit] r7659 - SwiftApps/cloud

[ketan at ci.uchicago.edu]

Author: ketan
Date: 2014-03-08 17:55:42 -0600 (Sat, 08 Mar 2014)
New Revision: 7659

Modified:
   SwiftApps/cloud/README
Log:
add to readme

Modified: SwiftApps/cloud/README
===================================================================
--- SwiftApps/cloud/README	2014-03-08 23:31:39 UTC (rev 7658)
+++ SwiftApps/cloud/README	2014-03-08 23:55:42 UTC (rev 7659)
@@ -8,20 +8,40 @@
 
 2. Configure:
     a. environment variables
-    Make sure GLOBUS_TCP_PORT_RANGE and GLOBUS_HOSTNAME are defined.
+    Make sure GLOBUS_TCP_PORT_RANGE and GLOBUS_HOSTNAME are defined. For example:
     
-    b. coaster-service.conf
-    Configure coaster-service.conf
+    export GLOBUS_TCP_PORT_RANGE=50000,51000
+    export GLOBUS_HOSTNAME=churn.mcs.anl.gov
     
     c. ec2
     ami-id, security group, keypair set up.
 
+    b. coaster-service.conf
+    Configure coaster-service.conf. An example coaster-service.conf can be found in the current directory. Make sure to set the EC2XXX variables to the correct values as per your account.
+    Set other environment variables e.g:
+    
+    export WORKER_LOCATION=/home/ubuntu/worker
+    export WORKER_USERNAME=ubuntu
+    export LOG_DIR=logs
+    export SHARED_FILESYSTEM=no
+    export SSH_TUNNELING=yes
+
 3. Start coaster service
-Start coaster service: start-coaster-service
+Start the coaster service using the following command:
 
+start-coaster-service
+
+Above command will generate an apps and sites configuration file. Use these configuration files to run Swift command as shown in the next section.
+
+Make sure coaster-service.conf is available in the current working directory or use the "-conf" option to use config file located elsewhere.
+
 4. Start Swift run
-Start swift run.
+Start swift run. Assuming your Swift scripts, applications and data are set, run a Swift script using swift command as follows:
 
+   swift -sites.file sites.xml -tc.file apps -config cf catsnsleep.swift -s=10 -n=20
+
+The example catsnsleep.swift and cf files are provided with the package.
+
 5. Manage resources:
     a. Add EC2 compute instances
     Add more resources via addnodes. Use -n to add by number and -a to add by ip address.
@@ -31,3 +51,4 @@
     Monitor Swift tasks and EC2 instances while jobs are running.
 
 6. Shut everything down: stop-coaster-service
+Use the stop-coaster-service command to stop everything.