Updated Branches: refs/heads/sqoop2 78f689869 -> 073d37c72
SQOOP-939: Sqoop2: devguide: Document how to open project in Eclipse (Vasanth kumar RJ via Jarek Jarcec Cecho) Project: http://git-wip-us.apache.org/repos/asf/sqoop/repo Commit: http://git-wip-us.apache.org/repos/asf/sqoop/commit/073d37c7 Tree: http://git-wip-us.apache.org/repos/asf/sqoop/tree/073d37c7 Diff: http://git-wip-us.apache.org/repos/asf/sqoop/diff/073d37c7 Branch: refs/heads/sqoop2 Commit: 073d37c726fceb26149fc133babba54376986442 Parents: 78f6898 Author: Jarek Jarcec Cecho <[email protected]> Authored: Sat Apr 6 16:05:58 2013 -0700 Committer: Jarek Jarcec Cecho <[email protected]> Committed: Sat Apr 6 16:05:58 2013 -0700 ---------------------------------------------------------------------- docs/src/site/sphinx/DevEnv.rst | 57 ++++++++++++++++++++++++++++++++++ docs/src/site/sphinx/index.rst | 1 + 2 files changed, 58 insertions(+), 0 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/sqoop/blob/073d37c7/docs/src/site/sphinx/DevEnv.rst ---------------------------------------------------------------------- diff --git a/docs/src/site/sphinx/DevEnv.rst b/docs/src/site/sphinx/DevEnv.rst new file mode 100644 index 0000000..1fd55de --- /dev/null +++ b/docs/src/site/sphinx/DevEnv.rst @@ -0,0 +1,57 @@ +.. Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +===================================== +Sqoop 2 Development Environment Setup +===================================== + +This document describes you how to setup development environment for Sqoop 2. + +System Requirement +================== + +Java +---- + +Sqoop written in Java and using version 1.6. You can `download java <http://www.oracle.com/technetwork/java/javase/downloads/index.html>`_ and install. Locate JAVA_HOME to installed directroy, e.g. export JAVA_HOME=/usr/lib/jvm/jdk1.6.0_32. + +Maven +----- + +Sqoop uses Maven 3 for building the project. Download `Maven <http://maven.apache.org/download.cgi>`_ and its Installation instructions given in `link <http://maven.apache.org/download.cgi#Maven_Documentation>`_. + +Eclipse Setup +============= + +Steps for downloading source code is given in `Building Sqoop2 <BuildingSqoop2.html>`_ + +Sqoop 2 project has multiple modules where one module is depend on another module for e.g. sqoop 2 client module has sqoop 2 common module dependency. Follow below step for creating eclipse's project and classpath for each module. + +:: + + //Install all package into local maven repository + mvn clean install -DskipTests + + //Adding M2_REPO variable to eclipse workspace + mvn eclipse:configure-workspace -Declipse.workspace=<path-to-eclipse-workspace-dir-for-sqoop-2> + + //Eclipse project creation with optional parameters + mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true + +Alternatively, for manually adding M2_REPO classpath variable as maven repository path in eclipse-> window-> Java ->Classpath Variables ->Click "New" ->In new dialog box, input Name as M2_REPO and Path as $HOME/.m2/repository ->click Ok. + +On successful execution of above maven commands, Then import the sqoop project modules into eclipse-> File -> Import ->General ->Existing Projects into Workspace-> Click Next-> Browse Sqoop 2 directory ($HOME/git/sqoop2) ->Click Ok ->Import dialog shows multiple projects (sqoop-client, sqoop-common, etc.) -> Select all modules -> click Finish. + http://git-wip-us.apache.org/repos/asf/sqoop/blob/073d37c7/docs/src/site/sphinx/index.rst ---------------------------------------------------------------------- diff --git a/docs/src/site/sphinx/index.rst b/docs/src/site/sphinx/index.rst index 02dce33..07f1c31 100644 --- a/docs/src/site/sphinx/index.rst +++ b/docs/src/site/sphinx/index.rst @@ -59,3 +59,4 @@ Developer Guide --------------- - `Building Sqoop2 <BuildingSqoop2.html>`_ +- `Development Environment Setup <DevEnv.html>`_
