You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by mw...@apache.org on 2018/11/19 21:27:28 UTC
[accumulo-website] branch asf-site updated: Jekyll build from
master:6e7943f
This is an automated email from the ASF dual-hosted git repository.
mwalch pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 145f9f7 Jekyll build from master:6e7943f
145f9f7 is described below
commit 145f9f7816e1fc3337331e5528323bbcddea0cb2
Author: Mike Walch <mw...@apache.org>
AuthorDate: Mon Nov 19 16:20:39 2018 -0500
Jekyll build from master:6e7943f
Refactored configuration overview (#132)
---
docs/2.x/configuration/overview.html | 71 ++++++++++++++---------
docs/2.x/getting-started/table_configuration.html | 4 +-
feed.xml | 4 +-
search_data.json | 4 +-
4 files changed, 48 insertions(+), 35 deletions(-)
diff --git a/docs/2.x/configuration/overview.html b/docs/2.x/configuration/overview.html
index 09ac609..626424a 100644
--- a/docs/2.x/configuration/overview.html
+++ b/docs/2.x/configuration/overview.html
@@ -437,66 +437,79 @@
<h2 id="server-configuration">Server Configuration</h2>
-<p>Accumulo services (i.e master, tablet server, monitor, etc) are configured by <a href="/docs/2.x/configuration/server-properties">server properties</a> whose values can be
-set in the following locations (with increasing precedence):</p>
+<p>Accumulo processes (i.e master, tablet server, monitor, etc) are configured by <a href="/docs/2.x/configuration/server-properties">server properties</a> whose values can be
+set in the following configuration locations (with increasing precedence) that are described in detail below:</p>
<ol>
- <li>Default values</li>
- <li><a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a> (overrides defaults)</li>
- <li>Zookeeper (overrides <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a> & defaults)</li>
+ <li><a href="#default">Default</a> - All properties have a default value</li>
+ <li><a href="#site">Site</a> - Properties set in <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a></li>
+ <li><a href="#system">System</a> - Properties set using shell or Java API that apply to entire Accumulo instance</li>
+ <li><a href="#namespace">Namespace</a> - Table properties set using shell or Java API that apply to a table namespace</li>
+ <li><a href="#table">Table</a> - Table properties set using shell or Java API that apply to a table.</li>
</ol>
<p>If a property is set in multiple locations, the value in the location with the highest precedence is used.</p>
-<p>The configuration locations above are described in detail below.</p>
+<p>These configuration locations are described in detail below:</p>
-<h3 id="default-values">Default values</h3>
+<h3 id="default">Default</h3>
<p>All <a href="/docs/2.x/configuration/server-properties">server properties</a> have a default value. Default values are set in the source code and can be viewed for each property on the <a href="/docs/2.x/configuration/server-properties">server properties</a> page.
While default values have the lowest precedence, they are usually optimal. However, there are cases where a change can increase query and ingest performance.</p>
-<h3 id="accumuloproperties">accumulo.properties</h3>
+<h3 id="site">Site</h3>
-<p>Setting <a href="/docs/2.x/configuration/server-properties">server properties</a> in <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a> will override their default value. If you are running Accumulo on a cluster, any updates to accumulo.properties must
-be synced across the cluster. Accumulo processes (master, tserver, etc) read their local <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a> on start up so processes must be restarted to apply changes.
-Certain properties can only be set in accumulo.properties. These properties have <strong>zk mutable: no</strong> in their description. Setting properties in accumulo.properties allows you
-to configure tablet servers with different settings.</p>
+<p>Site configuration refers to <a href="/docs/2.x/configuration/server-properties">server properties</a> set in the <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a> file. Site configuration will override the default value of a property. If you are
+running Accumulo on a cluster, any updates to accumulo.properties must be synced across the cluster. Accumulo processes (master, tserver, etc) read their local <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a>
+on start up so processes must be restarted to apply changes. Certain properties can only be set in accumulo.properties. These properties have <strong>zk mutable: no</strong> in their description.
+Setting properties in accumulo.properties allows you to configure tablet servers with different settings.</p>
-<h3 id="zookeeper">Zookeeper</h3>
-
-<p>Many <a href="/docs/2.x/configuration/server-properties">server properties</a> can be set in Zookeeper using the Accumulo API or shell. These properties can identified by <strong>zk mutable: yes</strong> in their description on
-the <a href="/docs/2.x/configuration/server-properties">server properties</a> page. Zookeeper properties can be applied on a per-table or system-wide basis. Per-table properties take precedence over system-wide
-properties. While most properties set in Zookeeper take effect immediately, some require a restart of the process which is indicated in <strong>zk mutable</strong> section
-of their description.</p>
+<p>Site configuration can be overriden when starting an Accumulo process on the command line (by using the <code class="highlighter-rouge">-o</code> option):</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>accumulo tserver -o instance.secret=mysecret -o instance.zookeeper.host=localhost:2181
+</code></pre></div></div>
+<p>Overriding properties is useful if you can’t change <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a>. It’s done when <a href="https://github.com/apache/accumulo-docker">running Accumulo using Docker</a>.</p>
-<h4 id="zookeeper-system-properties">Zookeeper System properties</h4>
+<h3 id="system">System</h3>
-<p>System properties consist of all <a href="/docs/2.x/configuration/server-properties">server properties</a> with <strong>zk mutable: yes</strong> in their description. They are set with the following shell command:</p>
+<p>System configuration refers to <a href="/docs/2.x/configuration/server-properties">server properties</a> set for the entire Accumulo instance/cluster. These settings are stored in ZooKeeper and can identified by <strong>zk mutable: yes</strong>
+in their description on the <a href="/docs/2.x/configuration/server-properties">server properties</a> page. System configuration will override any site configuration set in <a href="/docs/2.x/configuration/files#accumuloproperties">accumulo.properties</a>. While most system configuration
+settings take effect immediately, some require a restart of the process which is indicated in the <strong>zk mutable</strong> section of their description. System configuration can be set using
+the following shell command:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>config -s PROPERTY=VALUE
</code></pre></div></div>
-<p>If a <a href="/docs/2.x/configuration/server-properties#table_prefix">table.*</a> property is set using this method, the value will apply to all tables except those configured on per-table basis (which have higher precedence).</p>
-
-<h4 id="zookeeper-table-properties">Zookeeper Table properties</h4>
+<p>They can also be set using <a href="https://static.javadoc.io/org.apache.accumulo/accumulo-core/2.0.0-alpha-1/org/apache/accumulo/core/client/admin/InstanceOperations.html">InstanceOperations</a> in the Java API:</p>
-<p>Table properties consist of all properties with the <a href="/docs/2.x/configuration/server-properties#table_prefix">table.*</a> prefix.</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">instanceOperations</span><span class="o">().</span><span class="na">setProperty</span><span class="o">(</span><span class="s">"table.durability"</span><span class="o">,</span> <span class="s">"flush"</span><span class="o">);</span>
+</code></pre></div></div>
-<p>Table properties are configured for a table namespace (i.e group of tables) or on a per-table basis.</p>
+<h3 id="namespace">Namespace</h3>
-<p>To configure a table property for a namespace, use the following command:</p>
+<p>Namespace configuration refers to <a href="/docs/2.x/configuration/server-properties#table_prefix">table.* properties</a> set for a certain table namespace (i.e group of tables). These settings are stored in ZooKeeper. Namespace configuration
+will override System configuration and can be set using the following shell command:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>config -ns NAMESPACE -s PROPERTY=VALUE
</code></pre></div></div>
-<p>To configure a table property for a specific table, use the following command:</p>
+<p>It can also be set using <a href="https://static.javadoc.io/org.apache.accumulo/accumulo-core/2.0.0-alpha-1/org/apache/accumulo/core/client/admin/NamespaceOperations.html">NamespaceOperations</a> in the Java API:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">namespaceOperations</span><span class="o">().</span><span class="na">setProperty</span><span class="o">(</span><span class="s">"mynamespace"</span><span class="o">,</span> <span class="s">"table.durability"</span><span class="o">,</span> <span class="s">"sync"</span><span class="o">);</span>
+</code></pre></div></div>
+
+<h3 id="table">Table</h3>
+
+<p>Table configuration refers to <a href="/docs/2.x/configuration/server-properties#table_prefix">table.* properties</a> set for a certain table. These settings are stored in ZooKeeper and can be set using the following shell command:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>config -t TABLE -s PROPERTY=VALUE
</code></pre></div></div>
-<p>Per-table settings take precedent over table namespace settings. Both take precedent over system properties.</p>
+<p>They can also be set using <a href="https://static.javadoc.io/org.apache.accumulo/accumulo-core/2.0.0-alpha-1/org/apache/accumulo/core/client/admin/TableOperations.html">TableOperations</a> in the Java API:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">tableOperations</span><span class="o">().</span><span class="na">setProperty</span><span class="o">(</span><span class="s">"mytable"</span><span class="o">,</span> <span class="s">"table.durability"</span><span class="o">,</span> <span class="s">"log"</span><span class="o">);</span>
+</code></pre></div></div>
-<h4 id="zookeeper-considerations">Zookeeper Considerations</h4>
+<h3 id="zookeeper-considerations">Zookeeper Considerations</h3>
<p>Any <a href="/docs/2.x/configuration/server-properties">server properties</a> that are set in Zookeeper should consider the limitations of Zookeeper itself with respect to the
number of nodes and the size of the node data. Custom table properties and options for Iterators configured on tables
diff --git a/docs/2.x/getting-started/table_configuration.html b/docs/2.x/getting-started/table_configuration.html
index ae4b8cd..081a6b0 100644
--- a/docs/2.x/getting-started/table_configuration.html
+++ b/docs/2.x/getting-started/table_configuration.html
@@ -431,8 +431,8 @@
<p>Accumulo tables have a few options that can be configured to alter the default
behavior of Accumulo as well as improve performance based on the data stored.
These include locality groups, constraints, bloom filters, iterators, and block
-cache. See the <a href="/docs/2.x/configuration/server-properties">configuration properties documentation</a> for
-a complete list of available configuration options.</p>
+cache. See the <a href="/docs/2.x/configuration/server-properties">server properties</a> documentation for a complete list of available
+configuration options.</p>
<h2 id="locality-groups">Locality Groups</h2>
diff --git a/feed.xml b/feed.xml
index cbeac48..9d5c507 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://accumulo.apache.org/</link>
<atom:link href="https://accumulo.apache.org/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Mon, 19 Nov 2018 12:03:25 -0500</pubDate>
- <lastBuildDate>Mon, 19 Nov 2018 12:03:25 -0500</lastBuildDate>
+ <pubDate>Mon, 19 Nov 2018 16:20:31 -0500</pubDate>
+ <lastBuildDate>Mon, 19 Nov 2018 16:20:31 -0500</lastBuildDate>
<generator>Jekyll v3.7.3</generator>
diff --git a/search_data.json b/search_data.json
index e89c9d9..1a506fc 100644
--- a/search_data.json
+++ b/search_data.json
@@ -72,7 +72,7 @@
"docs-2-x-configuration-overview": {
"title": "Configuration Overview",
- "content" : "Configuration is managed differently for Accumulo clients and servers.Client ConfigurationAccumulo clients are created using Java builder methods, a Java properties object or anaccumulo-client.properties file containing client properties.Server ConfigurationAccumulo services (i.e master, tablet server, monitor, etc) are configured by server properties whose values can beset in the following locations (with increasing precedence): Default values accumulo.properties ( [...]
+ "content" : "Configuration is managed differently for Accumulo clients and servers.Client ConfigurationAccumulo clients are created using Java builder methods, a Java properties object or anaccumulo-client.properties file containing client properties.Server ConfigurationAccumulo processes (i.e master, tablet server, monitor, etc) are configured by server properties whose values can beset in the following configuration locations (with increasing precedence) that are described in de [...]
"url": " /docs/2.x/configuration/overview",
"categories": "configuration"
},
@@ -177,7 +177,7 @@
"docs-2-x-getting-started-table-configuration": {
"title": "Table Configuration",
- "content" : "Accumulo tables have a few options that can be configured to alter the defaultbehavior of Accumulo as well as improve performance based on the data stored.These include locality groups, constraints, bloom filters, iterators, and blockcache. See the configuration properties documentation fora complete list of available configuration options.Locality GroupsAccumulo supports storing sets of column families separately on disk to allowclients to efficiently scan over colu [...]
+ "content" : "Accumulo tables have a few options that can be configured to alter the defaultbehavior of Accumulo as well as improve performance based on the data stored.These include locality groups, constraints, bloom filters, iterators, and blockcache. See the server properties documentation for a complete list of availableconfiguration options.Locality GroupsAccumulo supports storing sets of column families separately on disk to allowclients to efficiently scan over columns tha [...]
"url": " /docs/2.x/getting-started/table_configuration",
"categories": "getting-started"
},