Skip to content

Commit 8e6f10b

Browse files
author
Doc Deploy Bot
committed
Deployed e3ab7ee to dev with MkDocs 1.6.1 and mike 2.1.3
1 parent cc14e61 commit 8e6f10b

3 files changed

Lines changed: 8 additions & 7 deletions

File tree

dev/guides/redundant-allocations/readme/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1245,9 +1245,9 @@ <h3 id="lvm">LVM</h3>
12451245
<p>For XFS and Raw allocations using LVM, the RAID device can only be rebuilt when the Rabbit node has the LV activated. For <code>jobdw</code> allocations, this means that the RAID cannot be rebuilt while the compute nodes have the LV activated between <code>PreRun</code> and <code>PostRun</code>. For this reason, the most common way to use RAID configurations in this situation will be without rebuilding enabled.</p>
12461246
<p>If an XFS or Raw allocation is made with <code>create_persistent</code>, then the rebuild commands should be specified to allow the RAID to be rebuilt when no compute nodes have the LV activated.</p>
12471247
<h3 id="zpool">Zpool</h3>
1248-
<p>For Lustre allocations using zpool, there are no restrictions on when rebuild commands can be used. The RAID can be rebuilt for job and persistent instances regardless of whether the compute nodes have the file system mounted.</p>
1248+
<p>For Lustre allocations using zpool, there are no restrictions on when rebuild commands can be used. The RAID can be rebuilt for job and persistent instances regardless of whether the compute nodes have the file system mounted. This is possible because the Lustre targets are only mounted on the Rabbits.</p>
12491249
<h3 id="replacing-a-drive">Replacing a Drive</h3>
1250-
<p>If a drive has failed and needs to be replaced, the Rabbit-p and Rabbit-s should be powered off to replace the drive. After powering the Rabbit back on, the <code>nnf-node-manager</code> pod will restart on the Rabbit. On initialization, Rabbit software will find the new drive and add an NVMe namespace for each allocation. If the rebuild commands have been specified, the Rabbit software will run them to add the new NVMe namespace into the RAID device.</p>
1250+
<p>If a drive fails and must be replaced, the Rabbit-p and Rabbit-s should be powered off to replace the drive. After replacing the drive and powering the Rabbit back on, the <code>nnf-node-manager</code> pod restarts on the Rabbit. On initialization, Rabbit software locates the new drive and adds an NVMe namespace for each allocation. If rebuild commands have been specified, the Rabbit software will run them to add the new NVMe namespace into the RAID device and restore the correct data.</p>
12511251
<h2 id="allocation-status">Allocation Status</h2>
12521252
<p>If the allocation is a <code>PersistentStorageInstance</code>, the status of the RAID device is available in the <code>Status.State</code> field. If all the RAIDs in the persistent storage are healthy, <code>Status.State=Active</code>. If any of the RAIDs are degraded, <code>Status.State=Degraded</code>.</p>
12531253

dev/guides/storage-profiles/readme/index.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1679,9 +1679,9 @@ <h5 id="example-layouts">Example Layouts</h5>
16791679
<p>The <code>count</code> field may be useful when creating a persistent file system since the job with the <code>create_persistent</code> directive may only have a single compute node.</p>
16801680
<p>In general, <code>scale</code> gives a simple way for users to get a filesystem that has performance consistent with their job size. <code>count</code> is useful for times when a user wants full control of the file system layout.</p>
16811681
<h3 id="raid-configurations">RAID Configurations</h3>
1682-
<p>Allocations can be set up to use a RAID device to provide redundancy in the event of a drive failure. Optionally, commands can be specified to rebuild the RAID device after a replacement drive has been added. The storage profile parameters differ depending on whether the allocation is using LVM or zpool.</p>
1682+
<p>Allocations can be set up to use a RAID device to provide continued access in the event of a drive failure. Optionally, commands can be specified to rebuild the RAID device after a replacement drive has been added. The storage profile parameters differ depending on whether the allocation is using LVM or zpool.</p>
16831683
<h4 id="zpool">Zpool</h4>
1684-
<p>To create a Lustre confiuration with a redundant zpool, the <code>raidz</code> option should be added to the <code>zpoolCreate</code> command. To allow the zpool to be rebuilt with a new drive, the <code>zpoolReplace</code> command should be included.</p>
1684+
<p>To create a Lustre confiuration with a redundant zpool, the <code>raidz</code> option is required in <code>zpoolCreate</code> command. To allow the zpool to be rebuilt with a new drive, the <code>zpoolReplace</code> command is required.</p>
16851685
<p>The example below shows a RAID configuration for the OST, however, the same options can be specified for any of the Lustre targets.</p>
16861686
<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nnf.cray.hpe.com/v1alpha8</span>
16871687
<a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">NnfStorageProfile</span>
@@ -1702,9 +1702,10 @@ <h4 id="zpool">Zpool</h4>
17021702
<a id="__codelineno-16-17" name="__codelineno-16-17" href="#__codelineno-16-17"></a><span class="w"> </span><span class="nt">zpoolReplace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">$POOL_NAME $OLD_DEVICE $NEW_DEVICE</span>
17031703
</code></pre></div>
17041704
<h4 id="lvm">LVM</h4>
1705-
<p>A RAID logical volume can be used with XFS and Raw allocations. gfs2 allocations can not use RAID logical volumes because the LV is shared.</p>
1705+
<p>A RAID logical volume can be used with XFS and Raw allocations.
1706+
NOTE: gfs2 allocations cannot use RAID logical volumes because the LV is shared.</p>
17061707
<p>To create a redundant LV, <code>--type raid[x]</code> and <code>--nosync</code> should be specified in the <code>lvcreate</code> command. Also, the <code>--stripes</code> parameter should be adjusted accordingly to specify the number of data stripes. For <code>raid5</code>, <code>$DEVICE_NUM-1</code> is used.</p>
1707-
<p>To allow the LV to be rebuilt after a replacement drive is added, <code>vgExtend</code>, <code>lvRepair</code>, and <code>vgReduce</code> should be specified in the <code>lvmRebuild</code> section.</p>
1708+
<p>To allow the LV to rebuild after a drive is replaced, <code>vgExtend</code>, <code>lvRepair</code>, and <code>vgReduce</code> should be specified in the <code>lvmRebuild</code> section.</p>
17081709
<p><div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nnf.cray.hpe.com/v1alpha8</span>
17091710
<a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">NnfStorageProfile</span>
17101711
<a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="nt">metadata</span><span class="p">:</span>

dev/search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)