Home
6.0 Installation
This section contains information about installing and upgrading MapR software. It also contains information about how to migrate data and applications from an Apache Hadoop cluster to a MapR cluster.
Upgrading MapR Core or MEP Components
Depending on your current configuration, you may choose to upgrade the MapR version (MapR Core), ecosystem components, clients, or MapR Monitoring components.
Upgrading MapR Core
Describes the process of upgrading MapR Core.
Finishing the MapR Core Upgrade
This section provides post-upgrade steps for MapR Core.
Post-Upgrade Steps for MapR Core
After upgrading MapR core, several manual steps are required.
Step 3: Manually Update your License
The Base License may need to be updated manually depending on the MapR version you are upgrading from.

MapR 6.0 Documentation

6.0 Installation
This section contains information about installing and upgrading MapR software. It also contains information about how to migrate data and applications from an Apache Hadoop cluster to a MapR cluster.
- Planning the Cluster
  Describes information and factors used in planning your cluster.
- Installing MapR and/or MapR Ecosystem Components
  Describes how to install MapR software and ecosystem components with the MapR Installer or without the MapR Installer.
- Installing the File Migration Service on the Edge Cluster
- Installing MapR-XD
  Describes how to install MapR-XD software with or without the MapR Installer.
- Installing MapR Data Fabric for Kubernetes
  This section describes how to plan for, install, and upgrade the MapR Container Storage Interface (CSI) Storage Plugin and MapR Data Fabric for Kubernetes FlexVolume Driver.
- Installing MapR in the Cloud
  Provides an overview of MapR cloud installer capabilities.
- Upgrading MapR Core or MEP Components
  Depending on your current configuration, you may choose to upgrade the MapR version (MapR Core), ecosystem components, clients, or MapR Monitoring components.
  - Upgrading MapR Core
    Describes the process of upgrading MapR Core.
    - Upgrading and Your License
      If you are upgrading from MapR version 5.0 or earlier, the Base License file must be manually updated on all nodes in your cluster.
    - MapR Core Upgrade Process
      When you upgrade MapR Core, you will also upgrade a number of cluster components.
    - Planning Your MapR Core Upgrade
      This section describes how to develop a successful plan for your upgrade process.
    - Preparing to Upgrade MapR Core
      Complete these pre-upgrade steps for MapR Core.
    - Upgrading MapR Core With the MapR Installer
      If the cluster that you want to upgrade was installed using the MapR Installer, use the MapR Installer to upgrade MapR core.
    - Upgrading MapR Core Without the MapR Installer
      You can upgrade MapR Core without using the MapR Installer.
    - Finishing the MapR Core Upgrade
      This section provides post-upgrade steps for MapR Core.
      - Post-Upgrade Steps for MapR Core
        After upgrading MapR core, several manual steps are required.
        Considerations for Upgrades Using the MapR Installer
        If you use the MapR Installer to upgrade the cluster, some post-upgrade steps for MapR Core do not need to be performed. This page describes the post-upgrade steps that are performed by the MapR Installer and the steps that you must perform manually.
        Step 1: Restart and Check Cluster Services
        After upgrading MapR Core using either a manual offline or rolling upgrade method (not upgrading with the MapR Installer) and upgrading your ecosystem components, configure and restart the cluster and services.
        Step 2: Manually Update Configuration Files
        After upgrading MapR Core using a manual offline or rolling upgrade method, update your configuration files.
        Step 3: Manually Update your License
        The Base License may need to be updated manually depending on the MapR version you are upgrading from.
        Step 4: Upgrade Clients
        After you upgrade your cluster, you may also need to upgrade your MapR Client or MapR POSIX Client.
        Step 5: Enable New Features
        After upgrading MapR Core without the MapR Installer (using a manual offline or rolling upgrade method), enable the new features.
        Step 6: Update Hadoop Configuration File
        When manually upgrading (manual offline and manual rolling upgrade) from version 4.x to version 6.x and switching from classic mode to YARN mode, you must manually update the Hadoop configuration file.
      - Installing Additional MapR Core Features
        New features, such as MapR Monitoring, may require the installation of additional packages after an upgrade.
      - Securing the Upgraded Cluster
        Nonsecure clusters can be secured after the upgrade process.
  - Upgrading MapR Ecosystem Packs
    Describes how to upgrade MapR Ecosystem Packs (MEPs), either as part of a MapR Core upgrade or to take advantage of a new MEP for the current version of MapR Core.
  - Preparing the Cluster for a Maintenance Update
    This section identifies how to prepare for applying either a minor update or a patch.
  - Performing a Maintenance Update
    Perform a maintenance update when you want to upgrade to a new patch version of MapR Core or apply a patch.
- Setting Up Clients
  Describes how to set up and use interfaces to a MapR cluster from a client computer.
- Setting Up the MapR Control System
  Describes how to configure and access the MapR Control System (MCS).
- Migrating to MapR
  Provides instructions for migrating business-critical data and applications from an Apache Hadoop cluster to a MapR cluster.
- Applying a Patch
  You can apply a patch by using the MapR Installer, by using the command line (a manual process), or by using a MapR Installer Stanza.

Step 3: Manually Update your License

The Base License may need to be updated manually depending on the MapR version you are upgrading from.

Depending on which MapR release you are upgrading from, the Base License may need to be updated. This is due to new license categories implemented as of MapR version 5.1. This applies to all upgrade methods (MapR Installer, rolling upgrade, or manual rolling upgrade).

To update the Base License, copy the new Base License file from the /opt/mapr/conf.new/ directory to the /opt/mapr/conf/ directory on every node in your cluster.

cp /opt/mapr/conf.new/BaseLicense.txt /opt/mapr/conf/

NOTE: The BaseLicense.txt file must be copied before starting Warden, otherwise, Warden must be restarted.

If you are upgrading from the Enterprise Database Edition (M7) to the Enterprise Edition and want to use the MapR-ES module, you must purchase additional licensing. In this case, you will be issued a new license to apply. See Managing Licenses for more information. In addition, the new MapR-ES feature must be manually enabled.

(Topic last modified: 2018-09-11)