org.elasticsearch.test

Class CompositeTestCluster

java.lang.Object

org.elasticsearch.test.TestCluster

org.elasticsearch.test.CompositeTestCluster

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class CompositeTestCluster
extends TestCluster

A test cluster implementation that holds a fixed set of external nodes as well as a InternalTestCluster which is used to run mixed version clusters in tests like backwards compatibility tests. Note: this is an experimental API

Field Summary

Fields inherited from class org.elasticsearch.test.TestCluster

logger, random, transportClientRatio

Constructor Summary

Constructors

Constructor and Description
CompositeTestCluster(InternalTestCluster cluster, int numExternalNodes, org.elasticsearch.test.ExternalNode externalNode)

Method Summary

Modifier and Type	Method and Description
void	afterTest() This method should be executed during tear down, after each test (but after assertAfterTest)
void	allowOnAllNodes(java.lang.String... index) Allows allocation of shards of the given indices on all nodes in the cluster.
void	allowOnlyNewNodes(java.lang.String... index) Allows allocation of shards of the given indices only on "new" nodes in the cluster.
java.lang.String	backwardsNodePattern() Returns the a simple pattern that matches all "old" / "backwardss" nodes in the cluster.
void	beforeTest(java.util.Random random, double transportClientRatio) This method should be executed before each test to reset the cluster to its initial state.
Client	client() Returns a client connected to any node in the cluster
void	close() Closes the current cluster
void	ensureEstimatedStats() Ensures that any breaker statistics are reset to 0.
TransportAddress	externalTransportAddress()
void	fullRestartInternalCluster() Delegates to InternalTestCluster.fullRestart()
java.lang.Iterable<Client>	getClients() Returns an Iterable over all clients in this test cluster
java.lang.String	getClusterName() Returns the cluster name
java.net.InetSocketAddress[]	httpAddresses() Returns the http addresses of the nodes within the cluster.
InternalTestCluster	internalCluster()
java.lang.String	newNodePattern() Returns the a simple pattern that matches all "new" nodes in the cluster.
int	numBackwardsDataNodes() Returns the number of former version data nodes in the cluster
int	numDataAndMasterNodes() Returns the number of data and master eligible nodes in the cluster.
int	numDataNodes() Returns the number of data nodes in the cluster.
int	numNewDataNodes() Returns the number of current version data nodes in the cluster
int	size() Returns the number of nodes in the cluster.
void	startNewNode() Starts a current version data node
boolean	upgradeAllNodes() Upgrades all external running nodes to a node from the version running the tests.
boolean	upgradeAllNodes(Settings nodeSettings) Upgrades all external running nodes to a node from the version running the tests.
boolean	upgradeOneNode() Upgrades one external running node to a node from the version running the tests.
boolean	upgradeOneNode(Settings nodeSettings) Upgrades one external running node to a node from the version running the tests.

Methods inherited from class org.elasticsearch.test.TestCluster

assertAfterTest, beforeIndexDeletion, seed, wipe, wipeAllTemplates, wipeIndices, wipeRepositories, wipeTemplates

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeTestCluster

public CompositeTestCluster(InternalTestCluster cluster,
                            int numExternalNodes,
                            org.elasticsearch.test.ExternalNode externalNode)
                     throws java.io.IOException

Throws:

java.io.IOException

Method Detail

afterTest

public void afterTest()
               throws java.io.IOException

Description copied from class: TestCluster

This method should be executed during tear down, after each test (but after assertAfterTest)

Specified by:

afterTest in class TestCluster

Throws:

java.io.IOException

beforeTest

public void beforeTest(java.util.Random random,
                       double transportClientRatio)
                throws java.io.IOException,
                       java.lang.InterruptedException

Description copied from class: TestCluster

This method should be executed before each test to reset the cluster to its initial state.

Overrides:

beforeTest in class TestCluster

Throws:

java.io.IOException

java.lang.InterruptedException

upgradeOneNode

public boolean upgradeOneNode()
                       throws java.lang.InterruptedException,
                              java.io.IOException

Upgrades one external running node to a node from the version running the tests. Commonly this is used to move from a node with version N-1 to a node running version N. This works seamless since they will share the same data directory. This method will return true iff a node got upgraded otherwise if no external node is running it returns false

Throws:

java.lang.InterruptedException

java.io.IOException

upgradeAllNodes

public boolean upgradeAllNodes()
                        throws java.lang.InterruptedException,
                               java.io.IOException

Upgrades all external running nodes to a node from the version running the tests. All nodes are shut down before the first upgrade happens.

Returns:

true iff at least one node as upgraded.

Throws:

java.lang.InterruptedException

java.io.IOException

upgradeAllNodes

public boolean upgradeAllNodes(Settings nodeSettings)
                        throws java.lang.InterruptedException,
                               java.io.IOException

Upgrades all external running nodes to a node from the version running the tests. All nodes are shut down before the first upgrade happens.

Parameters:

nodeSettings - settings for the upgrade nodes

Returns:

true iff at least one node as upgraded.

Throws:

java.lang.InterruptedException

java.io.IOException

upgradeOneNode

public boolean upgradeOneNode(Settings nodeSettings)
                       throws java.lang.InterruptedException,
                              java.io.IOException

Upgrades one external running node to a node from the version running the tests. Commonly this is used to move from a node with version N-1 to a node running version N. This works seamless since they will share the same data directory. This method will return true iff a node got upgraded otherwise if no external node is running it returns false

Throws:

java.lang.InterruptedException

java.io.IOException

newNodePattern

public java.lang.String newNodePattern()

Returns the a simple pattern that matches all "new" nodes in the cluster.

backwardsNodePattern

public java.lang.String backwardsNodePattern()

Returns the a simple pattern that matches all "old" / "backwardss" nodes in the cluster.

allowOnAllNodes

public void allowOnAllNodes(java.lang.String... index)

Allows allocation of shards of the given indices on all nodes in the cluster.

allowOnlyNewNodes

public void allowOnlyNewNodes(java.lang.String... index)

Allows allocation of shards of the given indices only on "new" nodes in the cluster. Note: if a shard is allocated on an "old" node and can't be allocated on a "new" node it will only be removed it can be allocated on some other "new" node.

startNewNode

public void startNewNode()

Starts a current version data node

client

public Client client()

Description copied from class: TestCluster

Returns a client connected to any node in the cluster

Specified by:

client in class TestCluster

size

public int size()

Description copied from class: TestCluster

Returns the number of nodes in the cluster.

Specified by:

size in class TestCluster

numDataNodes

public int numDataNodes()

Description copied from class: TestCluster

Returns the number of data nodes in the cluster.

Specified by:

numDataNodes in class TestCluster

numDataAndMasterNodes

public int numDataAndMasterNodes()

Description copied from class: TestCluster

Returns the number of data and master eligible nodes in the cluster.

Specified by:

numDataAndMasterNodes in class TestCluster

httpAddresses

public java.net.InetSocketAddress[] httpAddresses()

Description copied from class: TestCluster

Returns the http addresses of the nodes within the cluster. Can be used to run REST tests against the test cluster.

Specified by:

httpAddresses in class TestCluster

close

public void close()
           throws java.io.IOException

Description copied from class: TestCluster

Closes the current cluster

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class TestCluster

Throws:

java.io.IOException

ensureEstimatedStats

public void ensureEstimatedStats()

Description copied from class: TestCluster

Ensures that any breaker statistics are reset to 0. The implementation is specific to the test cluster, because the act of checking some breaker stats can increase them.

Specified by:

ensureEstimatedStats in class TestCluster

getClusterName

public java.lang.String getClusterName()

Description copied from class: TestCluster

Returns the cluster name

Specified by:

getClusterName in class TestCluster

getClients

public java.lang.Iterable<Client> getClients()

Description copied from class: TestCluster

Returns an Iterable over all clients in this test cluster

Specified by:

getClients in class TestCluster

fullRestartInternalCluster

public void fullRestartInternalCluster()
                                throws java.lang.Exception

Delegates to InternalTestCluster.fullRestart()

Throws:

java.lang.Exception

numNewDataNodes

public int numNewDataNodes()

Returns the number of current version data nodes in the cluster

numBackwardsDataNodes

public int numBackwardsDataNodes()

Returns the number of former version data nodes in the cluster

externalTransportAddress

public TransportAddress externalTransportAddress()

internalCluster

public InternalTestCluster internalCluster()