Skip to content

Commit ef99960

Browse files
committed
Deployed fec7df4 with MkDocs version: 1.5.3
1 parent af495b6 commit ef99960

File tree

6 files changed

+224
-33
lines changed

6 files changed

+224
-33
lines changed

config/index.html

Lines changed: 50 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,10 @@
191191
<li class="nav-item" data-level="4"><a href="#database" class="nav-link">Database</a>
192192
<ul class="nav flex-column">
193193
</ul>
194+
</li>
195+
<li class="nav-item" data-level="4"><a href="#slurmdbd" class="nav-link">Slurmdbd</a>
196+
<ul class="nav flex-column">
197+
</ul>
194198
</li>
195199
</ul>
196200
</li>
@@ -350,11 +354,16 @@ <h1 id="configuraton-file-format">Configuraton File Format</h1>
350354
<a href="#database">Database</a>:
351355
<a href="#databasestackname">DatabaseStackName</a>: str
352356
<a href="#fqdn">FQDN</a>: str
353-
<a href="#port">Port</a>: str
357+
<a href="#database-port">Port</a>: str
354358
<a href="#adminusername">AdminUserName</a>: str
355359
<a href="#adminpasswordsecretarn">AdminPasswordSecretArn</a>: str
356-
<a href="#clientsecuritygroup">ClientSecurityGroup</a>:
360+
<a href="#database-clientsecuritygroup">ClientSecurityGroup</a>:
357361
SecurityGroupName: SecurityGroupId
362+
<a href="#slurmdbd">Slurmdbd</a>:
363+
<a href="#slurmdbdstackname">SlurmdbdStackName</a>: str
364+
<a href="#slurmdbd-host">Host</a>: str
365+
<a href="#slurmdbd-port">Port</a>: str
366+
<a href="#slurmdbd-clientsecuritygroup">ClientSecurityGroup</a>: str
358367
<a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/HeadNode-v3.html#HeadNode-v3-Dcv">Dcv:</a>
359368
<a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/HeadNode-v3.html#yaml-HeadNode-Dcv-Enabled">Enabled</a>: bool
360369
<a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/HeadNode-v3.html#yaml-HeadNode-Dcv-Port">Port</a>: int
@@ -548,11 +557,14 @@ <h4 id="enableefa">EnableEfa</h4>
548557
<p>See <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#placement-groups-cluster">https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html#placement-groups-cluster</a></p>
549558
<h4 id="database">Database</h4>
550559
<p>Optional</p>
560+
<p><strong>Note</strong>: Starting with ParallelCluster 3.10.0, you should use slurm/ParallelClusterConfig/<a href="#slurmdbd">Slurmdbd</a> instead of slurm/ParallelClusterConfig/Database.
561+
You cannot have both parameters.</p>
551562
<p>Configure the Slurm database to use with the cluster.</p>
552563
<p>This is created independently of the cluster so that the same database can be used with multiple clusters.</p>
553-
<p>The easiest way to do this is to use the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/tutorials_07_slurm-accounting-v3.html#slurm-accounting-db-stack-v3">CloudFormation template provided by ParallelCluster</a> and then to just pass
554-
the name of the stack in <a href="#databasestackname">DatabaseStackName</a>.
555-
All of the other parameters will be pulled from the stack.</p>
564+
<p>See <a href="../deployment-prerequisites#create-parallelcluster-slurm-database">Create ParallelCluster Slurm Database</a> on the deployment prerequisites page.</p>
565+
<p>If you used the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/tutorials_07_slurm-accounting-v3.html#slurm-accounting-db-stack-v3">CloudFormation template provided by ParallelCluster</a>, then the easiest way to configure it is to pass
566+
the name of the stack in slurm/ParallelClusterConfig/Database/<a href="#databasestackname">DatabaseStackName</a>.
567+
All of the other parameters will be pulled from the outputs of the stack.</p>
556568
<p>See the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/Scheduling-v3.html#Scheduling-v3-SlurmSettings-Database">ParallelCluster documentation</a>.</p>
557569
<h5 id="databasestackname">DatabaseStackName</h5>
558570
<p>Name of the ParallelCluster CloudFormation stack that created the database.</p>
@@ -566,7 +578,7 @@ <h5 id="databasestackname">DatabaseStackName</h5>
566578
</ul>
567579
<h5 id="fqdn">FQDN</h5>
568580
<p>Used with the Port to set the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/Scheduling-v3.html#yaml-Scheduling-SlurmSettings-Database-Uri">Uri</a> of the database.</p>
569-
<h5 id="port">Port</h5>
581+
<h5 id="database-port">Database: Port</h5>
570582
<p>type: int</p>
571583
<p>Database's port.</p>
572584
<h5 id="adminusername">AdminUserName</h5>
@@ -578,9 +590,37 @@ <h5 id="adminpasswordsecretarn">AdminPasswordSecretArn</h5>
578590
<p>The Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the AdminUserName plaintext password.
579591
This password is used together with AdminUserName and Slurm accounting to authenticate on the database server.</p>
580592
<p>Sets the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/Scheduling-v3.html#yaml-Scheduling-SlurmSettings-Database-PasswordSecretArn">PasswordSecretArn</a> parameter in ParallelCluster.</p>
581-
<h5 id="clientsecuritygroup">ClientSecurityGroup</h5>
593+
<h5 id="database-clientsecuritygroup">Database: ClientSecurityGroup</h5>
582594
<p>Security group that has permissions to connect to the database.</p>
583-
<p>Required to be attached to the head node that is running slurmdbd so that the port connection to the database is allows.</p>
595+
<p>Required to be attached to the head node that is running slurmdbd so that the port connection to the database is allowed.</p>
596+
<h4 id="slurmdbd">Slurmdbd</h4>
597+
<p><strong>Note</strong>: This is not supported before ParallelCluster 3.10.0. If you specify this parameter then you cannot specify slurm/ParallelClusterConfig/<a href="#database">Database</a>.</p>
598+
<p>Optional</p>
599+
<p>Configure an external Slurmdbd instance to use with the cluster.
600+
The Slurmdbd instance provides access to the shared Slurm database.
601+
This is created independently of the cluster so that the same database can be used with multiple clusters.</p>
602+
<p>This is created independently of the cluster so that the same slurmdbd instance can be used with multiple clusters.</p>
603+
<p>See <a href="../deployment-prerequisites#create-slurmdbd-instance">Create Slurmdbd instance</a> on the deployment prerequisites page.</p>
604+
<p>If you used the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/external-slurmdb-accounting.html#external-slurmdb-accounting-step1">CloudFormation template provided by ParallelCluster</a>, then the easiest way to configure it is to pass
605+
the name of the stack in slurm/ParallelClusterConfig/Database/<a href="#slurmdbdstackname">SlurmdbdStackName</a>.
606+
All of the other parameters will be pulled from the parameters and outputs of the stack.</p>
607+
<p>See the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/Scheduling-v3.html#Scheduling-v3-SlurmSettings-ExternalSlurmdbd">ParallelCluster documentation for ExternalSlurmdbd</a>.</p>
608+
<h5 id="slurmdbdstackname">SlurmdbdStackName</h5>
609+
<p>Name of the ParallelCluster CloudFormation stack that created the Slurmdbd instance.</p>
610+
<p>The following parameters will be set using the outputs of the stack:</p>
611+
<ul>
612+
<li>Host</li>
613+
<li>Port</li>
614+
<li>ClientSecurityGroup</li>
615+
</ul>
616+
<h5 id="slurmdbd-host">Slurmdbd: Host</h5>
617+
<p>IP address or DNS name of the Slurmdbd instance.</p>
618+
<h5 id="slurmdbd-port">Slurmdbd: Port</h5>
619+
<p>Default: 6819</p>
620+
<p>Port used by the slurmdbd daemon on the Slurmdbd instance.</p>
621+
<h5 id="slurmdbd-clientsecuritygroup">Slurmdbd: ClientSecurityGroup</h5>
622+
<p>Security group that has access to use the Slurmdbd instance.
623+
This will be added as an extra security group to the head node.</p>
584624
<h3 id="clustername">ClusterName</h3>
585625
<p>Name of the ParallelCluster cluster.</p>
586626
<p>Default: If StackName ends with "-config" then ClusterName is StackName with "-config" stripped off.
@@ -590,6 +630,7 @@ <h3 id="mungekeysecret">MungeKeySecret</h3>
590630
For an existing secret can be the secret name or the ARN.
591631
If the secret doesn't exist one will be created, but won't be part of the cloudformation stack so that it won't be deleted when the stack is deleted.
592632
Required if your submitters need to use more than 1 cluster.</p>
633+
<p>See <a href="../deployment-prerequisites#create-munge-key">Create Munge Key</a> for more details.</p>
593634
<h3 id="slurmctl">SlurmCtl</h3>
594635
<p>Configure the Slurm head node or controller.</p>
595636
<p>Required, but can be an empty dict to accept all of the defaults.</p>
@@ -875,7 +916,7 @@ <h5 id="count">Count</h5>
875916
<h5 id="server">Server</h5>
876917
<p>The license server hosting the licenses.</p>
877918
<p>Not currently used.</p>
878-
<h5 id="port_1">Port</h5>
919+
<h5 id="port">Port</h5>
879920
<p>The port on the license server used to request licenses.</p>
880921
<p>Not currently used.</p>
881922
<h5 id="servertype">ServerType</h5>

deploy-parallel-cluster/index.html

Lines changed: 0 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -114,14 +114,6 @@
114114
<ul class="nav flex-column">
115115
<li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
116116
<ul class="nav flex-column">
117-
<li class="nav-item" data-level="3"><a href="#create-parallelcluster-ui-optional-but-recommended" class="nav-link">Create ParallelCluster UI (optional but recommended)</a>
118-
<ul class="nav flex-column">
119-
</ul>
120-
</li>
121-
<li class="nav-item" data-level="3"><a href="#create-parallelcluster-slurm-database" class="nav-link">Create ParallelCluster Slurm Database</a>
122-
<ul class="nav flex-column">
123-
</ul>
124-
</li>
125117
</ul>
126118
</li>
127119
<li class="nav-item" data-level="2"><a href="#create-the-cluster" class="nav-link">Create the Cluster</a>
@@ -163,19 +155,6 @@ <h1 id="deploy-aws-parallelcluster">Deploy AWS ParallelCluster</h1>
163155
The current latest version is 3.9.1.</p>
164156
<h2 id="prerequisites">Prerequisites</h2>
165157
<p>See <a href="../deployment-prerequisites/">Deployment Prerequisites</a> page.</p>
166-
<h3 id="create-parallelcluster-ui-optional-but-recommended">Create ParallelCluster UI (optional but recommended)</h3>
167-
<p>It is highly recommended to create a ParallelCluster UI to manage your ParallelCluster clusters.
168-
A different UI is required for each version of ParallelCluster that you are using.
169-
The versions are list in the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/document_history.html">ParallelCluster Release Notes</a>.
170-
The minimum required version is 3.6.0 which adds support for RHEL 8 and increases the number of allows queues and compute resources.
171-
The suggested version is at least 3.7.0 because it adds configurable compute node weights which we use to prioritize the selection of
172-
compute nodes by their cost.</p>
173-
<p>The instructions are in the <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/install-pcui-v3.html">ParallelCluster User Guide</a>.</p>
174-
<h3 id="create-parallelcluster-slurm-database">Create ParallelCluster Slurm Database</h3>
175-
<p>The Slurm Database is required for configuring Slurm accounts, users, groups, and fair share scheduling.
176-
It you need these and other features then you will need to create a ParallelCluster Slurm Database.
177-
You do not need to create a new database for each cluster; multiple clusters can share the same database.
178-
Follow the directions in this <a href="https://docs.aws.amazon.com/parallelcluster/latest/ug/tutorials_07_slurm-accounting-v3.html#slurm-accounting-db-stack-v3">ParallelCluster tutorial to configure slurm accounting</a>.</p>
179158
<h2 id="create-the-cluster">Create the Cluster</h2>
180159
<p>To install the cluster run the install script. You can override some parameters in the config file
181160
with command line arguments, however it is better to specify all of the parameters in the config file.</p>

0 commit comments

Comments
 (0)