When heavy-duty indexing is performed in parallel by all cluster nodes, the cluster's
performance and availability may be reduced.
The extent of the reduction in cluster conduct depends upon its nodes' resources,
the scope of the required indexing, and the number of nodes concurrently indexing.
On Site, dedicating much of all nodes' resources to indexing rather than to processing
data and tasks may reduce the cluster's performance.
On the Cloud, parallel indexing may exhaust the credits available to multiple nodes
at the same time and degrade the cluster's availability.
Rolling index deployment ensures that indexes will be created and updated while
the cluster remains fully available and performant.
Parallel indexing may be a better option when there is minor or no database activity.
How Does It Work
The Rolling Procedure
Nodes are assigned with the indexing of each database in a linear order, one node at a time.
The cluster assigns indexing to one of its nodes.
When the assigned node finishes indexing, it sends a cluster-wide confirmation command
that indexing is done.
The cluster assigns indexing to the next node.
If the delivery of an indexing completion confirmation fails when the current node
finishes indexing, no other node will be able to start indexing until the confirmation
succeeds or indexing is initiated manually.
Confirmation delivery may fail, for example, due to forceful disconnection of the indexing
node or cluster leader node during indexation.
Deployment Concurrency and Order
A node is assigned to index a database, only if no other node currently indexes this database.
Multiple nodes can be assigned to concurrently index different databases.
E.g., node A can index the "Integration" database, while node B indexes the "Production" database.
Deployment order is determined by the cluster.
Indexing is deployed in the reverse order of nodes membership in the database group.
Nodes that are currently in Rehab or Promotable state
are given a lower priority.
Setting Indexing Deployment Mode
Server-Wide Deployment Mode
Deployment mode can be set server-wide using configuration options.
Setting the server-wide configuration option will apply to all databases on a given node.
Auto Indexes Deployment Mode
Set a deployment mode for indexes created automatically using the Indexing.Auto.DeploymentMode configuration option. "Indexing.Auto.DeploymentMode": "Rolling" "Indexing.Auto.DeploymentMode": "Parallel"
Static Indexes Deployment Mode
Set a deployment mode for static indexes using the Indexing.Static.DeploymentMode configuration option. "Indexing.Static.DeploymentMode": "Rolling" "Indexing.Static.DeploymentMode": "Parallel"
Database Deployment Mode
Enable or disable rolling for a specific database using database configuration keys.
Setting these properties overrides the
Database Configuration Keys
Open Settings > Database Settings view.
Filter Keys - Enter a search string to locate the configuration keys.
Edit - Click to edit values (see next image for details).
Configuration Keys - Indexing.Auto.DeploymentMode - Deployment mode configuration key for Auto Indexes. Indexing.Static.DeploymentMode - Deployment mode configuration key for Static Indexes.
Effective Value - The current configuration.
Origin - The origin of the current configuration.
Can be - Default | Database
Override - Toggle to override the server-wide configuation.
Edit Value - Select Parallel or Rolling indexing deployment mode.
Set Default - Click 'Set Default' to select the server-wide default value.
Save - Apply changes.
An edited configuration key value will become effective only after the database is reloaded.
Deployment Mode in an Index Definition
Enable or disable rolling for a specific index using the index-definition DeploymentMode property.
Setting this property overrides server-wide
and database settings configuration.
DeploymentMode = IndexDeploymentMode.Rolling
DeploymentMode = IndexDeploymentMode.Parallel
The deployment mode can be set for a specific index when, for example, parallel indexing
is preferred in general but rolling is a better option for a particularly "weighty" index.
private class MyRollingIndex : AbstractIndexCreationTask<Order>
Map = orders => from order in orders
DeploymentMode = IndexDeploymentMode.Rolling;