pulsar-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From GitBox <...@apache.org>
Subject [GitHub] ivankelly commented on a change in pull request #2048: Add Upgrade Guide to Apache Pulsar
Date Wed, 11 Jul 2018 10:22:23 GMT
ivankelly commented on a change in pull request #2048: Add Upgrade Guide to Apache Pulsar
URL: https://github.com/apache/incubator-pulsar/pull/2048#discussion_r201622511
 
 

 ##########
 File path: site/docs/latest/admin/Upgrade.md
 ##########
 @@ -0,0 +1,152 @@
+---
+title: Upgrade
+---
+
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+> If you have questions about upgrades (or need help), please feel free to reach out to
us by [mailing list]({{ site.baseurl }}/contact) or [Slack Channel]({{ site.baseurl }}/contact).
+
+## Overview
+
+Consider the below guidelines in preparation for upgrading.
+
+- Always back up all your configuration files before upgrading.
+- Read through the documentation and draft an upgrade plan that matches your specific requirements
and environment before starting the upgrade process.
+    Put differently, don't start working through the guide on a live cluster. Read guide
entirely, make a plan, then execute the plan.
+- Pay careful consideration to the order in which components are upgraded. In general, you
need to upgrade bookies first, upgrade brokers next and then upgrade your clients.
+- If autorecovery is running along with bookies, you need to pay attention to the upgrade
sequence.
+- Read the release notes carefully for each release. They contain not only information about
noteworthy features, but also changes to configurations
+    that may impact your upgrade.
+- Always upgrade one or a small set of bookies/brokers to canary new version before upgraing
all bookies/brokers in your cluster.
 
 Review comment:
   "upgrade one or a small set" -> "a small subset"
   "to canary new version" -> "to canary the new version"
   "upgraing" -> "upgrading"
   
   This is kinda contradictory with the fact that bookies should all be upgraded first, then
brokers. An admin can't upgrade one broker and one bookie to canary the release. You have
the full sequence below, so maybe here just you can say:
   
   - Always upgrade a small subset of nodes of each type to canary test the new version before
upgrading all nodes of that type in the cluster. When you have upgraded the canary nodes,
allow them to run for a while to ensure that they are working correctly.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

Mime
View raw message