Login

AWS Marketplace Deployment Guide

The article documents the fastest, easiest methodology for installing GRAX from the AWS Marketplace.

If you have any questions, please reach out to Support.

AWS Account Identification / Creation

GRAX runs inside an account controlled and owned by your business. As such, identifying/creating the account is the first step. You'll need high-level or administrator access to the chosen account throughout the process of installing GRAX. We recommend that this account be separated from the rest of your AWS network simply to provide your team with a clear demarcation between GRAX resources and other parts of your infrastructure. It can also simplify access and auditing conversations.

Marketplace

You can purchase GRAX through the AWS Marketplace.

There are various options to choose from that can fit your needs.

Unit NameDescription
GRAX 30-Day TrialGRAX Runtime for 30 Days - Including Backup & Restore, GRAX Time Machine, Archive & Lifecycle Management, Sandbox Seeding, and History Stream
GRAX LiteGRAX Runtime for Production Data - Free Salesforce backup with Auto Backup (hourly RPO) and single record restore.
GRAX ProGRAX Runtime for Production Data - Including Auto Backup (hourly RPO), single record restore, and GRAX Recovery (hierarchy restore). Standard 9x5 email support only. Up to 2500 users.
GRAX EnterpriseGRAX Runtime for Production Data - Including Hourly Auto Backup, single record restore, GRAX Recovery, Time Machine, 1 Partial & 1 Full copy sandbox. Standard 9x5 email and phone support.

📘

Legacy Versions?

There might be "Legacy" versions available on the Marketplace listing that isn't mentioned above. We highly recommend against new purchases of "Legacy" versions.

Once you've purchased the version that works for you, move on to the next section.

Cloudformation

Now that you've secured a license and been sent into the Cloudformation interface, it's time to actually provision some infrastructure. We'll go one parameter at a time down the list and provide examples for when each parameter is needed.

The single most important step here is ensuring you're logged into the correct AWS account. Clicking the install/deploy links assumes the account that you were last using. This may not be correct for your use-case. Double check your account before proceeding.

Stack Details

Stack Name

The name for this stack in AWS. A stack name can include letters (A-Z and a-z), numbers (0-9), and dashes (-).

Parameters

The parameters provide a few options to configure a GRAX environment.

Registration Key (Required)

A registration key is required for installation for proper functionality. A registration key can be acquired signing up for the GRAX Platform.

When creating a new deployment, select the "AWS Marketplace" and click "Create Registration Key." You can refer to the newly created deployment to copy the registration key.

EC2 Instance Type (Required)

An EC2 instance type indicates what kind of compute resources your GRAX environment will use. The default option will suffice for standard setups but you can scale it up or down depending on your needs.

You can choose from one of the following:

  • 2 vCPU 8 GiB RAM (m6a.large)
  • 4 vCPU 16 GiB RAM (m6a.xlarge)
  • 16 vCPU 64 GiB RAM (m6a.4xlarge)
Administrator Password (Optional)

The administrator password is used to log into the GRAX web app. It's optional, and we recommend leaving blank. Only set it if SSO is not possible or to grant access to GRAX support. One method to generating a secure random value is to run the following command in a Linux terminal:

openssl rand -base64 48 | tr "+/" "-_" | tr -d =
Database Instance Type (Required)

The Database instance type indicates what kind of database resources your GRAX environment will use. The default option will suffice for standard setups but you can scale it up or down depending on your needs.

You can choose from one of the following:

  • 2 vCPU 8 GiB RAM (db.r6g.large)
  • 4 vCPU 16 GiB RAM (r6g.xlarge)
  • 16 vCPU 64 GiB RAM (db.r6g.4xlarge)
Database Password (Required)

The database password is used as the admin password to access the database. Generate a secure random value as desired. A length of at least 30 characters is recommended. One method to generating a secure random value is to run the following command in a Linux terminal:

openssl rand -base64 48 | tr "+/" "-_" | tr -d =
Database Encryption Key (Required)

The database encryption key is used to encrypt configuration options in the database. Generate a secure random value as desired. A length of at least 30 characters is recommended. One method to generating a secure random value is to run the following command in a Linux terminal:

openssl rand -base64 48 | tr "+/" "-_" | tr -d =

Creation

Check the box at the bottom of the page to approve creation and click Create Stack. Within 25 minutes your GRAX stack should be ready for connection.

While the Cloudformation stack runs, you'll be able to see installation progress over on GRAX Platform. Once installation is complete, you can use the Platform provided domain name to connect to GRAX.

Salesforce Connection

Follow the standard GRAX connection documentation with these values to prepare your GRAX app.