Refresh the Cluster Configuration
When property values change on the cluster, refresh the cluster configuration to import the changes. Similar to when you import the cluster configuration, you can refresh it either directly or from a .zip or .tar archive file.
You can refresh the cluster configuration from the Actions menu.
The refresh operation updates the cluster configuration in the following ways:
- •Unedited values of imported properties are refreshed with the value from the cluster.
- •The refresh operation refreshes the contents of the cluster configuration and properties in the connections that are associated with it, such as fs.defaultFS. If you refresh the cluster configuration from an archive file that does not contain one of the required *-site.xml files, the refresh cluster configuration drops the configuration set. If a missing *-site.xml file contained properties that get propagated to a connection, the refresh operation succeeds, but the connection refresh fails.
- •If you override an imported property value, the refresh operation refreshes the imported value and maintains the overridden value. The Administrator tool displays the updated imported value and the active override value.
- •If you override an imported property value, and the property is subsequently removed from the cluster, the refresh operation converts the property to a user-defined property.
- •User-defined properties that do not exist in the cluster are not affected.
- •If you configure a user-defined property that is subsequently configured on the cluster, the refresh operation converts the user-defined property to an imported property. The user-defined property value becomes an overridden value of the imported property.
- •If you deleted an imported property, the refresh operation imports the property again if it exists on the cluster.
Example - Cluster Configuration Refresh
The following example shows the process for importing a property added during a refresh operation after you create it as a user-defined property.
- 1. You add the following user-defined property to the cluster configuration:
<property>
<name>hive.runtime.mode.prefix</name>
<value>rt_</value>
<description>prefixes the runtime output table by this string</description>
</property>
- 2. The Hadoop administrator adds the property to the cluster, but with a different value, as follows:
<property>
<name>hive.runtime.mode.prefix</name>
<value>runtime_</value>
<description>prefixes the runtime output table by this string</description>
</property>
- 3. You refresh the cluster configuration, and the refresh operation performs the following tasks.
- a. Converts the user-defined property to an imported property.
- b. Maintains the user-defined "rt_" value as an overridden value.
- c. Imports the cluster value "runtime_" as the imported value.