New System Creation

• Head over to the CloudFormation console page at AWS.
• Click "Create Stack"

The template to be used depends on your needs, but it is highly recommended to use the most current version.

• Go to the Release History.
• Click the file icon of the Storage version you'd like.
  • This copies the template URL to your clipboard in most modern browsers.
• Return to the AWS "Select Template" screen and paste the template URL under Specify an Amazon S3 Template URL.
• Click "Next"

Fill in the template's parameter values as specified below.

Note: Stack Name and Application Name cannot be changed later. See planning your system for guidance.

Stack Name

Choose a name for your system. Use only lowercase letters, numbers, and hyphens. ASCII characters only. Your system name gets concatenated in various contexts and so should be kept short, e.g. fewer than 24 characters.

• Remember this Stack Name for later use.

Reuse existing storage

Set this to "False".

This CloudFormation Template creates a VPC in which to run Datomic Cloud. Configure the settings for the VPC in the VPC Configuration section. See the AWS VPC Guide for details on specifying the CIDR blocks. Unless you know you need to change the CIDR block settings, you should accept the default configuration.

VPC CIDR block

The CIDR block to assign to the VPC. Accept the defaults.

First, Second, and Third CIDR Blocks.

Datomic will configure three subnets in the VPC. These three CIDR Blocks must be subsets of the VPC CIDR Block, and they must not overlap with each other. Accept the defaults.

Click the Next button.

• "Options" Screen
  
  1. Leave the default settings
  2. Click the Next button.

• "Review" Screen
  
  1. Under "Capabilities", click the checkbox stating "I acknowledge that AWS CloudFormation might create IAM resources with custom names." You may need to scroll down.
  2. Click the checkbox stating "I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND"
  3. Click "Create" to launch the stack.

• Verify System
  

  Your Datomic system will have a Cloudwatch dashboard named datomic-$(System)-$(Region). Open the CloudWatch dashboards and refresh the window until your dashboard appears. This can take several minutes.

  If your dashboard does not appear after 25 minutes, check for a possible CloudFormation failure.

  Once your dashboard is visible, click on it and find the "Alerts, Events" widget. If this shows zero Alerts and nonzero Events, your system is ready to go.

  In the event of failure, check the troubleshooting page.

The template to be used depends on your needs, but it is highly recommended to use the most current version.

• Go to the Release History.
• Click the file icon of either "Solo" or "Production", depending on what your needs are.
  • This copies the template URL to your clipboard in most modern browsers.
• Return to the AWS "Select Template" screen and paste the template URL under Specify an Amazon S3 Template URL.
• Click "Next"

Fill in the template's parameter values as specified below.

Stack Name

Choose a name for your system. Use only lowercase letters, numbers, and hyphens. ASCII characters only. Your system name gets concatenated in various contexts and so should be kept short, e.g. fewer than 24 characters.

• This must be different from the storage stack name.

System Name

The "System Name" is the same as the Storage Stack "Stack Name" that was created earlier.

Start Basion?

Set this to "Yes" so that the template will start a bastion for developer internet access. You will need to authorize access to the bastion instance in a later step.

AWS EC2 Key Pair

The key pair to assign to compute nodes. Select a key pair for ssh access to nodes and the bastion host.

Application Name

Leave this blank to create an application with the same name as the system.

Environment Map

Ion environment map. Set to {:env :dev} for now.

Preload Database

All compute group instances will load this database when they start.

Existing IAM managed policy for instance

Utilize an existing IAM managed policy for this compute instance.

• "Options" Screen
  
  1. Leave the default settings
  2. Click the Next button.

• "Review" Screen
  

  Review your settings to make sure that they are correct. "Enable Bastion" and "KeyName" are of particular importance.

  1. Under "Capabilities", click the checkbox stating "I acknowledge that AWS CloudFormation might create IAM resources with custom names." You may need to scroll down.
  2. Click the checkbox stating "I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND"
  3. Click "Create" to launch the stack.

• Verify System
  

  Your Datomic system will have a Cloudwatch dashboard named datomic-$(System)-$(Region). Open the CloudWatch dashboards and refresh the window until your dashboard appears. This can take several minutes.

  If your dashboard does not appear after 25 minutes, check for a possible CloudFormation failure.

  Once your dashboard is visible, click on it and find the "Alerts, Events" widget. If this shows zero Alerts and nonzero Events, your system is ready to go.

  In the event of failure, check the troubleshooting page.

• Bastion
  

  In order to access the Compute Stack from a remote location, you will need to setup Bastion and authorize a group if necessary.