org.apache.cassandra.locator

Class Ec2Snitch

java.lang.Object

org.apache.cassandra.locator.AbstractEndpointSnitch

org.apache.cassandra.locator.AbstractNetworkTopologySnitch

org.apache.cassandra.locator.Ec2Snitch

All Implemented Interfaces:

IEndpointSnitch

Direct Known Subclasses:

Ec2MultiRegionSnitch

public class Ec2Snitch
extends AbstractNetworkTopologySnitch

A snitch that assumes an EC2 region is a DC and an EC2 availability_zone is a rack. This information is available in the config for the node. Since CASSANDRA-16555, it is possible to choose version of AWS IMDS. By default, since CASSANDRA-16555, IMDSv2 is used. The version of IMDS is driven by property Ec2MetadataServiceConnector.EC2_METADATA_TYPE_PROPERTY and can be of value either 'v1' or 'v2'. It is possible to specify custom URL of IMDS by Ec2MetadataServiceConnector.EC2_METADATA_URL_PROPERTY. A user is not meant to change this under normal circumstances, it is suitable for testing only. IMDSv2 is secured by a token which needs to be fetched from IDMSv2 first, and it has to be passed in a header for the actual queries to IDMSv2. Ec2Snitch is doing this automatically. The only configuration parameter exposed to a user is Ec2MetadataServiceConnector.V2Connector.AWS_EC2_METADATA_TOKEN_TTL_SECONDS_HEADER_PROPERTY which is by default set to Ec2MetadataServiceConnector.V2Connector.MAX_TOKEN_TIME_IN_SECONDS. TTL has to be an integer from the range [30, 21600].

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.cassandra.locator.Ec2MetadataServiceConnector	connector
protected java.lang.String	ec2region
protected java.lang.String	ec2zone
protected static org.slf4j.Logger	logger
static java.lang.String	ZONE_NAME_QUERY

Constructor Summary

Constructors

Constructor and Description
Ec2Snitch()
Ec2Snitch(SnitchProperties props)
Ec2Snitch(SnitchProperties props, org.apache.cassandra.locator.Ec2MetadataServiceConnector connector)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDatacenter(java.net.InetAddress endpoint) Return the data center for which an endpoint resides in
java.lang.String	getRack(java.net.InetAddress endpoint) Return the rack for which an endpoint resides in

Methods inherited from class org.apache.cassandra.locator.AbstractNetworkTopologySnitch

compareEndpoints

Methods inherited from class org.apache.cassandra.locator.AbstractEndpointSnitch

getSortedListByProximity, gossiperStarting, isWorthMergingForRangeQuery, sortByProximity

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final org.slf4j.Logger logger

ZONE_NAME_QUERY

public static final java.lang.String ZONE_NAME_QUERY

See Also:

Constant Field Values

ec2zone

protected java.lang.String ec2zone

ec2region

protected java.lang.String ec2region

connector

protected final org.apache.cassandra.locator.Ec2MetadataServiceConnector connector

Constructor Detail

Ec2Snitch

public Ec2Snitch()
          throws java.io.IOException,
                 ConfigurationException

Throws:

java.io.IOException

ConfigurationException

Ec2Snitch

public Ec2Snitch(SnitchProperties props)
          throws java.io.IOException,
                 ConfigurationException

Throws:

java.io.IOException

ConfigurationException

Ec2Snitch

public Ec2Snitch(SnitchProperties props,
                 org.apache.cassandra.locator.Ec2MetadataServiceConnector connector)
          throws java.io.IOException

Throws:

java.io.IOException

Method Detail

getRack

public java.lang.String getRack(java.net.InetAddress endpoint)

Description copied from class: AbstractNetworkTopologySnitch

Return the rack for which an endpoint resides in

Specified by:

getRack in interface IEndpointSnitch

Specified by:

getRack in class AbstractNetworkTopologySnitch

Parameters:

endpoint - a specified endpoint

Returns:

string of rack

getDatacenter

public java.lang.String getDatacenter(java.net.InetAddress endpoint)

Description copied from class: AbstractNetworkTopologySnitch

Return the data center for which an endpoint resides in

Specified by:

getDatacenter in interface IEndpointSnitch

Specified by:

getDatacenter in class AbstractNetworkTopologySnitch

Parameters:

endpoint - a specified endpoint

Returns:

string of data center