com.hazelcast.config

Class AwsConfig

java.lang.Object

com.hazelcast.config.AwsConfig

Direct Known Subclasses:

ClientAwsConfig

public class AwsConfig
extends Object

The AWSConfig contains the configuration for AWS join mechanism.

what happens behind the scenes is that data about the running AWS instances in a specific region are downloaded using the accesskey/secretkey and are potential Hazelcast members.

Filtering

There are 2 mechanisms for filtering out AWS instances and these mechanisms can be combined (AND).

1. If a securityGroup is configured, only instances within that security group are selected.
2. If a tag key/value is set, only instances with that tag key/value will be selected.

Once Hazelcast has figured out which instances are available, it will use the private IP addresses of these instances to create a TCP/IP-cluster.

Constructor Summary

Constructors

Constructor and Description
AwsConfig()

Method Summary

Modifier and Type	Method and Description
String	getAccessKey() Gets the access key to access AWS.
int	getConnectionTimeoutSeconds() Gets the connection timeout in seconds.
String	getHostHeader() Gets the host header; the address where the EC2 API can be found.
String	getIamRole() Gets the iamRole name
String	getRegion() Gets the region where the EC2 instances running the Hazelcast members will be running.
String	getSecretKey() Gets the secret key to access AWS.
String	getSecurityGroupName() Gets the security group name.
String	getTagKey() Gets the tag key.
String	getTagValue() Gets the tag value.
boolean	isEnabled() Checks if the AWS join mechanism is enabled.
AwsConfig	setAccessKey(String accessKey) Sets the access key to access AWS.
AwsConfig	setConnectionTimeoutSeconds(int connectionTimeoutSeconds) Sets the connect timeout in seconds.
AwsConfig	setEnabled(boolean enabled) Enables or disables the AWS join mechanism.
AwsConfig	setHostHeader(String hostHeader) Sets the host header; the address where the EC2 API can be found.
AwsConfig	setIamRole(String iamRole) Sets the tag value.
AwsConfig	setRegion(String region) Sets the region where the EC2 instances running the Hazelcast members will be running.
AwsConfig	setSecretKey(String secretKey) Sets the secret key to access AWS.
AwsConfig	setSecurityGroupName(String securityGroupName) Sets the security group name.
AwsConfig	setTagKey(String tagKey) Sets the tag key.
AwsConfig	setTagValue(String tagValue) Sets the tag value.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AwsConfig

public AwsConfig()

Method Detail

getAccessKey

public String getAccessKey()

Gets the access key to access AWS. Returns null if no access key is configured.

Returns:

the access key to access AWS

See Also:

setAccessKey(String)

setAccessKey

public AwsConfig setAccessKey(String accessKey)

Sets the access key to access AWS.

Parameters:

accessKey - the access key to access AWS

Returns:

the updated AwsConfig

Throws:

IllegalArgumentException - if accessKey is null or empty

See Also:

getAccessKey(), setSecretKey(String)

getSecretKey

public String getSecretKey()

Gets the secret key to access AWS. Returns null if no access key is configured.

Returns:

the secret key

See Also:

setSecretKey(String)

setSecretKey

public AwsConfig setSecretKey(String secretKey)

Sets the secret key to access AWS.

Parameters:

secretKey - the secret key to access AWS

Returns:

the updated AwsConfig

Throws:

IllegalArgumentException - if secretKey is null or empty

See Also:

getSecretKey(), setAccessKey(String)

getRegion

public String getRegion()

Gets the region where the EC2 instances running the Hazelcast members will be running.

Returns:

the region where the EC2 instances running the Hazelcast members will be running

See Also:

setRegion(String)

setRegion

public AwsConfig setRegion(String region)

Sets the region where the EC2 instances running the Hazelcast members will be running.

Parameters:

region - the region where the EC2 instances running the Hazelcast members will be running

Returns:

the updated AwsConfig

Throws:

IllegalArgumentException - if region is null or empty

getHostHeader

public String getHostHeader()

Gets the host header; the address where the EC2 API can be found.

Returns:

the host header; the address where the EC2 API can be found

setHostHeader

public AwsConfig setHostHeader(String hostHeader)

Sets the host header; the address where the EC2 API can be found.

Parameters:

hostHeader - the new host header; the address where the EC2 API can be found

Returns:

the updated AwsConfig

Throws:

IllegalArgumentException - if hostHeader is null or an empty string

setEnabled

public AwsConfig setEnabled(boolean enabled)

Enables or disables the AWS join mechanism.

Parameters:

enabled - true if enabled, false otherwise

Returns:

the updated AwsConfig

isEnabled

public boolean isEnabled()

Checks if the AWS join mechanism is enabled.

Returns:

true if enabled, false otherwise

setSecurityGroupName

public AwsConfig setSecurityGroupName(String securityGroupName)

Sets the security group name. See the filtering section above for more information.

Parameters:

securityGroupName - the security group name

Returns:

the updated AwsConfig

See Also:

getSecurityGroupName()

getSecurityGroupName

public String getSecurityGroupName()

Gets the security group name. If nothing has been configured, null is returned.

Returns:

the security group name; null if nothing has been configured

setTagKey

public AwsConfig setTagKey(String tagKey)

Sets the tag key. See the filtering section above for more information.

Parameters:

tagKey - the tag key (see the filtering section above for more information)

Returns:

the updated AwsConfig

See Also:

setTagKey(String)

setTagValue

public AwsConfig setTagValue(String tagValue)

Sets the tag value. See the filtering section above for more information.

Parameters:

tagValue - the tag value (see the filtering section above for more information)

Returns:

the updated AwsConfig

See Also:

setTagKey(String), getTagValue()

getTagKey

public String getTagKey()

Gets the tag key. If nothing is specified, null is returned.

Returns:

the tag key or null if nothing is returned

getTagValue

public String getTagValue()

Gets the tag value. If nothing is specified, null is returned.

Returns:

the tag value or null if nothing is returned

getConnectionTimeoutSeconds

public int getConnectionTimeoutSeconds()

Gets the connection timeout in seconds.

Returns:

the connectionTimeoutSeconds; connection timeout in seconds

See Also:

setConnectionTimeoutSeconds(int)

setConnectionTimeoutSeconds

public AwsConfig setConnectionTimeoutSeconds(int connectionTimeoutSeconds)

Sets the connect timeout in seconds. See TcpIpConfig.setConnectionTimeoutSeconds(int) for more information.

Parameters:

connectionTimeoutSeconds - the connectionTimeoutSeconds (connection timeout in seconds) to set

Returns:

the updated AwsConfig

See Also:

getConnectionTimeoutSeconds(), TcpIpConfig.setConnectionTimeoutSeconds(int)

getIamRole

public String getIamRole()

Gets the iamRole name

Returns:

the iamRole or null if nothing is returned

See Also:

(int)

setIamRole

public AwsConfig setIamRole(String iamRole)

Sets the tag value. See the filtering section above for more information.

Parameters:

iamRole - the IAM Role name

Returns:

the updated AwsConfig

See Also:

getIamRole()

toString

public String toString()

Overrides:

toString in class Object