Account Setup
This page covers making sure your AWS account is compatible with and correctly configured for Datomic Cloud:
- Subscribe to Datomic
- EC2 Key Pair
- Verify region is EC2-VPC Only
- Raise the i3.large Instance Limit
- Supported Regions
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 up to 30 minutes until your subscription is confirmed with a message in the green status bar:
EC2 Key Pair
You need an EC2 Key Pair to associate with EC2 instances launched by Datomic Cloud. This keypair is never used as part of normal operation, but is available in case an operator wants to e.g. 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. This includes all accounts created after Dec 4, 2013. If you have an older account, verify that you have an EC2-VPC only region, follow these instructions in one of the supported regions.
- 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.
If you don't have any EC2-VPC only regions, you must create a new account to run Datomic Cloud at this time. 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
Raise the i3.large Instance Limit
The Production Topology requires two or more i3.large EC2 instances. Some AWS accounts have a default limit equivalent to one i3.large instance. To check your account instance limit
- click on
Limits in the EC2 Dashboard Menu:
- Scroll down to find the
Running On-Demand All...
which includesi
instances in the instance list. - Open the
- Add a number of i3.large instance types that is 2+ and corresponds to how high you plan to scale your system.
- Ensure that your
Current limit
is greater than thevCPUs needed
. Ignore the "New limit" value, as this is assumes that you are currently at your vCPU limit.- If your
Current limit
exceeds the number ofvCPUs needed
then click theRequest on-deman limit increase
link under "Options". - Request the number of vCPUs that match your planned system needs.
- If your
Once complete, submit the form and you will receive confirmation from AWS once your instance limit has been raised.
Supported Regions
Datomic Cloud currently runs in the following AWS regions:
- us-east-1
- us-east-2
- us-west-2
- eu-central-1
- ap-southeast-1
- ap-southeast-2
- 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.