Rolling Upgrade Guide
Also available as:
PDF
loading table of contents...

Contents

1. Overview
Introduction
Packaging
The upgrade process
Reverting to prior state
2. Preparation
Cluster Prerequisites
Preparing the Cluster
Download the new software onto each node in the cluster
Back up component metadata
Move the new client libraries into HDFS
3. Upgrading the Cluster
Upgrade ZooKeeper
Upgrade Ranger
Upgrade Ranger Admin
Upgrade Ranger UserSync
Upgrade core-cluster master processes
Upgrade HDFS JournalNodes
Upgrade the HDFS NameNode HA Process Pair
Upgrade the MapReduce JobHistoryServer
Upgrade the YARN Timeline Service
Upgrade the YARN ResourceManager process or HA process pair
Upgrade HBase Master(s)
Upgrade the HBase REST server
Upgrade the HBase Thrift server
Upgrade core slave nodes (HDFS, YARN, HBase)
On the core slave node, upgrade the HDFS DataNode
On the core slave node, upgrade the YARN NodeManager
On the core slave node, upgrade HBase RegionServer
Upgrade remaining nodes
Validate new core-masters, core-workers with old clients
Upgrade non-core cluster components
Upgrade Hive
Upgrade Oozie
Upgrade Falcon
Upgrade Knox
Upgrade components outside of the cluster
Upgrade Storm
Upgrade Storm Cluster on YARN via Slider
Upgrade Kafka
Upgrade Hue
Upgrade Slider
Upgrade clients on cluster (core and non-core) components
Upgrade MapReduce Clients
Upgrade Flume
Validation
Finalize the rolling upgrade process
4. Downgrading the Cluster
Downgrade clients on cluster components
Downgrade Flume
Downgrade Slider
Downgrade components outside of the cluster
Downgrade Hue
Downgrade Kafka
Downgrade Storm Cluster on YARN via Slider
Downgrade Storm
Downgrade Knox
Downgrade non-core cluster components
Downgrade Falcon
Downgrade Oozie
Downgrade Hive
Downgrade core slave nodes
Downgrade the HBase RegionServer
Downgrade the YARN NodeManager
Downgrade HDFS DataNodes
Validate the downgrade process
Downgrade core-cluster master processes
Downgrade the HBase Thrift server
Downgrade HBase REST Server
Downgrade HBase Master(s)
Downgrade the YARN ResourceManager process or HA process pair
Downgrade the YARN Timeline Service
Downgrade the MapReduce JobHistoryServer
Downgrade the HDFS NameNode HA Process Pair
Downgrade HDFS JournalNode(s)
Validation
Downgrade Ranger
Downgrade Ranger UserSync
Downgrade Ranger Admin
Validate Ranger HBase Plugin
Downgrade ZooKeeper
5. Initiating Rollback
6. Appendix A
7. Appendix B

List of Tables

6.1. Validation Links