org.apache.ambari.server.state

Enum RepositoryVersionState

java.lang.Object

java.lang.Enum<RepositoryVersionState>

org.apache.ambari.server.state.RepositoryVersionState

All Implemented Interfaces:

Serializable, Comparable<RepositoryVersionState>

public enum RepositoryVersionState
extends Enum<RepositoryVersionState>

The RepositoryVersionState represents the state of a repository on a particular host. Because hosts can contain a mixture of components from different repositories, there can be any combination of CURRENT} entries for a single host. A host may not have multiple entries for the same repository.

 Step 1: Initial Configuration
 Version 1 is CURRENT

 Step 2: Add another repository and trigger distributing repositories/installing packages
 Version 1: CURRENT
 Version 2: INSTALLING

 Step 3: distributing repositories/installing packages action finishes successfully or fails
 Version 1: CURRENT
 Version 2: INSTALLED

 or

 Version 1: CURRENT
 Version 2: INSTALL_FAILED (a retry can set this back to INSTALLING)

 Step 4: Perform an upgrade of every component on the host from version 1 to version 2
 Version 1: INSTALLED
 Version 2: CURRENT

 Step 4a: Perform an upgrade of a single component, leaving other components on the prior version
 Version 1: CURRENT
 Version 2: CURRENT

 Step 4b: May revert to the original version via a downgrade, which is technically still an upgrade to a version
 and eventually becomes

 Version 1: CURRENT
 Version 2: INSTALLED

 *********************************************
 Start states: NOT_REQUIRED, INSTALLING, CURRENT
 Allowed Transitions:
 INSTALLED -> CURRENT
 INSTALLING -> INSTALLED | INSTALL_FAILED | OUT_OF_SYNC
 INSTALLED -> INSTALLED | INSTALLING | OUT_OF_SYNC
 OUT_OF_SYNC -> INSTALLING
 INSTALL_FAILED -> INSTALLING
 CURRENT -> INSTALLED
 

Enum Constant Summary

Enum Constants

Enum Constant and Description
CURRENT Repository version that is installed and supported and is the active version.
INSTALL_FAILED Repository version that during the install process failed to install some components.
INSTALLED Repository version that is installed and supported but not the active version.
INSTALLING Repository version that is in the process of being installed.
NOT_REQUIRED Repository version is not required
OUT_OF_SYNC Repository version that is installed for some components but not for all.

Method Summary

Modifier and Type	Method and Description
static RepositoryVersionState	getAggregateState(List<RepositoryVersionState> states) Gets a single representation of the repository state based on the supplied states.
static RepositoryVersionState	valueOf(String name) Returns the enum constant of this type with the specified name.
static RepositoryVersionState[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NOT_REQUIRED

public static final RepositoryVersionState NOT_REQUIRED

Repository version is not required

INSTALLING

public static final RepositoryVersionState INSTALLING

Repository version that is in the process of being installed.

INSTALLED

public static final RepositoryVersionState INSTALLED

Repository version that is installed and supported but not the active version.

INSTALL_FAILED

public static final RepositoryVersionState INSTALL_FAILED

Repository version that during the install process failed to install some components.

OUT_OF_SYNC

public static final RepositoryVersionState OUT_OF_SYNC

Repository version that is installed for some components but not for all.

CURRENT

public static final RepositoryVersionState CURRENT

Repository version that is installed and supported and is the active version.

Method Detail

values

public static RepositoryVersionState[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (RepositoryVersionState c : RepositoryVersionState.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static RepositoryVersionState valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getAggregateState

public static RepositoryVersionState getAggregateState(List<RepositoryVersionState> states)

Gets a single representation of the repository state based on the supplied states.

Parameters:

states - the states to calculate the aggregate for.

Returns:

the "heaviest" state.