MapR Installer FAQ

Review frequently asked questions about the MapR Installer.


What is the difference between the MapR Installer and the Quick Installer?

The MapR Installer is a robust, user-friendly replacement for the Quick Installer. You can use the MapR Installer to install a cluster with MapR services and ecosystem components. You can also use the MapR Installer to update an existing cluster with additional nodes, MapR services, and ecosystem components. However, the MapR Installer does not install the MapR client.


You cannot use the MapR Installer to update a cluster that was not installed using the MapR Installer.

Which versions of MapR can I install?

You can use the MapR Installer to install MapR 4.1, 5.0, 5.1, and 5.2.

Can I use the MapR Installer to upgrade my cluster?

The MapR Installer can only be used to upgrade a cluster that was installed using the MapR Installer. See Upgrading MapR Core With the MapR Installer for information on how to upgrade with the MapR Installer.

Can I use the MapR Installer to install a patch?

No. You cannot install a patch using the MapR Installer. See the MapR Patch installation instructions.

Preparing to Install

What are the MapR Installer requirements?

See the Prerequisites.

What information should I be prepared with before I start?
The script will requests the following information:
  • The hostname and port number that nodes that you include in the cluster can use to connect to the MapR Installer node.
  • A user for the MapR Admin user account. If the user account doesn't exists, the script will prompt for the UIG, GID, group name, and password so that it can create the account.

The MapR installer will request the following information:

  • The MapR services that you want to install on the cluster
  • Hostnames or IP addresses of the nodes that you want to include in the cluster
  • Credentials for the root user or a user with sudo privileges on each node in the cluster
What are the node requirements?

See the Prerequisites.

What are my options if I don't want to use an Internet repository?

See Installation Options.

Can I install on nodes in the cloud?

Yes. See Installation Options.

Using the MapR Installer

Which license edition applies to my installation?
As of 5.1, MapR licenses are categorized by new editions and modules that further define the features supported by an edition.

See the following table for descriptions of the new license options:

License Edition Description
Converged Community Edition An unlimited, free, community-supported MapR edition with one free NFS Gateway. This edition includes Hadoop, MapR-DB, and MapR Streams. However, real-time global replication of MapR-DB tables or MapR Streams is not included.
Converged Enterprise Edition MapR Edition that enables enterprise class features such as high availability, multi-tenancy, and disaster recovery. Each of the following modules for the Converged Enterprise Edition unlocks a portion of the total platform capabilities:
Enables enterprise class features for analytic use cases, such as highly-available NFS and support for Hadoop services like YARN and MapReduce.
Enables enterprise class features for operational NoSQL database, with MapR-DB JSON and binary tables, and real-time global database replication.
Enables enterprise class features for publish/subscribe event streaming, with MapR Streams and real-time global stream replication.
What happened to the M3, M5, M7, or Enterprise Edition licenses?
With the release of 5.1 and MapR Streams, the licensing model has been simplified, allowing more choice in which specific features are licensed on a cluster.

See the following table to understand how the new MapR licenses correspond to the legacy license editions that you are familiar with:

Legacy Edition New Edition & Module(s)
M3 or Community Edition Converged Community Edition. Starting in 5.1, the Converged Community Edition includes MapR Streams.
M5 or Enterprise Edition Converged Enterprise Edition with Hadoop Module
M7 or Enterprise Database Edition Converged Enterprise Edition with Hadoop and Database modules
What expressions can I use to specify multiple nodes?

You can enter the following types of expressions to specify nodes:

  • [0-99] => Expands hostnames to 0, 1, 2, ...99. The second delimiter allows one or more digits.
  • [00-99] => Expands hostnames to 00,01,02,...99. Allows two or more digits of the same length
  • [a-z] or [A-Z] => Expands hostnames to a,b,c,...z or A,B,C,...Z

To group hosts based on racks for performance or reliability, append ":" followed by the rack name to each expression.


  • host1, host2, host3
  • host[A-Z][0-99] => hostA0, hostA1, hostA2 ,...hostZ99
  • host[000-333] => host000, host001, host002, ... host333
  • host[0-3],otherhost[00-05] => host0, host1, host2,...host3 and otherhost00,...otherhost05
  • host[0-5]:rack1,host[6-10]:rack2 => host1, host2, host3,...host5 on rack1. host6, host7, host8,...host10 on rack2
How do I change the service layout?

The MapR Installer uses groups to organize nodes and services. A group is a set of services that you can run on one or more nodes. A service can only be assigned to one group.

On the Configure Service Layout page, you can use the Advanced Configuration option to drag and drop services between existing groups to specify where the services are to be installed. You can also create new groups or change the list of nodes assigned to a group.
Note: Some services can only be assigned to one node.
Can I install a single-master service, such as Hive, on multiple nodes?
When you use the MapR Installer, single-master services are added to the default MASTER group. By design, only one node can be assigned to the MASTER group.

To install a single-master service on more than one node:

  1. On the Configure Service Layout page, create a new group.
  2. Assign multiple nodes to the new group.
  3. Drag the single-master service to the new group.
Can I install a secure MapR cluster with the MapR Installer?

After the MapR installation completes, you can configure the cluster to be secure. See Configuring Mapr Security for more information.

Are there limitations to what you can do when you update an existing cluster?

You can perform the following actions when performing an incremental install on a cluster:

  • Add nodes to the cluster
  • Add services to new and existing nodes
  • Upgrade existing services

You cannot perform the following actions when performing an incremental install on a cluster:

  • Move a service to a different node
  • Delete a node
  • Delete a service from the cluster
How do I uninstall the MapR Installer?

The node from which you run the MapR installer, the installer node, must always be part of the cluster. Therefore, the MapR Installer packages should remain on the installer node until after the cluster is uninstalled

If you have uninstalled the cluster, you can run one of the following commands to uninstall the MapR Installer packages from the installer node:

  • On CentOS/ Red Hat:

    yum remove 'mapr-installer*'
  • On Ubuntu:
    apt-get remove 'mapr-installer*'


Why does the MapR Installer URL not work?

Check that the URL you are trying to access is external. For example, if you install on a cluster that is in the cloud, the URL that the MapR Installer lists may not work if it is an internal URL. Try accessing the external URL that is associated with the internal URL.

Why doesn't the MapR Installer list the ecosystem component that I want to install?

The MapR Installer Definitions package contains the MapR versions and services that you can install. Once you update the MapR Installer Definitions, you can install ecosystem components that were made available after you first configured the MapR Installer. See Update the MapR Installer.

Why are the nodes listed on the Verify Nodes page different from those that I chose to install on?

If you abort an installation and then install on a different set of nodes, you must use the Verify Nodes page to manually remove nodes that were part of the aborted installation but are no longer part of the current installation.

I can't login to Hue. What credentials should I be using to log into Hue for the first time?
Log in with cluster administrator username that you configured while running and the password mapr.