Package org.apache.solr.cluster.placement

package org.apache.solr.cluster.placement

This package contains interfaces visible by plugins (i.e. contributed code) implementing cluster elasticity, placement and scalability, as well as a few examples on how plugins can be implemented.

Initially, only placement related plugins are supported.

The entry point is the PlacementPluginFactory building instances of the PlacementPlugin interface where the placement computation is implemented.

From there, one will access the interfaces that allow navigating the cluster topology, see org.apache.solr.cluster.

Plugin code:

• Gets work to be done by receiving a PlacementRequest,
• Can obtain more info using AttributeFetcher and building an AttributeValues
• Uses the values from AttributeValues as well as cluster state and SolrCollection.getCustomProperty(java.lang.String) and other data to compute placement,
• Placement decisions are returned to Solr using an instance of PlacementPlan built using the PlacementPlanFactory

Related Packages

Package	Description
org.apache.solr.cluster	This package contains the interfaces giving access to cluster state, including nodes, collections and the structure of the collections (shards and replicas).
org.apache.solr.cluster.placement.impl	Implementation classes (not visible to plugins, subject to change at any time) for the interfaces in org.apache.solr.cluster.placement and to make them work with the rest of Solr.
org.apache.solr.cluster.placement.plugins	Sample plugin implementations.
org.apache.solr.cluster.events	Interfaces defining support for cluster-level event generation and processing.
org.apache.solr.cluster.maintenance	Cluster Singleton plugins that are used to perform maintenance tasks within the cluster.

Class	Description
AttributeFetcher	Instances of this interface are used to fetch various attributes from nodes (and other sources) in the cluster.
AttributeValues
BalancePlan	A fully specified plan or instructions for replica balancing to be applied to the cluster.
BalancePlanFactory	Allows plugins to create BalancePlans telling the Solr layer how to balance replicas following the processing of a BalanceRequest.
BalanceRequest	A cluster related placement request that Solr asks a PlacementPlugin to resolve and compute replica balancing plan for replicas that already exist across a set of Nodes.
CollectionMetrics	Collection-level metrics.
DeleteCollectionRequest	Delete collection request.
DeleteReplicasRequest	Delete replicas request.
DeleteShardsRequest	Delete shards request.
Metric<T>	Metric-related attribute of a node or replica.
ModificationRequest	Collection modification request.
NodeMetric<T>	Node metric identifier, corresponding to a node-level metric name with optional labels for metric
PlacementContext	Placement context makes it easier to pass around and access main placement-related components.
PlacementException	Exception thrown by a PlacementPlugin when it is unable to compute placement for whatever reason (except an InterruptedException that PlacementPlugin.computePlacement(org.apache.solr.cluster.placement.PlacementRequest, org.apache.solr.cluster.placement.PlacementContext) is also allowed to throw).
PlacementModificationException	Exception thrown when a placement modification is rejected by the placement plugin.
PlacementPlan	A fully specified plan or instructions for placement, deletion or move to be applied to the cluster.
PlacementPlanFactory	Allows plugins to create PlacementPlans telling the Solr layer where to create replicas following the processing of a PlacementRequest.
PlacementPlugin	Implemented by external plugins to control replica placement and movement on the search cluster (as well as other things such as cluster elasticity?) when cluster changes are required (initiated elsewhere, most likely following a Collection API call).
PlacementPluginConfig	Configuration beans should use this interface to define public (mutable) configuration properties.
PlacementPluginFactory<T extends PlacementPluginConfig>	Factory implemented by client code and configured in container plugins (see ContainerPluginsApi.editAPI) allowing the creation of instances of PlacementPlugin to be used for replica placement computation.
PlacementPluginFactory.NoConfig	Useful type for plugins that don't use any configuration.
PlacementRequest	A cluster related placement request that Solr asks a PlacementPlugin plugin to resolve and compute a PlacementPlan placing one or more Replica's of one or more Shard's of an existing SolrCollection.
ReplicaMetric<T>	Replica metric identifier, corresponding to one of the internal replica-level metric names (as reported in solr.core.[collection].[replica] registry)
ReplicaMetrics	Strongly-typed replica-level metrics.
ReplicaPlacement	Placement decision for a single Replica.
ShardMetrics	Shard-level metrics.