Skip to content

Commit

Permalink
Update Install_AWSParallelCluster.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@RamiyapriyaS
RamiyapriyaS authored Dec 23, 2024
1 parent cb5f255 commit c677aa7
Showing 1 changed file with 24 additions and 33 deletions.
57 changes: 24 additions & 33 deletions docs/Install_AWSParallelCluster.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,43 +2,34 @@

## To install an instance of the AWS ParallelCluster UI choose an AWS Cloud Formation quick-create link for the AWS region you want the cluster in.

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 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.

Follow the instructions [here](https://docs.aws.amazon.com/parallelcluster/latest/ug/install-pcui-v3.html), once UI is deployed the link should direct you to the UI and should look like :
The AWS documentation for installing the PCUI can be found [here](https://docs.aws.amazon.com/parallelcluster/latest/ug/install-pcui-v3.html).

To install an instance of the AWS ParallelCluster UI (PCUI), 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.

The quick link for creating this stack within the us-east-1 region can be found [here](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?stackName=parallelcluster-ui&templateURL=https://parallelcluster-ui-release-artifacts-us-east-1.s3.us-east-1.amazonaws.com/parallelcluster-ui.yaml)

**Use an AWS CloudFormation quick-create link to deploy an PCUI stack with nested Amazon Cognito, API Gateway, and Amazon EC2 Systems Manager stacks.**

1. Sign in to the AWS Management Console.
2. Deploy the PCUI 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.**
4. Enter an **ImageBuilder Custom VPC**. This can be found in the VPC Dashboard on AWS Console.
5. After deployment completes successfully, the PCUI sends you a temporary password to this email address. You use the temporary password to access the PCUI. If you delete the email before you save or use the temporary password, you must delete the stack and reinstall the PCUI.
6. Keep the rest of the form blank or enter values for (optional) parameters to customize the PCUI build.
7. Note the stack name for use in later steps.
8. Navigate to **Capabilities.** Agree to the CloudFormation capabilities.
9. Choose **Create.** It takes about 15 minutes to complete the AWS ParallelCluster API and PCUI deployment.
10. View the stack details as the stack is created.
11. 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 PCUI. If you permanently delete the email and you haven’t yet logged in to the PCUI, you must delete the PCUI stack you created and reinstall the PCUI.
12. In the AWS CloudFormation console list of stacks, choose the link to the stack name that you noted in a previous step.
13. In **Stack details**, choose **Outputs** and select the link for the key named **StacknameURL** to open the PCUI. Stackname is the name that you noted in a previous step.
14. Enter the temporary password. Follow the steps to create your own password and log in.
15. You are now on the home page of the PCUI in the AWS Region that you selected.

![parallel cluster UI image](/docs/images/ParallelclusterUI.PNG)

### Create and Configure ParallelCluster using the UI without pre-made templates

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 and a 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. Choose and instance type, and choose Next.

7. In Storage, select desired shared storage type or stay with default options and 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.

# Installing the AWS ParallelCluster CLI:

Expand Down

0 comments on commit c677aa7

Please sign in to comment.