|
@@ -168,20 +168,29 @@ include::open-ml.asciidoc[]
|
|
|
|
|
|
During a rolling upgrade, the cluster continues to operate normally. However,
|
|
|
any new functionality is disabled or operates in a backward compatible mode
|
|
|
-until all nodes in the cluster are upgraded. New functionality
|
|
|
-becomes operational once the upgrade is complete and all nodes are running the
|
|
|
-new version. Once that has happened, there's no way to return to operating
|
|
|
-in a backward compatible mode. Nodes running the previous major version will
|
|
|
-not be allowed to join the fully-updated cluster.
|
|
|
+until all nodes in the cluster are upgraded. New functionality becomes
|
|
|
+operational once the upgrade is complete and all nodes are running the new
|
|
|
+version. Once that has happened, there's no way to return to operating in a
|
|
|
+backward compatible mode. Nodes running the previous major version will not be
|
|
|
+allowed to join the fully-updated cluster.
|
|
|
|
|
|
In the unlikely case of a network malfunction during the upgrade process that
|
|
|
-isolates all remaining old nodes from the cluster, you must take the
|
|
|
-old nodes offline and upgrade them to enable them to join the cluster.
|
|
|
+isolates all remaining old nodes from the cluster, you must take the old nodes
|
|
|
+offline and upgrade them to enable them to join the cluster.
|
|
|
+
|
|
|
+If you stop half or more of the master-eligible nodes all at once during the
|
|
|
+upgrade then the cluster will become unavailable, meaning that the upgrade is
|
|
|
+no longer a _rolling_ upgrade. If this happens, you should upgrade and restart
|
|
|
+all of the stopped master-eligible nodes to allow the cluster to form again, as
|
|
|
+if performing a <<restart-upgrade,full-cluster restart upgrade>>. It may also
|
|
|
+be necessary to upgrade all of the remaining old nodes before they can join the
|
|
|
+cluster after it re-forms.
|
|
|
|
|
|
Similarly, if you run a testing/development environment with only one master
|
|
|
node, the master node should be upgraded last. Restarting a single master node
|
|
|
forces the cluster to be reformed. The new cluster will initially only have the
|
|
|
upgraded master node and will thus reject the older nodes when they re-join the
|
|
|
-cluster. Nodes that have already been upgraded will successfully re-join the
|
|
|
-upgraded master.
|
|
|
+cluster. Nodes that have already been upgraded will successfully re-join the
|
|
|
+upgraded master.
|
|
|
+
|
|
|
====================================================
|