diff --git hadoop-tools/hadoop-sls/README hadoop-tools/hadoop-sls/README index 86b554e..55023ba 100644 --- hadoop-tools/hadoop-sls/README +++ hadoop-tools/hadoop-sls/README @@ -8,5 +8,25 @@ SLS runs a regular RM without RPC endpoints and uses a NodeManager and Application Manager simulators to send and receive events simulating cluster and application load behavior. -The size of the cluster and the application load is scripted in a configuration -file. +==== Quick Start ==== + +Let $HADOOP_ROOT represent the Hadoop install directory. If you build Hadoop +yourself, $HADOOP_ROOT is hadoop-dist/target/hadoop-$VERSION. The simulator +is located at $HADOOP_ROOT/share/hadoop/tools/sls. The folder sls contains +four directories: bin (running scripts), html (web portal to view progress), +sample-conf (some example configurations), and sample-data (an example rumen +trace). + +STEP 1: Copy all configuration files (under sample-conf) to $HADOOP_ROOT/etc/hadoop. +STEP 2: Go to the $HADOOP_ROOT/share/hadoop/tools/sls directory, and run the simulator +using the sample rumen trace (under sample-data). + +bin/slsrun.sh —-input-rumen=sample-data/2jobs2min-rumen-jh.json —-output-dir=sample-output + +The simulator will start to run, and you can track the running progress +using its web portal (http://$HOST:10001/simulate, where $HOST is the place +where you run the simulator.). All collected scheduler metrics are stored +under the output-dir during running. This trace takes about 3 mins to finish. + +For more detailed setup, you can check out the document +(http://issues.apache.org/jira/secure/attachment/12604817/YARN-1021.pdf) +and the JIRA YARN-1021 (http://issues.apache.org/jira/browse/YARN-1021).