accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwa...@apache.org
Subject [accumulo-website] branch asf-site updated: Jekyll build from master:6e7943f
Date Mon, 19 Nov 2018 21:27:28 GMT
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 <mwalch@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>
&amp; 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"
     },


Mime
View raw message