You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by mj...@apache.org on 2017/02/27 16:24:37 UTC
[03/16] accumulo-website git commit: Jekyll build from master:90a96b6
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/classpath.html
----------------------------------------------------------------------
diff --git a/1.8/examples/classpath.html b/1.8/examples/classpath.html
index 58d8d50..8a85732 100644
--- a/1.8/examples/classpath.html
+++ b/1.8/examples/classpath.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Classpath Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Classpath Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This example shows how to use per table classpaths. The example leverages a
+ <p>Title: Apache Accumulo Classpath Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This example shows how to use per table classpaths. The example leverages a
test jar which contains a Filter that supresses rows containing \u201cfoo\u201d. The
example shows copying the FooFilter.jar into HDFS and then making an Accumulo
table reference that jar.</p>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/classpath.md
----------------------------------------------------------------------
diff --git a/1.8/examples/classpath.md b/1.8/examples/classpath.md
new file mode 100644
index 0000000..710560f
--- /dev/null
+++ b/1.8/examples/classpath.md
@@ -0,0 +1,68 @@
+Title: Apache Accumulo Classpath Example
+Notice: 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.
+
+
+This example shows how to use per table classpaths. The example leverages a
+test jar which contains a Filter that supresses rows containing "foo". The
+example shows copying the FooFilter.jar into HDFS and then making an Accumulo
+table reference that jar.
+
+
+Execute the following command in the shell.
+
+ $ hadoop fs -copyFromLocal $ACCUMULO_HOME/test/src/test/resources/FooFilter.jar /user1/lib
+
+Execute following in Accumulo shell to setup classpath context
+
+ root@test15> config -s general.vfs.context.classpath.cx1=hdfs://<namenode host>:<namenode port>/user1/lib/[^.].*.jar
+
+Create a table
+
+ root@test15> createtable nofoo
+
+The following command makes this table use the configured classpath context
+
+ root@test15 nofoo> config -t nofoo -s table.classpath.context=cx1
+
+The following command configures an iterator thats in FooFilter.jar
+
+ root@test15 nofoo> setiter -n foofilter -p 10 -scan -minc -majc -class org.apache.accumulo.test.FooFilter
+ Filter accepts or rejects each Key/Value pair
+ ----------> set FooFilter parameter negate, default false keeps k/v that pass accept method, true rejects k/v that pass accept method: false
+
+The commands below show the filter is working.
+
+ root@test15 nofoo> insert foo1 f1 q1 v1
+ root@test15 nofoo> insert noo1 f1 q1 v2
+ root@test15 nofoo> scan
+ noo1 f1:q1 [] v2
+ root@test15 nofoo>
+
+Below, an attempt is made to add the FooFilter to a table thats not configured
+to use the clasppath context cx1. This fails util the table is configured to
+use cx1.
+
+ root@test15 nofoo> createtable nofootwo
+ root@test15 nofootwo> setiter -n foofilter -p 10 -scan -minc -majc -class org.apache.accumulo.test.FooFilter
+ 2013-05-03 12:49:35,943 [shell.Shell] ERROR: java.lang.IllegalArgumentException: org.apache.accumulo.test.FooFilter
+ root@test15 nofootwo> config -t nofootwo -s table.classpath.context=cx1
+ root@test15 nofootwo> setiter -n foofilter -p 10 -scan -minc -majc -class org.apache.accumulo.test.FooFilter
+ Filter accepts or rejects each Key/Value pair
+ ----------> set FooFilter parameter negate, default false keeps k/v that pass accept method, true rejects k/v that pass accept method: false
+
+
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/client.html
----------------------------------------------------------------------
diff --git a/1.8/examples/client.html b/1.8/examples/client.html
index 8e37e07..358d4cd 100644
--- a/1.8/examples/client.html
+++ b/1.8/examples/client.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Client Examples</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Client Examples</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This documents how you run the simplest java examples.</p>
+ <p>Title: Apache Accumulo Client Examples
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This documents how you run the simplest java examples.</p>
<p>This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.client in the examples-simple module:</p>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/client.md
----------------------------------------------------------------------
diff --git a/1.8/examples/client.md b/1.8/examples/client.md
new file mode 100644
index 0000000..f6b8bcb
--- /dev/null
+++ b/1.8/examples/client.md
@@ -0,0 +1,79 @@
+Title: Apache Accumulo Client Examples
+Notice: 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.
+
+This documents how you run the simplest java examples.
+
+This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.client in the examples-simple module:
+
+ * Flush.java - flushes a table
+ * RowOperations.java - reads and writes rows
+ * ReadWriteExample.java - creates a table, writes to it, and reads from it
+
+Using the accumulo command, you can run the simple client examples by providing their
+class name, and enough arguments to find your accumulo instance. For example,
+the Flush class will flush a table:
+
+ $ PACKAGE=org.apache.accumulo.examples.simple.client
+ $ bin/accumulo $PACKAGE.Flush -u root -p mypassword -i instance -z zookeeper -t trace
+
+The very simple RowOperations class demonstrates how to read and write rows using the BatchWriter
+and Scanner:
+
+ $ bin/accumulo $PACKAGE.RowOperations -u root -p mypassword -i instance -z zookeeper
+ 2013-01-14 14:45:24,738 [client.RowOperations] INFO : This is everything
+ 2013-01-14 14:45:24,744 [client.RowOperations] INFO : Key: row1 column:1 [] 1358192724640 false Value: This is the value for this key
+ 2013-01-14 14:45:24,744 [client.RowOperations] INFO : Key: row1 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,744 [client.RowOperations] INFO : Key: row1 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,744 [client.RowOperations] INFO : Key: row1 column:4 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,746 [client.RowOperations] INFO : Key: row2 column:1 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,746 [client.RowOperations] INFO : Key: row2 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,746 [client.RowOperations] INFO : Key: row2 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,746 [client.RowOperations] INFO : Key: row2 column:4 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,747 [client.RowOperations] INFO : Key: row3 column:1 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,747 [client.RowOperations] INFO : Key: row3 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,747 [client.RowOperations] INFO : Key: row3 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,747 [client.RowOperations] INFO : Key: row3 column:4 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,756 [client.RowOperations] INFO : This is row1 and row3
+ 2013-01-14 14:45:24,757 [client.RowOperations] INFO : Key: row1 column:1 [] 1358192724640 false Value: This is the value for this key
+ 2013-01-14 14:45:24,757 [client.RowOperations] INFO : Key: row1 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,757 [client.RowOperations] INFO : Key: row1 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,757 [client.RowOperations] INFO : Key: row1 column:4 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,761 [client.RowOperations] INFO : Key: row3 column:1 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,761 [client.RowOperations] INFO : Key: row3 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,761 [client.RowOperations] INFO : Key: row3 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,761 [client.RowOperations] INFO : Key: row3 column:4 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,765 [client.RowOperations] INFO : This is just row3
+ 2013-01-14 14:45:24,769 [client.RowOperations] INFO : Key: row3 column:1 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,770 [client.RowOperations] INFO : Key: row3 column:2 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,770 [client.RowOperations] INFO : Key: row3 column:3 [] 1358192724642 false Value: This is the value for this key
+ 2013-01-14 14:45:24,770 [client.RowOperations] INFO : Key: row3 column:4 [] 1358192724642 false Value: This is the value for this key
+
+To create a table, write to it and read from it:
+
+ $ bin/accumulo $PACKAGE.ReadWriteExample -u root -p mypassword -i instance -z zookeeper --createtable --create --read
+ hello%00; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%01; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%02; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%03; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%04; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%05; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%06; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%07; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%08; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+ hello%09; datatypes:xml [LEVEL1|GROUP1] 1358192329450 false -> world
+
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/combiner.html
----------------------------------------------------------------------
diff --git a/1.8/examples/combiner.html b/1.8/examples/combiner.html
index 57a0c22..658b764 100644
--- a/1.8/examples/combiner.html
+++ b/1.8/examples/combiner.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Combiner Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Combiner Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This tutorial uses the following Java class, which can be found in org.apache.accumulo.examples.simple.combiner in the examples-simple module:</p>
+ <p>Title: Apache Accumulo Combiner Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This tutorial uses the following Java class, which can be found in org.apache.accumulo.examples.simple.combiner in the examples-simple module:</p>
<ul>
<li>StatsCombiner.java - a combiner that calculates max, min, sum, and count</li>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/combiner.md
----------------------------------------------------------------------
diff --git a/1.8/examples/combiner.md b/1.8/examples/combiner.md
new file mode 100644
index 0000000..f388e5b
--- /dev/null
+++ b/1.8/examples/combiner.md
@@ -0,0 +1,70 @@
+Title: Apache Accumulo Combiner Example
+Notice: 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.
+
+This tutorial uses the following Java class, which can be found in org.apache.accumulo.examples.simple.combiner in the examples-simple module:
+
+ * StatsCombiner.java - a combiner that calculates max, min, sum, and count
+
+This is a simple combiner example. To build this example run maven and then
+copy the produced jar into the accumulo lib dir. This is already done in the
+tar distribution.
+
+ $ bin/accumulo shell -u username
+ Enter current password for 'username'@'instance': ***
+
+ Shell - Apache Accumulo Interactive Shell
+ -
+ - version: 1.5.0
+ - instance name: instance
+ - instance id: 00000000-0000-0000-0000-000000000000
+ -
+ - type 'help' for a list of available commands
+ -
+ username@instance> createtable runners
+ username@instance runners> setiter -t runners -p 10 -scan -minc -majc -n decStats -class org.apache.accumulo.examples.simple.combiner.StatsCombiner
+ Combiner that keeps track of min, max, sum, and count
+ ----------> set StatsCombiner parameter all, set to true to apply Combiner to every column, otherwise leave blank. if true, columns option will be ignored.:
+ ----------> set StatsCombiner parameter columns, <col fam>[:<col qual>]{,<col fam>[:<col qual>]} escape non aplhanum chars using %<hex>.: stat
+ ----------> set StatsCombiner parameter radix, radix/base of the numbers: 10
+ username@instance runners> setiter -t runners -p 11 -scan -minc -majc -n hexStats -class org.apache.accumulo.examples.simple.combiner.StatsCombiner
+ Combiner that keeps track of min, max, sum, and count
+ ----------> set StatsCombiner parameter all, set to true to apply Combiner to every column, otherwise leave blank. if true, columns option will be ignored.:
+ ----------> set StatsCombiner parameter columns, <col fam>[:<col qual>]{,<col fam>[:<col qual>]} escape non aplhanum chars using %<hex>.: hstat
+ ----------> set StatsCombiner parameter radix, radix/base of the numbers: 16
+ username@instance runners> insert 123456 name first Joe
+ username@instance runners> insert 123456 stat marathon 240
+ username@instance runners> scan
+ 123456 name:first [] Joe
+ 123456 stat:marathon [] 240,240,240,1
+ username@instance runners> insert 123456 stat marathon 230
+ username@instance runners> insert 123456 stat marathon 220
+ username@instance runners> scan
+ 123456 name:first [] Joe
+ 123456 stat:marathon [] 220,240,690,3
+ username@instance runners> insert 123456 hstat virtualMarathon 6a
+ username@instance runners> insert 123456 hstat virtualMarathon 6b
+ username@instance runners> scan
+ 123456 hstat:virtualMarathon [] 6a,6b,d5,2
+ 123456 name:first [] Joe
+ 123456 stat:marathon [] 220,240,690,3
+
+In this example a table is created and the example stats combiner is applied to
+the column family stat and hstat. The stats combiner computes min,max,sum, and
+count. It can be configured to use a different base or radix. In the example
+above the column family stat is configured for base 10 and the column family
+hstat is configured for base 16.
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/constraints.html
----------------------------------------------------------------------
diff --git a/1.8/examples/constraints.html b/1.8/examples/constraints.html
index cd1c330..8485a46 100644
--- a/1.8/examples/constraints.html
+++ b/1.8/examples/constraints.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Constraints Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Constraints Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.constraints in the examples-simple module:</p>
+ <p>Title: Apache Accumulo Constraints Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.constraints in the examples-simple module:</p>
<ul>
<li>AlphaNumKeyConstraint.java - a constraint that requires alphanumeric keys</li>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/constraints.md
----------------------------------------------------------------------
diff --git a/1.8/examples/constraints.md b/1.8/examples/constraints.md
new file mode 100644
index 0000000..b15b409
--- /dev/null
+++ b/1.8/examples/constraints.md
@@ -0,0 +1,54 @@
+Title: Apache Accumulo Constraints Example
+Notice: 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.
+
+This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.constraints in the examples-simple module:
+
+ * AlphaNumKeyConstraint.java - a constraint that requires alphanumeric keys
+ * NumericValueConstraint.java - a constraint that requires numeric string values
+
+This an example of how to create a table with constraints. Below a table is
+created with two example constraints. One constraints does not allow non alpha
+numeric keys. The other constraint does not allow non numeric values. Two
+inserts that violate these constraints are attempted and denied. The scan at
+the end shows the inserts were not allowed.
+
+ $ ./bin/accumulo shell -u username -p password
+
+ Shell - Apache Accumulo Interactive Shell
+ -
+ - version: 1.5.0
+ - instance name: instance
+ - instance id: 00000000-0000-0000-0000-000000000000
+ -
+ - type 'help' for a list of available commands
+ -
+ username@instance> createtable testConstraints
+ username@instance testConstraints> constraint -a org.apache.accumulo.examples.simple.constraints.NumericValueConstraint
+ username@instance testConstraints> constraint -a org.apache.accumulo.examples.simple.constraints.AlphaNumKeyConstraint
+ username@instance testConstraints> insert r1 cf1 cq1 1111
+ username@instance testConstraints> insert r1 cf1 cq1 ABC
+ Constraint Failures:
+ ConstraintViolationSummary(constrainClass:org.apache.accumulo.examples.simple.constraints.NumericValueConstraint, violationCode:1, violationDescription:Value is not numeric, numberOfViolatingMutations:1)
+ username@instance testConstraints> insert r1! cf1 cq1 ABC
+ Constraint Failures:
+ ConstraintViolationSummary(constrainClass:org.apache.accumulo.examples.simple.constraints.NumericValueConstraint, violationCode:1, violationDescription:Value is not numeric, numberOfViolatingMutations:1)
+ ConstraintViolationSummary(constrainClass:org.apache.accumulo.examples.simple.constraints.AlphaNumKeyConstraint, violationCode:1, violationDescription:Row was not alpha numeric, numberOfViolatingMutations:1)
+ username@instance testConstraints> scan
+ r1 cf1:cq1 [] 1111
+ username@instance testConstraints>
+
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/dirlist.html
----------------------------------------------------------------------
diff --git a/1.8/examples/dirlist.html b/1.8/examples/dirlist.html
index af03bf5..72a64c7 100644
--- a/1.8/examples/dirlist.html
+++ b/1.8/examples/dirlist.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo File System Archive</title>
+<title>Directory Table</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo File System Archive</h1>
+ <h1 class="title">Directory Table</h1>
- <p>This example stores filesystem information in accumulo. The example stores the information in the following three tables. More information about the table structures can be found at the end of README.dirlist.</p>
+ <p>Title: Apache Accumulo File System Archive
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This example stores filesystem information in accumulo. The example stores the information in the following three tables. More information about the table structures can be found at the end of README.dirlist.</p>
<ul>
<li>directory table : This table stores information about the filesystem directory structure.</li>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/dirlist.md
----------------------------------------------------------------------
diff --git a/1.8/examples/dirlist.md b/1.8/examples/dirlist.md
new file mode 100644
index 0000000..50623c6
--- /dev/null
+++ b/1.8/examples/dirlist.md
@@ -0,0 +1,114 @@
+Title: Apache Accumulo File System Archive
+Notice: 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.
+
+This example stores filesystem information in accumulo. The example stores the information in the following three tables. More information about the table structures can be found at the end of README.dirlist.
+
+ * directory table : This table stores information about the filesystem directory structure.
+ * index table : This table stores a file name index. It can be used to quickly find files with given name, suffix, or prefix.
+ * data table : This table stores the file data. File with duplicate data are only stored once.
+
+This example shows how to use Accumulo to store a file system history. It has the following classes:
+
+ * Ingest.java - Recursively lists the files and directories under a given path, ingests their names and file info into one Accumulo table, indexes the file names in a separate table, and the file data into a third table.
+ * QueryUtil.java - Provides utility methods for getting the info for a file, listing the contents of a directory, and performing single wild card searches on file or directory names.
+ * Viewer.java - Provides a GUI for browsing the file system information stored in Accumulo.
+ * FileCount.java - Computes recursive counts over file system information and stores them back into the same Accumulo table.
+
+To begin, ingest some data with Ingest.java.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.Ingest -i instance -z zookeepers -u username -p password --vis exampleVis --chunkSize 100000 /local/username/workspace
+
+This may take some time if there are large files in the /local/username/workspace directory. If you use 0 instead of 100000 on the command line, the ingest will run much faster, but it will not put any file data into Accumulo (the dataTable will be empty).
+Note that running this example will create tables dirTable, indexTable, and dataTable in Accumulo that you should delete when you have completed the example.
+If you modify a file or add new files in the directory ingested (e.g. /local/username/workspace), you can run Ingest again to add new information into the Accumulo tables.
+
+To browse the data ingested, use Viewer.java. Be sure to give the "username" user the authorizations to see the data (in this case, run
+
+ $ ./bin/accumulo shell -u root -e 'setauths -u username -s exampleVis'
+
+then run the Viewer:
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.Viewer -i instance -z zookeepers -u username -p password -t dirTable --dataTable dataTable --auths exampleVis --path /local/username/workspace
+
+To list the contents of specific directories, use QueryUtil.java.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t dirTable --auths exampleVis --path /local/username
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t dirTable --auths exampleVis --path /local/username/workspace
+
+To perform searches on file or directory names, also use QueryUtil.java. Search terms must contain no more than one wild card and cannot contain "/".
+*Note* these queries run on the _indexTable_ table instead of the dirTable table.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t indexTable --auths exampleVis --path filename --search
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t indexTable --auths exampleVis --path 'filename*' --search
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t indexTable --auths exampleVis --path '*jar' --search
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.QueryUtil -i instance -z zookeepers -u username -p password -t indexTable --auths exampleVis --path 'filename*jar' --search
+
+To count the number of direct children (directories and files) and descendants (children and children's descendants, directories and files), run the FileCount over the dirTable table.
+The results are written back to the same table. FileCount reads from and writes to Accumulo. This requires scan authorizations for the read and a visibility for the data written.
+In this example, the authorizations and visibility are set to the same value, exampleVis. See README.visibility for more information on visibility and authorizations.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.dirlist.FileCount -i instance -z zookeepers -u username -p password -t dirTable --auths exampleVis
+
+## Directory Table
+
+Here is a illustration of what data looks like in the directory table:
+
+ row colf:colq [vis] value
+ 000 dir:exec [exampleVis] true
+ 000 dir:hidden [exampleVis] false
+ 000 dir:lastmod [exampleVis] 1291996886000
+ 000 dir:length [exampleVis] 1666
+ 001/local dir:exec [exampleVis] true
+ 001/local dir:hidden [exampleVis] false
+ 001/local dir:lastmod [exampleVis] 1304945270000
+ 001/local dir:length [exampleVis] 272
+ 002/local/Accumulo.README \x7F\xFF\xFE\xCFH\xA1\x82\x97:exec [exampleVis] false
+ 002/local/Accumulo.README \x7F\xFF\xFE\xCFH\xA1\x82\x97:hidden [exampleVis] false
+ 002/local/Accumulo.README \x7F\xFF\xFE\xCFH\xA1\x82\x97:lastmod [exampleVis] 1308746481000
+ 002/local/Accumulo.README \x7F\xFF\xFE\xCFH\xA1\x82\x97:length [exampleVis] 9192
+ 002/local/Accumulo.README \x7F\xFF\xFE\xCFH\xA1\x82\x97:md5 [exampleVis] 274af6419a3c4c4a259260ac7017cbf1
+
+The rows are of the form depth + path, where depth is the number of slashes ("/") in the path padded to 3 digits. This is so that all the children of a directory appear as consecutive keys in Accumulo; without the depth, you would for example see all the subdirectories of /local before you saw /usr.
+For directories the column family is "dir". For files the column family is Long.MAX_VALUE - lastModified in bytes rather than string format so that newer versions sort earlier.
+
+## Index Table
+
+Here is an illustration of what data looks like in the index table:
+
+ row colf:colq [vis]
+ fAccumulo.README i:002/local/Accumulo.README [exampleVis]
+ flocal i:001/local [exampleVis]
+ rEMDAER.olumuccA i:002/local/Accumulo.README [exampleVis]
+ rlacol i:001/local [exampleVis]
+
+The values of the index table are null. The rows are of the form "f" + filename or "r" + reverse file name. This is to enable searches with wildcards at the beginning, middle, or end.
+
+## Data Table
+
+Here is an illustration of what data looks like in the data table:
+
+ row colf:colq [vis] value
+ 274af6419a3c4c4a259260ac7017cbf1 refs:e77276a2b56e5c15b540eaae32b12c69\x00filext [exampleVis] README
+ 274af6419a3c4c4a259260ac7017cbf1 refs:e77276a2b56e5c15b540eaae32b12c69\x00name [exampleVis] /local/Accumulo.README
+ 274af6419a3c4c4a259260ac7017cbf1 ~chunk:\x00\x0FB@\x00\x00\x00\x00 [exampleVis] *******************************************************************************\x0A1. Building\x0A\x0AIn the normal tarball release of accumulo, [truncated]
+ 274af6419a3c4c4a259260ac7017cbf1 ~chunk:\x00\x0FB@\x00\x00\x00\x01 [exampleVis]
+
+The rows are the md5 hash of the file. Some column family : column qualifier pairs are "refs" : hash of file name + null byte + property name, in which case the value is property value. There can be multiple references to the same file which are distinguished by the hash of the file name.
+Other column family : column qualifier pairs are "~chunk" : chunk size in bytes + chunk number in bytes, in which case the value is the bytes for that chunk of the file. There is an end of file data marker whose chunk number is the number of chunks for the file and whose value is empty.
+
+There may exist multiple copies of the same file (with the same md5 hash) with different chunk sizes or different visibilities. There is an iterator that can be set on the data table that combines these copies into a single copy with a visibility taken from the visibilities of the file references, e.g. (vis from ref1)|(vis from ref2).
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/export.html
----------------------------------------------------------------------
diff --git a/1.8/examples/export.html b/1.8/examples/export.html
index e0ea3b1..0290fbe 100644
--- a/1.8/examples/export.html
+++ b/1.8/examples/export.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Export/Import Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Export/Import Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>Accumulo provides a mechanism to export and import tables. This README shows
+ <p>Title: Apache Accumulo Export/Import Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>Accumulo provides a mechanism to export and import tables. This README shows
how to use this feature.</p>
<p>The shell session below shows creating a table, inserting data, and exporting
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/export.md
----------------------------------------------------------------------
diff --git a/1.8/examples/export.md b/1.8/examples/export.md
new file mode 100644
index 0000000..b6ea8f8
--- /dev/null
+++ b/1.8/examples/export.md
@@ -0,0 +1,91 @@
+Title: Apache Accumulo Export/Import Example
+Notice: 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.
+
+Accumulo provides a mechanism to export and import tables. This README shows
+how to use this feature.
+
+The shell session below shows creating a table, inserting data, and exporting
+the table. A table must be offline to export it, and it should remain offline
+for the duration of the distcp. An easy way to take a table offline without
+interuppting access to it is to clone it and take the clone offline.
+
+ root@test15> createtable table1
+ root@test15 table1> insert a cf1 cq1 v1
+ root@test15 table1> insert h cf1 cq1 v2
+ root@test15 table1> insert z cf1 cq1 v3
+ root@test15 table1> insert z cf1 cq2 v4
+ root@test15 table1> addsplits -t table1 b r
+ root@test15 table1> scan
+ a cf1:cq1 [] v1
+ h cf1:cq1 [] v2
+ z cf1:cq1 [] v3
+ z cf1:cq2 [] v4
+ root@test15> config -t table1 -s table.split.threshold=100M
+ root@test15 table1> clonetable table1 table1_exp
+ root@test15 table1> offline table1_exp
+ root@test15 table1> exporttable -t table1_exp /tmp/table1_export
+ root@test15 table1> quit
+
+After executing the export command, a few files are created in the hdfs dir.
+One of the files is a list of files to distcp as shown below.
+
+ $ hadoop fs -ls /tmp/table1_export
+ Found 2 items
+ -rw-r--r-- 3 user supergroup 162 2012-07-25 09:56 /tmp/table1_export/distcp.txt
+ -rw-r--r-- 3 user supergroup 821 2012-07-25 09:56 /tmp/table1_export/exportMetadata.zip
+ $ hadoop fs -cat /tmp/table1_export/distcp.txt
+ hdfs://n1.example.com:6093/accumulo/tables/3/default_tablet/F0000000.rf
+ hdfs://n1.example.com:6093/tmp/table1_export/exportMetadata.zip
+
+Before the table can be imported, it must be copied using distcp. After the
+discp completed, the cloned table may be deleted.
+
+ $ hadoop distcp -f /tmp/table1_export/distcp.txt /tmp/table1_export_dest
+
+The Accumulo shell session below shows importing the table and inspecting it.
+The data, splits, config, and logical time information for the table were
+preserved.
+
+ root@test15> importtable table1_copy /tmp/table1_export_dest
+ root@test15> table table1_copy
+ root@test15 table1_copy> scan
+ a cf1:cq1 [] v1
+ h cf1:cq1 [] v2
+ z cf1:cq1 [] v3
+ z cf1:cq2 [] v4
+ root@test15 table1_copy> getsplits -t table1_copy
+ b
+ r
+ root@test15> config -t table1_copy -f split
+ ---------+--------------------------+-------------------------------------------
+ SCOPE | NAME | VALUE
+ ---------+--------------------------+-------------------------------------------
+ default | table.split.threshold .. | 1G
+ table | @override ........... | 100M
+ ---------+--------------------------+-------------------------------------------
+ root@test15> tables -l
+ accumulo.metadata => !0
+ accumulo.root => +r
+ table1_copy => 5
+ trace => 1
+ root@test15 table1_copy> scan -t accumulo.metadata -b 5 -c srv:time
+ 5;b srv:time [] M1343224500467
+ 5;r srv:time [] M1343224500467
+ 5< srv:time [] M1343224500467
+
+
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/filedata.html
----------------------------------------------------------------------
diff --git a/1.8/examples/filedata.html b/1.8/examples/filedata.html
index b8125d8..45bca81 100644
--- a/1.8/examples/filedata.html
+++ b/1.8/examples/filedata.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo File System Archive Example (Data Only)</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo File System Archive Example (Data Only)</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This example archives file data into an Accumulo table. Files with duplicate data are only stored once.
+ <p>Title: Apache Accumulo File System Archive Example (Data Only)
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This example archives file data into an Accumulo table. Files with duplicate data are only stored once.
The example has the following classes:</p>
<ul>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/filedata.md
----------------------------------------------------------------------
diff --git a/1.8/examples/filedata.md b/1.8/examples/filedata.md
new file mode 100644
index 0000000..26a6c1e
--- /dev/null
+++ b/1.8/examples/filedata.md
@@ -0,0 +1,47 @@
+Title: Apache Accumulo File System Archive Example (Data Only)
+Notice: 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.
+
+This example archives file data into an Accumulo table. Files with duplicate data are only stored once.
+The example has the following classes:
+
+ * CharacterHistogram - A MapReduce that computes a histogram of byte frequency for each file and stores the histogram alongside the file data. An example use of the ChunkInputFormat.
+ * ChunkCombiner - An Iterator that dedupes file data and sets their visibilities to a combined visibility based on current references to the file data.
+ * ChunkInputFormat - An Accumulo InputFormat that provides keys containing file info (List<Entry<Key,Value>>) and values with an InputStream over the file (ChunkInputStream).
+ * ChunkInputStream - An input stream over file data stored in Accumulo.
+ * FileDataIngest - Takes a list of files and archives them into Accumulo keyed on hashes of the files.
+ * FileDataQuery - Retrieves file data based on the hash of the file. (Used by the dirlist.Viewer.)
+ * KeyUtil - A utility for creating and parsing null-byte separated strings into/from Text objects.
+ * VisibilityCombiner - A utility for merging visibilities into the form (VIS1)|(VIS2)|...
+
+This example is coupled with the dirlist example. See README.dirlist for instructions.
+
+If you haven't already run the README.dirlist example, ingest a file with FileDataIngest.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.filedata.FileDataIngest -i instance -z zookeepers -u username -p password -t dataTable --auths exampleVis --chunk 1000 $ACCUMULO_HOME/README
+
+Open the accumulo shell and look at the data. The row is the MD5 hash of the file, which you can verify by running a command such as 'md5sum' on the file.
+
+ > scan -t dataTable
+
+Run the CharacterHistogram MapReduce to add some information about the file.
+
+ $ bin/tool.sh lib/accumulo-examples-simple.jar org.apache.accumulo.examples.simple.filedata.CharacterHistogram -i instance -z zookeepers -u username -p password -t dataTable --auths exampleVis --vis exampleVis
+
+Scan again to see the histogram stored in the 'info' column family.
+
+ > scan -t dataTable
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/filter.html
----------------------------------------------------------------------
diff --git a/1.8/examples/filter.html b/1.8/examples/filter.html
index 9cd1ca1..3b6977d 100644
--- a/1.8/examples/filter.html
+++ b/1.8/examples/filter.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Filter Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Filter Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This is a simple filter example. It uses the AgeOffFilter that is provided as
+ <p>Title: Apache Accumulo Filter Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This is a simple filter example. It uses the AgeOffFilter that is provided as
part of the core package org.apache.accumulo.core.iterators.user. Filters are
iterators that select desired key/value pairs (or weed out undesired ones).
Filters extend the org.apache.accumulo.core.iterators.Filter class
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/filter.md
----------------------------------------------------------------------
diff --git a/1.8/examples/filter.md b/1.8/examples/filter.md
new file mode 100644
index 0000000..e00ba4a
--- /dev/null
+++ b/1.8/examples/filter.md
@@ -0,0 +1,110 @@
+Title: Apache Accumulo Filter Example
+Notice: 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.
+
+This is a simple filter example. It uses the AgeOffFilter that is provided as
+part of the core package org.apache.accumulo.core.iterators.user. Filters are
+iterators that select desired key/value pairs (or weed out undesired ones).
+Filters extend the org.apache.accumulo.core.iterators.Filter class
+and must implement a method accept(Key k, Value v). This method returns true
+if the key/value pair are to be delivered and false if they are to be ignored.
+Filter takes a "negate" parameter which defaults to false. If set to true, the
+return value of the accept method is negated, so that key/value pairs accepted
+by the method are omitted by the Filter.
+
+ username@instance> createtable filtertest
+ username@instance filtertest> setiter -t filtertest -scan -p 10 -n myfilter -ageoff
+ AgeOffFilter removes entries with timestamps more than <ttl> milliseconds old
+ ----------> set AgeOffFilter parameter negate, default false keeps k/v that pass accept method, true rejects k/v that pass accept method:
+ ----------> set AgeOffFilter parameter ttl, time to live (milliseconds): 30000
+ ----------> set AgeOffFilter parameter currentTime, if set, use the given value as the absolute time in milliseconds as the current time of day:
+ username@instance filtertest> scan
+ username@instance filtertest> insert foo a b c
+ username@instance filtertest> scan
+ foo a:b [] c
+ username@instance filtertest>
+
+... wait 30 seconds ...
+
+ username@instance filtertest> scan
+ username@instance filtertest>
+
+Note the absence of the entry inserted more than 30 seconds ago. Since the
+scope was set to "scan", this means the entry is still in Accumulo, but is
+being filtered out at query time. To delete entries from Accumulo based on
+the ages of their timestamps, AgeOffFilters should be set up for the "minc"
+and "majc" scopes, as well.
+
+To force an ageoff of the persisted data, after setting up the ageoff iterator
+on the "minc" and "majc" scopes you can flush and compact your table. This will
+happen automatically as a background operation on any table that is being
+actively written to, but can also be requested in the shell.
+
+The first setiter command used the special -ageoff flag to specify the
+AgeOffFilter, but any Filter can be configured by using the -class flag. The
+following commands show how to enable the AgeOffFilter for the minc and majc
+scopes using the -class flag, then flush and compact the table.
+
+ username@instance filtertest> setiter -t filtertest -minc -majc -p 10 -n myfilter -class org.apache.accumulo.core.iterators.user.AgeOffFilter
+ AgeOffFilter removes entries with timestamps more than <ttl> milliseconds old
+ ----------> set AgeOffFilter parameter negate, default false keeps k/v that pass accept method, true rejects k/v that pass accept method:
+ ----------> set AgeOffFilter parameter ttl, time to live (milliseconds): 30000
+ ----------> set AgeOffFilter parameter currentTime, if set, use the given value as the absolute time in milliseconds as the current time of day:
+ username@instance filtertest> flush
+ 06 10:42:24,806 [shell.Shell] INFO : Flush of table filtertest initiated...
+ username@instance filtertest> compact
+ 06 10:42:36,781 [shell.Shell] INFO : Compaction of table filtertest started for given range
+ username@instance filtertest> flush -t filtertest -w
+ 06 10:42:52,881 [shell.Shell] INFO : Flush of table filtertest completed.
+ username@instance filtertest> compact -t filtertest -w
+ 06 10:43:00,632 [shell.Shell] INFO : Compacting table ...
+ 06 10:43:01,307 [shell.Shell] INFO : Compaction of table filtertest completed for given range
+ username@instance filtertest>
+
+By default, flush and compact execute in the background, but with the -w flag
+they will wait to return until the operation has completed. Both are
+demonstrated above, though only one call to each would be necessary. A
+specific table can be specified with -t.
+
+After the compaction runs, the newly created files will not contain any data
+that should have been aged off, and the Accumulo garbage collector will remove
+the old files.
+
+To see the iterator settings for a table, use config.
+
+ username@instance filtertest> config -t filtertest -f iterator
+ ---------+---------------------------------------------+---------------------------------------------------------------------------
+ SCOPE | NAME | VALUE
+ ---------+---------------------------------------------+---------------------------------------------------------------------------
+ table | table.iterator.majc.myfilter .............. | 10,org.apache.accumulo.core.iterators.user.AgeOffFilter
+ table | table.iterator.majc.myfilter.opt.ttl ...... | 30000
+ table | table.iterator.majc.vers .................. | 20,org.apache.accumulo.core.iterators.user.VersioningIterator
+ table | table.iterator.majc.vers.opt.maxVersions .. | 1
+ table | table.iterator.minc.myfilter .............. | 10,org.apache.accumulo.core.iterators.user.AgeOffFilter
+ table | table.iterator.minc.myfilter.opt.ttl ...... | 30000
+ table | table.iterator.minc.vers .................. | 20,org.apache.accumulo.core.iterators.user.VersioningIterator
+ table | table.iterator.minc.vers.opt.maxVersions .. | 1
+ table | table.iterator.scan.myfilter .............. | 10,org.apache.accumulo.core.iterators.user.AgeOffFilter
+ table | table.iterator.scan.myfilter.opt.ttl ...... | 30000
+ table | table.iterator.scan.vers .................. | 20,org.apache.accumulo.core.iterators.user.VersioningIterator
+ table | table.iterator.scan.vers.opt.maxVersions .. | 1
+ ---------+---------------------------------------------+---------------------------------------------------------------------------
+ username@instance filtertest>
+
+When setting new iterators, make sure to order their priority numbers
+(specified with -p) in the order you would like the iterators to be applied.
+Also, each iterator must have a unique name and priority within each scope.
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/helloworld.html
----------------------------------------------------------------------
diff --git a/1.8/examples/helloworld.html b/1.8/examples/helloworld.html
index 2565ba5..3053c9b 100644
--- a/1.8/examples/helloworld.html
+++ b/1.8/examples/helloworld.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Hello World Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Hello World Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.helloworld in the examples-simple module:</p>
+ <p>Title: Apache Accumulo Hello World Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.helloworld in the examples-simple module:</p>
<ul>
<li>InsertWithBatchWriter.java - Inserts 10K rows (50K entries) into accumulo with each row having 5 entries</li>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/helloworld.md
----------------------------------------------------------------------
diff --git a/1.8/examples/helloworld.md b/1.8/examples/helloworld.md
new file mode 100644
index 0000000..618e301
--- /dev/null
+++ b/1.8/examples/helloworld.md
@@ -0,0 +1,47 @@
+Title: Apache Accumulo Hello World Example
+Notice: 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.
+
+This tutorial uses the following Java classes, which can be found in org.apache.accumulo.examples.simple.helloworld in the examples-simple module:
+
+ * InsertWithBatchWriter.java - Inserts 10K rows (50K entries) into accumulo with each row having 5 entries
+ * ReadData.java - Reads all data between two rows
+
+Log into the accumulo shell:
+
+ $ ./bin/accumulo shell -u username -p password
+
+Create a table called 'hellotable':
+
+ username@instance> createtable hellotable
+
+Launch a Java program that inserts data with a BatchWriter:
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.helloworld.InsertWithBatchWriter -i instance -z zookeepers -u username -p password -t hellotable
+
+On the accumulo status page at the URL below (where 'master' is replaced with the name or IP of your accumulo master), you should see 50K entries
+
+ http://master:9995/
+
+To view the entries, use the shell to scan the table:
+
+ username@instance> table hellotable
+ username@instance hellotable> scan
+
+You can also use a Java class to scan the table:
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.helloworld.ReadData -i instance -z zookeepers -u username -p password -t hellotable --startKey row_0 --endKey row_1001
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/index.html
----------------------------------------------------------------------
diff --git a/1.8/examples/index.html b/1.8/examples/index.html
index 998e86c..29f16ab 100644
--- a/1.8/examples/index.html
+++ b/1.8/examples/index.html
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/isolation.html
----------------------------------------------------------------------
diff --git a/1.8/examples/isolation.html b/1.8/examples/isolation.html
index c01bf9a..97bf33b 100644
--- a/1.8/examples/isolation.html
+++ b/1.8/examples/isolation.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo Isolation Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo Isolation Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>Accumulo has an isolated scanner that ensures partial changes to rows are not
+ <p>Title: Apache Accumulo Isolation Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>Accumulo has an isolated scanner that ensures partial changes to rows are not
seen. Isolation is documented in ../docs/isolation.html and the user manual.</p>
<p>InterferenceTest is a simple example that shows the effects of scanning with
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/isolation.md
----------------------------------------------------------------------
diff --git a/1.8/examples/isolation.md b/1.8/examples/isolation.md
new file mode 100644
index 0000000..4739f59
--- /dev/null
+++ b/1.8/examples/isolation.md
@@ -0,0 +1,50 @@
+Title: Apache Accumulo Isolation Example
+Notice: 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.
+
+
+Accumulo has an isolated scanner that ensures partial changes to rows are not
+seen. Isolation is documented in ../docs/isolation.html and the user manual.
+
+InterferenceTest is a simple example that shows the effects of scanning with
+and without isolation. This program starts two threads. One threads
+continually upates all of the values in a row to be the same thing, but
+different from what it used to be. The other thread continually scans the
+table and checks that all values in a row are the same. Without isolation the
+scanning thread will sometimes see different values, which is the result of
+reading the row at the same time a mutation is changing the row.
+
+Below, Interference Test is run without isolation enabled for 5000 iterations
+and it reports problems.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.isolation.InterferenceTest -i instance -z zookeepers -u username -p password -t isotest --iterations 5000
+ ERROR Columns in row 053 had multiple values [53, 4553]
+ ERROR Columns in row 061 had multiple values [561, 61]
+ ERROR Columns in row 070 had multiple values [570, 1070]
+ ERROR Columns in row 079 had multiple values [1079, 1579]
+ ERROR Columns in row 088 had multiple values [2588, 1588]
+ ERROR Columns in row 106 had multiple values [2606, 3106]
+ ERROR Columns in row 115 had multiple values [4615, 3115]
+ finished
+
+Below, Interference Test is run with isolation enabled for 5000 iterations and
+it reports no problems.
+
+ $ ./bin/accumulo org.apache.accumulo.examples.simple.isolation.InterferenceTest -i instance -z zookeepers -u username -p password -t isotest --iterations 5000 --isolated
+ finished
+
+
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/1d06e96a/1.8/examples/mapred.html
----------------------------------------------------------------------
diff --git a/1.8/examples/mapred.html b/1.8/examples/mapred.html
index ac9bc66..9eb7973 100644
--- a/1.8/examples/mapred.html
+++ b/1.8/examples/mapred.html
@@ -25,7 +25,7 @@
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/v/bs/jq-2.2.3/dt-1.10.12/datatables.min.css">
<link href="/css/accumulo.css" rel="stylesheet" type="text/css">
-<title>Apache Accumulo MapReduce Example</title>
+<title>Apache Accumulo\u2122</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
@@ -84,7 +84,7 @@
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Releases<span class="caret"></span></a>
<ul class="dropdown-menu">
- <li><a href="/release/accumulo-1.8.0/">1.8.0 (Latest)</a></li>
+ <li><a href="/release/accumulo-1.8.1/">1.8.1 (Latest)</a></li>
<li><a href="/release/accumulo-1.7.2/">1.7.2</a></li>
<li><a href="/release/accumulo-1.6.6/">1.6.6</a></li>
<li><a href="/release/">Archive</a></li>
@@ -140,9 +140,27 @@
</div>
<div id="content">
- <h1 class="title">Apache Accumulo MapReduce Example</h1>
+ <h1 class="title">Apache Accumulo\u2122</h1>
- <p>This example uses mapreduce and accumulo to compute word counts for a set of
+ <p>Title: Apache Accumulo MapReduce Example
+Notice: 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
+ \u201cLicense\u201d); 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
+ \u201cAS IS\u201d 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.</p>
+
+<p>This example uses mapreduce and accumulo to compute word counts for a set of
documents. This is accomplished using a map-only mapreduce job and a
accumulo table with combiners.</p>