Install MapR Converged Data Platform.

3 minute read

Pre-Install Checks

  • Verify prerequisites on every node!
    • Correct any problems before you start installation.
  • Nodes that are out of spec are a common cause of a failed installation
  • Check the documentation for the full list of prerequisites

Installation Overview

  1. Download the script to the node that will be part of the cluster
  2. Run the script as root
    bash ./
  3. The script will perform the following tasks :
    • Verified dependencies on the install Nodes
    • Checks internet connectivity; if not available it uses archive files.
    • Establishes MapR administrator account (mapr)
    • Creates Repository with required package files; if you provided packages in archive files it will create a local repository.
  4. Start the MapR Installer Web Interface on Installer node in webbrowser.
    https://<external IP address>:9443
  5. Login as MapR administrator (default is mapr)
  6. Provide the details to installer as required and finish the installation.

Prepare to Install

Information to provide:

  • Nodes to include in the cluster
  • Services to install on the cluster
  • Credentials for the MapR administrator account

MapR Installer

Select Version and Services

Version and Edition

Select the Community Free Edition or Enterprise Edition if you have the License

Version & Edition

License Option

Get Trail License from you MapR Account or directly signup with the install later which will download the license.

License Option

Select Services: Overview

Select Pre-Provisioned Templates and Expand Show Advanced service options to see the summary of components installed.

Select Services

Custom Services

Also you can choose to install custom services and versions. Warnings will be displayed when incompatible services are selected as shown below.

Custom Services

Database Setup

Fields displayed will depend on services selected. If you choose to install Hue, Hive, Oozie or Metrics enter the database information as shown below:

  1. Database Type
    • Use Embedded
    • Existing MySQL server
    • Install MySQL Server
  2. Username and password for DB User
  3. Name for each DB Schema like hue , oozie, hive etc..

You can also choose to have multiple database types but create unique users for each database.

Database Setup

Set Up the Cluster

  1. In the Setup Cluster screen provide the mapr user details created earlier.
  2. In the Cluster Name filed enter a unique DNS name for the cluster like

Cluster Setup

Configure Nodes

On the Configuration page enter resolvable IPAddress/Hostnames/HostNameExpressions for the nodes that need to be included in the cluster.

Note: If you are using cloud like AWS/Azure use internal resolvable privateIP address or FQDN.

Specify Nodes

Configure Disks

In the Disks section enter a , list of disks to use (Unused and Unmounted disks). By default disks are configured to be reformatted under Advanced Disk Options

Configure Disks

Configure Remote Authentication

Use Passwordless SSH between nodes to connect instead of mapr password.

SSH Passwordless

Verify Nodes

Verification Process

Installer will connect to all nodes and check if they satisfy minimum requirements. Notice the Following Indication on each node icon :

  • White - Verification InProgress
  • Green - Ready for installation
  • Yellow - Warnings but can be installed
  • Red - Node cannot be part of cluster

Node Verification

Verification Problems

If Node verification posts Warnings or Errors, Click on Node Icon and see the recommendation failed and correct them manually. If the problem cannot be resolved , remove the node from the Specify Nodes step by reviewing it.You can add the node at later point of time by resolving the issue.

Node Verification Problems

Configure Service Layout

Default Service Layout

After Verification as default service layout window is displayed as shown below:

Default Service Layout

View Node Layout

Click on View Node Layout to examine the which services are installed on which node.

View Node Layout

Advanced Configuration

You can modify the default service layout as per needs by clicking on Advanced Configuration as shown below by drag&drop components and nodes.

Advanced Configuration

Install MapR


Click Next to begin Installtion and Monitor the Progress of Installation.

Install Cluster


When finished installer will suggest whether a valid license to be applied or not in the later stages for all services to work.

Install Cluster

Once Installation is completed a list of Service URLs like CLDB, History Server , Hue and MapR Controller are provide. Login to those services and monitor status of components.

Install Cluster

Add a MapR License

Apply a License

Follow the steps below to install/update a new license :

  1. Log into the MCS https://<node IP address>:8443 as user mapr.

    login MCS

  2. Click Manage licenses on Top Right Corner.

    Manage License

  3. Upload or Copy-Paste the licenses and Click Apply Licenses.

    Apply License

Restart Services

  • After Installing License review the cluster dashboard to see some failed services because MapR tried to start these services without a valid licenses. Service Status

  • Click on Manage Service next to the node with failed service where you can Start , Stop or Restart Services.

    Restart Services

This concludes the installation of MapR Enterprise Edition with a valid license. Read the Next article to manage MapR Configuration.

Leave a Comment