This is an automated email from the ASF dual-hosted git repository.
ctubbsii pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/main by this push:
new b7ce444 Extract safe changes from #232 and #263
b7ce444 is described below
commit b7ce44494f9d39ccf9df34cc76a660a6b31630ac
Author: Christopher Tubbs <ctubb...@apache.org>
AuthorDate: Tue Feb 9 19:09:45 2021 -0500
Extract safe changes from #232 and #263
Incorporate changes from apache/accumulo-website#232 (css/accumulo.scss)
and apache/accumulo-website#263
(_posts/release/2020-01-19-accumulo-2.1.0.md) that are okay to merge
into the main branch today, leaving documentation changes staged for 2.1
in the next-release branch for merging when 2.1 is released.
---
_posts/release/2020-01-19-accumulo-2.1.0.md | 74 +++++++++++++++++++++++++++++
css/accumulo.scss | 4 +-
2 files changed, 76 insertions(+), 2 deletions(-)
diff --git a/_posts/release/2020-01-19-accumulo-2.1.0.md
b/_posts/release/2020-01-19-accumulo-2.1.0.md
index 460c339..7dee888 100644
--- a/_posts/release/2020-01-19-accumulo-2.1.0.md
+++ b/_posts/release/2020-01-19-accumulo-2.1.0.md
@@ -1,10 +1,19 @@
---
title: Apache Accumulo 2.1.0
+sortableversion: '02.01.00'
draft: true
---
** DRAFT RELEASE NOTES **
+## Binary Incompatibility
+
+This release is known to be incompatible with prior versions of the client
+libraries. That is, the 2.0.0 or 2.0.1 version of the client libraries will not
+be able to communicate with a 2.1.0 or later installaction of Accumulo, nor
will
+the 2.1.0 or later version of the client libraries communicate with a 2.0.1 or
+earlier installation.
+
## Notable Changes
### Compaction Changes
@@ -68,4 +77,69 @@ root@uno> getsplits -t accumulo.metadata
~dela7
```
+### Master Renamed to Manager
+
+In order to support more inclusive language in our code, the Accumulo team has
+renamed all references to the word "master" to "manager" (with the exception
+of deprecated classes and packages retained for compatibility). This change
+includes the master process, configuration properties with master in the name,
+utilities with master in the name, and packages/classes in the code base. Where
+these changes affect the public API, the deprecated "master" name will still be
+supported until at least Accumulo 3.0.
+
+ > **Important**
+ One particular change to be aware of is that certain state for the manager
+ process is stored in ZooKeeper, previously in under a directory named
+ `masters`. This directory has been renamed to `managers`, and the upgrade
+ will happen automatically if you launch Accumulo using the provided scripts.
+ However, if you do not use the built in scripts (e.g., accumulo-cluster or
+ accumulo-service), then you will need to perform a one-time upgrade of the
+ ZooKeeper state by executing the `RenameMasterDirInZK` utility:
+ ```
+ ${ACCUMULO_HOME}/bin/accumulo
org.apache.accumulo.manager.upgrade.RenameMasterDirInZK
+ ```
+
+Some other specific examples of these changes include:
+* All configuration properties starting with `master.` have been renamed to
+ start with `manager.` instead. The `master.*` property names in the site
+ configuration file (or passed on the command-line) are converted internally
+ to the new name, and a warning is printed. However, the old name can still be
+ used until at least the 3.0 release of Accumulo. Any `master.*` properties
+ that have been set in ZooKeeper will be automatically converted to the new
+ `manager.*` name when Accumulo is upgraded. The old property names can still
+ be used by the `config` shell command or via the methods accessible via
+ `AccumuloClient`, but a warning will be generated when the old names are
+ used. You are encouraged to update all references to `master` in your site
+ configuration files to `manager` when installing Accumulo 2.1.
+* The tablet balancers in the `org.apache.accumulo.server.master.balancer`
+ package have all been relocated to
`org.apache.accumulo.server.manager.balancer`.
+ DefaultLoadBalancer has been also renamed to SimpleLoadBalancer along with
+ the move. The default balancer has been updated from
+ `org.apache.accumulo.server.master.balancer.TableLoadBalancer` to
+ `org.apache.accumulo.server.manager.balancer.TableLoadBalancer`, and the
+ default per-table balancer has been updated from
+ `org.apache.accumulo.server.master.balancer.DefaultLoadBalancer` to
+ `org.apache.accumulo.server.manager.balancer.SimpleLoadBalancer`. If you have
+ customized the tablet balancer configuration, you are strongly encouraged to
+ update your configuration to reference the updated balancer names. If you
+ written a custom tablet balancer, it should be updated to implement the new
+ interface `org.apache.accumulo.server.manager.balancer.TabletBalancer`
+ rather than extending the deprecated abstract
+ `org.apache.accumulo.server.master.balancer.TabletBalancer`.
+* The configuration file `masters` for identifying the manager host(s) has been
+ deprecated. If this file is found, a warning will be printed. The replacement
+ file `managers` should be used (i.e., rename your masters file to managers)
+ instead.
+* The `master` argument to the `accumulo-service` script has been deprecated,
+ and the replacement `manager` argument should be used instead.
+* The `-master` argument to the `org.apache.accumulo.server.util.ZooZap`
+ utility has been deprecated and the replacement `-manager` argument should be
+ used instead.
+* The `GetMasterStats` utility has been renamed to `GetManagerStats`.
+* `org.apache.accumulo.master.state.SetGoalState` is deprecated, and any custom
+ scripts that invoke this utility should be updated to call
+ `org.apache.accumulo.manager.state.SetGoalState` instead.
+* `masterMemory` in `minicluster.properties` has been deprecated and
+ `managerMemory` should be used instead in any `minicluster.properties` files
+ you have configured.
\ No newline at end of file
diff --git a/css/accumulo.scss b/css/accumulo.scss
index 17609cb..6579cc9 100644
--- a/css/accumulo.scss
+++ b/css/accumulo.scss
@@ -43,13 +43,13 @@ body {
pre code {
font-size: 14px;
+ /* override nowrap in bootstrap */
+ white-space: pre;
}
code {
background-color: #f5f5f5;
color: #555;
- /* override nowrap in bootstrap */
- white-space: normal;
}
#nav-logo {
