PD-1135 Add Enclosure Options to Pool Creation Wizard Content

content/SCALE/SCALEUIReference/Storage/PoolCreateWizardScreens.md

@@ -17,17 +17,20 @@ The **Pool Creation Wizard** configuration screens include a configuration previ
 
 {{< trueimage src="/images/SCALE/Storage/PoolCreationWizard.png" alt="Pool Creation Wizard" id="Pool Creation Wizard" >}}
 
-**Configuration Preview** displays a list of pool and VDEV settings that dynamically update as you configure settings in the wizard.
+**Configuration Preview** lists pool and VDEV settings that dynamically update as you configure settings in the wizard.
 
 **Inventory** displays the number of available disks by size on the system, and this list dynamically updates as disks move to VDEVs added in the wizard.
 
 ## Pool Creation Wizard
-The **Pool Creation Wizard** has seven configuration screens, numbered in sequence, to create a pool with VDEVs.
+The **Pool Creation Wizard** for most systems has seven configuration screens, numbered in sequence, to create a pool with VDEVs.
+{{< enterprise>}}
+Larger iXsystems-provided servers for Enterprise users equipped with expansion shelves include the additional [**Enclosure Options**](#enclosure-options) screen.
+{{< /enterprise >}}
 
 Each wizard VDEV configuration screen includes the **Automated Disk Selection** and **Advanced Options** areas.
 Click **Manual Disk Selection** to open the **[Manual Selection](#manual-selection-screen)** screen.
 
-**Back** and **Next** move to either the previous or next wizard screen.
+**Back** and **Next** move to the previous or next wizard screen.
 **Reset Step** clears the VDEV settings for the VDEV type selected. For example, **Data** VDEV configuration.
 **Save And Go To Review** saves the current selections and goes directly to the **Review** wizard screen.
 
@@ -66,6 +69,25 @@ If system disks have non-unique serial numbers, a warning displays with addition
 **Allow** permits using disks with non-unique serial numbers, such as those that can occur on virtual disks, and displays them as available disks on the **Data** wizard screen.
 **Don't Allow** does not permit using disks with non-unique serial numbers.
 
+{{< enterprise >}}
+### Enclosure Options
+The **Enclosure Options** screen shows in the **Pool Creation Wizard** if the iXsystems hardware includes one or more expansion shelves.
+
+{{< trueimage src="/images/SCALE/Storage/PoolCreationWizardEnclosureOptionsScreen.png" alt="Pool Creation Wizard Enclosure Options" id="Pool Creation Wizard Enclosure Options" >}}
+
+The **Enclosure Options** screen shows three radio buttons that could apply a set pool storage configuration topology when using the **Automated Disk Selection** option to assign disks to a VDEV.
+
+* **No Enclosure Dispersal Strategy** does not apply a dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+  Does not show additional options. Disks added to the pool VDEVs are assigned in sequence based on disk availability and are not balanced across all enclosures.
+* **Maximum Dispersal Strategy** applies a maximum dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+  This balances disk selection across all enclosures and available disks.
+  Does not show additional options. Disks added to the pool VDEVs are spread across all available enclosure disks.
+* **Limit Pool To A Single Enclosure** applies a minimum dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+  Shows the **Enclosure** dropdown with a list of available expansion shelf options. Disks added to the pool VDEVs are spread across the enclosure disks that align with the selection in **Enclosure**.
+
+{{< trueimage src="/images/SCALE/Storage/PoolCreationWizardEnclosureOptionsLimitedToSingleEnclosure.png" alt="Enclosure Option Limit Pool to a Single Enclosure" id="Enclosure Option Limit Pool to a Single Enclosure" >}}
+
+{{< /enterprise >}}
 ### Data Screen
 The **Data** wizard screen includes the option to automatically or manually add disks to a data VDEV.
 You must add a data VDEV before you can add other types of VDEVs to the pool.

static/includes/CreatePool.md

@@ -6,6 +6,12 @@ Click **Create Pool** to open the **Pool Creation Wizard**.
 {{< include file="/static/includes/PoolCreationWizardCommonSettings.md" >}}
 {{< /expand >}}
 
+**Enclosure Option** only shows for iXsystems-provided systems with expansion shelves.
+
+{{< hint type="information" >}}
+You can rename your enclosure on the [Enclosure Screen]({{< relref "EnclosureScreensSCALE.md" >}}) to include the rack and U number in the name, which helps identify the physical location while in the pool creation screen.
+{{< /hint >}}
+
 1. Enter a name of up to 50 lowercase alpha-numeric characters.
    Use only the permitted special characters that conform to [ZFS naming conventions](https://docs.oracle.com/cd/E23824_01/html/821-1448/gbcpt.html).
    The pool name contributes to the maximum character length for datasets, so it is limited to 50 characters.
@@ -14,7 +20,23 @@ Click **Create Pool** to open the **Pool Creation Wizard**.
    You cannot change the pool name after creation.
    {{< /hint >}}
 
-2. Create the required data VDEV.
+2. (Enterprise systems only) Select the **Enclosure Option** to apply the dispersal strategy of your choice. Only shows for iXsystems-provided systems with expansion shelves.
+
+   {{< trueimage src="/images/SCALE/Storage/PoolCreationWizardEnclosureOptionsScreen.png" alt="Pool Creation Wizard Enclosure Options" id="Pool Creation Wizard Enclosure Options" >}}
+
+   **No Enclosure Dispersal Strategy** does not apply a dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+   Does not show additional options. Disks added to the pool VDEVs are assigned in sequence based on disk availability and are not balanced across all enclosures.
+
+   **Maximum Dispersal Strategy** applies a maximum dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+   This balances disk selection across all enclosures and available disks.
+   Does not show additional options. Disks added to the pool VDEVs are spread across all available enclosure disks.
+
+   **Limit Pool To A Single Enclosure** applies a minimum dispersal strategy in how the system adds disks by size and type to the pool VDEVs created when using the **Automated Disk Selection** option.
+   Select the expansion shelf option on the **Enclosure** dropdown. Disks added to the pool VDEVs are spread across the enclosure disks that align with the selection in **Enclosure**.
+
+   {{< trueimage src="/images/SCALE/Storage/PoolCreationWizardEnclosureOptionsLimitedToSingleEnclosure.png" alt="Enclosure Option Limit Pool to a Single Enclosure" id="Enclosure Option Limit Pool to a Single Enclosure" >}}
+
+3. Create the required data VDEV.
 
    Select the layout from the **Layout** dropdown list, then either use the **Automated Disk Selection** fields to select and add the disks, or click **Manual Disk Selection** to add specific disks to the chosen **Layout**.
 
@@ -24,6 +46,6 @@ Click **Create Pool** to open the **Pool Creation Wizard**.
 
    Click **Save And Go To Review** if you do not want to add other VDEV types to the pool, or click **Next** to move to the next wizard screens.
 
-3. Add any other optional VDEVs as determined by your specific storage redundancy and performance requirements.
+4. Add any other optional VDEVs as determined by your specific storage redundancy and performance requirements.
 
-4. Click **Create Pool** on the **Review** wizard screen to add the pool.
+5. Click **Create Pool** on the **Review** wizard screen to add the pool.