org.elasticsearch.common.util

Class MultiDataPathUpgrader

java.lang.Object

org.elasticsearch.common.util.MultiDataPathUpgrader

public class MultiDataPathUpgrader
extends Object

Constructor Summary

Constructors

Constructor and Description
MultiDataPathUpgrader(NodeEnvironment nodeEnvironment) Creates a new upgrader instance

Method Summary

Methods

Modifier and Type	Method and Description
void	checkIndex(ShardPath targetPath) Runs check-index on the target shard and throws an exception if it failed
protected long	getSpaceUsedByShard(Path path)
protected long	getUsabelSpace(NodeEnvironment.NodePath path)
boolean	needsUpgrading(ShardId shard) Returns true iff the given shard needs upgrading.
ShardPath	pickShardPath(ShardId shard) Picks a target ShardPath to allocate and upgrade the given shard to.
void	upgrade(ShardId shard, ShardPath targetPath) Upgrades the given shard Id from multiple shard paths into the given target path.
static void	upgradeMultiDataPath(NodeEnvironment nodeEnv, ESLogger logger) Runs an upgrade on all shards located under the given node environment if there is more than 1 data.path configured otherwise this method will return immediately.

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiDataPathUpgrader

public MultiDataPathUpgrader(NodeEnvironment nodeEnvironment)

Creates a new upgrader instance

Parameters:

nodeEnvironment - the node env to operate on.

Method Detail

upgrade

public void upgrade(ShardId shard,
           ShardPath targetPath)
             throws IOException

Upgrades the given shard Id from multiple shard paths into the given target path.

Throws:

IOException

See Also:

pickShardPath(org.elasticsearch.index.shard.ShardId)

checkIndex

public void checkIndex(ShardPath targetPath)
                throws IOException

Runs check-index on the target shard and throws an exception if it failed

Throws:

IOException

needsUpgrading

public boolean needsUpgrading(ShardId shard)

Returns true iff the given shard needs upgrading.

pickShardPath

public ShardPath pickShardPath(ShardId shard)
                        throws IOException

Picks a target ShardPath to allocate and upgrade the given shard to. It picks the target based on a simple heuristic:

• if the smallest datapath has 2x more space available that the shards total size the datapath with the most bytes for that shard is picked to minimize the amount of bytes to copy
• otherwise the largest available datapath is used as the target no matter how big of a slice of the shard it already holds.

Throws:

IOException

getSpaceUsedByShard

protected long getSpaceUsedByShard(Path path)
                            throws IOException

Throws:

IOException

getUsabelSpace

protected long getUsabelSpace(NodeEnvironment.NodePath path)
                       throws IOException

Throws:

IOException

upgradeMultiDataPath

public static void upgradeMultiDataPath(NodeEnvironment nodeEnv,
                        ESLogger logger)
                                 throws IOException

Runs an upgrade on all shards located under the given node environment if there is more than 1 data.path configured otherwise this method will return immediately.

Throws:

IOException