[Swift-commit] r5098 - in trunk: docs docs/siteguide tests/providers/mcs
davidk at ci.uchicago.edu
davidk at ci.uchicago.edu
Thu Sep 8 23:48:09 CDT 2011
Author: davidk
Date: 2011-09-08 23:48:09 -0500 (Thu, 08 Sep 2011)
New Revision: 5098
Added:
trunk/docs/siteguide/mcs
Modified:
trunk/docs/build_docs.sh
trunk/docs/siteguide/futuregrid
trunk/docs/siteguide/siteguide.txt
trunk/tests/providers/mcs/coaster-service.conf
Log:
Siteguide entry for MCS workstations
Modified: trunk/docs/build_docs.sh
===================================================================
--- trunk/docs/build_docs.sh 2011-09-09 00:04:38 UTC (rev 5097)
+++ trunk/docs/build_docs.sh 2011-09-09 04:48:09 UTC (rev 5098)
@@ -43,7 +43,7 @@
for file in $FILES
do
echo Converting $directory"$file" to HTML
- asciidoc -a toc -a max-width=750px -a stylesheet=$(pwd)/../stylesheets/asciidoc.css $file
+ asciidoc -a toc -a toclevels=2 -a max-width=750px -a textwidth=80 -a stylesheet=$(pwd)/../stylesheets/asciidoc.css $file
echo Converting $directory"$file" to PDF
a2x --format=pdf --no-xmllint $file
done
Modified: trunk/docs/siteguide/futuregrid
===================================================================
--- trunk/docs/siteguide/futuregrid 2011-09-09 00:04:38 UTC (rev 5097)
+++ trunk/docs/siteguide/futuregrid 2011-09-09 04:48:09 UTC (rev 5098)
@@ -1,26 +1,6 @@
Futuregrid Quickstart Guide
---------------------------
-Downloading and Building Swift
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The most recent versions of Swift can be found at
-http://www.ci.uchicago.edu/swift/downloads/index.php. To run on futuregrid,
-you will need to download the development/trunk version from SVN.
-
-Adding Swift to your PATH
-~~~~~~~~~~~~~~~~~~~~~~~~~
-Once you have installed Swift, add the Swift binary to your PATH so you can
-easily run it from any directory.
-
-In your home directory, edit the file ".bashrc".
-
-If you have installed Swift via a source repository, add the following line
-at the bottom of .bashrc.
-
------
-export PATH=$PATH:$HOME/cog/modules/swift/dist/swift-svn/bin
------
-
Requesting Futuregrid Access
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you do not already have a futuregrid account, you can follow the
Added: trunk/docs/siteguide/mcs
===================================================================
--- trunk/docs/siteguide/mcs (rev 0)
+++ trunk/docs/siteguide/mcs 2011-09-09 04:48:09 UTC (rev 5098)
@@ -0,0 +1,126 @@
+MCS Workstations
+----------------
+
+Create a coaster-service.conf
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+To begin, copy the text below and paste it into your Swift distribution's etc
+directory. Name the file coaster-service.conf.
+
+-----
+include::../../tests/providers/mcs/coaster-service.conf[]
+-----
+
+SSH Configuration
+~~~~~~~~~~~~~~~~~
+For this configuration to work, you must be able to log into each of the MCS workstations
+using your SSH keys. Copy your id_rsa and id_rsa.pub files into the .ssh/ directory
+on login.mcs.anl.gov. Run the following commands to make sure your keys are private:
+
+-----
+chmod 600 id_rsa
+chmod 644 id_rsa.pub
+-----
+
+Once your SSH keys are in place, create a file in .ssh/ called auth.defaults. Paste the
+following text into the file:
+
+-----
+crush.mcs.anl.gov.type=key
+crush.mcs.anl.gov.username=yourusername
+crush.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+crush.mcs.anl.gov.passphrase=your passphrase here
+
+thwomp.mcs.anl.gov.type=key
+thwomp.mcs.anl.gov.username=yourusername
+thwomp.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+thwomp.mcs.anl.gov.passphrase=your passphrase here
+
+stomp.mcs.anl.gov.type=key
+stomp.mcs.anl.gov.username=yourusername
+stomp.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+stomp.mcs.anl.gov.passphrase=your passphrase here
+
+crank.mcs.anl.gov.type=key
+crank.mcs.anl.gov.username=yourusername
+crank.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+crank.mcs.anl.gov.passphrase=your passphrase here
+
+steamroller.mcs.anl.gov.type=key
+steamroller.mcs.anl.gov.username=yourusername
+steamroller.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+steamroller.mcs.anl.gov.passphrase=your passphrase here
+
+grind.mcs.anl.gov.type=key
+grind.mcs.anl.gov.username=yourusername
+grind.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+grind.mcs.anl.gov.passphrase=your passphrase here
+
+churn.mcs.anl.gov.type=key
+churn.mcs.anl.gov.username=yourusername
+churn.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+churn.mcs.anl.gov.passphrase=your passphrase here
+
+trounce.mcs.anl.gov.type=key
+trounce.mcs.anl.gov.username=yourusername
+trounce.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+trounce.mcs.anl.gov.passphrase=your passphrase here
+
+thrash.mcs.anl.gov.type=key
+thrash.mcs.anl.gov.username=yourusername
+thrash.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+thrash.mcs.anl.gov.passphrase=your passphrase here
+
+vanquish.mcs.anl.gov.type=key
+vanquish.mcs.anl.gov.username=yourusername
+vanquish.mcs.anl.gov.key=/home/yourusername/.ssh/id_rsa
+vanquish.mcs.anl.gov.passphrase=your passphrase here
+-----
+
+Replace the username, key path, and passphrase with your values.
+Change the permissions on the file to keep it private.
+
+-----
+chmod 600 auth.default
+-----
+
+Starting the Coaster Service
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Change directories to the location you would like to run a
+Swift script and start the coaster service with this
+command:
+
+-----
+start-coaster-service
+-----
+
+This will create a configuration file that Swift needs
+called sites.xml.
+
+WARNING: Any existing sites.xml files in this directory
+will be overwritten. Be sure to make a copy of any
+custom configuration files you may have.
+
+Run Swift
+~~~~~~~~~
+
+Next, run Swift. If you do not have a particular script
+in mind, you can test Swift by using a Swift script in
+the examples/ directory.
+
+Run the following command to run the script:
+-----
+swift -sites.file sites.xml -tc.file tc.data yourscript.swift
+-----
+
+Stopping the Coaster Service
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The coaster service will run indefinitely. The stop-coaster-service
+script will terminate the coaster service.
+
+-----
+$ stop-coaster-service
+-----
+
+This will kill the coaster service and kill the worker scripts on remote systems.
+
Modified: trunk/docs/siteguide/siteguide.txt
===================================================================
--- trunk/docs/siteguide/siteguide.txt 2011-09-09 00:04:38 UTC (rev 5097)
+++ trunk/docs/siteguide/siteguide.txt 2011-09-09 04:48:09 UTC (rev 5098)
@@ -16,4 +16,6 @@
include::futuregrid[]
+include::mcs[]
+
include::grid[]
Modified: trunk/tests/providers/mcs/coaster-service.conf
===================================================================
--- trunk/tests/providers/mcs/coaster-service.conf 2011-09-09 00:04:38 UTC (rev 5097)
+++ trunk/tests/providers/mcs/coaster-service.conf 2011-09-09 04:48:09 UTC (rev 5098)
@@ -14,7 +14,9 @@
export WORKER_LOGGING=INFO
# Worker host names for ssh
-export WORKER_HOSTS="crush.mcs.anl.gov thwomp.mcs.anl.gov stomp.mcs.anl.gov crank.mcs.anl.gov steamroller.mcs.anl.gov grind.mcs.anl.gov churn.mcs.anl.gov trounce.mcs.anl.gov thrash.mcs.anl.gov vanquish.mcs.anl.gov"
+export WORKER_HOSTS="crush.mcs.anl.gov thwomp.mcs.anl.gov stomp.mcs.anl.gov crank.mcs.anl.gov
+steamroller.mcs.anl.gov grind.mcs.anl.gov churn.mcs.anl.gov trounce.mcs.anl.gov
+thrash.mcs.anl.gov vanquish.mcs.anl.gov"
# Directory to keep log files, relative to working directory when launching start-coaster-service
export LOG_DIR=logs
@@ -23,7 +25,8 @@
export LOCAL_PORT=
export SERVICE_PORT=
-# start-coaster-service tries to automatically detect IP address. Specify here if auto detection is not working correctly
+# start-coaster-service tries to automatically detect IP address.
+# Specify here if auto detection is not working correctly
export IPADDR=
# Below are various settings to give information about how to create sites.xml
More information about the Swift-commit
mailing list