maprcommunity

How to Build “Stanzas” Using MapR Installer for Easy and Efficient Provisioning

Blog Post created by maprcommunity Employee on Feb 1, 2017

How to Build “Stanzas” Using MapR Installer for Easy and Efficient Provisioning

by Prashant Rathi

 

MapR launched the MapR Installer last year to provide cluster operators an intuitive way to set up a MapR cluster using a step-by-step wizard. The wizard guides you through:

  • Selecting a MapR Core Version and ecosystem services from the MapR Ecosystem Packages (MEPs)
  • Using Auto-Provisioning templates
  • Specifying a list of Nodes and Disks
  • Grouping Services and laying them out across nodes
  • Verification of all dependencies before cluster installation

At MapR, we have set up multiple clusters for several of our enterprise customers, and we have brought that knowledge and best practices to MapR Installer. Increasingly, these deployments have not only grown in number, but have also evolved based on the type, purpose, and lifetime of these clusters. If you add to the mix the rapid innovation in the community and the complexity that it brings, there is a clear demand for a higher level of automated and consistent cluster provisioning.

Under the Spyglass Initiative, today we are proud to announce MapR Installer Stanzas. MapR Installer Stanzas enable API-driven installation for the industry’s only converged data platform. With this capability, operators can build a Stanza, which contains layout and settings for the cluster to be installed, and pass it programmatically to the installer to execute the set of instructions.

This new capability is very useful when you need a script-based tool to install MapR software and you do not want to click through the menus and options provided by the MapR Installer wizard. While this method provides less visual feedback than the GUI version, it can be faster and more efficient at installing software on clusters with many nodes. Not only that, but once a Stanza gets defined, you can automate the cluster setup process for each successive cluster creation with a minimum set of changes.

Read the detailed “how-to” guide here. At the heart of these Stanzas is a YAML file. You must configure a YAML file before using this method to install or upgrade a cluster. Sample YAML files (basic and advanced) can be found in the installer package, but here are the top-level sections:

  • Environment – specifies the mapr_core_version
  • Config – specifies the list of nodes (with login information), disks, and other configuration info. Also includes the list of services chosen from pre-existing templates or custom-defined from MEP versions.
  • Groups (optional) – selection of services grouped across nodes for advanced layout option

Here’s an example structure for a 3-node cluster:

environment:    
   mapr_core_version: 5.2.0
config:   
   hosts:         
      - demonode[1-3].example.com   
   ssh_id: root   
   license_type: enterprise   
   mep_version: 2.0   
   disks:         
      - /dev/sdb        
     - /dev/sdc   
   services:                 
      template-05-converged:

MapR Installer Stanzas come with the following set of commands that can be executed on the command line:

  • Install – use to fresh install, incremental install, and upgrade a cluster
  • Uninstall – use to uninstall a cluster
  • Export – use to generate a YAML file to capture state of the cluster
  • List – list nodes, services, and groups in a cluster

Quick set of steps to get started: Download the Installer 1.4.

  1. Review the detailed documentation here.
  2. Start building new clusters!

 

Related Content

Installing MapR 

Using MapR Installer Stanzas 

mapr installation mapr installer stanzas

 

Content Originally posted in MapR Converge Blog post, visit here

Subscribe to Converge Blog

Outcomes