This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new e438900b Automatic Site Publish by Buildbot
e438900b is described below
commit e438900b20f0ad1ff95484ad110146539e0046db
Author: buildbot <[email protected]>
AuthorDate: Wed Nov 16 05:20:28 2022 +0000
Automatic Site Publish by Buildbot
---
output/docs/2.x/administration/upgrading.html | 86 ++++++++++++++++++++++++-
output/docs/2.x/getting-started/quickstart.html | 7 +-
output/feed.xml | 4 +-
output/search_data.json | 4 +-
4 files changed, 94 insertions(+), 7 deletions(-)
diff --git a/output/docs/2.x/administration/upgrading.html
b/output/docs/2.x/administration/upgrading.html
index e803e7e2..5b6b96c0 100644
--- a/output/docs/2.x/administration/upgrading.html
+++ b/output/docs/2.x/administration/upgrading.html
@@ -434,9 +434,30 @@
<p>The recommended way to upgrade from a prior 1.10.x or 2.0.x release is to
stop Accumulo, upgrade
to 2.1 and then start 2.1. To upgrade from a release prior to 1.10, follow the
-<a href="#upgrading-from-189-to-20">below steps</a> to upgrade to 2.0 and then
perform the upgrade to 2.1. A
+<a href="#upgrading-from-18910-to-20">below steps</a> to upgrade to at least
1.10 and then perform the upgrade to 2.1. A
direct upgrade from releases prior to 1.10 has not been tested.</p>
+<p>Important: before starting any upgrade process you need to make sure there
are no outstanding FATE transactions. This
+includes transactions that have completed with <code class="language-plaintext
highlighter-rouge">SUCCESS</code> or <code class="language-plaintext
highlighter-rouge">FAILED</code> but have not been removed by the automatic
clean-up
+process. This is required because the internal serialization of FATE
transactions is not guaranteed to be compatible
+between versions, so <em>ANY</em> FATE transaction that is present will fail
the upgrade. Procedures to manage FATE
+transactions, including commands to fail and delete transactions, are included
in the Accumulo documentation
+<a href="/docs/2.x/administration/fate#administration">FATE -
Administration</a></p>
+
+<p>Two significant changes from 1.10.x/2.0 to 2.1 that are important to
note:</p>
+
+<ol>
+ <li>properties and services that referenced <code class="language-plaintext
highlighter-rouge">master</code> are renamed <code class="language-plaintext
highlighter-rouge">manager</code> and</li>
+ <li>the property storage in ZooKeeper has changed from a ZooKeeper node per
property to a single node for all
+properties with a single ZooKeeper property node for each table, namespace.
and the system config properties.</li>
+</ol>
+
+<p>Before upgrading to 2.1, it is suggested that you create a snapshot of the
current ZooKeeper contents to be a backup
+in case issues occur and you need to rollback. There are no provisions to
roll back to a previous Accumulo version
+once an upgrade process has been completed other than restoring from a
snapshot of ZooKeeper.</p>
+
+<p>Details on renaming the properties and the ZooKeeper property conversion
provided in sections that follow.</p>
+
<h3 id="rename-master-properties-config-files-and-script-references">Rename
master Properties, Config Files, and Script References</h3>
<p>Although not required until at least release 3.0, it is strongly
recommended as a part of the
@@ -463,7 +484,68 @@ will then need to transfer the contents of the current
individual files to this
<p><strong>Warning</strong>: Upgrading a previously encrypted instance is not
supported as the implementation
and properties have changed.</p>
-<h2 id="upgrading-from-189-to-20">Upgrading from 1.8/9 to 2.0</h2>
+<h2 id="upgrading-from-1911020-to-21">Upgrading from 1.9/1.10/2.0 to 2.1</h2>
+
+<p>Note: the process for upgrading to 2.1 assumes that you have already
upgraded to 1.10 or 2.0. Upgrading from a
+version prior to 1.10 may work, but is unsupported and untested. If you are
upgrading from 1.10 make sure
+that you have adjusted for the <code class="language-plaintext
highlighter-rouge">master</code> to <code class="language-plaintext
highlighter-rouge">manager</code> and other configuration changes as described
in the
+Upgrading from 1.8/9/10 to 2.0 <a href="#upgrading-from-18910-to-20">below
steps</a>.</p>
+
+<p>Additional information on configuring 2.1 is available at
(/docs/2.x//in-depth-installation)</p>
+
+<p>The particular order for your installation will differ depending on how you
choose to install Accumulo.<br />
+The key part being that the upgrade utilities need to be run with 2.1 code on
a stopped 1.10 / 2.0 instance.</p>
+
+<p>You can elect to stop your current instance, install and configure the 2.1
binaries, optionally run the upgrade
+utilities and then start 2.1, or you could install and configure the 2.1
binaries while your instance remains
+running and then when ready, stop your instance, optionally run the upgrade
utilities and then start 2.1.</p>
+
+<p>The basic upgrade sequence is to:</p>
+
+<ul>
+ <li>stop Accumulo (1.10/2.0)</li>
+ <li>update your environment to point to 2.1 executable path.</li>
+ <li>(optional - but recommended) create a ZooKeeper snapshot</li>
+ <li>(optional) run the configuration upgrade utility</li>
+ <li>start Accumulo 2.1</li>
+</ul>
+
+<h3 id="create-zookeeper-snapshot-optional---but-recommended">Create ZooKeeper
snapshot (optional - but recommended)</h3>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>$ACCUMULO_HOME/bin/accumulo dump-zoo --xml --root
/accumulo | tee PATH_TO_SNAPSHOT
+</code></pre></div></div>
+
+<p>If you need to restore from the ZooKeeper snapshot see
(/docs/2.x/troubleshooting/tools )</p>
+
+<h3 id="upgrade-the-property-storage-in-zookeeper-optional">Upgrade the
property storage in ZooKeeper (optional)</h3>
+
+<p>The property conversion can be done using a command line utility or it will
occur automatically when the manager is
+started for the first time. Using the command line utility is optional, but
may provide more flexibility in
+handling issues if they were to occur. With ZooKeeper running, the command to
convert the properties is:</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>$ACCUMULO_HOME/bin/accumulo config-upgrade
+</code></pre></div></div>
+
+<p>The utility will print progress and a count of the number of properties
converted (as delete count) and an error count</p>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>2022-11-03T14:35:44,596 [conf.SiteConfiguration] INFO :
Found Accumulo configuration on classpath at
/opt/fluo-uno/install/accumulo-3.0.0-SNAPSHOT/conf/accumulo.properties
+2022-11-03T14:35:45,511 [util.ConfigPropertyUpgrader] INFO : Upgrade system
config properties for a1518a8b-f007-41ee-af2c-5cc760abe7fd
+2022-11-03T14:35:45,675 [util.ConfigTransformer] INFO : property transform for
SystemPropKey{InstanceId=a1518a8b-f007-41ee-af2c-5cc760abe7fd'} took 29ms ms,
delete count: 1, error count: 0
+2022-11-03T14:35:45,683 [util.ConfigPropertyUpgrader] INFO : Upgrading
namespace +accumulo base path:
/accumulo/a1518a8b-f007-41ee-af2c-5cc760abe7fd/namespaces/+accumulo/conf
+...
+2022-11-03T14:35:45,737 [util.ConfigPropertyUpgrader] INFO : Upgrading table
!0 base path: /accumulo/a1518a8b-f007-41ee-af2c-5cc760abe7fd/tables/!0/conf
+2022-11-03T14:35:45,813 [util.ConfigTransformer] INFO : property transform for
TablePropKey{TableId=!0'} took 72ms ms, delete count: 26, error count: 0
+...
+</code></pre></div></div>
+<p>If the upgrade utility is not used, similar messages will be printed to the
manager log on the first 2.1 version
+manager start up.</p>
+
+<p>When the property conversion is complete, you can verify the configuration
using the zoo-info-viewer utility
+(new in 2.1)</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>$ACCUMULO_HOME/bin/accumulo zoo-info-viewer
--print-props
+</code></pre></div></div>
+
+<h2 id="upgrading-from-18910-to-20">Upgrading from 1.8/9/10 to 2.0</h2>
<p>Follow the steps below to upgrade your Accumulo instance and client to
2.0.</p>
diff --git a/output/docs/2.x/getting-started/quickstart.html
b/output/docs/2.x/getting-started/quickstart.html
index c8532a85..a7133f97 100644
--- a/output/docs/2.x/getting-started/quickstart.html
+++ b/output/docs/2.x/getting-started/quickstart.html
@@ -595,7 +595,12 @@ and the shell will prompt you for the password of <code
class="language-plaintex
<h2 id="initialization">Initialization</h2>
<p>Accumulo needs to initialize the locations where it stores data in
Zookeeper and
-HDFS. The following command will do this.</p>
+HDFS.</p>
+
+<p>Note: Initialization only needs to be performed once for an instance - if
you are performing an
+upgrade you should not run the initialization command a second time unless you
really want a new instance</p>
+
+<p>The following command will perform the initialization.</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>accumulo init
</code></pre></div></div>
diff --git a/output/feed.xml b/output/feed.xml
index b9583d24..4920eb44 100644
--- a/output/feed.xml
+++ b/output/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>Wed, 02 Nov 2022 21:26:29 +0000</pubDate>
- <lastBuildDate>Wed, 02 Nov 2022 21:26:29 +0000</lastBuildDate>
+ <pubDate>Wed, 16 Nov 2022 05:20:21 +0000</pubDate>
+ <lastBuildDate>Wed, 16 Nov 2022 05:20:21 +0000</lastBuildDate>
<generator>Jekyll v4.3.1</generator>
diff --git a/output/search_data.json b/output/search_data.json
index 9ec15a4e..b3f00aca 100644
--- a/output/search_data.json
+++ b/output/search_data.json
@@ -65,7 +65,7 @@
"docs-2-x-administration-upgrading": {
"title": "Upgrading Accumulo",
- "content": "Upgrading from 1.10.x or 2.0.x to 2.1The recommended way to
upgrade from a prior 1.10.x or 2.0.x release is to stop Accumulo, upgradeto 2.1
and then start 2.1. To upgrade from a release prior to 1.10, follow thebelow
steps to upgrade to 2.0 and then perform the upgrade to 2.1. Adirect upgrade
from releases prior to 1.10 has not been tested.Rename master Properties,
Config Files, and Script ReferencesAlthough not required until at least release
3.0, it is strongly recomm [...]
+ "content": "Upgrading from 1.10.x or 2.0.x to 2.1The recommended way to
upgrade from a prior 1.10.x or 2.0.x release is to stop Accumulo, upgradeto 2.1
and then start 2.1. To upgrade from a release prior to 1.10, follow thebelow
steps to upgrade to at least 1.10 and then perform the upgrade to 2.1. Adirect
upgrade from releases prior to 1.10 has not been tested.Important: before
starting any upgrade process you need to make sure there are no outstanding
FATE transactions. Thisinclu [...]
"url": " /docs/2.x/administration/upgrading",
"categories": "administration"
},
@@ -184,7 +184,7 @@
"docs-2-x-getting-started-quickstart": {
"title": "Setup",
- "content": "User Manual (2.x)Starting with Accumulo 2.0, the user manual
now lives on the website as a seriesof web pages. Previously, it was one large
pdf document that was only generatedduring a release. The user manual can now
be updated very quickly and indexedfor searching across many webpages.The
manual can now be searched using the Search link at the top of thewebsite or
navigated by clicking the links to the left. If you are new toAccumulo, follow
the instructions below to [...]
+ "content": "User Manual (2.x)Starting with Accumulo 2.0, the user manual
now lives on the website as a seriesof web pages. Previously, it was one large
pdf document that was only generatedduring a release. The user manual can now
be updated very quickly and indexedfor searching across many webpages.The
manual can now be searched using the Search link at the top of thewebsite or
navigated by clicking the links to the left. If you are new toAccumulo, follow
the instructions below to [...]
"url": " /docs/2.x/getting-started/quickstart",
"categories": "getting-started"
},
