Configure and create a cluster with the AWS ParallelCluster UI - AWS ParallelCluster

Configure and create a cluster with the AWS ParallelCluster UI

The AWS ParallelCluster UI is a web-based user interface that mirrors the AWS ParallelCluster pcluster CLI, while providing a console-like experience. You install and access the AWS ParallelCluster UI in your AWS account. When you run it, the AWS ParallelCluster UI accesses an instance of the AWS ParallelCluster API hosted on Amazon API Gateway in your AWS account.


The AWS ParallelCluster UI wizard may not have UI options for all the supported features in the latest supported AWS ParallelCluster version. You can manually edit the configuration file as needed or use the AWS ParallelCluster CLI.

In this section, we guide you through configuring and creating a cluster by using the AWS ParallelCluster UI.

Configure and create a cluster
  1. In the AWS ParallelCluster UI Clusters view, choose Create cluster, Step by step.

  2. In Cluster, Name, enter a name for your cluster.

  3. Choose a VPC with a public subnet for your cluster, and choose Next.

  4. In Head node, choose Add SSM session, and choose Next.

  5. In Queues, Compute resources, choose 1 for Static nodes.

  6. For Instance type, remove the selected default instance type, choose t2.micro, and choose Next.

  7. In Storage, choose Next.

  8. In Cluster configuration, review the cluster configuration YAML and choose Dry run to validate it.

  9. Choose Create to create your cluster, based on the validated configuration.

  10. After a few seconds, the AWS ParallelCluster UI automatically navigates you back to Clusters, where you can monitor the cluster create status and Stack events.

  11. Choose Details to see cluster details, such as the version and status.

  12. Choose Instances to see the list of EC2 instances and status.

  13. Choose Stack events to view cluster stack events, and a AWS Management Console link to the CloudFormation stack that creates the cluster.

  14. In Details, after cluster creation completes, choose View YAML to view or download the cluster configuration YAML file.

  15. After cluster creation completes, choose Shell to access the cluster head node.


    When you choose Shell, AWS ParallelCluster opens an Amazon EC2 Systems Manager session and adds an ssm-user to /etc/sudoers. For more information, see Turn on or turn off ssm-user account administrative permissions in the Amazon EC2 Systems Manager User Guide.

  16. To clean up, in the Clusters view, select the cluster, and choose Actions, Delete cluster.