Setup
To create a Datomic Cloud system:
These tasks need only be performed once, by an AWS administrator.
If you want to try Datomic locally without incurring AWS expense, you can install dev-local first.
Create Master Stack
This section contains instructions for starting a master stack system with defaults suitable for quickly getting started with Datomic. If you are an experienced AWS user or are starting a production system, you should follow the more detailed and flexible split stack instructions.
Follow these steps from the Datomic listing on AWS Marketplace:
- Click Continue to Subscribe.
- Click the Continue to Configuration Button in the top right.
- Choose the most recent version and an AWS Region from the drop down menus.
- Click the Continue to Launch button.
- Select "Launch CloudFormation" from the the drop down menu and click the Launch button.
"Specify Template" Screen
- Under "Choose a Template", select the "Specify an Amazon S3 template URL" option. The URL field will be pre-populated for you.
- Click the Next button
"Specify Stack Details" Screen
The recommended parameter values for getting started are listed below. Note that you should make changes only to Stack Name and AWS EC2 Key Pair.
- Stack Name
- This will be your system name. Choose a name of up to 23 lowercase ASCII characters, numbers, and/or hyphens.
- Reuse existing storage
- Accept the default "false".
- Instance Type
- Accept the default "t3.small".
- AWS EC2 Key Pair
- AWS Marketplace requires that you specify a key pair. This can be any key pair you like and will not be used by Datomic itself.
- Application Name
- Leave this blank.
- Environment Map
- Accept the default "{:env :dev-or-prod}".
- Preload Database
- Leave this blank.
- Metrics Level
- Accept the default "Default"
- Auto Scaling Configuration
- API Gateways
- Client API
- Accept the default "yes".
- Ions
- Accept the default "yes".
- VPC
- VPC CIDR block
- Accept the default.
- First, Second, and Third CIDR Blocks.
- Accept the defaults.
- Existing IAM managed policy for instances
- Leave blank.
Click the Next button.
"Configure Stack options" Screen
- Leave the default settings
- Click the Next button.
"Review" Screen
- Under "Capabilities", click the checkbox stating "I acknowledge that AWS CloudFormation might create IAM resources with custom names." You may need to scroll down.
- Click the checkbox stating "I acknowledge that AWS CloudFormation might create IAM resources with custom names."
- Click the checkbox stating "I acknowledge that AWS CloudFormation might require the following capability:
CAPABILITY_AUTO_EXPAND
" - Click "Create" to launch the stack.
Wait for Stack
After you create a master stack, CloudFormation will create your
Datomic system. This can take up to 25 minutes. You can refresh the
CloudFormation dashboard to follow the stack's progress, which should
end with CREATE_COMPLETE
.
Next Steps
If you are trying Datomic for the first time, a good next step is the Client API Tutorial.