You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@storm.apache.org by bo...@apache.org on 2014/05/28 15:50:08 UTC
[10/12] git commit: storm-starter: explain how to build/install Storm
locally to run storm-starter from master branch
storm-starter: explain how to build/install Storm locally to run
storm-starter from master branch
Project: http://git-wip-us.apache.org/repos/asf/incubator-storm/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-storm/commit/452838f2
Tree: http://git-wip-us.apache.org/repos/asf/incubator-storm/tree/452838f2
Diff: http://git-wip-us.apache.org/repos/asf/incubator-storm/diff/452838f2
Branch: refs/heads/security
Commit: 452838f2ab5f2dbe72a77ab6bfc57529da1f4e0c
Parents: ddc6705
Author: Michael G. Noll <mi...@apache.org>
Authored: Tue May 27 18:31:03 2014 +0200
Committer: Michael G. Noll <mi...@apache.org>
Committed: Tue May 27 18:31:03 2014 +0200
----------------------------------------------------------------------
examples/storm-starter/README.markdown | 15 +++++++++++++++
1 file changed, 15 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-storm/blob/452838f2/examples/storm-starter/README.markdown
----------------------------------------------------------------------
diff --git a/examples/storm-starter/README.markdown b/examples/storm-starter/README.markdown
index e62cc34..b7c1798 100644
--- a/examples/storm-starter/README.markdown
+++ b/examples/storm-starter/README.markdown
@@ -31,6 +31,7 @@ code.
## storm-starter overview
+
storm-starter contains a variety of examples of using Storm. If this is your first time working with Storm, check out
these topologies first:
@@ -57,6 +58,20 @@ Install [Maven](http://maven.apache.org/) (preferably version 3.x) by following
the [Maven installation instructions](http://maven.apache.org/download.cgi).
+## Build and install Storm jars locally
+
+If you are using the latest development version of Storm, e.g. by having cloned the Storm git repository,
+then you must first perform a local build of Storm itself. Otherwise you will run into Maven errors such as
+`Could not resolve dependencies for project `org.apache.storm:storm-starter:<storm-version>-SNAPSHOT`.
+
+ # Must be run from the top-level directory of the Storm code repository
+ $ mvn clean install -DskipTests=true
+
+This command will build Storm locally and install its jar files to your user's `$HOME/.m2/repository/`. When you run
+the Maven command to build and run storm-starter (see below), Maven will then be able to find the corresponding version
+of Storm in this local Maven repository at `$HOME/.m2/repository`.
+
+
## Running topologies with Maven
storm-starter topologies can be run with the maven-exec-plugin. For example, to