Run Oxla via AWS

Over the following steps, we’ll guide you on how to deploy and configure Oxla on AWS.

Prerequisite

⚠️ You need to have an active AWS account. 

⚠️ Ensure that your billing details are up-to-date. AWS Marketplace charges will appear on your AWS bill.

⚠️ Your IAM user account should have permissions to subscribe to and manage software in the AWS Marketplace.

⚠️  Ensure the product is available in the AWS region where you intend to deploy it

Steps

Step 1: Subscribe to Oxla

1. Go to the AWS Marketplace and type Oxla in the search field.
2. Select Oxla from the search results.

3. Click on the Subscribe button.

Step 2: Manage Subscriptions

After subscribing, you will find Oxla in the Manage Subscriptions page.

Step 3: Launch Oxla Cluster

1. From the Manage Subscriptions page, click on Launch CloudFormation stack to configure Oxla.
2. You will go to the “Configure this software” prompt, where you need to configure the following:
   • Under the fulfillment option, select Oxla Cluster Stack.
   • Select the latest software version.
   • Choose a region where you want to deploy Oxla.
3. Click Continue to Launch.
4. You will go to the “Launch this software” page. Select Launch CloudFormation.
5. Click Launch to proceed.

Step 4: Specify Stack Details

1. On the “CloudFormation template” page, you don’t need to change anything, so click Next.
2. Fill in the Stack details:

Fields	Details
Stack name	The stack name.
AvailabilityZone	Availability zone of your choice. This field is mandatory.
ExistingS3BucketName	The S3 bucket name. You can also leave this field empty to allow AWS to create a new S3 bucket.
InstanceType	The instance type. Available options are c5a.2xlarge, c5a.4xlarge, c5a.8xlarge.
IsPubliclyAccessible	Set to true or false, depending on whether you want the cluster to be publicly accessible.
NodeNumber	The node number. Minimum value is 1 and maximum value is 16.
OxlaVersion	The default oxla version.
OxlaWhitelistedCidr	The CIDR range. Only specified CIDR will have access to the Oxla cluster.

3. Click Next to continue by adjusting the configuration to your personal needs.

Step 5: Accessing Oxla

1. Once the stack is successfully deployed, go to CloudFormation → Stacks →select your stack.
2. Find the OxlaEndpoint in the Outputs section.
3. Connect to your Oxla cluster using PSQL, for example:

psql -h [OxlaEndpoint] -p 5432