Package org.elasticsearch.persistent
Class PersistentTasksClusterService
- java.lang.Object
-
- org.elasticsearch.persistent.PersistentTasksClusterService
-
- All Implemented Interfaces:
java.io.Closeable
,java.lang.AutoCloseable
,ClusterStateListener
public class PersistentTasksClusterService extends java.lang.Object implements ClusterStateListener, java.io.Closeable
Component that runs only on the master node and is responsible for assigning running tasks to nodes
-
-
Field Summary
Fields Modifier and Type Field Description static Setting<TimeValue>
CLUSTER_TASKS_ALLOCATION_RECHECK_INTERVAL_SETTING
-
Constructor Summary
Constructors Constructor Description PersistentTasksClusterService(Settings settings, PersistentTasksExecutorRegistry registry, ClusterService clusterService, ThreadPool threadPool)
-
Method Summary
Modifier and Type Method Description void
close()
void
clusterChanged(ClusterChangedEvent event)
Called when cluster state changes.void
completePersistentTask(java.lang.String id, long allocationId, java.lang.Exception failure, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Restarts a record about a running persistent task from cluster state<Params extends PersistentTaskParams>
voidcreatePersistentTask(java.lang.String taskId, java.lang.String taskName, Params taskParams, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Creates a new persistent task on master nodestatic boolean
needsReassignment(PersistentTasksCustomMetaData.Assignment assignment, DiscoveryNodes nodes)
Returns true if the task is not assigned or is assigned to a non-existing nodevoid
removePersistentTask(java.lang.String id, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Removes the persistent taskvoid
setRecheckInterval(TimeValue recheckInterval)
void
unassignPersistentTask(java.lang.String taskId, long taskAllocationId, java.lang.String reason, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
This unassigns a task from any node, i.e.void
updatePersistentTaskState(java.lang.String taskId, long taskAllocationId, PersistentTaskState taskState, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Update the state of a persistent task
-
-
-
Constructor Detail
-
PersistentTasksClusterService
public PersistentTasksClusterService(Settings settings, PersistentTasksExecutorRegistry registry, ClusterService clusterService, ThreadPool threadPool)
-
-
Method Detail
-
setRecheckInterval
public void setRecheckInterval(TimeValue recheckInterval)
-
close
public void close()
- Specified by:
close
in interfacejava.lang.AutoCloseable
- Specified by:
close
in interfacejava.io.Closeable
-
createPersistentTask
public <Params extends PersistentTaskParams> void createPersistentTask(java.lang.String taskId, java.lang.String taskName, Params taskParams, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Creates a new persistent task on master node- Parameters:
taskId
- the task's idtaskName
- the task's nametaskParams
- the task's parameterslistener
- the listener that will be called when task is started
-
completePersistentTask
public void completePersistentTask(java.lang.String id, long allocationId, java.lang.Exception failure, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Restarts a record about a running persistent task from cluster state- Parameters:
id
- the id of the persistent taskallocationId
- the allocation id of the persistent taskfailure
- the reason for restarting the task or null if the task completed successfullylistener
- the listener that will be called when task is removed
-
removePersistentTask
public void removePersistentTask(java.lang.String id, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Removes the persistent task- Parameters:
id
- the id of a persistent tasklistener
- the listener that will be called when task is removed
-
updatePersistentTaskState
public void updatePersistentTaskState(java.lang.String taskId, long taskAllocationId, PersistentTaskState taskState, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
Update the state of a persistent task- Parameters:
taskId
- the id of a persistent tasktaskAllocationId
- the expected allocation id of the persistent tasktaskState
- new statelistener
- the listener that will be called when task is removed
-
unassignPersistentTask
public void unassignPersistentTask(java.lang.String taskId, long taskAllocationId, java.lang.String reason, ActionListener<PersistentTasksCustomMetaData.PersistentTask<?>> listener)
This unassigns a task from any node, i.e. it is assigned to anull
node with the provided reason. Since the assignment executor node is null, thePersistentTasksClusterService
will attempt to reassign it to a valid node quickly.- Parameters:
taskId
- the id of a persistent tasktaskAllocationId
- the expected allocation id of the persistent taskreason
- the reason for unassigning the task from any nodelistener
- the listener that will be called when task is unassigned
-
clusterChanged
public void clusterChanged(ClusterChangedEvent event)
Description copied from interface:ClusterStateListener
Called when cluster state changes.- Specified by:
clusterChanged
in interfaceClusterStateListener
-
needsReassignment
public static boolean needsReassignment(PersistentTasksCustomMetaData.Assignment assignment, DiscoveryNodes nodes)
Returns true if the task is not assigned or is assigned to a non-existing node
-
-