hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Hadoop Wiki] Update of "Hbase/MavenPrimer" by Misty
Date Mon, 19 Oct 2015 02:37:30 GMT
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 Misty:
https://wiki.apache.org/hadoop/Hbase/MavenPrimer?action=diff&rev1=16&rev2=17

- == Table of Contents ==
+ The HBase Wiki is in the process of being decommissioned. The info that used to be on this
page has moved to http://hbase.apache.org/book.html#build. Please update your bookmarks.
  
-  1. [[#whatdoineed|What do I need?]]
-  1. [[#ide|What about IDE support?]]
-  1. [[#jar|How do I just build the jars without going through a full unit test cycle?]]
-  1. [[#full|How do I do a full Distribution style build, including running all the tests?]]
-  1. [[#core|I don't want to build all the other modules, I'm just interested in the base
Hbase 'core' stuff, is there something simpler?]]
-  1. [[#javadoc|How do I build javadoc only?]]
-  1. [[#oneunittest|How do I run one unit test only?]]
-  2. [[#unittestoutput|How do I get full log output from unit tests?]]
-  1. [[#equiv|How do I do the equivalent of an "ant clean", or "ant jar", etc., using maven?]]
-  1. [[#otherjar|How do I try out a jar that is not installed in a maven repository (e.g.
a new zookeeper jar)?]]
-  1. [[#newjar|How do I add a new dependency to the project?]]
- 
- <<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
- 
- Macports (sudo port install maven2), Debian/Ubuntu packaging are available too.
- 
- You'll definitely want to setup an environment variable ala:
- 
- {{{export MAVEN_OPTS="-Xmx512m"}}}
- 
- 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.
- 
- Eclipse: Definitely recommend the M2Eclipse plugin here: http://m2eclipse.sonatype.org/.
Or, you can have eclipse generate the {{{.classpath}}} and {{{.project}}} for you.  This works
pretty well.  First do {{{$ mvn install}}} or {{{$ mvn -DskipTests install}}}.  Then do {{{$mvn
eclipse:eclipse}}}.  This writes the eclipse files for core and each of the contribs.  In
eclipse, you'd open new project based off existing sources.
- 
- <<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.
- 
- <<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.  
- 
- <<Anchor(core)>>
- == I don't want to build all the other modules, I'm just interested in the base Hbase 'core'
stuff, is there something simpler? ==
- 
- sure, just:
- 
- {{{cd core}}}   then   {{{mvn -DskipTests package}}}
- 
- look in the target sub-directory.
- 
- <<Anchor(javadoc)>>
- 
- == How do I build javadoc only? ==
- 
- {{{mvn javadoc:javadoc}}}
- 
- <<Anchor(oneunittest)>>
- 
- == How do I run one unit test only? ==
- 
- {{{mvn test -Dtest=<CLASSNAME>}}}
- 
- <<Anchor(unittestoutput)>>
- 
- == How do I get full log output from unit tests? ==
- 
- {{{mvn test -Dtest.output=true}}}
- 
- Test output is located in:  core/target/surefire-reports/
- 
- 
- <<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 -Dtestcase=TestClient||mvn test -Dtest=TestClient||
- 
- For more on the [[http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html|mvn
lifecycles...]]
- 
- 
- <<Anchor(otherjar)>>
- == 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>
- }}}
- 
- 
- <<Anchor(newjar)>>
- == How do I add a new dependency to the project? ==
- 
- You need to add the required jars as <dependency> entries to the <dependencies>
element of core/pom.xml.
- 

Mime
View raw message