org.apache.ambari.server.stack.upgrade.orchestrate

Class UpgradeHelper

java.lang.Object

org.apache.ambari.server.stack.upgrade.orchestrate.UpgradeHelper

public class UpgradeHelper
extends Object

Class to assist with upgrading a cluster.

Constructor Summary

Constructors

Constructor and Description
UpgradeHelper()

Method Summary

Modifier and Type	Method and Description
List<UpgradeGroupHolder>	createSequence(UpgradePack upgradePack, UpgradeContext context) Generates a list of UpgradeGroupHolder items that are used to execute either an upgrade or a downgrade.
Resource	getTaskResource(String clusterName, Long requestId, Long stageId, Long taskId) Get a single resource for the task with the given parameters.
void	publishDesiredRepositoriesUpdates(UpgradeContext upgradeContext)
UpgradePack	suggestUpgradePack(String clusterName, StackId sourceStackId, StackId targetStackId, Direction direction, org.apache.ambari.spi.upgrade.UpgradeType upgradeType, String preferredUpgradePackName) Get right Upgrade Pack, depends on stack, direction and upgrade type information
void	updateDesiredRepositoriesAndConfigs(UpgradeContext upgradeContext) Updates the various repositories and configurations for services participating in the upgrade or downgrade.

Methods inherited from class java.lang.Object

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

Constructor Detail

UpgradeHelper

public UpgradeHelper()

Method Detail

suggestUpgradePack

public UpgradePack suggestUpgradePack(String clusterName,
                                      StackId sourceStackId,
                                      StackId targetStackId,
                                      Direction direction,
                                      org.apache.ambari.spi.upgrade.UpgradeType upgradeType,
                                      String preferredUpgradePackName)
                               throws org.apache.ambari.server.AmbariException

Get right Upgrade Pack, depends on stack, direction and upgrade type information

Parameters:

clusterName - The name of the cluster

sourceStackId - the "from" stack for this upgrade/downgrade

targetStackId - the "to" stack for this upgrade/downgrade

direction - Direction of the upgrade

upgradeType - The UpgradeType

preferredUpgradePackName - For unit test, need to prefer an upgrade pack since multiple matches can be found.

Returns:

UpgradeType object

Throws:

org.apache.ambari.server.AmbariException

createSequence

public List<UpgradeGroupHolder> createSequence(UpgradePack upgradePack,
                                               UpgradeContext context)
                                        throws org.apache.ambari.server.AmbariException

Generates a list of UpgradeGroupHolder items that are used to execute either an upgrade or a downgrade.

Parameters:

upgradePack - the upgrade pack

context - the context that wraps key fields required to perform an upgrade

Returns:

the list of holders

Throws:

org.apache.ambari.server.AmbariException

getTaskResource

public Resource getTaskResource(String clusterName,
                                Long requestId,
                                Long stageId,
                                Long taskId)
                         throws UnsupportedPropertyException,
                                NoSuchResourceException,
                                NoSuchParentResourceException,
                                SystemException

Get a single resource for the task with the given parameters.

Parameters:

clusterName - Cluster Name

requestId - Request Id

stageId - Stage Id

taskId - Task Id

Returns:

Single task resource that matches the predicates, otherwise, null.

Throws:

UnsupportedPropertyException

NoSuchResourceException

NoSuchParentResourceException

SystemException

updateDesiredRepositoriesAndConfigs

public void updateDesiredRepositoriesAndConfigs(UpgradeContext upgradeContext)
                                         throws org.apache.ambari.server.AmbariException

Updates the various repositories and configurations for services participating in the upgrade or downgrade. The following actions are performed in order:

• The desired repository for every service and component is changed
• The UpgradeState of every component host is moved to either UpgradeState.IN_PROGRESS or UpgradeState.NONE.
• In the case of an upgrade, new configurations and service configurations are created if necessary. In the case of a downgrade, any configurations created by the upgrade are reverted.

Parameters:

upgradeContext - the upgrade context holding all relevent upgrade information (not null).

Throws:

org.apache.ambari.server.AmbariException

publishDesiredRepositoriesUpdates

public void publishDesiredRepositoriesUpdates(UpgradeContext upgradeContext)
                                       throws org.apache.ambari.server.AmbariException

Throws:

org.apache.ambari.server.AmbariException