Module org.elasticsearch.server

Package org.elasticsearch.node

Class Node

java.lang.Object

org.elasticsearch.node.Node

All Implemented Interfaces:

Closeable, AutoCloseable

public class Node
extends Object
implements Closeable

A node represent a node within a cluster (cluster.name). The client() can be used in order to use a Client to perform actions/operations against the cluster.

Field Summary

Fields

Modifier and Type	Field	Description
static final Setting<String>	BREAKER_TYPE_KEY
static final Setting<TimeValue>	INITIAL_STATE_TIMEOUT_SETTING
static final Setting.AffixSetting<String>	NODE_ATTRIBUTES
static final Setting<String>	NODE_EXTERNAL_ID_SETTING
static final Setting<String>	NODE_NAME_SETTING
static final Setting<Boolean>	WRITE_PORTS_FILE_SETTING

Constructor Summary

Constructors

Modifier	Constructor	Description
	Node(Environment environment)	Constructs a node
protected	Node(Environment initialEnvironment, Function<Settings,PluginsService> pluginServiceCtor, boolean forbidPrivateIndexSettings)	Constructs a node

Method Summary

Modifier and Type	Method	Description
boolean	awaitClose(long timeout, TimeUnit timeUnit)	Wait for this node to be effectively closed.
Client	client()	A client that can be used to execute actions (operations) against the cluster.
void	close()
protected void	configureNodeAndClusterIdStateListener(ClusterService clusterService)
static void	deleteTemporaryApmConfig(JvmInfo jvmInfo, BiConsumer<Exception,Path> errorHandler)	If the JVM was started with the Elastic APM agent and a config file argument was specified, then delete the config file.
Environment	getEnvironment()	Returns the environment of the node
NodeEnvironment	getNodeEnvironment()	Returns the NodeEnvironment instance of this node
protected PluginsService	getPluginsService()	The PluginsService used to build this node's components.
Injector	injector()
boolean	isClosed()	Returns true if the node is closed.
protected ClusterInfoService	newClusterInfoService(Settings settings, ClusterService clusterService, ThreadPool threadPool, NodeClient client)	Constructs a ClusterInfoService which may be mocked for tests.
protected HttpServerTransport	newHttpTransport(NetworkModule networkModule)	Constructs a HttpServerTransport which may be mocked for tests.
protected ScriptService	newScriptService(Settings settings, Map<String,ScriptEngine> engines, Map<String,ScriptContext<?>> contexts, LongSupplier timeProvider)	Creates a new the ScriptService.
protected SearchService	newSearchService(ClusterService clusterService, IndicesService indicesService, ThreadPool threadPool, ScriptService scriptService, BigArrays bigArrays, FetchPhase fetchPhase, ResponseCollectorService responseCollectorService, CircuitBreakerService circuitBreakerService, ExecutorSelector executorSelector, Tracer tracer)	Creates a new the SearchService.
protected TransportService	newTransportService(Settings settings, Transport transport, ThreadPool threadPool, TransportInterceptor interceptor, Function<BoundTransportAddress,DiscoveryNode> localNodeFactory, ClusterSettings clusterSettings, TaskManager taskManager, Tracer tracer)
void	prepareForClose()	Invokes hooks to prepare this node to be closed.
protected void	processRecoverySettings(ClusterSettings clusterSettings, RecoverySettings recoverySettings)
Settings	settings()	The settings that are used by this node.
Node	start()	Start the node.
protected void	validateNodeBeforeAcceptingRequests(BootstrapContext context, BoundTransportAddress boundTransportAddress, List<BootstrapCheck> bootstrapChecks)	Hook for validating the node after network services are started but before the cluster service is started and before the network service starts accepting incoming network requests.

Methods inherited from class java.lang.Object

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

Field Details

WRITE_PORTS_FILE_SETTING

public static final Setting<Boolean> WRITE_PORTS_FILE_SETTING

NODE_NAME_SETTING

public static final Setting<String> NODE_NAME_SETTING

NODE_EXTERNAL_ID_SETTING

public static final Setting<String> NODE_EXTERNAL_ID_SETTING

NODE_ATTRIBUTES

public static final Setting.AffixSetting<String> NODE_ATTRIBUTES

BREAKER_TYPE_KEY

public static final Setting<String> BREAKER_TYPE_KEY

INITIAL_STATE_TIMEOUT_SETTING

public static final Setting<TimeValue> INITIAL_STATE_TIMEOUT_SETTING

Constructor Details

Node

public Node(Environment environment)

Constructs a node

Parameters:

environment - the initial environment for this node, which will be added to by plugins

Node

protected Node(Environment initialEnvironment,
 Function<Settings,PluginsService> pluginServiceCtor,
 boolean forbidPrivateIndexSettings)

Constructs a node

Parameters:

initialEnvironment - the initial environment for this node, which will be added to by plugins

pluginServiceCtor - a function that takes a Settings object and returns a PluginsService

forbidPrivateIndexSettings - whether or not private index settings are forbidden when creating an index; this is used in the test framework for tests that rely on being able to set private settings

Method Details

deleteTemporaryApmConfig

public static void deleteTemporaryApmConfig(JvmInfo jvmInfo,
 BiConsumer<Exception,Path> errorHandler)

If the JVM was started with the Elastic APM agent and a config file argument was specified, then delete the config file. The agent only reads it once, when supplied in this fashion, and it may contain a secret token.

Public for testing only

newTransportService

protected TransportService newTransportService(Settings settings,
 Transport transport,
 ThreadPool threadPool,
 TransportInterceptor interceptor,
 Function<BoundTransportAddress,DiscoveryNode> localNodeFactory,
 ClusterSettings clusterSettings,
 TaskManager taskManager,
 Tracer tracer)

processRecoverySettings

protected void processRecoverySettings(ClusterSettings clusterSettings,
 RecoverySettings recoverySettings)

settings

public Settings settings()

The settings that are used by this node. Contains original settings as well as additional settings provided by plugins.

client

public Client client()

A client that can be used to execute actions (operations) against the cluster.

getEnvironment

public Environment getEnvironment()

Returns the environment of the node

getNodeEnvironment

public NodeEnvironment getNodeEnvironment()

Returns the NodeEnvironment instance of this node

start

public Node start()
           throws NodeValidationException

Start the node. If the node is already started, this method is no-op.

Throws:

NodeValidationException

configureNodeAndClusterIdStateListener

protected void configureNodeAndClusterIdStateListener(ClusterService clusterService)

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

prepareForClose

public void prepareForClose()

Invokes hooks to prepare this node to be closed. This should be called when Elasticsearch receives a request to shut down gracefully from the underlying operating system, before system resources are closed. This method will block until the node is ready to shut down. Note that this class is part of infrastructure to react to signals from the operating system - most graceful shutdown logic should use Node Shutdown, see NodesShutdownMetadata.

awaitClose

public boolean awaitClose(long timeout,
 TimeUnit timeUnit)
                   throws InterruptedException

Wait for this node to be effectively closed.

Throws:

InterruptedException

isClosed

public boolean isClosed()

Returns true if the node is closed.

injector

public Injector injector()

validateNodeBeforeAcceptingRequests

protected void validateNodeBeforeAcceptingRequests(BootstrapContext context,
 BoundTransportAddress boundTransportAddress,
 List<BootstrapCheck> bootstrapChecks)
                                            throws NodeValidationException

Hook for validating the node after network services are started but before the cluster service is started and before the network service starts accepting incoming network requests.

Parameters:

context - the bootstrap context for this node

boundTransportAddress - the network addresses the node is bound and publishing to

Throws:

NodeValidationException

getPluginsService

protected PluginsService getPluginsService()

The PluginsService used to build this node's components.

newSearchService

protected SearchService newSearchService(ClusterService clusterService,
 IndicesService indicesService,
 ThreadPool threadPool,
 ScriptService scriptService,
 BigArrays bigArrays,
 FetchPhase fetchPhase,
 ResponseCollectorService responseCollectorService,
 CircuitBreakerService circuitBreakerService,
 ExecutorSelector executorSelector,
 Tracer tracer)

Creates a new the SearchService. This method can be overwritten by tests to inject mock implementations.

newScriptService

protected ScriptService newScriptService(Settings settings,
 Map<String,ScriptEngine> engines,
 Map<String,ScriptContext<?>> contexts,
 LongSupplier timeProvider)

Creates a new the ScriptService. This method can be overwritten by tests to inject mock implementations.

newClusterInfoService

protected ClusterInfoService newClusterInfoService(Settings settings,
 ClusterService clusterService,
 ThreadPool threadPool,
 NodeClient client)

Constructs a ClusterInfoService which may be mocked for tests.

newHttpTransport

protected HttpServerTransport newHttpTransport(NetworkModule networkModule)

Constructs a HttpServerTransport which may be mocked for tests.