Workflow: Offline Manual Upgrade

This page summarizes the steps for upgrading from MapR 5.2.x to MapR 6.1.x by using the offline manual upgrade. In this workflow, the cluster to be upgraded is nonsecure; after the upgrade, the cluster will continue to be nonsecure, but can be secured by using manual steps.

Offline Manual Upgrade Summary

In an offline manual upgrade, cluster processes and the jobs that depend on them are stopped on all nodes so that packages can be updated. The offline upgrade process is simpler than a rolling upgrade, and usually completes faster. The offline manual upgrade requires you to:

Perform pre-upgrade checks.
Shut down the cluster.
Upgrade core to 6.1.x.
Upgrade the EEP to 6.0.0.
Merge custom configuration settings.
Start the cluster and perform post-upgrade checks.
Enable core 6.1.x features.

The workflow later on this page provides more detail to help you get started with an offline manual upgrade.

Considerations for Offline Manual Upgrades

Before performing an offline manual upgrade, note the following considerations:

NOTE After upgrading core to release 6.1.x, you must upgrade ecosystem components to an EEP that is compatible with your MapR 6.1.x release. This must be done before you enable MapR 6.1.x features. To determine the compatible EEPs, see EEP Support and Lifecycle Status.

You can perform an offline upgrade to MapR 6.1.xfrom the following core versions: 3.x, 4.0.x, 4.1, 5.x, and 6.x.
The offline upgrade procedure requires an outage of the entire cluster. During the maintenance window, the administrator:
- Stops all jobs on the cluster.
- Stops all cluster services.
- Upgrades packages on all nodes (which can be done in parallel).
- Brings the cluster back online at once.

Offline Manual Upgrade Workflow

High-Level Steps	Detailed Information (review all items unless noted otherwise)
1. Understand MapR Core/EEP Dependencies	Operating System Support Matrix Operating System Support Matrix (MapR 5.x) EEP Support and Lifecycle Status Component Versions for Released EEPs
2. Plan for the MapR Core Upgrade	Upgrading and Your License Installation and Upgrade Notes (MapR 6.0) Installation and Upgrade Notes (MapR 6.0.1) Installation and Upgrade Notes (MapR 6.1.0) Installation and Upgrade Notes (MapR 6.1.1) Planning Your MapR Core Upgrade
3. Plan for the EEP Upgrade	Planning Ezmeral Ecosystem Pack (EEP) Upgrades
4. Perform Pre-Upgrade Steps for MapR Core	Preparing to Upgrade MapR Core
5. Prepare to Upgrade EEP Components	Preparing to Upgrade the Ezmeral Ecosystem Pack
6. Set up Repositories	Setting Up Repositories
7. Perform the Offline Manual Upgrade	Offline and Manual Upgrade Procedure
8. Upgrade the EEP Components	Upgrading the Ezmeral Ecosystem Pack Without the MapR Installer
9. Perform Post-Upgrade Steps for EEP	Finishing the Ezmeral Ecosystem Pack Upgrade
10. Perform Post-Upgrade Steps for MapR Core	Restart and Check Cluster Services Manually Update Configuration Files Upgrade Clients Enable New Features Update Hadoop Configuration File
11. Install Additional MapR Core Features	Installing Additional MapR Core Features NOTE This page includes the steps to generate Object Store certificates by using `manageSSLKeys.sh`. The certificates must be generated after upgrading and running `configure.sh -R`. If you fail to generate the certificates, you will not be able to use the Object Store.
12. Secure the Upgraded Cluster	Securing the Upgraded Cluster