org.apache.hadoop.hdfs.server.common

接口 Upgradeable

所有超级接口:

Comparable<Upgradeable>

所有已知实现类:

UpgradeObject, UpgradeObjectDatanode, UpgradeObjectNamenode

public interface Upgradeable
extends Comparable<Upgradeable>

Common interface for distributed upgrade objects. Each upgrade object corresponds to a layout version, which is the latest version that should be upgraded using this object. That is all components whose layout version is greater or equal to the one returned by getVersion() must be upgraded with this object.

方法概要

方法

限定符和类型	方法和说明
UpgradeCommand	completeUpgrade() Complete upgrade.
String	getDescription() Description of the upgrade object for displaying.
HdfsConstants.NodeType	getType() Get the type of the software component, which this object is upgrading.
short	getUpgradeStatus() Upgrade status determines a percentage of the work done out of the total amount required by the upgrade. 100% means that the upgrade is completed.
UpgradeStatusReport	getUpgradeStatusReport(boolean details) Get status report for the upgrade.
int	getVersion() Get the layout version of the upgrade object.
UpgradeCommand	startUpgrade() Prepare for the upgrade.

从接口继承的方法 java.lang.Comparable

compareTo

方法详细资料

getVersion

int getVersion()

Get the layout version of the upgrade object.

返回:

layout version

getType

HdfsConstants.NodeType getType()

Get the type of the software component, which this object is upgrading.

返回:

type

getDescription

String getDescription()

Description of the upgrade object for displaying.

返回:

description

getUpgradeStatus

short getUpgradeStatus()

Upgrade status determines a percentage of the work done out of the total amount required by the upgrade. 100% means that the upgrade is completed. Any value < 100 means it is not complete. The return value should provide at least 2 values, e.g. 0 and 100.

返回:

integer value in the range [0, 100].

startUpgrade

UpgradeCommand startUpgrade()
                            throws IOException

Prepare for the upgrade. E.g. initialize upgrade data structures and set status to 0. Returns an upgrade command that is used for broadcasting to other cluster components. E.g. name-node informs data-nodes that they must perform a distributed upgrade.

返回:

an UpgradeCommand for broadcasting.

抛出:

IOException

completeUpgrade

UpgradeCommand completeUpgrade()
                               throws IOException

Complete upgrade. E.g. cleanup upgrade data structures or write metadata to disk. Returns an upgrade command that is used for broadcasting to other cluster components. E.g. data-nodes inform the name-node that they completed the upgrade while other data-nodes are still upgrading.

抛出:

IOException

getUpgradeStatusReport

UpgradeStatusReport getUpgradeStatusReport(boolean details)
                                           throws IOException

Get status report for the upgrade.

参数:

details - true if upgradeStatus details need to be included, false otherwise

返回:

UpgradeStatusReport

抛出:

IOException