[Hadoop Wiki] Update of "Hbase/MavenPrimer" by stack

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.

The "Hbase/MavenPrimer" page has been changed by stack.
http://wiki.apache.org/hadoop/Hbase/MavenPrimer?action=diff&rev1=6&rev2=7

--------------------------------------------------

   1. [[#oneunittest|How do I run one unit test only?]]
   1. [[#starthbase|How do I do an in-situ bin/start-hbase.sh?]]
   1. [[#equiv|How do I do the equivalent of an "ant clean", or "ant jar", etc., using maven?]]
+  1. [[#jar|How do I try out a jar that is not installed in a maven repository (e.g. a new zookeeper jar)?]]
+ 
  
  <<Anchor(whatdoineed)>>
  
  == What do I need? ==
- You need Maven 2.0.9 or greater, I would recommend Maven 2.2 though.  Downloads here:
  
  http://maven.apache.org/download.html
  
@@ -26, +27 @@

  
  as there are a few things within the build that require more than the standard JVM memory allows.
  
- <<Anchor(ide)>>
- 
  == What about IDE support? ==
  IntelliJ: Built-in awesomeness.  It just works.
  
@@ -36, +35 @@

  <<Anchor(jar)>>
  
  == How do I just build the jars without going through a full unit test cycle? ==
- From the top-level directory:
- 
  mvn -DskipTests package
  
  you'll find the jars under the 'target' sub-directory of each sub-module, so 'hbase/core/target/hbase-core-0.20.1.jar' is effectively the original 'hbase.jar' produced previously.
@@ -45, +42 @@

  <<Anchor(full)>>
  
  == How do I do a full Distribution style build, including running all the tests? ==
- From the top-level directory:
- 
- mvn install assembly:assembly
  
  In the top-level 'hbase/target' directory you will find a set of tar balls and zip files.  the '-bin' contains something akin to the original HBase release tar ball.  The -'project' and -'src' are there to provide an archive of the entire Maven project as it stood during release, and a slimmer, source-only bundle respectively.
  
@@ -57, +51 @@

  sure, just:
  
  cd core mvn -DskipTests package
- 
- look in the target sub-directory.
- 
  <<Anchor(javadoc)>>
  
  == How do I build javadoc only? ==
- {{{mvn javadoc:javadoc}}}
+ == How do I run one unit test only? ==
  
+ ---- /!\ '''Edit conflict - other version:''' ----
- <<Anchor(oneunittest)>>
- 
- == How do I run one unit test only? ==
- {{{mvn mvn test -Dtest=<CLASSNAME>}}}
- 
- <<Anchor(starthbase)>>
- 
- == How do I do an in-situ bin/start-hbase.sh? ==
- To get around {{{java.lang.ClassNotFoundException}}} when you run {{{${HBASE_HOME}/bin/start-hbase.sh}}} in-situ -- i.e. you are trying to run hbase in-place from where you did your checkout --  do the following:
- 
- {{{
- $ mvn install # Pass -DskipTests if you'd avoid running tests. Install is needed to get hbase jars into mvn local repo under ~/.m2
- $ HBASE_CLASSPATH=`mvn -q dependency:build-classpath -Dmdep.outputFile="/tmp/cp.txt"; cat "/tmp/cp.txt"` ./bin/start-hbase.sh
- }}}
  <<Anchor(equiv)>>
  
  == How do I do the equivalent of an "ant clean", or "ant jar", etc., using maven? ==
  ||ant clean ||mvn clean # Run mvn -q clean to have it run quietly ||
  ||ant compile ||mvn compile ||
  ||ant jar ||mvn -DskipTests install # Mvn by default runs tests before it makes jar as opposed to ant which does jar first.  Both go down into contrib dirs and build jars down in there too.  Mvn will actually install the jars into your local mvn repo.  This is probably what you want if you want to go on to run hbase ||
- ||ant test ||mvn test ||
+ ||ant test||mvn test||
- ||ant test -Dtestcase=TestClient ||mvn test -Dtest=TestClient ||
+ ||ant test -Dtestcase=TestClient||mvn test -Dtest=TestClient||
- 
  
  For more on the [[http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html|mvn lifecycles...]]
  
+ <<Anchor(jar)>>
+ == How do I try out a jar that is not installed in a maven repository (e.g. a new zookeeper jar)? ==
+ Here is how you'd have it use a zookeeper jar that was added to the {{{${HBASE_HOME}/lib}}} directory.
+ 
+ Edit the core/pom.xml since its hbase core that depends on zk:
+ 
+ {{{
+ Index: core/pom.xml
+ ===================================================================
+ --- core/pom.xml        (revision 943580)
+ +++ core/pom.xml        (working copy)
+ @@ -223,6 +223,9 @@
+      <dependency>
+        <groupId>org.apache.hadoop</groupId>
+        <artifactId>zookeeper</artifactId>
+ +      <scope>system</scope>
+ +      <!--Go up to the lib dir at ${HBASE_HOME} to find zk jar-->
+ +      <systemPath>${basedir}/../lib/zookeeper-3.3.1.jar</systemPath>
+      </dependency>
+  
+      <dependency>
+ @@ -277,4 +280,4 @@
+        <artifactId>hadoop-test</artifactId>
+      </dependency>
+    </dependencies>
+ -</project>
+ \ No newline at end of file
+ +</project>
+ }}}
+