Welcome to the new DOCS.vastdata.com. We've added new menus and a version selector, plus new persona and resource pages to help customers get started. Looking for a previous article? Use the docs search.

AWS - Deploy the MCM and a Cluster

Prev Next

Introduction

VAST on Cloud (VoC) clusters are deployed using the Multi-Cluster Manager (MCM) cloud-based service. This service is provisioned via a VAST Data-provided AWS CloudFormation template. Each VoC cluster is automatically configured with a management access IP and predefined VIP pools for both replication and protocol access. This streamlined deployment process enables you to begin running workloads with minimal setup time.

Prerequisites

You will need to acquire a License Token to use the MCM and create clusters. Please contact the VAST on Cloud Sales Team to request one.

  • NOTE: Tokens are single-use and only last 14 days from the date of issue. If you delete the MCM, you will need a new one.

Installation:

High-Level Steps:

  1. Review and verify Prerequisites.

  2. Request Token.

  3. Deploy the Validation CloudFormation Stack (see document above).

    1. Resolve any issues.

  4. Add a subscription to the VAST Data Platform in the Marketplace.

  5. Launch the VAST Data CloudFormation Stack from the subscription page.

    1. Go through the launch steps.

    2. Wait for completion.

    3. Click on the MCM URL.

  6. Log in to MCM.

    1. Apply Token.

  7. Launch Cluster.

    1. Login

  8. Configure and use a cluster.

NOTE:

  • The installation starts at step 5.  Instructions for running the Validation Stack are in the attached document.

MCM Deployment from the AWS Marketplace

1. Launch the VAST Data CloudFormation Stack from the subscription page.

After you have subscribed to the VAST Data Platform, you will see it in your list of subscriptions. This account only has the one subscription - do not subscribe to the 4.7 version..

The screenshot shows an AWS Marketplace subscription management page with details about the VAST Data Platform, including delivery method being CloudFormation Template, service start date June 16, 2025, and access level set to Agreement.

2. Choose the VAST Version, then → “Continue to Launch”.

The screenshot displays the configuration page for deploying the VAST Data Platform within the AWS Marketplace, where users can select software versions and fulfillment options such as running on m5.large instances in the US East (N. Virginia) region.

3. Launch the CloudFormation Stack:

The screenshot displays the AWS Marketplace page for launching the VAST Data Platform, where configuration details such as the fulfillment option and software version can be reviewed before proceeding with the launch through CloudFormation.

4. Create the Stack

Nothing to choose here, everything is pre-selected, and you will see the URL for the CloudFormation Stack prepopulated [Next]:

The image shows the AWS CloudFormation console in the process of creating a stack, specifically on the "Prepare template" step where users can choose an existing template from an Amazon S3 URL or their have already stored there. The selected template is visible with its full URL provided for reference.

5. Specify Stack Details:

  • Parameters -

    • Stack name: The name that will be used for the Multi-Cluster Manager Instance. You will live with this for a while, so choose wisely.

      • Required -

        • EnableCallHome:  <boolean> Can be enabled later.  

        • KeyName: <dropdown> Select the Key Pair you will use for SSH access.

        • SecurityGroupIds: <dropdown> Select an SG(s) configured for the subnets/VPC you are using.

        • DBSubnetsGroup: <dropdown> Select 2 subnets in different availability zones.

        • BucketName: Existing S3 bucket for MCM CloudWatch logs.

      • Optional -

        • AdditionalTags:  For additional tags your organization may require.

        • ExtraParams: <Reserved for VAST Engineering/Support>

        • DbSecurityGroupId: <Use the same SG chosen above>

      • Provided -

        • ImageId: Do not change this.

      • [Next]

The screenshot shows the "Specify stack details" step in AWS CloudFormation, where users can input parameters such as stack name, key pair names, security group IDs, subnets, and optional tags to configure a new cloud resource deployment stack.

6. Configure Stack Options

Acknowledge that IAM resources may get created [Next]

The image shows the "Configure stack options" step in AWS CloudFormation, where users can specify tags and permissions for their AWS resources as well as configure behavior on provisioning failure, additional settings like stack policy and rollback configuration, notification options, and stack creation options to ensure successful resource management during deployment.

7. Review and Create

[Submit] starts the deployment.

The screenshot displays an AWS CloudFormation console page where users can review and create a stack, specifying details such as the template URL, stack name (VOC-HCMStack-01), parameters like BucketName and SecurityGroupIds, and configuring options such as tags, permissions, rollback settings, and notification configurations.

8. CloudFormation Stacks - [Events]

Once you submit the stack, the console will switch to a different view that will scroll events as the Stack is provisioned. This is where you will see errors related to IAM permissions.

Watch the events until it reaches “CREATE_COMPLETE”

The screenshot displays the AWS CloudFormation console, where the VoC-MCMStack-01 stack is in "CREATE_COMPLETE" status with 100+ events logged. The details include timestamps and statuses such as CREATE_COMPLETE and CREATE_IN_PROGRESS, indicating the successful initiation and completion of resource creation within the stack.

9. CloudFormation Stack [Outputs]

After the provisioning is complete, switch to the “Outputs” tab, where you will see a link for the MCM.

Clicking on the link will launch the MCM Management Console.

If you don’t have issues with insufficient privileges, you will get this far, and if you have a route to the VPC/subnet, you will be able to launch the MCM and log in.

The AWS CloudFormation stack "VoC-MCMStack-01" has been successfully created, and its outputs provide important details such as access to the CloudWatchLogs console link and the VPC identifier (VpcId), which is vpc-002d66abeb551fb6d. Additionally, there the stack includes a link to the MC management console at https://LB-VoC-MCMDStack-XX.amazonaws.com:443.

This stack was deployed on 2025-07-02 UTC-0 time and can be managed via AWS Console or AWS CLI

At this point, you have successfully deployed the Multi Cluster Manager and will use your one-time token to register the new instance and start creating clusters.

10. Accessing the MCM: Logging In and Applying Token

  • First, you get the usual unsigned certificate screen - click on “proceed to <stack name>:

The screenshot indicates a browser warning due to an untrusted certificate, suggesting potential security risks from accessing lb-voc-mcmstack-01-1c355debb0d42.elb.us-east-1.amazonaws.com. Users should exercise caution and proceed with enhanced protection enabled to ensure maximum security.

  • EULA:

The image displays an End User License Agreement (E
 addCriterion
Agreement) for VAST DATA, detailing terms that must be accepted before accessing or using their services and software. It highlights key points including the agreement's application to direct users from VAST Data as well as through partners under specific conditions.

  • Login - standard default VAST Login <admin> <123456>:

The image depicts a login screen with a dark background and a starry field design, featuring an astronaut icon holding a device with "VAST" branding, indicating it could be part of a user automation tool's graphical interface.

  • Once you are logged in, you will see the “Provide a registration token link at the top - click on it and type in the token you were given:

The user is presented with an interface to manage clusters using DataSpace, and it prompts them to provide a registration token by clicking "Click to Update," as indicated by a red exclamation mark above the area where tokens should be entered.The image shows a VAST DataSpace interface where users need to input a registration token provided by VAST Support in order to proceed with creating a new VAST-on-Cloud cluster. The screen also includes options like settings and adding new features, highlighting the steps necessary for cloud cluster configuration.

  • Now you are fully up and running and ready to start up a cluster or 2:

The screenshot shows VAST's DataSpace portal, designed to manage and view clusters in one place. Users can create new cloud clusters through either a direct button or via an "Add New" dropdown menu under the Clusters section.

Creating a Cluster

11. Cluster Creation from MCM

  • Once you choose one of the options above, you will be placed in the “Create a Cluster' dialogue:

The image displays the "Create Cloud cluster" interface, where users can define various parameters such as region, instance type, and VAST version before proceeding to finalize setup via AWS. The "General" tab is currently selected, showing fields like Cluster name, Type Name, Capacity type, Storage capacity (25TB or 50TB), Instance type options, and capabilities such as resiliency, similarity, and callhome toggled on and off.

Notes:

  • Naming follows the standard AWS naming conventions for resources.

  • The region will be pre-chosen based on the VPC you are using.

  • On Demand is recommended - Spot is cheaper but could be preempted.

  • One more step: Clusters are installed by launching another CloudFormation Stack. It is triggered when you “Click to finish setup in AWS”. The next section will go over configuring and launching the stack.

The screenshot indicates that an AWS CloudFormation Stack configuration is required to complete the setup, as marked by a notification stating "Need to switch to AWS Cloudformation Stack config." The status shows "voc-east1-test01" with the state being "WAITING_FOR_STACK_CREATION," suggesting that the stack creation process has not yet been initiated but is pending completion.

12. Cluster Stack Configuration

When you “Set” the cluster parameters, you get switched to this AWS dialogue:

All of the defaults should be sufficient - the drop-downs will be pre-populated lists based on the MCM stack inputs.

ℹ️ Info

Be careful with the “create new Security Group” option - if you know your user has the permissions, you can, but if you aren’t sure, it's better to use the one already chosen/created.

The image displays a AWS CloudFormation dashboard where users can configure and deploy an Amazon Virtual Private Cloud (Amazon VPC) stack, including options to specify key parameters such as security group rules, subnets, bucket names, and IAM roles, with additional settings like rollbacks, monitoring alarms, notification topics, and timeout options for the stack creation process.

  • This should look familiar by now - time to go get some coffee.

The screenshot displays an AWS CloudFormation console where the "voc-east1-test01-stack" stack is in the process of being created, with one event logged indicating it's currently in progress due to user initiation. The left pane lists other stacks within this region, some marked as completed, while others are still pending or initiate.

  • When it is done, there will be a new stack added - the “wrapper”. Select that one and the “Output” tab, and you will see “ClusterMgmt” - the value is the link to the VMS for that cluster.  Save it for later if you want to access the cluster directly without the MCM.

The image displays an AWS CloudFormation stack named "voc-east1-test01-stack-StackWrapper-12N7RZ4JDAHSK" which has successfully completed its creation process, indicated by the CREATE_COMPLETE status and timestamp shown in the left pane. The Outputs tab on the right provides details such as the Auto Scaling Group ID, availability zone, CloudWatch Logs URL, Cluster Management link, EC2 Instance console link, and private IP address, facilitating access to various resources within the newly created infrastructure.

  • And there it is - the standard new cluster login with the unsigned cert.

The screenshot shows a security warning in Google Chrome indicating that the connection is not private due to an invalid certificate authority, potentially allowing attackers to steal sensitive information like passwords and credit card details from 10.105.28.73. Users have options to either turn on enhanced protection or navigate back to a safer browsing option.

  • Go back to the MCM - you will now see a new view with the cluster added in a pane on the right. This is how you will manage the cluster(s) you create:

  • You can:

    • Open the VMS GUI

    • Remove the Cluster

    • Suspend the cluster

The image displays the interface for managing cluster entries in DataSpace, including options to open specific clusters and remove/suspend them. The right section highlights details about a particular cluster named 'voc-east1-test01,' showing its it is located in US East (Virginia) with relevant performance metrics such as BW, IOPS, and Latency.

13. VMS Login/Running

We will skip the next few screens; you should be very familiar with them by now, and they are self-explanatory.

If everything has gone smoothly up to this point, you will have a running cluster and a familiar VMS GUI interface:

The dashboard provides an overview of storage capacity, performance metrics (bandwidth, IOPS, and latency), and inventory status for active CNodes, DNodes, external volumes, and SSDs in VAST, with all resources currently unused or free.

The interface displays real-time monitoring without any live data being displayed under bandwidth, IOPs, read/write bandwidth, and read/write latency sections.

What now?

Now that the cluster is up and running, you have a fully functional 5.3 VAST Data cluster in a VPC. You can start creating cluster resources like views, DNS, VIPs, etc.

Guidance:

Deleting a Cluster and associated Resources

  • This should be done through the MCM using “Remove Cluster.”

  • You could do it by deleting the CloudFormation Stack, but it is cleaner and supported to use the MCM.

Deleting an MCM and associated Resources

  • Go back to the CloudFormation Stack portal and “delete” the stack.

  • If you left clusters behind, you can delete them from the same place by deleting their stacks.

Default cluster resources

  • 2 VIP Pools with IPs pulled from the subnet the cluster lives in.

    • replicationPool

    • protocolsPool

  • Policies -

    • default - NFS

    • s3_default_policy

Accessing and managing the cluster(s)

There are several ways to access a cluster once it is running.

Through the MCM

Once a cluster has been deployed, you can do some basic management from the interface.

The screenshot shows the VAST DataSpace interface, where users can manage their clusters by accessing detailed information such as data usage and performance metrics (BW, IOPS, Latency) through the "Open Cluster" option. Additionally, actions like removing or suspending the cluster are also available from this view.

Directly from the URL

This can be retrieved from the “Outputs” tab of the CloudFormation Stack that created the cluster.

You don’t need to be authenticated to AWS to access the MCM or cluster directly, so it is probably a good idea to save these URLs somewhere.

SSH login to the VM and use VCLI

You will use the .pem or .ppk key you created and used with the CloudFormation Stack that created the MCM/Cluster. You can add other keys later, but you will need to use the one you chose initially.

NOTE: You will need to have a route to the private subnet.

  • Find the private IP of the Instance (or DNS name if you can resolve AWS private DNS:)

  • Locate your .pem file

  • SSH to the instance -

  • Recommendation: either save the path in a variable for reuse, or better yet, add the entry to your .ssh config file.

.ssh/config:

Host source
    HostName 10.105.38.6
    User ubuntu
    IdentityFile C:\Users\karlv\.ssh\other_keys\aws.karlv-poc.pem
    PasswordAuthentication no

Host clustera
    HostName 10.105.28.77
    User centos
    IdentityFile C:\Users\karlv\.ssh\other_keys\aws.karlv-poc.pem
    PasswordAuthentication no

This lets you use the Host alias - “source” or “clustera” in this case directly -

KV C:\> ssh clustera
Last login: Fri Jul 18 22:34:10 2025 from ip-10-241-248-45.ec2.internal
   ,     #_
   ~\_  ####_        Amazon Linux 2
  ~~  \_#####\
  ~~     \###|       AL2 End of Life is 2026-06-30.
  ~~       \#/ ___
   ~~       V~' '->
    ~~~         /    A newer version of Amazon Linux is available!
      ~~._.   _/
         _/ _/       Amazon Linux 2023, GA and supported until 2028-03-15.
       _/m/'           https://aws.amazon.com/linux/amazon-linux-2023/

60 package(s) needed for security, out of 77 available
Run "sudo yum update" to apply all updates.
[centos@ip-10-105-28-243 ~]$

Using a variable -

ssh -i $AWSPem centos@10.105.28.77

If you aren’t familiar with the .ssh/config file, it is worth some investigation.

Use Terraform to configure clusters.

Complete Example


Resources: