Setting Cloudera Manager Configurations

You can use Cloudera Director to set configurations for the various Cloudera Manager entities that it deploys:
  • Cloudera Manager
  • Cloudera Management Service
  • The various CDH components, such as HDFS, Hive, and HBase
  • Role types, such as NameNode, ResourceManager, and Impala Daemon
This functionality is not available through the Cloudera Director UI, but is available for both Cloudera Director client and Cloudera Director server:
  • Client - Using the configuration file. For more information on the configuration file, see The Cloudera Director Configuration File.
  • Server - Submitting JSON documents to the REST service endpoint. The REST service endpoint can also be exercised through the API console at http://director-server-hostname:7189/api-console.

Cloudera Director enables you to customize deployment and cluster setup, and configurations are applied on top of Cloudera Manager default and automatic host-based configuration of services and roles. Set configurations either in the deployment template or in the cluster template.

Deployment Template Configuration

This section shows the structure of the Cloudera Manager deployment configuration settings in both the CLI and the API.

CLI

Using the CLI, the configs section in the deployment template has the following structure: 
cloudera-manager {
   ...
   configs {
      # CLOUDERA_MANAGER corresponds to the Cloudera Manager Server configuration options 
      CLOUDERA_MANAGER { 
         enable_api_debug: false 
      } 
   
      # CLOUDERA_MANAGEMENT_SERVICE corresponds to the Service-Wide configuration options 
      CLOUDERA_MANAGEMENT_SERVICE { 
         enable_alerts : false 
         enable_config_alerts : false 
      } 

      ACTIVITYMONITOR { ... } 

      REPORTSMANAGER { ... } 

      NAVIGATOR { ... } 

      # Added in Cloudera Manager 5.2+ 
      NAVIGATORMETASERVER { ... } 

      # Configuration properties for all hosts 
      HOSTS { ... } 
   }
   ...
}

API

Using the API, the configs section for deployment templates has the following structure: 
{
   "configs":  {
      "CLOUDERA_MANAGER": {
         "enable_api_debug": "true"
      },
      "CLOUDERA_MANAGEMENT_SERVICE": {
         "enable_alerts": "false"
      }
   }
}

Cluster Template Service-wide Configuration

This section shows the structure of the Cloudera Manager service-wide configuration settings in both the CLI and the API.

CLI

Using the CLI, the configs section for service-wide configurations in the cluster template has the following structure: 
cluster {
   ...
   configs {
      HDFS {
         dfs_block_size: 1342177280
      } 
      MAPREDUCE {
         mapred_system_dir: /user/home
         mr_user_to_impersonate: mapred1
      }
   }
   ...
}

API

Using the API, the service-wide configurations block in the ClusterTemplate is labelled servicesConfigs, and has the following structure: 
{
   "servicesConfigs": {
      "HDFS": {
         "dfs_block_size": 1342177280
      },
      "MAPREDUCE": {
         "mapred_system_dir": "/user/home",
         "mr_user_to_impersonate": "mapred1"
      }
   }
}

Cluster Template Roletype Configurations

This section shows the structure of the Cloudera Manager roletype configuration settings in both the CLI and the API.

CLI

Using the CLI, roletype configurations in the cluster template are specified per instance group: 
cluster {
   ...
   masters {
      ...
      # Optional custom role configurations
      configs {
         HDFS {
            NAMENODE {
               dfs_name_dir_list: /data/nn
               namenode_port: 1234
            }
         }
      }
      ...
   }
   ...
}

API

Using the API, roletype configurations in the cluster template are specified per instance group: 
{
   "virtualInstanceGroups" : {
      "configs": {
         "HDFS": {
            "NAMENODE": {
                "dfs_name_dir_list": "/data/nn",
                "namenode_port": "1234"
            }
         }
      }
   }
}