org.apache.ambari.server.serveraction.upgrades

Class ConfigureAction

java.lang.Object

org.apache.ambari.server.serveraction.AbstractServerAction

org.apache.ambari.server.serveraction.upgrades.AbstractUpgradeServerAction

org.apache.ambari.server.serveraction.upgrades.ConfigureAction

All Implemented Interfaces:

ServerAction

Direct Known Subclasses:

CreateAndConfigureAction

public class ConfigureAction
extends AbstractUpgradeServerAction

The ConfigureAction is used to alter a configuration property during an upgrade. It will only produce a new configuration if an actual change is occuring. For some configure tasks, the value is already at the desired property or the conditions of the task are not met. In these cases, a new configuration will not be created. This task can perform any of the following actions in a single declaration:

• Copy a configuration to a new property key, optionally setting a default if the original property did not exist
• Copy a configuration to a new property key from one configuration type to another, optionally setting a default if the original property did not exist
• Rename a configuration, optionally setting a default if the original property did not exist
• Delete a configuration property
• Set a configuration property
• Conditionally set a configuration property based on another configuration property value

Field Summary

Fields inherited from class org.apache.ambari.server.serveraction.upgrades.AbstractUpgradeServerAction

agentConfigsHolder, m_amc, m_clusters, m_metainfoProvider, m_upgradeDAO, m_upgradeHelper

Fields inherited from class org.apache.ambari.server.serveraction.AbstractServerAction

actionLog, gson

Fields inherited from interface org.apache.ambari.server.serveraction.ServerAction

ACTION_NAME, ACTION_USER_NAME, DEFAULT_LONG_RUNNING_TASK_TIMEOUT_SECONDS, WRAPPED_CLASS_NAME

Constructor Summary

Constructors

Constructor and Description
ConfigureAction()

Method Summary

Modifier and Type	Method and Description
CommandReport	execute(ConcurrentMap<String,Object> requestSharedDataContext) Aside from the normal execution, this method performs the following logic, with the stack values set in the table below:

Methods inherited from class org.apache.ambari.server.serveraction.upgrades.AbstractUpgradeServerAction

getClusters, getGson, getUpgradeContext

Methods inherited from class org.apache.ambari.server.serveraction.AbstractServerAction

auditLog, createCommandReport, createCompletedCommandReport, getCommandParameters, getCommandParameterValue, getExecutionCommand, getHostRoleCommand, setExecutionCommand, setHostRoleCommand

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConfigureAction

public ConfigureAction()

Method Detail

execute

public CommandReport execute(ConcurrentMap<String,Object> requestSharedDataContext)
                      throws org.apache.ambari.server.AmbariException,
                             InterruptedException

Aside from the normal execution, this method performs the following logic, with the stack values set in the table below:

Upgrade Path	direction	Stack Actual	Stack Desired	Config Stack	Action
2.2.x -> 2.2.y	upgrade or downgrade	2.2	2.2	2.2	if value has changed, create a new config object with new value
2.2 -> 2.3	upgrade	2.2	2.3: set before action is executed	2.3: set before action is executed	new configs are already created; just update with new properties
2.3 -> 2.2	downgrade	2.2	2.2: set before action is executed	2.2	configs are already managed, results are the same as 2.2.x -> 2.2.y

Executes this ServerAction

This is typically called by the ServerActionExecutor in it's own thread, but there is no guarantee that this is the case. It is expected that the ExecutionCommand and HostRoleCommand properties are set before calling this method.

Parameters:

requestSharedDataContext - a Map to be used a shared data among all ServerActions related to a given request

Returns:

a CommandReport declaring the status of the task

Throws:

org.apache.ambari.server.AmbariException

InterruptedException