• FAQ
• Quickstart
  • Setup
  • Run Example
  • Java API
  • Scala API
• Setup & Configuration
  • Local Setup
  • Cluster Setup
  • YARN Setup
  • Configuration
• Programming Guides
  • Java API
  • Scala API
  • Hadoop Compatability
  • Iterations
  • Spargel Graph API
• Examples
  • Java API
  • Scala API
• Execution
  • Local/Debugging
  • Cluster
  • Command-Line Interface
  • Web Interface
• Internals
  • Overview

Quickstart: Setup

• Requirements
• Download
• Start
• Run Example
• Cluster Setup
• Stratosphere on YARN

Get Stratosphere up and running in a few simple steps.

Requirements

Stratosphere runs on all UNIX-like environments: Linux, Mac OS X, Cygwin. The only requirement is to have a working Java 6.x (or higher) installation.

Download

Download the ready to run binary package. Choose the Stratosphere distribution that matches your Hadoop version. If you are unsure which version to choose or you just want to run locally, pick the package for Hadoop 1.2.

• Hadoop 1.2
• Hadoop 2 (YARN)

Start

You are almost done.

1. Go to the download directory.
2. Unpack the downloaded archive.
3. Start Stratosphere.

$ cd ~/Downloads              # Go to download directory
$ tar xzf stratosphere-*.tgz  # Unpack the downloaded archive
$ cd stratosphere
$ bin/start-local.sh          # Start Stratosphere

Check the JobManager's web frontend at http://localhost:8081 and make sure everything is up and running.

Run Example

Run the Word Count example to see Stratosphere at work.

• Download test data: bash $ wget -O hamlet.txt http://www.gutenberg.org/cache/epub/1787/pg1787.txt
• You now have a text file called hamlet.txt in your working directory.

• Start the example program:

  $ bin/stratosphere run \
  --jarfile ./examples/stratosphere-java-examples-0.5.1-WordCount.jar \
  
  --arguments file://`pwd`/hamlet.txt file://`pwd`/wordcount-result.txt
  

• You will find a file called wordcount-result.txt in your current directory.

Cluster Setup

Running Stratosphere on a cluster is as easy as running it locally. Having passwordless SSH and the same directory structure on all your cluster nodes lets you use our scripts to control everything.

1. Copy the unpacked stratosphere directory from the downloaded archive to the same file system path on each node of your setup.
2. Choose a master node (JobManager) and set the jobmanager.rpc.address key in conf/stratosphere-conf.yaml to its IP or hostname. Make sure that all nodes in your cluster have the same jobmanager.rpc.address configured.
3. Add the IPs or hostnames (one per line) of all worker nodes (TaskManager) to the slaves files in conf/slaves.

You can now start the cluster at your master node with bin/start-cluster.sh.

The following example illustrates the setup with three nodes (with IP addresses from 10.0.0.1 to 10.0.0.3 and hostnames master, worker1, worker2) and shows the contents of the configuration files, which need to be accessible at the same path on all machines:

/path/to/stratosphere/conf/
stratosphere-conf.yaml

jobmanager.rpc.address: 10.0.0.1

/path/to/stratosphere/
conf/slaves

    10.0.0.2
    10.0.0.3

Stratosphere on YARN

You can easily deploy Stratosphere on your existing YARN cluster.

1. Download the Stratosphere YARN package with the YARN client: Stratosphere for YARN
2. Make sure your HADOOP_HOME (or YARN_CONF_DIR or HADOOP_CONF_DIR) environment variable is set to read your YARN and HDFS configuration.
3. Run the YARN client with: ./bin/yarn-session.sh. You can run the client with options -n 10 -tm 8192 to allocate 10 TaskManagers with 8GB of memory each.

For more detailed instructions, check out the programming Guides and examples.