Compute Templates

To create a new compute group, choose "Create stack (with new resources)" in CloudFormation. Then in the "Prepare template" section, choose "Template is ready" and proceed to specify template.

You can update a template to do one or both of the following:

• upgrade to a newer version of Datomic
• modify template parameters

To update a compute group template, select an existing compute group stack in CloudFormation. Then chooose "Update Stack".

• If you are upgrading Datomic, choose "Replace current template" and proceed to specify template below.
• If you are only modifying template parameters, choose "Use current template" and proceed to parameters below.

Deleting a compute group deletes all that group's resources: EC2 instances, Application Load Balancer, and API Gateways. It does not delete your Datomic system or any data, and you can recreate the compute group again later. To delete a Datomic compute group:

1. Find your compute group stack in CloudFormation.
2. Right-click on your query group stack and select "Delete Stack".

You will use the compute stack name to distinguish your compute group from other groups on the same system and from compute groups for other systems. A good choice is "$(System)-(Role)", where $(System) is your system name, and $(Role) is the role this group serves, e.g. "primary compute", an application name, or a particular task or load profile. For example, the "inventory" system might have "inventory-primary" for its primary compute group, and "inventory-analytics" for a query group serving analytics.

Datomic configuration is managed via CloudFormation parameters, minimizing the surface area of AWS you must engage to run a system. As your needs grow, you may revisit and adjust the parameters that control the amount of compute resources, i.e. Instance Type and the Auto Scaling Configuration. Most other parameters are likely to be set once when starting a compute group and never revisited again. That said, except where explicitly noted, you can change any of these parameters by performing a rolling stack update.

Each parameter is summarized in the table below and then described in detail. Compute stack parameters are named by a Label in the CloudFormation UI, and under the Parameters key in CloudFormation JSON.

Instance Type

Type of EC2 instance for compute nodes. See Instance Sizes.

AWS EC2 Key Pair

Key pair for ssh access to nodes.

Application Name

Ion CodeDeploy application name. This name cannot be changed later.

Environment Map

Ion environment map.

Preload Database

All compute group instances will load this database when they start, before accepting requests.

Metrics Level

Level of metrics detail. "default" sets metric level based on instance size, and should be suitable for most users.

Auto Scaling Configuration

Each of the Auto Scaling configuration settings allows you to set a specific number, or "Default" to choose a default based on your instance size.

Desired capacity

AWS Auto Scaling desired capacity or "Default"

Minimum group instances

AWS Auto Scaling minimum size or "Default".

Maximum group instances

AWS Auto Scaling maximum size or "Default".

Minimum number of instances during update

Number of instances that must be in service within the AWS while AWS CloudFormation updates instances, should be at least 1 less than maximum. A number or "Default".

Client API

Manage an AWS API gateway for Datomic Client API access. Most users should choose "yes". (If "no", you will have to configure VPC access for clients.)

Ions

Manage an AWS API Gateway for ion web applications. Most users should choose "yes". (If "no", HTTP direct ions will be inaccessible.)

Existing IAM managed policy for instances

(Optional) Name of a IAM managed policy to assign to instance nodes.

Support Configuration

Leave blank unless directed by Datomic Support.