Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id C5B3D200CB7 for ; Fri, 30 Jun 2017 18:02:07 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id C347D160BEB; Fri, 30 Jun 2017 16:02:07 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 99936160BDD for ; Fri, 30 Jun 2017 18:02:05 +0200 (CEST) Received: (qmail 1231 invoked by uid 500); 30 Jun 2017 16:02:04 -0000 Mailing-List: contact commits-help@accumulo.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@accumulo.apache.org Delivered-To: mailing list commits@accumulo.apache.org Received: (qmail 1222 invoked by uid 99); 30 Jun 2017 16:02:04 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 30 Jun 2017 16:02:04 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id A68CFDFB8A; Fri, 30 Jun 2017 16:02:04 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: mwalch@apache.org To: commits@accumulo.apache.org Message-Id: <6b7373bd4ad84f3f936d3d2af41c8008@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: accumulo-website git commit: Jekyll build from master:7fbaf66 Date: Fri, 30 Jun 2017 16:02:04 +0000 (UTC) archived-at: Fri, 30 Jun 2017 16:02:08 -0000 Repository: accumulo-website Updated Branches: refs/heads/asf-site 0064e629e -> 429e9884e Jekyll build from master:7fbaf66 Merge branch 'docs-post' Project: http://git-wip-us.apache.org/repos/asf/accumulo-website/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo-website/commit/429e9884 Tree: http://git-wip-us.apache.org/repos/asf/accumulo-website/tree/429e9884 Diff: http://git-wip-us.apache.org/repos/asf/accumulo-website/diff/429e9884 Branch: refs/heads/asf-site Commit: 429e9884e6283265a644c8179eb4b1b527305c78 Parents: 0064e62 Author: Mike Walch Authored: Fri Jun 30 12:01:42 2017 -0400 Committer: Mike Walch Committed: Fri Jun 30 12:01:42 2017 -0400 ---------------------------------------------------------------------- .../29/accumulo-documentation-improvements.html | 198 +++++++++++++++ .../configuration-management.html | 2 +- .../configuration-properties.html | 2 +- docs/unreleased/administration/fate.html | 2 +- .../administration/in-depth-install.html | 2 +- docs/unreleased/administration/kerberos.html | 2 +- .../administration/monitoring-metrics.html | 2 +- docs/unreleased/administration/multivolume.html | 2 +- docs/unreleased/administration/replication.html | 2 +- docs/unreleased/administration/ssl.html | 2 +- docs/unreleased/administration/tracing.html | 2 +- .../development/development_tools.html | 2 +- .../development/high_speed_ingest.html | 2 +- docs/unreleased/development/iterators.html | 2 +- docs/unreleased/development/mapreduce.html | 2 +- docs/unreleased/development/proxy.html | 2 +- docs/unreleased/development/sampling.html | 2 +- docs/unreleased/development/security.html | 2 +- docs/unreleased/development/summaries.html | 2 +- docs/unreleased/getting-started/clients.html | 2 +- docs/unreleased/getting-started/design.html | 2 +- .../getting-started/quick-install.html | 2 +- docs/unreleased/getting-started/shell.html | 2 +- .../getting-started/table_configuration.html | 2 +- .../getting-started/table_design.html | 2 +- docs/unreleased/index.html | 8 +- docs/unreleased/troubleshooting/advanced.html | 2 +- docs/unreleased/troubleshooting/basic.html | 2 +- .../troubleshooting/system-metadata-tables.html | 2 +- docs/unreleased/troubleshooting/tools.html | 2 +- feed.xml | 250 +++---------------- index.html | 14 +- news/index.html | 7 + 33 files changed, 280 insertions(+), 253 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/blog/2017/06/29/accumulo-documentation-improvements.html ---------------------------------------------------------------------- diff --git a/blog/2017/06/29/accumulo-documentation-improvements.html b/blog/2017/06/29/accumulo-documentation-improvements.html new file mode 100644 index 0000000..7137385 --- /dev/null +++ b/blog/2017/06/29/accumulo-documentation-improvements.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + +Documentation Improvements for 2.0 + + + + + + + + + + + + +
+
+
+ + +
+ +

Documentation Improvements for 2.0

+ +

+Author:   Mike Walch
+Date:   29 Jun 2017
+ +

+ +

Since Accumulo 1.5, the Accumulo user manual source resided in the source repository as asciidoc. For every release or update to the manual, +an HTML document is produced from the asciidoc, committed to the project website repository, and published to the website. This process will remain +for 1.x releases.

+ +

For 2.0, the source for the user manual was converted to markdown and moved to the website repository. The +upcoming 2.0 documentation has several improvements over the older documentation:

+ +
    +
  • Improved navigation using a new sidebar
    • +
  • Changes to the documentation are now immediately viewable on the website
    • +
  • Better linking to Javadocs and between documentation pages
    • +
  • Documentation style now matches the website
    • +
+ +

While the unreleased documentation is viewable, it is not linked to (except by this post) and every page contains a warning that the documentation +is for a future release. Each page also links to the documentation for the latest release.

+ +

It is now much easier to view, edit, and propose changes to the documentation. If you would like to contribute to the documentation for 2.0, view +the unreleased documentation. Each page has an Edit this page link that will take you to GitHub where you can edit the markdown for the page, preview it, +and submit a pull request to the website repository. A committer will review your changes so don’t be afraid to contribute!

+ + + +

View all posts in the news archive

+ +
+ + + + + +
+
+
+ + http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/configuration-management.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/configuration-management.html b/docs/unreleased/administration/configuration-management.html index d86aeec..885625b 100644 --- a/docs/unreleased/administration/configuration-management.html +++ b/docs/unreleased/administration/configuration-management.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Configuration Management

- +

Configuration Management

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/configuration-properties.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/configuration-properties.html b/docs/unreleased/administration/configuration-properties.html index 6a88a4f..7d5e687 100644 --- a/docs/unreleased/administration/configuration-properties.html +++ b/docs/unreleased/administration/configuration-properties.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Configuration Properties

- +

Configuration Properties

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/fate.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/fate.html b/docs/unreleased/administration/fate.html index abd69ce..a93d778 100644 --- a/docs/unreleased/administration/fate.html +++ b/docs/unreleased/administration/fate.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  FATE

- +

FATE

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/in-depth-install.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/in-depth-install.html b/docs/unreleased/administration/in-depth-install.html index 14191c4..79971d5 100644 --- a/docs/unreleased/administration/in-depth-install.html +++ b/docs/unreleased/administration/in-depth-install.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  In-depth Installation

- +

In-depth Installation

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/kerberos.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/kerberos.html b/docs/unreleased/administration/kerberos.html index 1b2e083..93a89c8 100644 --- a/docs/unreleased/administration/kerberos.html +++ b/docs/unreleased/administration/kerberos.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Kerberos

- +

Kerberos

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/monitoring-metrics.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/monitoring-metrics.html b/docs/unreleased/administration/monitoring-metrics.html index bc3d6ff..84f4e41 100644 --- a/docs/unreleased/administration/monitoring-metrics.html +++ b/docs/unreleased/administration/monitoring-metrics.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Monitoring & Metrics

- +

Monitoring & Metrics

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/multivolume.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/multivolume.html b/docs/unreleased/administration/multivolume.html index d6a3922..3a89dda 100644 --- a/docs/unreleased/administration/multivolume.html +++ b/docs/unreleased/administration/multivolume.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Multi-Volume Installations

- +

Multi-Volume Installations

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/replication.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/replication.html b/docs/unreleased/administration/replication.html index b3216c2..4aca63b 100644 --- a/docs/unreleased/administration/replication.html +++ b/docs/unreleased/administration/replication.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Replication

- +

Replication

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/ssl.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/ssl.html b/docs/unreleased/administration/ssl.html index 49d2235..a1fb5b5 100644 --- a/docs/unreleased/administration/ssl.html +++ b/docs/unreleased/administration/ssl.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  SSL

- +

SSL

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/administration/tracing.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/administration/tracing.html b/docs/unreleased/administration/tracing.html index f4dc0ac..07699cb 100644 --- a/docs/unreleased/administration/tracing.html +++ b/docs/unreleased/administration/tracing.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Administration  >>  Tracing

- +

Tracing

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/development_tools.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/development_tools.html b/docs/unreleased/development/development_tools.html index 1c57b49..dfd1ea2 100644 --- a/docs/unreleased/development/development_tools.html +++ b/docs/unreleased/development/development_tools.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Development Tools

- +

Development Tools

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/high_speed_ingest.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/high_speed_ingest.html b/docs/unreleased/development/high_speed_ingest.html index 5f21ffc..d67ac6d 100644 --- a/docs/unreleased/development/high_speed_ingest.html +++ b/docs/unreleased/development/high_speed_ingest.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  High-Speed Ingest

- +

High-Speed Ingest

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/iterators.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/iterators.html b/docs/unreleased/development/iterators.html index 4ef3fbc..32fc21a 100644 --- a/docs/unreleased/development/iterators.html +++ b/docs/unreleased/development/iterators.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Iterators

- +

Iterators

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/mapreduce.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/mapreduce.html b/docs/unreleased/development/mapreduce.html index 4d5f47e..f4e6030 100644 --- a/docs/unreleased/development/mapreduce.html +++ b/docs/unreleased/development/mapreduce.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  MapReduce

- +

MapReduce

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/proxy.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/proxy.html b/docs/unreleased/development/proxy.html index 0394c7e..a3be297 100644 --- a/docs/unreleased/development/proxy.html +++ b/docs/unreleased/development/proxy.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Proxy

- +

Proxy

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/sampling.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/sampling.html b/docs/unreleased/development/sampling.html index f206287..6eff507 100644 --- a/docs/unreleased/development/sampling.html +++ b/docs/unreleased/development/sampling.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Sampling

- +

Sampling

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/security.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/security.html b/docs/unreleased/development/security.html index 2ebc2e5..b7d80cb 100644 --- a/docs/unreleased/development/security.html +++ b/docs/unreleased/development/security.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Security

- +

Security

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/development/summaries.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/development/summaries.html b/docs/unreleased/development/summaries.html index bf8f55d..321899e 100644 --- a/docs/unreleased/development/summaries.html +++ b/docs/unreleased/development/summaries.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Development  >>  Summary Statistics

- +

Summary Statistics

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/clients.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/clients.html b/docs/unreleased/getting-started/clients.html index 249b4e1..edd9691 100644 --- a/docs/unreleased/getting-started/clients.html +++ b/docs/unreleased/getting-started/clients.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Accumulo Clients

- +

Accumulo Clients

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/design.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/design.html b/docs/unreleased/getting-started/design.html index 348dd97..504c418 100644 --- a/docs/unreleased/getting-started/design.html +++ b/docs/unreleased/getting-started/design.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Accumulo Design

- +

Accumulo Design

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/quick-install.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/quick-install.html b/docs/unreleased/getting-started/quick-install.html index 872b5a6..34dcb14 100644 --- a/docs/unreleased/getting-started/quick-install.html +++ b/docs/unreleased/getting-started/quick-install.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Quick Installation

- +

Quick Installation

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/shell.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/shell.html b/docs/unreleased/getting-started/shell.html index 7e35257..c66782d 100644 --- a/docs/unreleased/getting-started/shell.html +++ b/docs/unreleased/getting-started/shell.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Accumulo Shell

- +

Accumulo Shell

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/table_configuration.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/table_configuration.html b/docs/unreleased/getting-started/table_configuration.html index 4ca23ce..1e89323 100644 --- a/docs/unreleased/getting-started/table_configuration.html +++ b/docs/unreleased/getting-started/table_configuration.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Table Configuration

- +

Table Configuration

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/getting-started/table_design.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/getting-started/table_design.html b/docs/unreleased/getting-started/table_design.html index a7540a2..406ae0f 100644 --- a/docs/unreleased/getting-started/table_design.html +++ b/docs/unreleased/getting-started/table_design.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Getting started  >>  Table Design

- +

Table Design

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/index.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/index.html b/docs/unreleased/index.html index d1b67c8..74d6e28 100644 --- a/docs/unreleased/index.html +++ b/docs/unreleased/index.html @@ -318,6 +318,9 @@
+ + +

Accumulo unreleased documentation

@@ -328,9 +331,8 @@

The links below contain additional documentation for this release:

http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/troubleshooting/advanced.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/troubleshooting/advanced.html b/docs/unreleased/troubleshooting/advanced.html index 8db0a6c..451563f 100644 --- a/docs/unreleased/troubleshooting/advanced.html +++ b/docs/unreleased/troubleshooting/advanced.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Troubleshooting  >>  Advanced Troubleshooting

- +

Advanced Troubleshooting

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/troubleshooting/basic.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/troubleshooting/basic.html b/docs/unreleased/troubleshooting/basic.html index 0c2f43e..8a45f02 100644 --- a/docs/unreleased/troubleshooting/basic.html +++ b/docs/unreleased/troubleshooting/basic.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Troubleshooting  >>  Basic Troubleshooting

- +

Basic Troubleshooting

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/troubleshooting/system-metadata-tables.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/troubleshooting/system-metadata-tables.html b/docs/unreleased/troubleshooting/system-metadata-tables.html index c26a8ec..7358b8b 100644 --- a/docs/unreleased/troubleshooting/system-metadata-tables.html +++ b/docs/unreleased/troubleshooting/system-metadata-tables.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Troubleshooting  >>  System Metadata Tables

- +

System Metadata Tables

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/docs/unreleased/troubleshooting/tools.html ---------------------------------------------------------------------- diff --git a/docs/unreleased/troubleshooting/tools.html b/docs/unreleased/troubleshooting/tools.html index bd896b0..8018820 100644 --- a/docs/unreleased/troubleshooting/tools.html +++ b/docs/unreleased/troubleshooting/tools.html @@ -320,10 +320,10 @@

Accumulo unreleased docs  >>  Troubleshooting  >>  Troubleshooting Tools

- +

Troubleshooting Tools

Edit this page
http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/feed.xml ---------------------------------------------------------------------- diff --git a/feed.xml b/feed.xml index 7086a6c..764c47e 100644 --- a/feed.xml +++ b/feed.xml @@ -6,11 +6,44 @@ https://accumulo.apache.org/ - Tue, 27 Jun 2017 17:15:30 -0400 - Tue, 27 Jun 2017 17:15:30 -0400 + Fri, 30 Jun 2017 12:01:33 -0400 + Fri, 30 Jun 2017 12:01:33 -0400 Jekyll v3.3.1 + Documentation Improvements for 2.0 + <p>Since Accumulo 1.5, the <a href="/1.8/accumulo_user_manual.html">Accumulo user manual</a> source resided in the <a href="https://github.com/apache/accumulo">source repository</a> as asciidoc. For every release or update to the manual, +an HTML document is produced from the asciidoc, committed to the <a href="https://github.com/apache/accumulo-website">project website repository</a>, and published to the website. This process will remain +for 1.x releases.</p> + +<p>For 2.0, the source for the user manual was converted to markdown and moved to the <a href="https://github.com/apache/accumulo-website">website repository</a>. The +<a href="/docs/unreleased/">upcoming 2.0 documentation</a> has several improvements over the older documentation:</p> + +<ul> + <li>Improved navigation using a new sidebar</li> + <li>Changes to the documentation are now immediately viewable on the website</li> + <li>Better linking to Javadocs and between documentation pages</li> + <li>Documentation style now matches the website</li> +</ul> + +<p>While the <a href="/docs/unreleased/">unreleased documentation</a> is viewable, it is not linked to (except by this post) and every page contains a warning that the documentation +is for a future release. Each page also links to the documentation for the latest release.</p> + +<p>It is now much easier to view, edit, and propose changes to the documentation. If you would like to contribute to the documentation for 2.0, view +the <a href="/docs/unreleased/">unreleased documentation</a>. Each page has an <strong>Edit this page</strong> link that will take you to GitHub where you can edit the markdown for the page, preview it, +and submit a pull request to the <a href="https://github.com/apache/accumulo-website">website repository</a>. A committer will review your changes so don’t be afraid to contribute!</p> + + + Thu, 29 Jun 2017 00:00:00 -0400 + https://accumulo.apache.org/blog/2017/06/29/accumulo-documentation-improvements.html + https://accumulo.apache.org/blog/2017/06/29/accumulo-documentation-improvements.html + + + blog + + + + Introducing Uno and Muchos <p>While <a href="https://github.com/apache/accumulo/blob/master/INSTALL.md">Accumulo’s installation instructions</a> are simple, it can be time consuming to install Accumulo given its requirement on <a href="https://hadoop.apache.org/">Hadoop</a> and <a href="https://zookeeper.apache.org/">Zookeeper</a> being installed and running. For a one-time production @@ -1632,218 +1665,5 @@ HDFS High-Availability instances, forcing NameNode failover.</p> - - Apache Accumulo 1.8.0 - <p>Apache Accumulo 1.8.0 is a significant release that includes many important -milestone features which expand the functionality of Accumulo. These include -features related to security, availability, and extensibility. Over -350 JIRA issues were resolved in this version. This includes over -200 bug fixes and 71 improvements and 4 new features. See <a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12312121&amp;version=12329879">JIRA</a> -for the complete list.</p> - -<p>Below are resources for this release:</p> - -<ul> - <li><a href="/1.8/accumulo_user_manual.html">User Manual</a></li> - <li><a href="/1.8/apidocs">Javadocs</a></li> - <li><a href="/1.8/examples">Examples</a></li> -</ul> - -<p>In the context of Accumulo’s <a href="http://semver.org">Semantic Versioning</a> <a href="https://github.com/apache/accumulo/blob/1.8/README.md#api">guidelines</a>, -this is a “minor version”. This means that new APIs have been created, some -deprecations may have been added, but no deprecated APIs have been removed. -Code written against 1.7.x should work against 1.8.0 – binary compatibility -has been preserved with one exception of an already-deprecated Mock Accumulo -utility class. As always, the Accumulo developers take API compatibility -very seriously and have invested much time to ensure that we meet the promises set forth to our users.</p> - -<h2 id="major-changes">Major Changes</h2> - -<h3 id="speed-up-wal-roll-overs">Speed up WAL roll overs</h3> - -<p>Performance of writing mutations is improved by refactoring the -bookeeping required for Write-Ahead Log (WAL) files and by creating a -standby WAL for faster switching when the log is full. This was a -substantial refactor in the way WALs worked, but smoothes overall -ingest performance in addition to provides a increase in write speed -as shown by the simple test below. The top entry is before -<a href="https://issues.apache.org/jira/browse/ACCUMULO-3423">ACCUMULO-3423</a> and the bottom graph is after the -refactor.</p> - -<p><img src="https://issues.apache.org/jira/secure/attachment/12705402/WAL-slowdown-graphs.jpg" alt="Graph of WAL speed up after ACCUMULO-3423" title="Graph of WAL speed up after ACCUMULO-3423" /></p> - -<h3 id="user-level-api-for-rfile">User level API for RFile</h3> - -<p>Previously the only public API available to write RFiles was via the AccumuloFileOutputFormat. There was no way to read RFiles in the public -API. <a href="https://issues.apache.org/jira/browse/ACCUMULO-4165">ACCUMULO-4165</a> exposes a brand new public <a href="/1.8/apidocs/org/apache/accumulo/core/client/rfile/RFile.html">API</a> for reading and writing RFiles as well as cleans up some of the internal APIs.</p> - -<h3 id="suspend-tablet-assignment-for-rolling-restarts">Suspend Tablet assignment for rolling restarts</h3> - -<p>When a tablet server dies, Accumulo attempted to reassign the tablets as quickly as possible to maintain availability. -A new configuration property <code class="highlighter-rouge">table.suspend.duration</code> (with a default of zero seconds) now controls how long to wait before reassigning -a tablet from a dead tserver. The property is configurable via the -Accumulo shell, so you can set it, do a rolling restart, and then -set it back to 0. A new state as introduced, TableState.SUSPENDED to support this feature. By default, metadata tablet -reassignment is not suspended, but that can also be changed with the <code class="highlighter-rouge">master.metadata.suspendable</code> property that is false by -default. Root tablet assignment can not be suspended. See <a href="https://issues.apache.org/jira/browse/ACCUMULO-4353">ACCUMULO-4353</a> for more info.</p> - -<h3 id="run-multiple-tablet-servers-on-one-node">Run multiple Tablet Servers on one node</h3> - -<p><a href="https://issues.apache.org/jira/browse/ACCUMULO-4328">ACCUMULO-4328</a> introduces the capability of running multiple tservers on a single node. This is intended for nodes with a large -amounts of memory and/or disk. This feature is disabled by default. There are several related tickets: <a href="https://issues.apache.org/jira/browse/ACCUMULO-4072">ACCUMULO-4072</a>, <a href="https://issues.apache.org/jira/browse/ACCUMULO-4331">ACCUMULO-4331</a> -and <a href="https://issues.apache.org/jira/browse/ACCUMULO-4406">ACCUMULO-4406</a>. Note that when this is enabled, the names of the log files change. Previous log file names were defined in the -generic_logger.xml as <code class="highlighter-rouge">${org.apache.accumulo.core.application}_{org.apache.accumulo.core.ip.localhost.hostname}.log</code>. -The files will now include the instance id after the application with -<code class="highlighter-rouge">${org.apache.accumulo.core.application}_${instance}_${org.apache.accumulo.core.ip.localhost.hostname}.log</code>.</p> - -<p>For example: tserver_host.domain.com.log will become tserver_1_host.domain.log when multiple TabletServers -are run per host. The same change also applies to the debug logs provided in the example configurations. The log -names do not change if this feature is not used.</p> - -<h3 id="rate-limiting-major-compactions">Rate limiting Major Compactions</h3> - -<p>Major Compactions can significantly increase the amount of load on -TabletServers. <a href="https://issues.apache.org/jira/browse/ACCUMULO-4187">ACCUMULO-4187</a> restricts the rate at which data is -read and written when performing major compactions. This has a direct -effect on the IO load caused by major compactions with a similar -effect on the CPU utilization. This behavior is controlled by a new -property <code class="highlighter-rouge">tserver.compaction.major.throughput</code> with a defaults of 0B -which disables the rate limiting.</p> - -<h3 id="table-sampling">Table Sampling</h3> - -<p>Queryable sample data was added by <a href="https://issues.apache.org/jira/browse/ACCUMULO-3913">ACCUMULO-3913</a>. This allows users to configure a pluggable -function to generate sample data. At scan time, the sample data can optionally be scanned. -Iterators also have access to sample data. Iterators can access all data and sample data, this -allows an iterator to use sample data for query optimizations. The new user level RFile API -supports writing RFiles with sample data for bulk import.</p> - -<p>A simple configurable sampler function is included with Accumulo. This sampler uses hashing and -can be configured to use a subset of Key fields. For example if it was desired to have entire rows -in the sample, then this sampler would be configured to hash+mod the row. Then when a row is -selected for the sample, all of its columns and all of its updates will be in the sample data. -Another scenario is one in which a document id is in the column qualifier. In this scenario, one -would either want all data related to a document in the sample data or none. To achieve this, the -sample could be configured to hash+mod on the column qualifier. See the sample <a href="/1.8/examples/sample">Readme -example</a> and javadocs on the new APIs for more information.</p> - -<p>For sampling to work, all tablets scanned must have pre-generated sample data that was generated in -the same way. If this is not the case then scans will fail. For existing tables, samples can be -generated by configuring sampling on the table and compacting the table.</p> - -<h3 id="upgrade-to-apache-thrift-093">Upgrade to Apache Thrift 0.9.3</h3> - -<p>Accumulo relies on Apache Thrift to implement remote procedure calls -between Accumulo services. Ticket <a href="https://issues.apache.org/jira/browse/ACCUMULO-4077">ACCUMULO-4077</a> -updates our dependency to 0.9.3. See the -<a href="https://github.com/apache/thrift/blob/0.9.3/CHANGES">Apache Thrift 0.9.3 Release Notes</a> for details on -the changes to Thrift. <strong>NOTE:</strong> The Thrift 0.9.3 Java library is not -compatible other versions of Thrift. Applications running against Accumulo -1.8 must use Thrift 0.9.3. Different versions of Thrift on the classpath -will not work.</p> - -<h3 id="iterator-test-harness">Iterator Test Harness</h3> - -<p>Users often write a new iterator without fully understanding its limits and lifetime. Previously, Accumulo did -not provide any means in which a user could test iterators to catch common issues that only become apparent -in multi-node production deployments. <a href="https://issues.apache.org/jira/browse/ACCUMULO-626">ACCUMULO-626</a> provides a framework and a collection of initial tests -which can be used to simulate common issues with Iterators that only appear in production deployments. This test -harness can be used directly by users as a supplemental tool to unit tests and integration tests with MiniAccumuloCluster.</p> - -<p>Please see the <a href="/1.8/accumulo_user_manual.html#_iterator_testing">Accumulo User Manual chapter on Iterator Testing</a> for more information</p> - -<h3 id="default-port-for-monitor-changed-to-9995">Default port for Monitor changed to 9995</h3> - -<p>Previously, the default port for the monitor was 50095. You will need to update your links to point to port 9995. The default -port for the GC process was also changed from 50091 to 9998, although this an RPC port used internally and automatically discovered. -These default ports were changed because the previous defaults fell in the Linux Ephemeral port range. This means that the operating -system, when a port in this range was unusued, would allocate this port for dynamic network communication. This has the side-effect of -temporal bind issues when trying to start these services (as the operating -system might have allocated them elsewhere). By moving these -defaults out of the ephemeral range, we can guarantee that the Monitor and GC -will reliably start. These values are still configurable by setting -<code class="highlighter-rouge">monitor.port.client</code>and <code class="highlighter-rouge">gc.port.client</code> in the accumulo-site.xml.</p> - -<h2 id="other-notable-changes">Other Notable Changes</h2> - -<ul> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-1055">ACCUMULO-1055</a> Configurable maximum file size for merging minor compactions</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-1124">ACCUMULO-1124</a> Optimization of RFile index</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-2883">ACCUMULO-2883</a> API to fetch current tablet assignments</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-3871">ACCUMULO-3871</a> Support for running integration tests in MapReduce</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-3920">ACCUMULO-3920</a> Deprecate the MockAccumulo class and remove usage in our tests</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4339">ACCUMULO-4339</a> Make hadoop-minicluster optional dependency of acccumulo-minicluster</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4318">ACCUMULO-4318</a> BatchWriter, ConditionalWriter, and ScannerBase now extend AutoCloseable</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4326">ACCUMULO-4326</a> Value constructor now accepts Strings (and Charsequences)</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4354">ACCUMULO-4354</a> Bump dependency versions to include gson, jetty, and sl4j</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-3735">ACCUMULO-3735</a> Bulk Import status page on the monitor</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4066">ACCUMULO-4066</a> Reduced time to processes conditional mutations.</li> - <li><a href="https://issues.apache.org/jira/browse/ACCUMULO-4164">ACCUMULO-4164</a> Reduced seek time for cached data.</li> -</ul> - -<h2 id="testing">Testing</h2> - -<p>Each unit and functional test only runs on a single node, while the RandomWalk -and Continuous Ingest tests run on any number of nodes. <em>Agitation</em> refers to -randomly restarting Accumulo processes and Hadoop Datanode processes, and, in -HDFS High-Availability instances, forcing NameNode failover.</p> - -<table id="release_notes_testing" class="table"> - <thead> - <tr> - <th>OS/Environment</th> - <th>Hadoop</th> - <th>Nodes</th> - <th>ZooKeeper</th> - <th>HDFS HA</th> - <th>Tests</th> - </tr> - </thead> - <tbody> - <tr> - <td>CentOS7/openJDK7/EC2; 3 m3.xlarge leaders, 8 d2.xlarge workers</td> - <td>2.6.4</td> - <td>11</td> - <td>3.4.8</td> - <td>No</td> - <td>24 HR Continuous Ingest without Agitation.</td> - </tr> - <tr> - <td>CentOS7/openJDK7/EC2; 3 m3.xlarge leaders, 8 d2.xlarge workers</td> - <td>2.6.4</td> - <td>11</td> - <td>3.4.8</td> - <td>No</td> - <td>16 HR Continuous Ingest with Agitation.</td> - </tr> - <tr> - <td>CentOS7/openJDK7/OpenStack VMs (16G RAM 2cores 2disk3; 1 leader, 5 workers</td> - <td>HDP 2.5 (Hadoop 2.7)</td> - <td>7</td> - <td>HDP 2.5 (ZK 3.4)</td> - <td>No</td> - <td>24 HR Continuous Ingest without Agitation.</td> - </tr> - <tr> - <td>CentOS7/openJDK7/OpenStack VMs (16G RAM 2cores 2disk3; 1 leader, 5 workers</td> - <td>HDP 2.5 (Hadoop 2.7)</td> - <td>7</td> - <td>HDP 2.5 (ZK 3.4)</td> - <td>No</td> - <td>24 HR Continuous Ingest with Agitation.</td> - </tr> - </tbody> -</table> - - - Tue, 06 Sep 2016 00:00:00 -0400 - https://accumulo.apache.org/release/accumulo-1.8.0/ - https://accumulo.apache.org/release/accumulo-1.8.0/ - - - release - - - http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/index.html ---------------------------------------------------------------------- diff --git a/index.html b/index.html index 929ee80..f7f2ab9 100644 --- a/index.html +++ b/index.html @@ -189,6 +189,13 @@
+ Jun 2017 + Documentation Improvements for 2.0 +
+
+ +
+
Apr 2017 Introducing Uno and Muchos
@@ -215,13 +222,6 @@
-
-
- Feb 2017 - Apache Accumulo 1.8.1 -
-
- http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/429e9884/news/index.html ---------------------------------------------------------------------- diff --git a/news/index.html b/news/index.html index 44290d3..cc5ef38 100644 --- a/news/index.html +++ b/news/index.html @@ -155,6 +155,13 @@
+
Jun 29
+
Documentation Improvements for 2.0
+
+ + + +
Apr 21
Introducing Uno and Muchos