Best practices - Amazon ParallelCluster
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Best practices

Best practices: master instance type selection

Although the master node doesn't execute any job, its functions and its sizing are crucial to the overall performance of the cluster.

When choosing the instance type to use for your master node you want to evaluate the following items:

  • Cluster size: the master node orchestrates the scaling logic of the cluster and is responsible of attaching new nodes to the scheduler. If you need to scale up and down the cluster of a considerable amount of nodes then you want to give the master node some extra compute capacity.

  • Shared file systems: when using shared file systems to share artifacts between compute nodes and the master node take into account that the master is the node exposing the NFS server. For this reason you want to choose an instance type with enough network bandwidth and enough dedicated Amazon EBS bandwidth to handle your workflows.

Best practices: network performance

There are three hints that cover the whole range of possibilities to improve network communication.

  • Placement group: a cluster placement group is a logical grouping of instances within a single Availability Zone. For more information on placement groups, see placement groups in the Amazon EC2 User Guide for Linux Instances. You can configure the cluster to use your own placement group with placement_group = your-placement-group-name or let Amazon ParallelCluster create a placement group with the "compute" strategy with placement_group = DYNAMIC. For more information, see placement_group for multiple queue mode and placement_group for single queue mode.

  • Enhanced networking: consider to choose an instance type that supports Enhanced Networking. For more information, see enhanced networking on Linux in the Amazon EC2 User Guide for Linux Instances.

  • Elastic Fabric Adapter: To support high levels of scaleable inter-instance communication, consider choosing EFA network interfaces for your network. The EFA's custom-built operating system (OS) bypass hardware enhances inter-instance communications with the on-demand elasticity and flexibility of the Amazon cloud. To configure a single Slurm cluster queue to use EFA, set enable_efa = true. For more information about using EFA with Amazon ParallelCluster, see Elastic Fabric Adapter and enable_efa. For more information about EFA, see Elastic Fabric Adapter in the Amazon EC2 User Guide for Linux Instances.

  • Instance bandwidth: the bandwidth scales with instance size, please consider to choose the instance type which better suits your needs, see Amazon EBS–optimized instances and Amazon EBS volume types in the Amazon EC2 User Guide for Linux Instances.

Best practices: budget alerts

To manage Amazon ParallelCluster resource costs, we recommend that you use Amazon Budgets actions to create a budget and defined budget threshold alerts for selected Amazon resources. For more information, see Configuring a budget action in the Amazon Budgets User Guide. You can also use Amazon CloudWatch to create a billing alarm. For more information, see Creating a billing alarm to monitor your estimated Amazon charges.

Best practices: moving a cluster to a new Amazon ParallelCluster minor or patch version

Currently each Amazon ParallelCluster minor version is self-contained along with its pcluster CLI. To move a cluster to a new minor or patch version, you must re-create the cluster using the new version's CLI.

To optimize the process of moving a cluster to a new minor version or to save your shared storage data for other reasons, we recommend that you use the following best practices.

  • Save personal data in external volumes, such as Amazon EFS and FSx for Lustre. By doing this, you can easily move the data from one cluster to another.

  • Create shared storage systems of the types listed below using the Amazon CLI or Amazon Web Services Management Console:

    Add them to the new cluster configuration as existing file systems. This way, they are preserved when you delete the cluster and can be attached to a new cluster. Shared storage systems generally incur charges whether they are attached or detached from a cluster.

    We recommend that you use Amazon EFS, or Amazon FSx for Lustre file systems because they can be attached to multiple clusters at the same time and you can attach them to the new cluster before deleting the old cluster. For more information, see Mounting Amazon EFS file systems in the Amazon EFS User Guide and Accessing FSx for Lustre file systems in the Amazon FSx for Lustre Lustre User Guide.

  • Use custom bootstrap actions to customize your instances rather than a custom AMI. This optimizes the creation process because a new custom AMI doesn't need to be created for each new version.

  • Recommended sequence.

    1. Update the cluster configuration to use existing file systems definitions.

    2. Verify the pcluster version and update it if needed.

    3. Create and test the new cluster.

      • Make sure your data is available in the new cluster.

      • Make sure your application works in the new cluster.

    4. If you're new cluster is fully tested and operational and you're sure you aren't going to use the old cluster, delete it.