diff --git hadoop-tools/hadoop-sls/README hadoop-tools/hadoop-sls/README index 86b554e..356216b 100644 --- hadoop-tools/hadoop-sls/README +++ hadoop-tools/hadoop-sls/README @@ -8,5 +8,29 @@ 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 ==== + +Here we show how to use the simulator quickly for a demo running. +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, html, sample-conf, and sample-data. + +The folder bin contains running scripts. The folder sample-conf specifies +some example configurations, and the sample-data provides an example rumen +trace for quickly demo running. + +STEP 1: Copy all configuration files (under sample-conf) to $HADOOP_ROOT/etc/hadoop. +STEP 2: Run the simulator using the sample rumen trace (under sample-data). + +$HADOOP_ROOT/share/hadoop/tools/sls/bin/slsrun.sh —-input-rumen=$HADOOP_ROOT/share/hadoop/tools/sls/sample-data/2jobs2min-rumen-jh.json —-output-dir=$HADOOP_ROOT/share/hadoop/tools/sls/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. The whole demo takes around 3 min 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).