[accumulo-website] branch main updated: Extract safe changes from #232 and #263

[ct...@apache.org]

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 <ct...@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 {