Getting Started

Create an AWS Instance Profile

For AWS boxes first create an instance profile

aws iam create-role --role-name aerospike-par-eng-aerolab \
  --assume-role-policy-document '{
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "ec2.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
  }'

aws iam attach-role-policy --role-name aerospike-par-eng-aerolab \
  --policy-arn arn:aws:iam::aws:policy/AmazonEC2FullAccess
aws iam attach-role-policy --role-name aerospike-par-eng-aerolab \
  --policy-arn arn:aws:iam::aws:policy/AmazonElasticFileSystemReadOnlyAccess
aws iam attach-role-policy --role-name aerospike-par-eng-aerolab \
  --policy-arn arn:aws:iam::aws:policy/AWSPriceListServiceFullAccess

aws iam create-instance-profile --instance-profile-name aerospike-par-eng-aerolab

aws iam add-role-to-instance-profile --instance-profile-name aerospike-par-eng-aerolab \
  --role-name aerospike-par-eng-aerolab

Now, export the instance profile name so it will be used in the bootstrap script, as well as configure aerolab to use your aws credentials

Make sure aws is configured to use us-east-1

aws configure

Configure aerolab

export AWS_INSTANCE_PROFILE=aerospike-par-eng-aerolab
aerolab config backend -t aws -r us-east-1

Jumpbox Setup and Operation

Deploy the jumpbox

./project-scripts/jumpbox-bootstrap

You can then log into the cluster using the commands on the screen.

One Time Setup

1. Move into the graviton-theseus folder

   cd /workspace/graviton-theseus

2. Configure project overrides

   vi ./project-ansible/overrides.yaml

3. Configure the jumpbox

   ./00-configure-jumpbox

4. Reboot the jumpbox

Deploy the clusters

Choose target cluster type

Graviton 2 cluster:

source project-config/g2_target

Graviton 4 cluster:

source project-config/g4_target

Deploy an Aerospike cluster

./01-deploy-target-cluster

Deploy a load generation server

./02-deploy-lgs-cluster

Hydrate

./10-hydrate

Start the workload

./11-run-workload

Destroy the cluster

par-exec🔬 -- 99-destroy