Account Setup
This page covers making sure your AWS account is compatible with and correctly configured for Datomic Cloud. Once you have performed these steps, you can start any number of systems in regions that support Datomic.
Subscribe to Datomic
Follow these steps from the Datomic listing on AWS Marketplace:
- If the top right button says Continue to Configuration, you are already subscribed, and can skip the remaining steps. If the button says Continue to Subscribe, click it.
- On the next page, read the EULA and if you agree then click the Accept Terms button to subscribe.
- Wait until your subscription is confirmed with a message in the green status bar.
EC2 Key Pair
AWS Marketplace requires that you associate an EC2 key pair with EC2 instances launched by Datomic. This keypair is never used by Datomic itself, and by default SSH ingress is disabled. The key pair is available in case an operator wants to deliberately open SSH ingress and log into boxes.
If you do not already have an EC2 Key Pair, create one from the EC2 Key Pair console
- Click the Create Key Pair button.
- Enter a name for your new Key Pair. Take note of this name–You will need it when you start a system.
- Press the Create button.
- Save the downloaded certificate (.pem) file for later use.
From a terminal window run:
chmod 400 <path-to-your-pem-file>Replacing <path-to-your-pem-file> with the path to the .pem file you downloaded in step 4.
Verify Region is EC2-VPC Only
Datomic Cloud requires an AWS account that supports only EC2-VPC. All accounts created after Dec 4, 2013 support EC2-VPC. If you have an older account, EC2-VPC support can be verified using the AWS CLI or the AWS web GUI.
If your target regions are EC2-Classic only, then there are two options for using Datomic:
Create a new account. You can associate it with your existing account(s) using AWS Consolidated Billing for Organizations .
- To use consolidated billing, you must either have or
create an Organization . You may then either associate existing accounts with it or create a new one
- Migrate your account if it's possible to delete all EC2-Classic resources in that region.
CLI Verification Method
If you have the AWS cli installed and appropriate credentials, you can use the following command:
aws ec2 describe-account-attributes --attribute-names supported-platforms --region <region>
Where <region> is the region to check the supported platforms.
An account that's EC2-Classic only will return a response where the AttributeValue keys are "EC2" and "VPC".
An account that supports EC2-VPC will return only a "VPC" AttributeValue
GUI Verification Method
Ensure that the correct region is selected in the upper right hand corner of the AWS web GUI.
- Open the Amazon EC2 console
- Use the navigation bar in the upper right to choose the region in which you will run Datomic.
On the Amazon EC2 console dashboard, look for Supported Platforms under Account Attributes. If you see only "VPC", your region is EC2-VPC only, and you can run Datomic in this region.
If you see "EC2" listed under Supported Platforms (even if you also see "VPC"), then this region is EC2-Classic, and you cannot run Datomic in this region at this time.
If the region you checked is an EC2-Classic region, one of your other regions might still be an EC2-VPC only region, if you didn't use that region prior to Dec 4, 2013. Follow the above instructions to check in the other supported regions.
Supported Regions
Datomic Cloud currently runs in the following AWS regions:
- us-east-1
- us-east-2
- us-west-2
- ca-central-1
- eu-central-1
- ap-southeast-1
- ap-southeast-2
- ap-northeast-1
- ap-south-1
- sa-east-1
- eu-west-1
- eu-west-2
- eu-north-1
If you are unfamiliar with AWS region codes, you can review available AWS region codes here.
If you are interested in a region not shown here, please contact Datomic Support.