Class AwarenessAllocationDecider


  • public class AwarenessAllocationDecider
    extends AllocationDecider
    This AllocationDecider controls shard allocation based on awareness key-value pairs defined in the node configuration. Awareness explicitly controls where replicas should be allocated based on attributes like node or physical rack locations. Awareness attributes accept arbitrary configuration keys like a rack data-center identifier. For example the setting:
     cluster.routing.allocation.awareness.attributes: rack_id
     

    will cause allocations to be distributed over different racks such that ideally at least one replicas of the all shard is available on the same rack. To enable allocation awareness in this example nodes should contain a value for the rack_id key like:

     node.attr.rack_id:1
     

    Awareness can also be used to prevent over-allocation in the case of node or even "zone" failure. For example in cloud-computing infrastructures like Amazon AWS a cluster might span over multiple "zones". Awareness can be used to distribute replicas to individual zones by setting:

     cluster.routing.allocation.awareness.attributes: zone
     

    and forcing allocation to be aware of the following zone the data resides in:

     cluster.routing.allocation.awareness.force.zone.values: zone1,zone2
     

    In contrast to regular awareness this setting will prevent over-allocation on zone1 even if zone2 fails partially or becomes entirely unavailable. Nodes that belong to a certain zone / group should be started with the zone id configured on the node-level settings like:

     node.zone: zone1