sqoop-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r843843 [1/4] - in /websites/staging/sqoop/trunk/content: ./ docs/1.99.1/ docs/1.99.1/_sources/ docs/1.99.1/_static/ docs/1.99.1/css/ docs/1.99.1/images/ docs/1.99.1/images/logos/
Date Wed, 26 Dec 2012 05:47:55 GMT
Author: buildbot
Date: Wed Dec 26 05:47:54 2012
New Revision: 843843

Log:
Staging update by buildbot for sqoop

Added:
    websites/staging/sqoop/trunk/content/docs/1.99.1/
    websites/staging/sqoop/trunk/content/docs/1.99.1/CommandLineClient.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/Installation.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/Sqoop5MinutesDemo.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/
    websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/CommandLineClient.txt
    websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/Installation.txt
    websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/Sqoop5MinutesDemo.txt
    websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/index.txt
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/ajax-loader.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/alert_info_32.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/alert_warning_32.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/basic.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/bg-page.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/bullet_orange.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/comment-bright.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/comment-close.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/comment.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/doctools.js
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/down-pressed.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/down.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/file.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/haiku.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/jquery.js
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/minus.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/plus.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/pygments.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/searchtools.js
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/sqoop-logo.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/underscore.js
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/up-pressed.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/up.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/_static/websupport.js
    websites/staging/sqoop/trunk/content/docs/1.99.1/css/
    websites/staging/sqoop/trunk/content/docs/1.99.1/css/maven-base.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/css/maven-theme.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/css/print.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/css/site.css
    websites/staging/sqoop/trunk/content/docs/1.99.1/genindex.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/collapsed.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/expanded.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/external.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/icon_error_sml.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/icon_info_sml.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/icon_success_sml.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/icon_warning_sml.gif   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/logos/
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/logos/build-by-maven-black.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/logos/build-by-maven-white.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/logos/maven-feather.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/images/newwindow.png   (with props)
    websites/staging/sqoop/trunk/content/docs/1.99.1/index.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/project-reports.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/search.html
    websites/staging/sqoop/trunk/content/docs/1.99.1/searchindex.js
Modified:
    websites/staging/sqoop/trunk/content/   (props changed)

Propchange: websites/staging/sqoop/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Dec 26 05:47:54 2012
@@ -1 +1 @@
-1417253
+1425839

Added: websites/staging/sqoop/trunk/content/docs/1.99.1/CommandLineClient.html
==============================================================================
--- websites/staging/sqoop/trunk/content/docs/1.99.1/CommandLineClient.html (added)
+++ websites/staging/sqoop/trunk/content/docs/1.99.1/CommandLineClient.html Wed Dec 26 05:47:54 2012
@@ -0,0 +1,768 @@
+
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    
+    <title>Command Line Client &mdash; Apache Sqoop  documentation</title>
+    
+    <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <link rel="stylesheet" href="_static/print.css" type="text/css" />
+    
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <script type="text/javascript" src="_static/theme_extras.js"></script>
+    <link rel="top" title="Apache Sqoop  documentation" href="index.html" /> 
+  </head>
+  <body>
+      <div class="header"><img class="rightlogo" src="_static/sqoop-logo.png" alt="Logo"/><h1 class="heading"><a href="index.html">
+          <span>Apache Sqoop  documentation</span></a></h1>
+        <h2 class="heading"><span>Command Line Client</span></h2>
+      </div>
+      <div class="topnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+      <div class="content">
+        
+        
+  <div class="section" id="command-line-client">
+<h1><a class="toc-backref" href="#id1">Command Line Client</a><a class="headerlink" href="#command-line-client" title="Permalink to this headline">¶</a></h1>
+<p>Sqoop 2 provides command line client that is capable of communicating with Sqoop 2 server using REST interface. Client is able to run in two modes - interactive and batch mode. Commands <tt class="docutils literal"><span class="pre">create</span></tt>, <tt class="docutils literal"><span class="pre">update</span></tt> and <tt class="docutils literal"><span class="pre">clone</span></tt> are not currently supported in batch mode. Interactive mode supports all available commands.</p>
+<p>You can start Sqoop 2 client in interactive mode using provided <tt class="docutils literal"><span class="pre">sqoop.sh</span></tt> shell script by passing argument <tt class="docutils literal"><span class="pre">client</span></tt>:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop.sh client
+</pre></div>
+</div>
+<p>Batch mode can be started by adding additional argument representing path to your Sqoop client script:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop.sh client /path/to/your/script.sqoop
+</pre></div>
+</div>
+<p>Sqoop client script is expected to contain valid Sqoop client commands, empty lines and lines starting with <tt class="docutils literal"><span class="pre">#</span></tt> that are denoting comment lines. Comments and empty lines are ignored, all other lines are interpreted. Example script:</p>
+<div class="highlight-none"><div class="highlight"><pre># Specify company server
+set server --host sqoop2.company.net
+
+# Executing given job
+submission start --jid 1
+</pre></div>
+</div>
+<div class="contents topic" id="table-of-contents">
+<p class="topic-title first">Table of Contents</p>
+<ul class="simple">
+<li><a class="reference internal" href="#command-line-client" id="id1">Command Line Client</a><ul>
+<li><a class="reference internal" href="#resource-file" id="id2">Resource file</a></li>
+<li><a class="reference internal" href="#commands" id="id3">Commands</a><ul>
+<li><a class="reference internal" href="#auxiliary-commands" id="id4">Auxiliary Commands</a></li>
+<li><a class="reference internal" href="#set-command" id="id5">Set Command</a><ul>
+<li><a class="reference internal" href="#set-server-function" id="id6">Set Server Function</a></li>
+<li><a class="reference internal" href="#set-option-function" id="id7">Set Option Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#show-command" id="id8">Show Command</a><ul>
+<li><a class="reference internal" href="#show-server-function" id="id9">Show Server Function</a></li>
+<li><a class="reference internal" href="#show-version-function" id="id10">Show Version Function</a></li>
+<li><a class="reference internal" href="#show-connector-function" id="id11">Show Connector Function</a></li>
+<li><a class="reference internal" href="#show-framework-function" id="id12">Show Framework Function</a></li>
+<li><a class="reference internal" href="#show-connection-function" id="id13">Show Connection Function</a></li>
+<li><a class="reference internal" href="#show-job-function" id="id14">Show Job Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#create-command" id="id15">Create Command</a><ul>
+<li><a class="reference internal" href="#create-connection-function" id="id16">Create Connection Function</a></li>
+<li><a class="reference internal" href="#create-job-function" id="id17">Create Job Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#update-command" id="id18">Update Command</a><ul>
+<li><a class="reference internal" href="#update-connection-function" id="id19">Update Connection Function</a></li>
+<li><a class="reference internal" href="#update-job-function" id="id20">Update Job Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#delete-command" id="id21">Delete Command</a><ul>
+<li><a class="reference internal" href="#delete-connection-function" id="id22">Delete Connection Function</a></li>
+<li><a class="reference internal" href="#delete-job-function" id="id23">Delete Job Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#clone-command" id="id24">Clone Command</a><ul>
+<li><a class="reference internal" href="#clone-connection-function" id="id25">Clone Connection Function</a></li>
+<li><a class="reference internal" href="#clone-job-function" id="id26">Clone Job Function</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#submission-command" id="id27">Submission Command</a><ul>
+<li><a class="reference internal" href="#submission-start-function" id="id28">Submission Start Function</a></li>
+<li><a class="reference internal" href="#submission-stop-function" id="id29">Submission Stop Function</a></li>
+<li><a class="reference internal" href="#submission-status-function" id="id30">Submission Status Function</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="resource-file">
+<h2><a class="toc-backref" href="#id2">Resource file</a><a class="headerlink" href="#resource-file" title="Permalink to this headline">¶</a></h2>
+<p>Sqoop 2 client have ability to load resource files similarly as other command line tools. At the beginning of execution Sqoop client will check existence of file <tt class="docutils literal"><span class="pre">.sqoop2rc</span></tt> in home directory of currently logged user. If such file exists, it will be interpreted before any additional actions. This file is loaded in both interactive and batch mode. It can be used to execute any batch compatible commands.</p>
+<p>Example resource file:</p>
+<div class="highlight-none"><div class="highlight"><pre># Configure our Sqoop 2 server automatically
+set server --host sqoop2.company.net
+
+# Run in verbose mode by default
+set option --name verbose --value true
+</pre></div>
+</div>
+</div>
+<div class="section" id="commands">
+<h2><a class="toc-backref" href="#id3">Commands</a><a class="headerlink" href="#commands" title="Permalink to this headline">¶</a></h2>
+<p>Sqoop 2 contains several commands that will be documented in this section. Each command have one more functions that are accepting various arguments. Not all commands are supported in both interactive and batch mode.</p>
+<div class="section" id="auxiliary-commands">
+<h3><a class="toc-backref" href="#id4">Auxiliary Commands</a><a class="headerlink" href="#auxiliary-commands" title="Permalink to this headline">¶</a></h3>
+<p>Auxiliary commands are commands that are improving user experience and are running purely on client side. Thus they do not need working connection to the server.</p>
+<ul class="simple">
+<li><tt class="docutils literal"><span class="pre">exit</span></tt> Exit client immediately. This command can be also executed by sending EOT (end of transmission) character. It&#8217;s CTRL+D on most common Linux shells like Bash or Zsh.</li>
+<li><tt class="docutils literal"><span class="pre">history</span></tt> Print out command history. Please note that Sqoop client is saving history from previous executions and thus you might see commands that you&#8217;ve executed in previous runs.</li>
+<li><tt class="docutils literal"><span class="pre">help</span></tt> Show all available commands with short in-shell documentation.</li>
+</ul>
+</div>
+<div class="section" id="set-command">
+<h3><a class="toc-backref" href="#id5">Set Command</a><a class="headerlink" href="#set-command" title="Permalink to this headline">¶</a></h3>
+<p>Set command allows to set various properties of the client. Similarly as auxiliary commands, set do not require connection to Sqoop server. Set commands is not used to reconfigure Sqoop server.</p>
+<p>Available functions:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="26%" />
+<col width="74%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Function</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">server</span></tt></td>
+<td>Set connection configuration for server</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">option</span></tt></td>
+<td>Set various client side options</td>
+</tr>
+</tbody>
+</table>
+<div class="section" id="set-server-function">
+<h4><a class="toc-backref" href="#id6">Set Server Function</a><a class="headerlink" href="#set-server-function" title="Permalink to this headline">¶</a></h4>
+<p>Configure connection to Sqoop server - host port and web application name. Available arguments:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="26%" />
+<col width="17%" />
+<col width="57%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Default value</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--host</span></tt></td>
+<td>localhost</td>
+<td>Server name (FQDN) where Sqoop server is running</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-p</span></tt>, <tt class="docutils literal"><span class="pre">--port</span></tt></td>
+<td>8080</td>
+<td>TCP Port</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--webapp</span></tt></td>
+<td>sqoop</td>
+<td>Tomcat&#8217;s web application name</td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>set server --host sqoop2.company.net --port 80 --webapp sqoop
+</pre></div>
+</div>
+</div>
+<div class="section" id="set-option-function">
+<h4><a class="toc-backref" href="#id7">Set Option Function</a><a class="headerlink" href="#set-option-function" title="Permalink to this headline">¶</a></h4>
+<p>Configure Sqoop client related options. This function have two required arguments <tt class="docutils literal"><span class="pre">name</span></tt> and <tt class="docutils literal"><span class="pre">value</span></tt>. Name represents internal property name and value holds new value that should be set. List of available option names follows:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="18%" />
+<col width="15%" />
+<col width="67%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Option name</th>
+<th class="head">Default value</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">verbose</span></tt></td>
+<td>false</td>
+<td>Client will print additional information if verbose mode is enabled</td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>set option --name verbose --value true
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="show-command">
+<h3><a class="toc-backref" href="#id8">Show Command</a><a class="headerlink" href="#show-command" title="Permalink to this headline">¶</a></h3>
+<p>Show commands displays various information including server and protocol versions or all stored meta data.</p>
+<p>Available functions:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="13%" />
+<col width="87%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Function</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">server</span></tt></td>
+<td>Display connection information to the server (host, port, webapp)</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">version</span></tt></td>
+<td>Show version of both client and server (build numbers, supported protocols)</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">connector</span></tt></td>
+<td>Show connector meta data - set of parameters that connectors needs to create connections and jobs</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">framework</span></tt></td>
+<td>Show framework meta data - set of parameters that Sqoop framework needs to create connections and jobs</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">connection</span></tt></td>
+<td>Show created connection meta data objects</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">job</span></tt></td>
+<td>Show created job meta data objects</td>
+</tr>
+</tbody>
+</table>
+<div class="section" id="show-server-function">
+<h4><a class="toc-backref" href="#id9">Show Server Function</a><a class="headerlink" href="#show-server-function" title="Permalink to this headline">¶</a></h4>
+<p>Show details about configuration connection to Sqoop server.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="27%" />
+<col width="73%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></td>
+<td>Show all connection related information (host, port, webapp)</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--host</span></tt></td>
+<td>Show host</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-p</span></tt>, <tt class="docutils literal"><span class="pre">--port</span></tt></td>
+<td>Show port</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--webapp</span></tt></td>
+<td>Show web application name</td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show server --all
+</pre></div>
+</div>
+</div>
+<div class="section" id="show-version-function">
+<h4><a class="toc-backref" href="#id10">Show Version Function</a><a class="headerlink" href="#show-version-function" title="Permalink to this headline">¶</a></h4>
+<p>Show versions of both client and server as well as supported protocols.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="34%" />
+<col width="66%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></td>
+<td>Show all versions (server, client, protocols)</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-c</span></tt>, <tt class="docutils literal"><span class="pre">--client</span></tt></td>
+<td>Show client version</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-s</span></tt>, <tt class="docutils literal"><span class="pre">--server</span></tt></td>
+<td>Show server version</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-p</span></tt>, <tt class="docutils literal"><span class="pre">--protocol</span></tt></td>
+<td>Show protocol support on client or server</td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show version --all
+</pre></div>
+</div>
+</div>
+<div class="section" id="show-connector-function">
+<h4><a class="toc-backref" href="#id11">Show Connector Function</a><a class="headerlink" href="#show-connector-function" title="Permalink to this headline">¶</a></h4>
+<p>Show connector meta data - parameters that connectors need in order to create new connection and job objects.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="32%" />
+<col width="68%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></td>
+<td>Show information for all connectors</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-c</span></tt>, <tt class="docutils literal"><span class="pre">--cid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Show information for connector with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show connector --all
+</pre></div>
+</div>
+</div>
+<div class="section" id="show-framework-function">
+<h4><a class="toc-backref" href="#id12">Show Framework Function</a><a class="headerlink" href="#show-framework-function" title="Permalink to this headline">¶</a></h4>
+<p>Show framework meta data - parameters that Sqoop framework need in order to create new connection and job objects.</p>
+<p>This function do not have any extra arguments.</p>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show framework
+</pre></div>
+</div>
+</div>
+<div class="section" id="show-connection-function">
+<h4><a class="toc-backref" href="#id13">Show Connection Function</a><a class="headerlink" href="#show-connection-function" title="Permalink to this headline">¶</a></h4>
+<p>Show persisted connection objects.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="30%" />
+<col width="70%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></td>
+<td>Show all available connections from all connectors</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-x</span></tt>, <tt class="docutils literal"><span class="pre">--xid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Show connection with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show connection --all
+</pre></div>
+</div>
+</div>
+<div class="section" id="show-job-function">
+<h4><a class="toc-backref" href="#id14">Show Job Function</a><a class="headerlink" href="#show-job-function" title="Permalink to this headline">¶</a></h4>
+<p>Show persisted job objects.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="33%" />
+<col width="67%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all</span></tt></td>
+<td>Show all available jobs from all connectors</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Show job with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>show job --all
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="create-command">
+<h3><a class="toc-backref" href="#id15">Create Command</a><a class="headerlink" href="#create-command" title="Permalink to this headline">¶</a></h3>
+<p>Creates new connection and job objects. This command is supported only in interactive mode. It will query user for all parameters that are required by specific connector and framework and persist them in Sqoop server for later use.</p>
+<p>Available functions:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="25%" />
+<col width="75%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Function</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">connection</span></tt></td>
+<td>Create new connection object</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">job</span></tt></td>
+<td>Create new job object</td>
+</tr>
+</tbody>
+</table>
+<div class="section" id="create-connection-function">
+<h4><a class="toc-backref" href="#id16">Create Connection Function</a><a class="headerlink" href="#create-connection-function" title="Permalink to this headline">¶</a></h4>
+<p>Create new connection object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="28%" />
+<col width="72%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-c</span></tt>, <tt class="docutils literal"><span class="pre">--cid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Create new connection object for connector with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>create connection --cid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="create-job-function">
+<h4><a class="toc-backref" href="#id17">Create Job Function</a><a class="headerlink" href="#create-job-function" title="Permalink to this headline">¶</a></h4>
+<p>Create new job object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="27%" />
+<col width="73%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-x</span></tt>, <tt class="docutils literal"><span class="pre">--xid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Create new job object for connection with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">-t</span></tt>, <tt class="docutils literal"><span class="pre">--type</span> <span class="pre">&lt;t&gt;</span></tt></td>
+<td>Create new job object with type <tt class="docutils literal"><span class="pre">&lt;t&gt;</span></tt> (<tt class="docutils literal"><span class="pre">import</span></tt>, <tt class="docutils literal"><span class="pre">export</span></tt>)</td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>create job --xid 1
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="update-command">
+<h3><a class="toc-backref" href="#id18">Update Command</a><a class="headerlink" href="#update-command" title="Permalink to this headline">¶</a></h3>
+<p>Update commands allows you to edit connection and job objects - change persisted meta data. This command is supported only in interactive mode.</p>
+<div class="section" id="update-connection-function">
+<h4><a class="toc-backref" href="#id19">Update Connection Function</a><a class="headerlink" href="#update-connection-function" title="Permalink to this headline">¶</a></h4>
+<p>Update existing connection object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="34%" />
+<col width="66%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-x</span></tt>, <tt class="docutils literal"><span class="pre">--xid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Update existing connection with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>update connection --xid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="update-job-function">
+<h4><a class="toc-backref" href="#id20">Update Job Function</a><a class="headerlink" href="#update-job-function" title="Permalink to this headline">¶</a></h4>
+<p>Update existing job object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="34%" />
+<col width="66%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Update existing job object with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>update job --jid 1
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="delete-command">
+<h3><a class="toc-backref" href="#id21">Delete Command</a><a class="headerlink" href="#delete-command" title="Permalink to this headline">¶</a></h3>
+<p>Deletes connection and job objects from Sqoop server.</p>
+<div class="section" id="delete-connection-function">
+<h4><a class="toc-backref" href="#id22">Delete Connection Function</a><a class="headerlink" href="#delete-connection-function" title="Permalink to this headline">¶</a></h4>
+<p>Delete existing connection object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-x</span></tt>, <tt class="docutils literal"><span class="pre">--xid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Delete connection object with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>delete connection --xid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="delete-job-function">
+<h4><a class="toc-backref" href="#id23">Delete Job Function</a><a class="headerlink" href="#delete-job-function" title="Permalink to this headline">¶</a></h4>
+<p>Delete existing job object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Delete job object with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>delete job --jid 1
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="clone-command">
+<h3><a class="toc-backref" href="#id24">Clone Command</a><a class="headerlink" href="#clone-command" title="Permalink to this headline">¶</a></h3>
+<p>Clone command will load existing connection or job object from Sqoop server and allow user in place changes that will result in creation of new connection or job object. This command is not supported in batch mode.</p>
+<div class="section" id="clone-connection-function">
+<h4><a class="toc-backref" href="#id25">Clone Connection Function</a><a class="headerlink" href="#clone-connection-function" title="Permalink to this headline">¶</a></h4>
+<p>Clone existing connection object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-x</span></tt>, <tt class="docutils literal"><span class="pre">--xid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Clone connection object with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>clone connection --xid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="clone-job-function">
+<h4><a class="toc-backref" href="#id26">Clone Job Function</a><a class="headerlink" href="#clone-job-function" title="Permalink to this headline">¶</a></h4>
+<p>Clone existing job object.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Clone job object with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>clone job --jid 1
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="submission-command">
+<h3><a class="toc-backref" href="#id27">Submission Command</a><a class="headerlink" href="#submission-command" title="Permalink to this headline">¶</a></h3>
+<p>Submission command is entry point for executing actual data transfers. It allows you to start, stop and retrieve status of currently running jobs.</p>
+<p>Available functions:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="25%" />
+<col width="75%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Function</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">start</span></tt></td>
+<td>Start job</td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">stop</span></tt></td>
+<td>Interrupt running job</td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">status</span></tt></td>
+<td>Retrieve status for given job</td>
+</tr>
+</tbody>
+</table>
+<div class="section" id="submission-start-function">
+<h4><a class="toc-backref" href="#id28">Submission Start Function</a><a class="headerlink" href="#submission-start-function" title="Permalink to this headline">¶</a></h4>
+<p>Start job (submit new submission). Starting already running job is considered as invalid operation.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="46%" />
+<col width="54%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Start job with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>submission start --jid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="submission-stop-function">
+<h4><a class="toc-backref" href="#id29">Submission Stop Function</a><a class="headerlink" href="#submission-stop-function" title="Permalink to this headline">¶</a></h4>
+<p>Interrupt running job.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Interrupt running job with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>submission stop --jid 1
+</pre></div>
+</div>
+</div>
+<div class="section" id="submission-status-function">
+<h4><a class="toc-backref" href="#id30">Submission Status Function</a><a class="headerlink" href="#submission-status-function" title="Permalink to this headline">¶</a></h4>
+<p>Retrieve last status for given job.</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="35%" />
+<col width="65%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Argument</th>
+<th class="head">Description</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">-j</span></tt>, <tt class="docutils literal"><span class="pre">--jid</span> <span class="pre">&lt;x&gt;</span></tt></td>
+<td>Retrieve status for job with id <tt class="docutils literal"><span class="pre">&lt;x&gt;</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Example:</p>
+<div class="highlight-none"><div class="highlight"><pre>submission status --jid 1
+</pre></div>
+</div>
+</div>
+</div>
+</div>
+</div>
+
+
+      </div>
+      <div class="bottomnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+
+    <div class="footer">
+        &copy; Copyright 2009-2012 The Apache Software Foundation.
+    </div>
+  </body>
+</html>
\ No newline at end of file

Added: websites/staging/sqoop/trunk/content/docs/1.99.1/Installation.html
==============================================================================
--- websites/staging/sqoop/trunk/content/docs/1.99.1/Installation.html (added)
+++ websites/staging/sqoop/trunk/content/docs/1.99.1/Installation.html Wed Dec 26 05:47:54 2012
@@ -0,0 +1,124 @@
+
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    
+    <title>Installation &mdash; Apache Sqoop  documentation</title>
+    
+    <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <link rel="stylesheet" href="_static/print.css" type="text/css" />
+    
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <script type="text/javascript" src="_static/theme_extras.js"></script>
+    <link rel="top" title="Apache Sqoop  documentation" href="index.html" /> 
+  </head>
+  <body>
+      <div class="header"><img class="rightlogo" src="_static/sqoop-logo.png" alt="Logo"/><h1 class="heading"><a href="index.html">
+          <span>Apache Sqoop  documentation</span></a></h1>
+        <h2 class="heading"><span>Installation</span></h2>
+      </div>
+      <div class="topnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+      <div class="content">
+        
+        
+  <div class="section" id="installation">
+<h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
+<p>Sqoop ships as one binary package however it&#8217;s compound from two separate parts - client and server. You need to install server on single node in your cluster. This node will then serve as an entry point for all connecting Sqoop clients. Server acts as a mapreduce client and therefore Hadoop must be installed and configured on machine hosting Sqoop server. Clients can be installed on any arbitrary number of machines. Client is not acting as a mapreduce client and thus you do not need to install Hadoop on nodes that will act only as a Sqoop client.</p>
+<div class="section" id="server-installation">
+<h2>Server installation<a class="headerlink" href="#server-installation" title="Permalink to this headline">¶</a></h2>
+<p>Copy Sqoop artifact on machine where you want to run Sqoop server. This machine must have installed and configured Hadoop. You don&#8217;t need to run any Hadoop related services there, however the machine must be able to act as an Hadoop client. You should be able to list a HDFS for example:</p>
+<div class="highlight-none"><div class="highlight"><pre>hadoop dfs -ls
+</pre></div>
+</div>
+<p>Sqoop server supports multiple Hadoop versions. However as Hadoop major versions are not compatible with each other, Sqoop have multiple binary artefacts - one for each supported major version of Hadoop. You need to make sure that you&#8217;re using appropriated binary artifact for your specific Hadoop version. To install Sqoop server decompress appropriate distribution artifact in location at your convenience and change your working directory to this folder.</p>
+<div class="highlight-none"><div class="highlight"><pre># Decompress Sqoop distribution tarball
+tar -xvf sqoop-&lt;version&gt;-bin-hadoop&lt;hadoop-version&gt;.tar.gz
+
+# Move decompressed content to any location
+mv sqoop-&lt;version&gt;-bin-hadoop&lt;hadoop version&gt;.tar.gz /usr/lib/sqoop
+
+# Change working directory
+cd /usr/lib/sqoop
+</pre></div>
+</div>
+<div class="section" id="installing-dependencies">
+<h3>Installing Dependencies<a class="headerlink" href="#installing-dependencies" title="Permalink to this headline">¶</a></h3>
+<p>You need to install Hadoop libraries into Sqoop server war file. Sqoop provides convenience script <tt class="docutils literal"><span class="pre">addtowar.sh</span></tt> to do so. If you have installed Hadoop in usual location in <tt class="docutils literal"><span class="pre">/usr/lib</span></tt> and executable <tt class="docutils literal"><span class="pre">hadoop</span></tt> is in your path, you can use automatic Hadoop installation procedure:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/addtowar.sh -hadoop-auto
+</pre></div>
+</div>
+<p>In case that you have Hadoop installed in different location, you will need to manually specify Hadoop version and path to Hadoop libraries. You can use parameter <tt class="docutils literal"><span class="pre">-hadoop-version</span></tt> for specifying Hadoop major version, we&#8217;re currently support versions 1.x and 2.x. Path to Hadoop libraries can be specified using <tt class="docutils literal"><span class="pre">-hadoop-path</span></tt> parameter. In case that your Hadoop libraries are in multiple different folders, you can specify all of them separated by <tt class="docutils literal"><span class="pre">:</span></tt>.  Example of manual installation:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/addtowar.sh -hadoop-version 2.0 -hadoop-path /usr/lib/hadoop-common:/usr/lib/hadoop-hdfs:/usr/lib/hadoop-yarn
+</pre></div>
+</div>
+<p>Lastly you might need to install JDBC drivers that are not bundled with Sqoop because of incompatible licenses. You can add any arbitrary java jar file to Sqoop server using script <tt class="docutils literal"><span class="pre">addtowar.sh</span></tt> with <tt class="docutils literal"><span class="pre">-jars</span></tt> parameter. Similarly as in case of hadoop path you can enter multiple jars separated with <tt class="docutils literal"><span class="pre">:</span></tt>. Example of installing MySQL JDBC driver to Sqoop server:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/addtowar.sh -jars /path/to/jar/mysql-connector-java-*-bin.jar
+</pre></div>
+</div>
+</div>
+<div class="section" id="configuring-server">
+<h3>Configuring Server<a class="headerlink" href="#configuring-server" title="Permalink to this headline">¶</a></h3>
+<p>Before starting server you should revise configuration to match your specific environment. Server configuration files are stored in <tt class="docutils literal"><span class="pre">server/config</span></tt> directory of distributed artifact along side with other configuration files of Tomcat.</p>
+<p>File <tt class="docutils literal"><span class="pre">sqoop_bootstrap.properties</span></tt> specifies which configuration provider should be used for loading configuration for rest of Sqoop server. Default value <tt class="docutils literal"><span class="pre">PropertiesConfigurationProvider</span></tt> should be sufficient.</p>
+<p>Second configuration file <tt class="docutils literal"><span class="pre">sqoop.properties</span></tt> contains remaining configuration properties that can affect Sqoop server. File is very well documented, so check if all configuration properties fits your environment. Default or very little tweaking should be sufficient most common cases.</p>
+</div>
+<div class="section" id="server-life-cycle">
+<h3>Server Life Cycle<a class="headerlink" href="#server-life-cycle" title="Permalink to this headline">¶</a></h3>
+<p>After installation and configuration you can start Sqoop server with following command:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/sqoop.sh server start
+</pre></div>
+</div>
+<p>Similarly you can stop server using following command:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/sqoop.sh server stop
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="client-installation">
+<h2>Client installation<a class="headerlink" href="#client-installation" title="Permalink to this headline">¶</a></h2>
+<p>Client do not need extra installation and configuration steps. Just copy Sqoop distribution artifact on target machine and unzip it in desired location. You can start client with following command:</p>
+<div class="highlight-none"><div class="highlight"><pre>bin/sqoop.sh client
+</pre></div>
+</div>
+<p>You can find more documentation to Sqoop client in <a class="reference external" href="CommandLineClient.html">Command Line Client</a> section.</p>
+</div>
+</div>
+
+
+      </div>
+      <div class="bottomnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+
+    <div class="footer">
+        &copy; Copyright 2009-2012 The Apache Software Foundation.
+    </div>
+  </body>
+</html>
\ No newline at end of file

Added: websites/staging/sqoop/trunk/content/docs/1.99.1/Sqoop5MinutesDemo.html
==============================================================================
--- websites/staging/sqoop/trunk/content/docs/1.99.1/Sqoop5MinutesDemo.html (added)
+++ websites/staging/sqoop/trunk/content/docs/1.99.1/Sqoop5MinutesDemo.html Wed Dec 26 05:47:54 2012
@@ -0,0 +1,198 @@
+
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    
+    <title>Sqoop 5 Minutes Demo &mdash; Apache Sqoop  documentation</title>
+    
+    <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <link rel="stylesheet" href="_static/print.css" type="text/css" />
+    
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <script type="text/javascript" src="_static/theme_extras.js"></script>
+    <link rel="top" title="Apache Sqoop  documentation" href="index.html" /> 
+  </head>
+  <body>
+      <div class="header"><img class="rightlogo" src="_static/sqoop-logo.png" alt="Logo"/><h1 class="heading"><a href="index.html">
+          <span>Apache Sqoop  documentation</span></a></h1>
+        <h2 class="heading"><span>Sqoop 5 Minutes Demo</span></h2>
+      </div>
+      <div class="topnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+      <div class="content">
+        
+        
+  <div class="section" id="sqoop-5-minutes-demo">
+<h1>Sqoop 5 Minutes Demo<a class="headerlink" href="#sqoop-5-minutes-demo" title="Permalink to this headline">¶</a></h1>
+<p>This page will walk you through basic usage of Sqoop. You need to have installed and configured Sqoop server and client in order to follow this guide. Installation procedure is described on <a class="reference external" href="Installation.html">Installation page</a>. Please note that precise output shown in this page might differ from your as Sqoop develops. All major information should however remain the same.</p>
+<p>Sqoop is using numerical identifiers to identify various meta data structures (connectors, connections, jobs). Each meta data structures have it&#8217;s own pool of identifiers and thus it&#8217;s perfectly valid when Sqoop have connector with id 1, connection with id 1 and job with id 1 at the same time.</p>
+<div class="section" id="starting-client">
+<h2>Starting Client<a class="headerlink" href="#starting-client" title="Permalink to this headline">¶</a></h2>
+<p>Start client in interactive mode using following command:</p>
+<div class="highlight-none"><div class="highlight"><pre>./bin/sqoop.sh client
+</pre></div>
+</div>
+<p>Configure client to use your Sqoop server:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; set server --host your.host.com --port 8080 --webapp sqoop
+</pre></div>
+</div>
+<p>Verify that connection is working by simple version checking:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; show version --all
+Server version:
+  Sqoop 2.0.0-SNAPSHOT revision Unknown
+  Compiled by jarcec on Wed Nov 21 16:15:51 PST 2012
+Client version:
+  Sqoop 2.0.0-SNAPSHOT revision Unknown
+  Compiled by jarcec on Wed Nov 21 16:15:51 PST 2012
+Protocol version:
+  [1]
+</pre></div>
+</div>
+<p>You should received similar output as shown describing versions of both your client and remote server as well as negotiated protocol version.</p>
+</div>
+<div class="section" id="creating-connection-object">
+<h2>Creating Connection Object<a class="headerlink" href="#creating-connection-object" title="Permalink to this headline">¶</a></h2>
+<p>Check what connectors are available on your Sqoop server:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; show connector --all
+1 connector(s) to show:
+Connector with id 1:
+  Name: generic-jdbc-connector
+  Class: org.apache.sqoop.connector.jdbc.GenericJdbcConnector
+  Supported job types: [EXPORT, IMPORT]
+...
+</pre></div>
+</div>
+<p>Our example contains one connector called <tt class="docutils literal"><span class="pre">generic-jdbc-connector</span></tt>. This is basic connector that is relying on Java JDBC interface for doing data transfers. It should work on most common databases that are providing JDBC drivers. Please note that you must install JDBC drivers separately. They are not bundled in Sqoop due to incompatible licenses.</p>
+<p>Generic JDBC Connector have in our example id 1 and we will use this value to create new connection object for this connector:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; create connection --cid 1
+Creating connection for connector with id 1
+Please fill following values to create new connection object
+Name: First connection
+
+Configuration configuration
+JDBC Driver Class: com.mysql.jdbc.Driver
+JDBC Connection String: jdbc:mysql://mysql.server/database
+Username: sqoop
+Password: *****
+JDBC Connection Properties:
+There are currently 0 values in the map:
+entry#
+
+Security related configuration options
+Max connections: 0
+New connection was successfully created with validation status FINE and persistent id 1
+</pre></div>
+</div>
+<p>Our new connection object was created with assigned id 1.</p>
+</div>
+<div class="section" id="creating-job-object">
+<h2>Creating Job Object<a class="headerlink" href="#creating-job-object" title="Permalink to this headline">¶</a></h2>
+<p>Job objects have multiple types and each connector might not support all of them. Generic JDBC Connector supports job types <tt class="docutils literal"><span class="pre">import</span></tt> (importing data to Hadoop ecosystem) and <tt class="docutils literal"><span class="pre">export</span></tt> (exporting data from Hadoop ecosystem). List of supported job types for each connector might be seen in the output of <tt class="docutils literal"><span class="pre">show</span> <span class="pre">connector</span></tt> command:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; show connector --all
+...
+  Name: generic-jdbc-connector
+...
+  Supported job types: [EXPORT, IMPORT]
+...
+</pre></div>
+</div>
+<p>Create import job for Connection object created in previous section:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; create job --xid 1 --type import
+Creating job for connection with id 1
+Please fill following values to create new job object
+Name: First job
+
+Database configuration
+Table name: users
+Table SQL statement:
+Table column names:
+Partition column name:
+Boundary query:
+
+Output configuration
+Storage type:
+  0 : HDFS
+Choose: 0
+Output directory: /user/jarcec/users
+New job was successfully created with validation status FINE and persistent id 1
+</pre></div>
+</div>
+<p>Our new job object was created with assigned id 1.</p>
+</div>
+<div class="section" id="moving-data">
+<h2>Moving Data<a class="headerlink" href="#moving-data" title="Permalink to this headline">¶</a></h2>
+<p>When all meta data objects are in place we can start moving data around. You can submit Hadoop job using <tt class="docutils literal"><span class="pre">submission</span> <span class="pre">start</span></tt> command:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; submission start --jid 1
+Submission details
+Job id: 1
+Status: BOOTING
+Creation date: 2012-20-23 13:20:34 PST
+Last update date: 2012-20-23 13:20:34 PST
+External Id: job_1353136146286_0004
+        http://hadoop.cluster.com:8088/proxy/application_1353136146286_0004/
+Progress: Progress is not available
+</pre></div>
+</div>
+<p>You can iteratively check your running job status with <tt class="docutils literal"><span class="pre">submission</span> <span class="pre">status</span></tt> command:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; submission status --jid 1
+Submission details
+Job id: 1
+Status: RUNNING
+Creation date: 2012-21-23 13:21:45 PST
+Last update date: 2012-21-23 13:21:56 PST
+External Id: job_1353136146286_0005
+        http://hadoop.cluster.com:8088/proxy/application_1353136146286_0004/
+Progress: 0.00 %
+</pre></div>
+</div>
+<p>And finally you can stop running job at any time using <tt class="docutils literal"><span class="pre">submission</span> <span class="pre">stop</span></tt> command:</p>
+<div class="highlight-none"><div class="highlight"><pre>sqoop:000&gt; submission stop --jid 1
+Submission details
+Job id: 1
+Status: FAILED
+Creation date: 2012-22-23 13:22:39 PST
+Last update date: 2012-22-23 13:22:42 PST
+External Id: job_1353136146286_0006
+        http://hadoop.cluster.com:8088/proxy/application_1353136146286_0004/
+</pre></div>
+</div>
+</div>
+</div>
+
+
+      </div>
+      <div class="bottomnav">
+      
+        <p>
+        <a class="uplink" href="index.html">Contents</a>
+        </p>
+
+      </div>
+
+    <div class="footer">
+        &copy; Copyright 2009-2012 The Apache Software Foundation.
+    </div>
+  </body>
+</html>
\ No newline at end of file

Added: websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/CommandLineClient.txt
==============================================================================
--- websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/CommandLineClient.txt (added)
+++ websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/CommandLineClient.txt Wed Dec 26 05:47:54 2012
@@ -0,0 +1,464 @@
+.. 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.
+
+
+===================
+Command Line Client
+===================
+
+Sqoop 2 provides command line client that is capable of communicating with Sqoop 2 server using REST interface. Client is able to run in two modes - interactive and batch mode. Commands ``create``, ``update`` and ``clone`` are not currently supported in batch mode. Interactive mode supports all available commands.
+
+You can start Sqoop 2 client in interactive mode using provided ``sqoop.sh`` shell script by passing argument ``client``: ::
+
+  sqoop.sh client
+
+Batch mode can be started by adding additional argument representing path to your Sqoop client script: ::
+
+  sqoop.sh client /path/to/your/script.sqoop
+
+Sqoop client script is expected to contain valid Sqoop client commands, empty lines and lines starting with ``#`` that are denoting comment lines. Comments and empty lines are ignored, all other lines are interpreted. Example script: ::
+
+  # Specify company server
+  set server --host sqoop2.company.net
+
+  # Executing given job
+  submission start --jid 1
+
+.. contents:: Table of Contents
+
+Resource file
+=============
+
+Sqoop 2 client have ability to load resource files similarly as other command line tools. At the beginning of execution Sqoop client will check existence of file ``.sqoop2rc`` in home directory of currently logged user. If such file exists, it will be interpreted before any additional actions. This file is loaded in both interactive and batch mode. It can be used to execute any batch compatible commands.
+
+Example resource file: ::
+
+  # Configure our Sqoop 2 server automatically
+  set server --host sqoop2.company.net
+
+  # Run in verbose mode by default
+  set option --name verbose --value true
+
+Commands
+========
+
+Sqoop 2 contains several commands that will be documented in this section. Each command have one more functions that are accepting various arguments. Not all commands are supported in both interactive and batch mode.
+
+Auxiliary Commands
+------------------
+
+Auxiliary commands are commands that are improving user experience and are running purely on client side. Thus they do not need working connection to the server.
+
+* ``exit`` Exit client immediately. This command can be also executed by sending EOT (end of transmission) character. It's CTRL+D on most common Linux shells like Bash or Zsh.
+* ``history`` Print out command history. Please note that Sqoop client is saving history from previous executions and thus you might see commands that you've executed in previous runs.
+* ``help`` Show all available commands with short in-shell documentation.
+
+Set Command
+-----------
+
+Set command allows to set various properties of the client. Similarly as auxiliary commands, set do not require connection to Sqoop server. Set commands is not used to reconfigure Sqoop server.
+
+Available functions:
+
++---------------+------------------------------------------+
+| Function      | Description                              |
++===============+==========================================+
+| ``server``    | Set connection configuration for server  |
++---------------+------------------------------------------+
+| ``option``    | Set various client side options          |
++---------------+------------------------------------------+
+
+Set Server Function
+~~~~~~~~~~~~~~~~~~~
+
+Configure connection to Sqoop server - host port and web application name. Available arguments:
+
++-----------------------+---------------+--------------------------------------------------+
+| Argument              | Default value | Description                                      |
++=======================+===============+==================================================+
+| ``-h``, ``--host``    | localhost     | Server name (FQDN) where Sqoop server is running |
++-----------------------+---------------+--------------------------------------------------+
+| ``-p``, ``--port``    | 8080          | TCP Port                                         |
++-----------------------+---------------+--------------------------------------------------+
+| ``-w``, ``--webapp``  | sqoop         | Tomcat's web application name                    |
++-----------------------+---------------+--------------------------------------------------+
+
+Example: ::
+
+  set server --host sqoop2.company.net --port 80 --webapp sqoop
+
+Set Option Function
+~~~~~~~~~~~~~~~~~~~
+
+Configure Sqoop client related options. This function have two required arguments ``name`` and ``value``. Name represents internal property name and value holds new value that should be set. List of available option names follows:
+
++-------------------+---------------+---------------------------------------------------------------------+
+| Option name       | Default value | Description                                                         |
++===================+===============+=====================================================================+
+| ``verbose``       | false         | Client will print additional information if verbose mode is enabled |
++-------------------+---------------+---------------------------------------------------------------------+
+
+Example: ::
+
+  set option --name verbose --value true
+
+Show Command
+------------
+
+Show commands displays various information including server and protocol versions or all stored meta data.
+
+Available functions:
+
++----------------+--------------------------------------------------------------------------------------------------------+
+| Function       | Description                                                                                            |
++================+========================================================================================================+
+| ``server``     | Display connection information to the server (host, port, webapp)                                      |
++----------------+--------------------------------------------------------------------------------------------------------+
+| ``version``    | Show version of both client and server (build numbers, supported protocols)                            |
++----------------+--------------------------------------------------------------------------------------------------------+
+| ``connector``  | Show connector meta data - set of parameters that connectors needs to create connections and jobs      |
++----------------+--------------------------------------------------------------------------------------------------------+
+| ``framework``  | Show framework meta data - set of parameters that Sqoop framework needs to create connections and jobs |
++----------------+--------------------------------------------------------------------------------------------------------+
+| ``connection`` | Show created connection meta data objects                                                              |
++----------------+--------------------------------------------------------------------------------------------------------+
+| ``job``        | Show created job meta data objects                                                                     |
++----------------+--------------------------------------------------------------------------------------------------------+
+
+Show Server Function
+~~~~~~~~~~~~~~~~~~~~
+
+Show details about configuration connection to Sqoop server.
+
++-----------------------+--------------------------------------------------------------+
+| Argument              |  Description                                                 |
++=======================+==============================================================+
+| ``-a``, ``--all``     | Show all connection related information (host, port, webapp) |
++-----------------------+--------------------------------------------------------------+
+| ``-h``, ``--host``    | Show host                                                    |
++-----------------------+--------------------------------------------------------------+
+| ``-p``, ``--port``    | Show port                                                    |
++-----------------------+--------------------------------------------------------------+
+| ``-w``, ``--webapp``  | Show web application name                                    |
++-----------------------+--------------------------------------------------------------+
+
+Example: ::
+
+  show server --all
+
+Show Version Function
+~~~~~~~~~~~~~~~~~~~~~
+
+Show versions of both client and server as well as supported protocols.
+
++------------------------+-----------------------------------------------+
+| Argument               |  Description                                  |
++========================+===============================================+
+| ``-a``, ``--all``      | Show all versions (server, client, protocols) |
++------------------------+-----------------------------------------------+
+| ``-c``, ``--client``   | Show client version                           |
++------------------------+-----------------------------------------------+
+| ``-s``, ``--server``   | Show server version                           |
++------------------------+-----------------------------------------------+
+| ``-p``, ``--protocol`` | Show protocol support on client or server     |
++------------------------+-----------------------------------------------+
+
+Example: ::
+
+  show version --all
+
+Show Connector Function
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Show connector meta data - parameters that connectors need in order to create new connection and job objects.
+
++-----------------------+------------------------------------------------+
+| Argument              |  Description                                   |
++=======================+================================================+
+| ``-a``, ``--all``     | Show information for all connectors            |
++-----------------------+------------------------------------------------+
+| ``-c``, ``--cid <x>`` | Show information for connector with id ``<x>`` |
++-----------------------+------------------------------------------------+
+
+Example: ::
+
+  show connector --all
+
+Show Framework Function
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Show framework meta data - parameters that Sqoop framework need in order to create new connection and job objects.
+
+This function do not have any extra arguments.
+
+Example: ::
+
+  show framework
+
+Show Connection Function
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Show persisted connection objects.
+
++-----------------------+------------------------------------------------------+
+| Argument              |  Description                                         |
++=======================+======================================================+
+| ``-a``, ``--all``     | Show all available connections from all connectors   |
++-----------------------+------------------------------------------------------+
+| ``-x``, ``--xid <x>`` | Show connection with id ``<x>``                      |
++-----------------------+------------------------------------------------------+
+
+Example: ::
+
+  show connection --all
+
+Show Job Function
+~~~~~~~~~~~~~~~~~
+
+Show persisted job objects.
+
++-----------------------+----------------------------------------------+
+| Argument              |  Description                                 |
++=======================+==============================================+
+| ``-a``, ``--all``     | Show all available jobs from all connectors  |
++-----------------------+----------------------------------------------+
+| ``-j``, ``--jid <x>`` | Show job with id ``<x>``                     |
++-----------------------+----------------------------------------------+
+
+Example: ::
+
+  show job --all
+
+Create Command
+--------------
+
+Creates new connection and job objects. This command is supported only in interactive mode. It will query user for all parameters that are required by specific connector and framework and persist them in Sqoop server for later use.
+
+Available functions:
+
++----------------+-------------------------------------------------+
+| Function       | Description                                     |
++================+=================================================+
+| ``connection`` | Create new connection object                    |
++----------------+-------------------------------------------------+
+| ``job``        | Create new job object                           |
++----------------+-------------------------------------------------+
+
+Create Connection Function
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Create new connection object.
+
++------------------------+-------------------------------------------------------------+
+| Argument               |  Description                                                |
++========================+=============================================================+
+| ``-c``, ``--cid <x>``  |  Create new connection object for connector with id ``<x>`` |
++------------------------+-------------------------------------------------------------+
+
+
+Example: ::
+
+  create connection --cid 1
+
+Create Job Function
+~~~~~~~~~~~~~~~~~~~
+
+Create new job object.
+
++------------------------+------------------------------------------------------------------+
+| Argument               |  Description                                                     |
++========================+==================================================================+
+| ``-x``, ``--xid <x>``  | Create new job object for connection with id ``<x>``             |
++------------------------+------------------------------------------------------------------+
+| ``-t``, ``--type <t>`` | Create new job object with type ``<t>`` (``import``, ``export``) |
++------------------------+------------------------------------------------------------------+
+
+Example: ::
+
+  create job --xid 1
+
+Update Command
+--------------
+
+Update commands allows you to edit connection and job objects - change persisted meta data. This command is supported only in interactive mode.
+
+Update Connection Function
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Update existing connection object.
+
++-----------------------+---------------------------------------------+
+| Argument              |  Description                                |
++=======================+=============================================+
+| ``-x``, ``--xid <x>`` |  Update existing connection with id ``<x>`` |
++-----------------------+---------------------------------------------+
+
+Example: ::
+
+  update connection --xid 1
+
+Update Job Function
+~~~~~~~~~~~~~~~~~~~
+
+Update existing job object.
+
++-----------------------+--------------------------------------------+
+| Argument              |  Description                               |
++=======================+============================================+
+| ``-j``, ``--jid <x>`` | Update existing job object with id ``<x>`` |
++-----------------------+--------------------------------------------+
+
+Example: ::
+
+  update job --jid 1
+
+
+Delete Command
+--------------
+
+Deletes connection and job objects from Sqoop server.
+
+Delete Connection Function
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Delete existing connection object.
+
++-----------------------+-------------------------------------------+
+| Argument              |  Description                              |
++=======================+===========================================+
+| ``-x``, ``--xid <x>`` |  Delete connection object with id ``<x>`` |
++-----------------------+-------------------------------------------+
+
+Example: ::
+
+  delete connection --xid 1
+
+
+Delete Job Function
+~~~~~~~~~~~~~~~~~~~
+
+Delete existing job object.
+
++-----------------------+------------------------------------------+
+| Argument              |  Description                             |
++=======================+==========================================+
+| ``-j``, ``--jid <x>`` | Delete job object with id ``<x>``        |
++-----------------------+------------------------------------------+
+
+Example: ::
+
+  delete job --jid 1
+
+
+Clone Command
+-------------
+
+Clone command will load existing connection or job object from Sqoop server and allow user in place changes that will result in creation of new connection or job object. This command is not supported in batch mode.
+
+Clone Connection Function
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Clone existing connection object.
+
++-----------------------+------------------------------------------+
+| Argument              |  Description                             |
++=======================+==========================================+
+| ``-x``, ``--xid <x>`` |  Clone connection object with id ``<x>`` |
++-----------------------+------------------------------------------+
+
+Example: ::
+
+  clone connection --xid 1
+
+
+Clone Job Function
+~~~~~~~~~~~~~~~~~~
+
+Clone existing job object.
+
++-----------------------+------------------------------------------+
+| Argument              |  Description                             |
++=======================+==========================================+
+| ``-j``, ``--jid <x>`` | Clone job object with id ``<x>``         |
++-----------------------+------------------------------------------+
+
+Example: ::
+
+  clone job --jid 1
+
+
+Submission Command
+------------------
+
+Submission command is entry point for executing actual data transfers. It allows you to start, stop and retrieve status of currently running jobs.
+
+Available functions:
+
++----------------+-------------------------------------------------+
+| Function       | Description                                     |
++================+=================================================+
+| ``start``      | Start job                                       |
++----------------+-------------------------------------------------+
+| ``stop``       | Interrupt running job                           |
++----------------+-------------------------------------------------+
+| ``status``     | Retrieve status for given job                   |
++----------------+-------------------------------------------------+
+
+Submission Start Function
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Start job (submit new submission). Starting already running job is considered as invalid operation.
+
++-----------------------+---------------------------+
+| Argument              |  Description              |
++=======================+===========================+
+| ``-j``, ``--jid <x>`` | Start job with id ``<x>`` |
++-----------------------+---------------------------+
+
+Example: ::
+
+  submission start --jid 1
+
+
+Submission Stop Function
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Interrupt running job.
+
++-----------------------+------------------------------------------+
+| Argument              |  Description                             |
++=======================+==========================================+
+| ``-j``, ``--jid <x>`` | Interrupt running job with id ``<x>``    |
++-----------------------+------------------------------------------+
+
+Example: ::
+
+  submission stop --jid 1
+
+Submission Status Function
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Retrieve last status for given job.
+
++-----------------------+------------------------------------------+
+| Argument              |  Description                             |
++=======================+==========================================+
+| ``-j``, ``--jid <x>`` | Retrieve status for job with id ``<x>``  |
++-----------------------+------------------------------------------+
+
+Example: ::
+
+  submission status --jid 1
+

Added: websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/Installation.txt
==============================================================================
--- websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/Installation.txt (added)
+++ websites/staging/sqoop/trunk/content/docs/1.99.1/_sources/Installation.txt Wed Dec 26 05:47:54 2012
@@ -0,0 +1,88 @@
+.. 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 lANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+
+=======================================
+Installation
+=======================================
+
+Sqoop ships as one binary package however it's compound from two separate parts - client and server. You need to install server on single node in your cluster. This node will then serve as an entry point for all connecting Sqoop clients. Server acts as a mapreduce client and therefore Hadoop must be installed and configured on machine hosting Sqoop server. Clients can be installed on any arbitrary number of machines. Client is not acting as a mapreduce client and thus you do not need to install Hadoop on nodes that will act only as a Sqoop client.
+
+Server installation
+===================
+
+Copy Sqoop artifact on machine where you want to run Sqoop server. This machine must have installed and configured Hadoop. You don't need to run any Hadoop related services there, however the machine must be able to act as an Hadoop client. You should be able to list a HDFS for example: ::
+
+  hadoop dfs -ls
+
+Sqoop server supports multiple Hadoop versions. However as Hadoop major versions are not compatible with each other, Sqoop have multiple binary artefacts - one for each supported major version of Hadoop. You need to make sure that you're using appropriated binary artifact for your specific Hadoop version. To install Sqoop server decompress appropriate distribution artifact in location at your convenience and change your working directory to this folder. ::
+
+  # Decompress Sqoop distribution tarball
+  tar -xvf sqoop-<version>-bin-hadoop<hadoop-version>.tar.gz
+
+  # Move decompressed content to any location
+  mv sqoop-<version>-bin-hadoop<hadoop version>.tar.gz /usr/lib/sqoop
+
+  # Change working directory
+  cd /usr/lib/sqoop
+
+
+Installing Dependencies
+-----------------------
+
+You need to install Hadoop libraries into Sqoop server war file. Sqoop provides convenience script ``addtowar.sh`` to do so. If you have installed Hadoop in usual location in ``/usr/lib`` and executable ``hadoop`` is in your path, you can use automatic Hadoop installation procedure: ::
+
+  ./bin/addtowar.sh -hadoop-auto
+
+In case that you have Hadoop installed in different location, you will need to manually specify Hadoop version and path to Hadoop libraries. You can use parameter ``-hadoop-version`` for specifying Hadoop major version, we're currently support versions 1.x and 2.x. Path to Hadoop libraries can be specified using ``-hadoop-path`` parameter. In case that your Hadoop libraries are in multiple different folders, you can specify all of them separated by ``:``.  Example of manual installation: ::
+
+  ./bin/addtowar.sh -hadoop-version 2.0 -hadoop-path /usr/lib/hadoop-common:/usr/lib/hadoop-hdfs:/usr/lib/hadoop-yarn
+
+Lastly you might need to install JDBC drivers that are not bundled with Sqoop because of incompatible licenses. You can add any arbitrary java jar file to Sqoop server using script ``addtowar.sh`` with ``-jars`` parameter. Similarly as in case of hadoop path you can enter multiple jars separated with ``:``. Example of installing MySQL JDBC driver to Sqoop server: ::
+
+  ./bin/addtowar.sh -jars /path/to/jar/mysql-connector-java-*-bin.jar
+
+Configuring Server
+------------------
+
+Before starting server you should revise configuration to match your specific environment. Server configuration files are stored in ``server/config`` directory of distributed artifact along side with other configuration files of Tomcat.
+
+File ``sqoop_bootstrap.properties`` specifies which configuration provider should be used for loading configuration for rest of Sqoop server. Default value ``PropertiesConfigurationProvider`` should be sufficient.
+
+
+Second configuration file ``sqoop.properties`` contains remaining configuration properties that can affect Sqoop server. File is very well documented, so check if all configuration properties fits your environment. Default or very little tweaking should be sufficient most common cases.
+
+Server Life Cycle
+-----------------
+
+After installation and configuration you can start Sqoop server with following command: ::
+
+  ./bin/sqoop.sh server start
+
+Similarly you can stop server using following command: ::
+
+  ./bin/sqoop.sh server stop
+
+
+Client installation
+===================
+
+Client do not need extra installation and configuration steps. Just copy Sqoop distribution artifact on target machine and unzip it in desired location. You can start client with following command: ::
+
+  bin/sqoop.sh client
+
+You can find more documentation to Sqoop client in `Command Line Client <CommandLineClient.html>`_ section.
+
+



Mime
View raw message