accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwa...@apache.org
Subject accumulo-website git commit: Jekyll build from master:2b8bf45
Date Fri, 30 Jun 2017 19:45:18 GMT
Repository: accumulo-website
Updated Branches:
  refs/heads/asf-site 429e9884e -> 13a473a67


Jekyll build from master:2b8bf45

Merge branch 'config-mgmt'


Project: http://git-wip-us.apache.org/repos/asf/accumulo-website/repo
Commit: http://git-wip-us.apache.org/repos/asf/accumulo-website/commit/13a473a6
Tree: http://git-wip-us.apache.org/repos/asf/accumulo-website/tree/13a473a6
Diff: http://git-wip-us.apache.org/repos/asf/accumulo-website/diff/13a473a6

Branch: refs/heads/asf-site
Commit: 13a473a67c41c78e02a8c8ca032c80b0e4b494a0
Parents: 429e988
Author: Mike Walch <mwalch@apache.org>
Authored: Fri Jun 30 15:44:09 2017 -0400
Committer: Mike Walch <mwalch@apache.org>
Committed: Fri Jun 30 15:44:09 2017 -0400

----------------------------------------------------------------------
 css/accumulo.css                                |  2 +-
 .../configuration-management.html               | 93 ++++++++++++--------
 feed.xml                                        |  4 +-
 3 files changed, 60 insertions(+), 39 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/13a473a6/css/accumulo.css
----------------------------------------------------------------------
diff --git a/css/accumulo.css b/css/accumulo.css
index ceeb52b..6117187 100644
--- a/css/accumulo.css
+++ b/css/accumulo.css
@@ -79,7 +79,7 @@ h6 { font-size: 15px; }
 
 body { font-size: 14px; }
 
-code { background-color: #f5f5f5; color: #20b2aa; /* override nowrap in bootstrap */ white-space:
normal; }
+code { background-color: #f5f5f5; color: #555; /* override nowrap in bootstrap */ white-space:
normal; }
 
 #nav-logo { padding-top: 10px; padding-bottom: 10px; padding-left: 10px; }
 

http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/13a473a6/docs/unreleased/administration/configuration-management.html
----------------------------------------------------------------------
diff --git a/docs/unreleased/administration/configuration-management.html b/docs/unreleased/administration/configuration-management.html
index 885625b..3f12df7 100644
--- a/docs/unreleased/administration/configuration-management.html
+++ b/docs/unreleased/administration/configuration-management.html
@@ -329,72 +329,92 @@
       <div class="col-md-2"><a class="pull-right" style="margin-top: 25px;" href="https://github.com/apache/accumulo-website/edit/master/_docs-unreleased/administration/configuration-management.md"
role="button"><i class="glyphicon glyphicon-pencil"></i> <small>Edit
this page</small></a></div>
     </div>  
     
-    <h2 id="configuration-overview">Configuration Overview</h2>
+    <h2 id="setting-configuration">Setting Configuration</h2>
 
-<p>All accumulo properties have a default value in the source code.  Properties can
also be set
-in accumulo-site.xml and in zookeeper on per-table or system-wide basis.  If properties are
set in more than one location,
-accumulo will choose the property with the highest precedence.  This order of precedence
is described
-below (from highest to lowest):</p>
+<p>Accumulo is configured using <a href="/docs/unreleased/administration/configuration-properties">properties</a>
whose values can be set in the following locations (with increasing precedence):</p>
 
-<h3 id="zookeeper-table-properties">Zookeeper table properties</h3>
+<ol>
+  <li>Default values</li>
+  <li>accumulo-site.xml (overrides defaults)</li>
+  <li>Zookeeper (overrides accumulo-site.xml &amp; defaults)</li>
+</ol>
 
-<p>Table properties are applied to the entire cluster when set in zookeeper using the
accumulo API or shell.  While table properties take precedent over system properties, both
will override properties set in accumulo-site.xml</p>
+<p>If a property is set in multiple locations, the value in the location with the highest
precedence is used.</p>
 
-<p>Table properties consist of all properties with the table.* prefix.  Table properties
are configured on a per-table basis using the following shell command:</p>
+<p>The configuration locations above are described in detail below.</p>
 
-<div class="highlighter-rouge"><pre class="highlight"><code>config -t TABLE
-s PROPERTY=VALUE
-</code></pre>
-</div>
+<h3 id="default-values">Default values</h3>
+
+<p>All <a href="/docs/unreleased/administration/configuration-properties">properties</a>
have a default value that is listed for each property on the <a href="/docs/unreleased/administration/configuration-properties">properties</a>
page. Default values are set in the source code.
+While defalt values have the lowest precendence, they are usually optimal.  However, there
are cases where a change can increase query and ingest performance.</p>
+
+<h3 id="accumulo-sitexml">accumulo-site.xml</h3>
+
+<p>Setting <a href="/docs/unreleased/administration/configuration-properties">properties</a>
in accumulo-site.xml will override their default value. If you are running Accumulo on a cluster,
any updates to accumulo-site.xml must
+be synced across the cluster. Accumulo processes (master, tserver, etc) read their local
accumulo-site.xml on start up so processes must be restarted to apply changes.
+Certain properties can only be set in accumulo-site.xml. These properties have <strong>zk
mutable: no</strong> in their description. Setting properties in accumulo-site.xml allows
you
+to configure tablet servers with different settings.</p>
+
+<h3 id="zookeeper">Zookeeper</h3>
+
+<p>Many <a href="/docs/unreleased/administration/configuration-properties">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/unreleased/administration/configuration-properties">properties page</a>.
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>
 
-<h3 id="zookeeper-system-properties">Zookeeper system properties</h3>
+<h4 id="zookeeper-system-properties">Zookeeper System properties</h4>
 
-<p>System properties are applied to the entire cluster when set in zookeeper using
the accumulo API or shell.  System properties consist of all properties with a <code class="highlighter-rouge">yes</code>
in the <em>Zookeeper Mutable</em> column in the table below.  They are set with
the following shell command:</p>
+<p>System properties consist of all <a href="/docs/unreleased/administration/configuration-properties">properties</a>
with <strong>zk mutable: yes</strong> in their description. They are set with
the following shell command:</p>
 
 <div class="highlighter-rouge"><pre class="highlight"><code>config -s PROPERTY=VALUE
 </code></pre>
 </div>
 
-<p>If a table.* 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>
+<p>If a <code class="highlighter-rouge">table.*</code> 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>
 
-<p>While most system properties take effect immediately, some require a restart of
the process which is indicated in <em>Zookeeper Mutable</em>.</p>
+<h4 id="zookeeper-table-properties">Zookeeper Table properties</h4>
 
-<h3 id="accumulo-sitexml">accumulo-site.xml</h3>
+<p><a href="/docs/unreleased/administration/configuration-properties#table_prefix">Table
properties</a> consist of all properties with the <code class="highlighter-rouge">table.*</code>
prefix.</p>
 
-<p>Accumulo processes (master, tserver, etc) read their local accumulo-site.xml on
start up.  Therefore, changes made to accumulo-site.xml must synced across the cluster and
processes must be restarted to apply changes.</p>
+<p>Table properties are configured for a table namespace (i.e group of tables) or on
a per-table basis.</p>
 
-<p>Certain properties (indicated by a <code class="highlighter-rouge">no</code>
in <em>Zookeeper Mutable</em>) cannot be set in zookeeper and only set in this
file.  The accumulo-site.xml also allows you to configure tablet servers with different settings.</p>
+<p>To configure a table property for a namespace, use the following command:</p>
 
-<h3 id="default-values">Default Values</h3>
+<div class="highlighter-rouge"><pre class="highlight"><code>config -ns
NAMESPACE -s PROPERTY=VALUE
+</code></pre>
+</div>
 
-<p>All properties have a default value in the source code.  This value has the lowest
precedence and is overridden if set in accumulo-site.xml or zookeeper.</p>
+<p>To configure a table property for a specific table, use the following command:</p>
 
-<p>While the default value is usually optimal, there are cases where a change can increase
query and ingest performance.</p>
+<div class="highlighter-rouge"><pre class="highlight"><code>config -t TABLE
-s PROPERTY=VALUE
+</code></pre>
+</div>
+
+<p>Per-table settings take precedent over table namespace settings.  Both take precedent
over system properties.</p>
 
-<h3 id="zookeeper-property-considerations">ZooKeeper Property Considerations</h3>
+<h4 id="zookeeper-considerations">Zookeeper Considerations</h4>
 
-<p>Any properties that are stored in ZooKeeper should consider the limitations of ZooKeeper
itself with respect to the
+<p>Any <a href="/docs/unreleased/administration/configuration-properties">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
 are two areas in which there aren’t any fail safes built into the API that can prevent
the user from making this mistake.</p>
 
 <p>While these properties have the ability to add some much needed dynamic configuration
tools, use cases which might fall
 into these warnings should be reconsidered.</p>
 
-<h2 id="configuration-in-the-shell">Configuration in the Shell</h2>
+<h2 id="viewing-configuration">Viewing Configuration</h2>
 
-<p>The <code class="highlighter-rouge">config</code> command in the shell
allows you to view the current system configuration.  You can also use the <code class="highlighter-rouge">-t</code>
option to view a table’s configuration as below:</p>
+<p>Accumulo’s current configuration can be viewed in the shell using the <code
class="highlighter-rouge">config</code> command.</p>
 
-<div class="highlighter-rouge"><pre class="highlight"><code>$ ./bin/accumulo
shell -u root
-Enter current password for 'root'@'accumulo-instance': ******
+<ul>
+  <li><code class="highlighter-rouge">config</code> - view configuration
for the entire system</li>
+  <li><code class="highlighter-rouge">config -ns &lt;NAMESPACE&gt;</code>
- view configuration for a specific namespace</li>
+  <li><code class="highlighter-rouge">config -t &lt;TABLE&gt;</code>
- view configuration for a specific table</li>
+</ul>
 
-Shell - Apache Accumulo Interactive Shell
--
-- version: 2.x.x
-- instance name: accumulo-instance
-- instance id: 4f48fa03-f692-43ce-ae03-94c9ea8b7181
--
-- type 'help' for a list of available commands
--
-root@accumulo-instance&gt; config -t foo
+<p>Below is example shell output from viewing configuration for the table <code
class="highlighter-rouge">foo</code>. Please note how <code class="highlighter-rouge">table.compaction.major.ratio</code>
+is set in multiple locations but the value <code class="highlighter-rouge">1.6</code>
set in the <code class="highlighter-rouge">table</code> scope is used as it has
the highest precedence.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>root@accumulo-instance&gt;
config -t foo
 ---------+---------------------------------------------+------------------------------------------------------
 SCOPE    | NAME                                        | VALUE
 ---------+---------------------------------------------+------------------------------------------------------
@@ -420,6 +440,7 @@ default  | table.failures.ignore ..................... | false
 </div>
 
 
+
     <div class="row" style="margin-top: 20px;">
       <div class="col-md-10"><strong>Find documentation for all releases in the
<a href="/docs-archive">archive</strong></div>
       <div class="col-md-2"><a class="pull-right" href="https://github.com/apache/accumulo-website/edit/master/_docs-unreleased/administration/configuration-management.md"
role="button"><i class="glyphicon glyphicon-pencil"></i> <small>Edit
this page</small></a></div>

http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/13a473a6/feed.xml
----------------------------------------------------------------------
diff --git a/feed.xml b/feed.xml
index 764c47e..b501479 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>Fri, 30 Jun 2017 12:01:33 -0400</pubDate>
-    <lastBuildDate>Fri, 30 Jun 2017 12:01:33 -0400</lastBuildDate>
+    <pubDate>Fri, 30 Jun 2017 15:44:01 -0400</pubDate>
+    <lastBuildDate>Fri, 30 Jun 2017 15:44:01 -0400</lastBuildDate>
     <generator>Jekyll v3.3.1</generator>
     
       <item>


Mime
View raw message