You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by bi...@apache.org on 2012/02/15 21:58:43 UTC
svn commit: r804967 [3/3] - in /websites/production/accumulo: ./
content/accumulo/example/ content/accumulo/user_manual_1.4-incubating/
Modified: websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Table_Configuration.html
==============================================================================
--- websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Table_Configuration.html (original)
+++ websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Table_Configuration.html Wed Feb 15 20:58:43 2012
@@ -59,7 +59,7 @@
<ul>
<li><a href="/accumulo/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/accumulo">Issues</a></li>
-<li><a href="https://builds.apache.org/job/Accumulo-Trunk">Builds</a></li>
+<li><a href="https://builds.apache.org/view/A-F/view/Accumulo/">Builds</a></li>
</ul>
<h1 id="documentation">Documentation</h1>
<ul>
@@ -173,7 +173,7 @@
<p>To deploy a new constraint, create a jar file containing the class implementing the new constraint and place it in the lib directory of the Accumulo installation. New constraint jars can be added to Accumulo and enabled without restarting but any change to an existing constraint class requires Accumulo to be restarted. </p>
<p>An example of constraints can be found in <br />
accumulo/docs/examples/README.constraints with corresponding code under <br />
-accumulo/src/examples/main/java/accumulo/examples/constraints . </p>
+accumulo/src/examples/simple/main/java/accumulo/examples/simple/constraints . </p>
<h2 id="a_idbloom_filtersa_bloom_filters"><a id=Bloom_Filters></a> Bloom Filters</h2>
<p>As mutations are applied to an Accumulo table, several files are created per tablet. If bloom filters are enabled, Accumulo will create and load a small data structure into memory to determine whether a file contains a given key before opening the file. This can speed up lookups considerably. </p>
<p>To enable bloom filters, enter the following command in the Shell: </p>
@@ -318,7 +318,7 @@ org.apache.accumulo.core.iterators.Filte
<p>Additional Combiners can be added by creating a Java class that extends <br />
<strong>org.apache.accumulo.core.iterators.Combiner</strong> and adding a jar containing that class to Accumulo's lib/ext directory. </p>
<p>An example of a Combiner can be found under <br />
-accumulo/src/examples/main/java/org/apache/accumulo/examples/combiner/StatsCombiner.java </p>
+accumulo/src/examples/simple/main/java/org/apache/accumulo/examples/simple/combiner/StatsCombiner.java </p>
<h2 id="a_idblock_cachea_block_cache"><a id=Block_Cache></a> Block Cache</h2>
<p>In order to increase throughput of commonly accessed entries, Accumulo employs a block cache. This block cache buffers data in memory so that it doesn't have to be read off of disk. The RFile format that Accumulo prefers is a mix of index blocks and data blocks, where the index blocks are used to find the appropriate data blocks. Typical queries to Accumulo result in a binary search over several index blocks followed by a linear scan of one or more data blocks. </p>
<p>The block cache can be configured on a per-table basis, and all tablets hosted on a tablet server share a single resource pool. To configure the size of the tablet server's block cache, set the following properties: </p>
Modified: websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Writing_Accumulo_Clients.html
==============================================================================
--- websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Writing_Accumulo_Clients.html (original)
+++ websites/production/accumulo/content/accumulo/user_manual_1.4-incubating/Writing_Accumulo_Clients.html Wed Feb 15 20:58:43 2012
@@ -59,7 +59,7 @@
<ul>
<li><a href="/accumulo/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/accumulo">Issues</a></li>
-<li><a href="https://builds.apache.org/job/Accumulo-Trunk">Builds</a></li>
+<li><a href="https://builds.apache.org/view/A-F/view/Accumulo/">Builds</a></li>
</ul>
<h1 id="documentation">Documentation</h1>
<ul>
@@ -96,11 +96,28 @@
</p>
<p><a id=CHILD_LINKS></a><strong>Subsections</strong></p>
<ul>
+<li><a href="Writing_Accumulo_Clients.html#Running_Client_Code">Running Client Code</a></li>
+<li><a href="Writing_Accumulo_Clients.html#Connecting">Connecting</a></li>
<li><a href="Writing_Accumulo_Clients.html#Writing_Data">Writing Data</a></li>
<li><a href="Writing_Accumulo_Clients.html#Reading_Data">Reading Data</a></li>
</ul>
<hr />
<h2 id="a_idwriting_accumulo_clientsa_writing_accumulo_clients"><a id=Writing_Accumulo_Clients></a> Writing Accumulo Clients</h2>
+<h2 id="a_idrunning_client_codea_running_client_code"><a id=Running_Client_Code></a> Running Client Code</h2>
+<p>There are multiple ways to run Java code that uses Accumulo. Below is a list of the different ways to execute client code. </p>
+<ul>
+<li>using java executable </li>
+<li>using the accumulo script </li>
+<li>using the tool script </li>
+</ul>
+<p>Inorder to run client code written to run against Accumulo, you will need to include the jars that Accumulo depends on in your classpath. Accumulo client code depends on Hadoop and Zookeeper. For Hadoop add the hadoop core jar, all of the jars in the Hadoop lib directory, and the conf directory to the classpath. For Zookeeper 3.3 you only need to add the Zookeeper jar, and not what is in the Zookeeper lib directory. You can run the following command on a configured Accumulo system to see what its using for its classpath. </p>
+<div class="codehilite"><pre><span class="nv">$ACCUMULO_HOME</span><span class="sr">/bin/</span><span class="n">accumulo</span> <span class="n">classpath</span>
+</pre></div>
+
+
+<p>Another option for running your code is to put a jar file in $ACCUMULO_HOME/lib/ext. After doing this you can use the accumulo script to execute your code. For example if you create a jar containing the class com.foo.Client and placed that in lib/ext, then you could use the command $ACCUMULO_HOME/bin/accumulo com.foo.Client to execute your code. </p>
+<p>If you are writing map reduce job that access Accumulo, then you can use the bin/tool.sh script to run those jobs. See the map reduce example. </p>
+<h2 id="a_idconnectinga_connecting"><a id=Connecting></a> Connecting</h2>
<p>All clients must first identify the Accumulo instance to which they will be communicating. Code to do this is as follows: </p>
<div class="codehilite"><pre><span class="n">String</span> <span class="n">instanceName</span> <span class="o">=</span> <span class="s">"myinstance"</span><span class="p">;</span>
<span class="n">String</span> <span class="n">zooServers</span> <span class="o">=</span> <span class="s">"zooserver-one,zooserver-two"</span>