Installing the AWS ParallelCluster UI - AWS ParallelCluster
Install the AWS ParallelCluster UI

Installing 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. For more information about the AWS ParallelCluster UI, see AWS ParallelCluster UI.

Prerequisites:

  • You must have an AWS account

  • You must have access to the AWS Management Console

For more information, see Setting up an AWS account.

Topics

Install the AWS ParallelCluster UI

To install an instance of the AWS ParallelCluster UI, you choose an AWS CloudFormation quick-create link for the AWS Region that you create clusters in. The quick-create URL takes you to a Create Stack Wizard where you provide quick-create stack template inputs and deploy the stack. For more information about CloudFormation quick-create stacks, see Creating quick-create links for stacks in the AWS CloudFormation User Guide.

Note

You can only create and edit clusters or build images with the same AWS ParallelCluster version that you use to install the AWS ParallelCluster UI.

UI quick-create links

us-east-1

us-east-2

us-west-1

us-west-2

eu-west-1

eu-west-2

eu-west-3

eu-central-1

eu-north-1

me-south-1

sa-east-1

ca-central-1

ap-northeast-1

ap-northeast-2

ap-south-1

ap-southeast-1

ap-southeast-2

us-gov-west-1
Use an AWS CloudFormation quick-create link to deploy an AWS ParallelCluster UI stack with nested Amazon Cognito, API Gateway, and Amazon EC2 Systems Manager stacks.

  1. Sign in to the AWS Management Console.

  2. Deploy the AWS ParallelCluster UI by choosing an AWS Region quick-create link from the table at the start of this section. This takes you to the CloudFormation Create Stack Wizard in the console.

  3. Enter a valid email address for Admin's Email.

    After deployment completes successfully, the AWS ParallelCluster UI sends you a temporary password to this email address. You use the temporary password to access the AWS ParallelCluster UI. If you delete the email before you save or use the temporary password, you must delete the stack and reinstall the AWS ParallelCluster UI.

  4. Keep the rest of the form blank or enter values for (optional) parameters to customize the AWS ParallelCluster UI build.

  5. Note the stack name for use in later steps.

  6. Navigate to Capabilities. Agree to the CloudFormation capabilities.

  7. Choose Create. It takes about 15 minutes to complete the AWS ParallelCluster API and AWS ParallelCluster UI deployment.

  8. View the stack details as the stack is created.

  9. After the deployment completes, open the admin email that was sent to the address you entered. It contains a temporary password that you use to access the AWS ParallelCluster UI. If you permanently delete the email and you haven’t yet logged in to the AWS ParallelCluster UI, you must delete the AWS ParallelCluster UI stack you created and reinstall the AWS ParallelCluster UI.

  10. In the AWS CloudFormation console list of stacks, choose the link to the stack name that you noted in a previous step.

  11. In Stack details, choose Outputs and select the link for the key named StacknameURL to open the AWS ParallelCluster UI. Stackname is the name that you noted in a previous step.

  12. Enter the temporary password. Follow the steps to create your own password and log in.

  13. You are now on the home page of the AWS ParallelCluster UI in the AWS Region that you selected.

  14. To get started using the AWS ParallelCluster UI, see Configure and create a cluster with the AWS ParallelCluster UI.

Note

PCUI sessions have a default duration of 5 minutes, which is the minimum value provided by Cognito as of PCUI 2023.12.0. Hence, it is expected that a user removed from Cognito User Pools is still able to access the system until the session expires.