Ambari Release Notes
Also available as:

Behavioral Changes

Ambari includes the following behavioral changes.

Table 1.1. Ambari Behavioral Changes

Apache Jira

HWX Jira



AMBARI-13241 AMBARI-13251 BUG-45125DataNode Mount Directory ListThe hadoop-env/ configuration property is no longer customizable from Ambari. The original default value of "/etc/hadoop/conf/dfs_data_dir_mount.hist" is now "/var/lib/ambari-agent/data/datanode/dfs_data_dir_mount.hist", which is not customizable. On Ambari Agent upgrade, Ambari will automatically move the file from "/etc/hadoop/conf/dfs_data_dir_mount.hist" to "/var/lib/ambari-agent/data/datanode/dfs_data_dir_mount.hist". If you have not modified this configuration property, no action is required. If you had previously modified this value, after upgrading to Ambari, you must restart your DataNodes for the file to written to be the new location.
AMBARI-12901 AMBARI-13062 BUG-42230Kerberos: Storm Headless PrincipalThe Ambari "headless" principal for Storm now includes ${cluster-name} by default. Be sure to check the Ambari Principal names (on the Configure Identities step) when enabling Kerberos.
AMBARI-13067 BUG-43905 Kafka Rolling Restart Action Kafka Service Actions include an option for Rolling Restart of Kafka Brokers. This should be used in lieu of Restart All, which can result in Brokers failing to elect a leader while stopping.
AMBARI-9784 BUG-32201 JDK SupportAdded support for JDK 1.8 and removed support for JDK 1.6. You must upgrade to JDK 1.7 in your current Ambari before upgrading to Ambari 2.1.
AMBARI-9791 BUG-32223 OS Support Added support for RHEL/CentOS/Oracle Linux 7 and removed support for RHEL/CentOS/Oracle Linux 5. You must be running RHEL/CentOS/Oracle Linux 6 or 7 before upgrading to Ambari 2.1.
AMBARI-6646 RMP-3096 Rack Awareness Added support for HDFS Rack Awareness. If you currently configured HDFS for rack awareness using your own topology script, that configuration will stay in place. If you want to switch to use Ambari Rack Awareness features, you will need to update the HDFS property to use the Ambari-generated script: /etc/hadoop/conf/
AMBARI-10506 BUG-33967 SSL Client and Server ConfigurationAdded support for managing ssl-client and ssl-server HDFS configurations. If you are currently managing these files manually across the hosts in your cluster, you will need to migrate management to Ambari.
AMBARI-12258 BUG-40449 Backup

During Ambari upgrade, the existing file is overwritten and a backup copy of (with extension . rpmsave) is created. If you have manually modified (for example, to change Ambari Server heap), you will need to re-apply your changes to the new file.
AMBARI-10648 BUG-34434HeatmapsThe Ambari Web Dashboard > Heatmaps tab includes a list of all heatmaps available for the hosts and services in the cluster. In addition, each Service that has Heatmaps also include a Service > Heatmaps tab with the list of the heatmaps specific to that Service. For example, HDFS and YARN include a heatmaps tab under their respective Services.
AMBARI-9794 BUG-32000Config OrganizationThe new Guided Configs features changes the layout + controls of Service Configs for HDFS, YARN, Hive and HBase. Under the Service > Configs tab, you will see sub-tabs "Settings" and "Advanced". The Settings tab include the most commonly used configuration properties for that service. The Advanced tab includes all other properties (with a layout similar to previous Ambari releases), including the Custom sections where you can add custom properties to a service configuration.
AMBARI-10400BUG-34054Sudo UsageWhen Ambari Agents are configured to run as non-root, Ambari will use sudo to execute commands. Therefore, sudo must be available in order to run non-root Agents. If you are not running a non-root Agent configuration, sudo will not be used to execute commands.
  Removed SLES 11 SP1 supportSLES 11 SP1 or SP3 can be used with Ambari when installing and managing HDP 2.2, 2.1 or 2.0 clusters. SLES 11 SP1 cannot be used with Ambari installing and managing HDP 2.3. You must use SLES 11 SP3.
  HDP Stack SupportAmbari support for HDP 2.0 and HDP 2.1 is deprecated starting with Ambari 2.1 release. Support for these HDP Stacks will be removed in a future Ambari release.
  HDP 2.0 or HDP 2.1 UpgradeAmbari 2.1 does not support directly upgrading from HDP 2.0 or HDP 2.1 to HDP 2.3. In order to upgrade from HDP 2.0 or HDP 2.1, you must first upgrade to HDP 2.2 using either Ambari 1.7 or 2.0. Once completed, upgrade your current Ambari to Ambari 2.1. Then, leverage Ambari 2.1 to complete the upgrade from HDP 2.2 to HDP 2.3.