diff --git a/content/SCALE/GettingStarted/Migrate/MigratePrep.md b/content/SCALE/GettingStarted/Migrate/MigratePrep.md index d82d8fc88b..5b461d7a74 100644 --- a/content/SCALE/GettingStarted/Migrate/MigratePrep.md +++ b/content/SCALE/GettingStarted/Migrate/MigratePrep.md @@ -21,16 +21,16 @@ keywords: ## Preparing for Migration Read this article before you attempt to migrate your FreeBSD-based system to a Linux-based TrueNAS version. {{< hint type="warning" title="Using USB Devices for Backups" >}} -We strongly recommend not using USB flash drives or USB-attached drives for backups as these can have issues, including with recovering backed up files. +We strongly recommend not using USB flash drives or USB-attached drives for backups as these can have issues, including with recovering backed-up files. For more information on using USB drives and devices in general, read the [Hardware Guide]({{< relref "scalehardwareguide.md" >}}). -If you must use a USB type device, verify you can access files on the device before you migrate. +If you must use a USB-type device, verify you can access files on the device before you migrate. {{< /hint >}} {{< enterprise >}} Enterprise customers are encouraged to contact Support for assistance with the process of moving from a FreeBSD-based (13.3 or earlier) to a Linux-based (22.12 or newer) TrueNAS version, especially customers with HA systems. {{< /enterprise >}} 1. Upgrade your system to either the latest 13.0 or 13.3 release. - TrueNAS Enterprise-licensed (or community systems that haven't switched to 13.3) systems on 12.0x or earlier should upgrade to the latest 13.0 release (e.g 13.0-U6.2 or newer) prior to migration. + TrueNAS Enterprise-licensed (or community systems that haven't switched to 13.3) systems on 12.0x or earlier should upgrade to the latest 13.0 release (e.g. 13.0-U6.2 or newer) before migration. Community users with 13.3 installed should update to the latest maintenance release of that version prior to migration. Either major version can use the [iso upgrade](#migrating-using-an-iso-file-to-upgrade) method for migration. @@ -38,7 +38,7 @@ Enterprise customers are encouraged to contact Support for assistance with the p If you do not migrate from GELI to ZFS encryption before upgrading to 13.0-U6.2 (or newer) or migrating to TrueNAS 24.04, you permanently lose access to the data in the GELI encrypted pool(s). 3. Verify the root user is not locked. - Go to **Accounts > Users**, select the root user and click **Edit** to view current settings and confirm **Lock User** is not selected. + Go to **Accounts > Users**, select the root user, and click **Edit** to view current settings and confirm **Lock User** is not selected. 4. Write down, copy, or take screenshots of settings to duplicate after migrating or use in the event of a post-upgrade/migration issue. Use the checklist below to guide you through this step: @@ -48,7 +48,7 @@ Enterprise customers are encouraged to contact Support for assistance with the p Deprecated services - Record the settings for [services deprecated in newer TrueNAS versions](#deprecated-services). - VMs - If you have virtual machines configured, write down or screenshot network, bootloader, and other setting information. + VMs - If you have virtual machines configured, write down or screenshot the network, bootloader, and other setting information. Plugins or jails - Plugins and jails do not migrate. Record settings for each plugin/jail and back up the data associated with each. @@ -66,11 +66,11 @@ Enterprise customers are encouraged to contact Support for assistance with the p Credentials - Copy or write down the credentials for SSH connections and keypairs, and any configured cloud service backup providers if you do not have the credential settings saved in other files kept secured outside of TrueNAS. - Data protection tasks - Write down or take screenshots of replication, periodic snapshot, cloud sync, or other task settings to reconfigure these after migrating. + Data protection tasks - Write down or take screenshots of replication, periodic snapshots, cloud sync, or other task settings to reconfigure these after migrating. 5. Remove all SMB auxiliary parameter settings before migrating. - In TrueNAS 23.10 (Cobia) or newer, the SMB **Auxiliary Parameters** option is not available in the UI. - Attempting to migrate with these settings can result in broken SMB shares post upgrade that require CLI access to fix. + In TrueNAS 23.10 (Cobia) or newer, the SMB **Auxiliary Parameters** option is unavailable in the UI. + Attempting to migrate with these settings can result in broken SMB shares post-upgrade that require CLI access to fix. 6. Write down or take screenshots of your network configuration information. Capture the global network settings, interfaces (LAGG, VLAN, bridge settings), static IP addresses, and aliases. @@ -92,14 +92,19 @@ Enterprise customers are encouraged to contact Support for assistance with the p 8. Back up any critical data. 9. Download your [system configuration file](https://www.truenas.com/docs/core/coretutorials/systemconfiguration/usingconfigurationbackups/) and a [debug file](https://www.truenas.com/docs/core/uireference/system/advanced/). - After updating to the latest publicly-available release of TrueNAS 13.0 (or 13.3 for community users) and making any changes to user accounts or any other settings, download these files and keep them in a safe place and where you can access them if you need to revert with a clean install using the TrueNAS 13.0 or 13.3 iso file. + After updating to the latest publicly available release of TrueNAS 13.0 (or 13.3 for community users) and making any changes to user accounts or any other settings, download these files and keep them in a safe place and where you can access them if you need to revert with a clean install using the TrueNAS 13.0 or 13.3 iso file. -After completing the steps listed above that apply to your existing system, download the latest [TrueNAS 24.04 ISO file](https://www.truenas.com/download-tn-scale/) and save it to your computer. -See [Software Releases]({{< relref "TrueNASUpgrades/_index.md #upgrade-paths" >}}) for current recommended update paths to make sure you download and migrate to and from the correct TrueNAS versions. +{{< enterprise >}} +Enterprise customers using iSCSI with ALUA or fibre channel ports should contact Support for assistance with migrating their systems. +These features require careful configuration to avoid data corruption or loss of data. +{{< /enterprise>}} + +After completing the steps listed above that apply to your existing system, download the latest [TrueNAS ISO file](https://www.truenas.com/download-tn-scale/) and save it to your computer. +See [Software Releases]({{< relref "TrueNASUpgrades/_index.md #upgrade-paths" >}}) for currently recommended update paths to make sure you download and migrate to and from the correct TrueNAS versions. Burn the iso to a USB drive (see [**Installing on Physical Hardware**]({{< relref "InstallingSCALE.md#installing-on-physical-hardware" >}})) when upgrading a physical system. ## Deprecated Services -The built-in services listed in this section are available in 13.0, but deprecated in 22.12.3 (Bluefin) and removed in later TrueNAS releases. +The built-in services listed in this section are available in 13.0 but deprecated in 22.12.3 (Bluefin) and removed in later TrueNAS releases. They require attention before attempting to migrate to 24.04. Each of the sections has information that can help you determine the best steps forward to secure any critical data before attempting to migrate from 13.0 to 24.04. @@ -167,4 +172,4 @@ To grant access to a specific user (and group) other than using the default admi Note the UID and GID for this new user to enter in the application configuration screen. After disabling the WebDAV service and clearing any existing share configurations from the **Shares > WebDAV** screen in Bluefin, install the **WebDAV** application to recreate your shares using the service settings from your notes. Use the **webdav** user and group in control, and the UID and GID (**666**) in the application. -{{< /expand >}} \ No newline at end of file +{{< /expand >}} diff --git a/content/SCALE/SCALETutorials/Shares/iSCSI/SettingUpFibreChannel.md b/content/SCALE/SCALETutorials/Shares/iSCSI/SettingUpFibreChannel.md new file mode 100644 index 0000000000..98f88adbd6 --- /dev/null +++ b/content/SCALE/SCALETutorials/Shares/iSCSI/SettingUpFibreChannel.md @@ -0,0 +1,78 @@ +--- +title: "Setting Up Fibre Channel" +description: "Provides instructions on setting up Fibre Channel on TrueNAS." +weight: 40 +tags: +- fibre channel +- iSCSI +- shares +- block shares +--- + + +{{< enterprise >}} +Fibre Channel is a TrueNAS Enterprise feature. Only TrueNAS systems licensed for Fibre Channel show iSCSI Fibre Channel screens and settings found by going to **Sharing > Block Shares (iSCSI)**. +{{< /enterprise >}} + +The Fibre Channel feature is available to Enterprise-licensed High Availability (HA) and non-HA systems. +Any Enterprise system, equipped with the required fibre channel hardware can implement this feature. + +This article provides instructions for VMware VCenter ESXi. +If you are using a different platform for your block share backups, use the documentation for that platform for alternative instructions for the ESXi process documented in this tutorial. +. +## Before You Begin + +When setting up iSCSI fibre channel for the first time: + +* (Optional) Create a zvol for each fibre channel port with a network interface associated with it. + + The wizard provides an option to create a dataset on the **Extents** screen when adding the device. + Selecting this option creates a dataset for organizational purposes and a zvol of the same name for block storage. + +## Configuring Fibre Channel - First-Time Install + +We recommend using the iSCSI wizard to create your target, create the extents, and set up fibre channel ports. + +If the system is a High Availability (HA) system, turn on ALUA. + +Click on the iSCSI widget header to open the **Sharing iSCSI** screens. Click on **Global Target Configuration**. Scroll down and select **Asynchronous Logic Unit Access (ALUA)**, then click **Save**. + +{{< trueimage src="/images/SCALE/Shares/GlobalTargetConfigurationScreeninHA.png" alt="iSCSI Global Target Configuration Screenl" id="iSCSI Global Target Configuration Screen" >}} + +Next and for all systems, go to **Shares** and click **Wizard** on the iSCSI widget to open the wizard. + +1. Select **Fibre Channel** as the target mode, then select **Create New** in **Target**. Click **Next** to show the **Extents** screen. + + {{< trueimage src="/images/SCALE/Shares/iSCSIWizardTargetScreenFC.png" alt="iSCSI Wizard Target Screen - Fibre Channel" id="iSCSI Wizard Target Screen - Fibre Channel" >}} + +2. Configure the extent. + + a. Enter a name for the target in **Name**. + + b. Select **Device** in **Extent Type**, then select **Create New** on the **Device** dropdown list. + When selecting **Create New**, the **Pool/Dataset** and **/mnt** fields display. + Navigate through the pool and datasets to select the zvol and populate the **/mnt** field with the path. + + {{< trueimage src="/images/SCALE/Shares/iSCSIWizardExtentScreenFCAddNew.png" alt="iSCSI Extents Screen - Fibre Channel" id="iSCSI Extents Screen - Fibre Channel" >}} + + Clicking **Create Dataset** allows you to add a dataset where the **/mnt** path indicates. TrueNAS creates the dataset for organizational purposes and a zvol of the same name for block storage. + + c. Enter a value in **Size**. + + d. Select the platform option that matches your use case and for this iSCSI share on the **Sharing Platform** dropdown list. + For example, if using the VMware ESXi platform for your block storage, select **VMware: Extent block size 512b, TCP enabled, no Xen compat mode, SSD speed**. + + e. Click **Next** to show the **Protocol Options** screen. + +3. Select the protocol option for your use case. + When installing iSCSI fibre channel ports the first time, select **Create new virtual port**. + + {{< trueimage src="/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenCreateNewVirtualPort.png" alt="iSCSI Wizard Protocol Options Create New Virtual Port" id="iSCSI Wizard Protocol Options Create New Virtual Port" >}} + +4. Click **Save**. + +5. Start the iSCSI service when prompted. + If you did not stop the iSCSI service, restart it by clicking the more_vert button, stop the service, and when the status indicates it is stopped, start it. + +6. Log into your block storage backup platform (i.e., VCenter ESXi) and configure your adaptors, devices, and datastores. + Refer to VMWare or documentation for the platform used for instructions on completing the configuration. diff --git a/content/SCALE/SCALEUIReference/Shares/FibreChannelScreens.md b/content/SCALE/SCALEUIReference/Shares/FibreChannelScreens.md new file mode 100644 index 0000000000..e7153804f9 --- /dev/null +++ b/content/SCALE/SCALEUIReference/Shares/FibreChannelScreens.md @@ -0,0 +1,234 @@ +--- +title: "Fibre Channel Screens" +description: "Provides information on iSCSI Fibre Channel screens and settings." +weight: 45 +aliases: +tags: +- iscsi +- shares +- fibre channel +- block shares +--- + + +{{< enterprise >}} +Fibre Channel is a TrueNAS Enterprise feature. Only TrueNAS systems licensed for Fibre Channel show iSCSI Fibre Channel screens and settings found by going to **Sharing > Block Shares (iSCSI)**. +{{< /enterprise >}} + +Enterprise systems with fibre channel hardware can access fibre channel settings and screens through various iSCSI wizard and share screens. + +## iSCSI Wizard Screens - Fibre Channel. + +The **Block (iSCSI) Shares Targets** widget shows iSCSI shares configured for fibre channels. +The **Wizard** button on the header opens the **Wizard iSCSI** wizard on the **Target** screen. See [Target Screens - Fibre Channel](#iscsi-wizard-target-screen---fibre-channel) below. + +{{< trueimage src="/images/SCALE/Shares/SharesScreenFC.png" alt="Block (iSCSI) Shares Targets Widget with Fibre Channel" id="Block (iSCSI) Shares Targets Widget with Fibre Channel" >}} + +The more_vert icon button shows two options: a toggle for **Turn On Service**/**Turn Off Service** and **Config Service**. +**Config Service** opens the **[iSCSI Global Configuration]({{< relref "iSCSISharesScreens.md #iscsi-global-configuration-screen" >}})** screen. + +### iSCSI Target Wizard Screen - Fibre Channel + +The **Wizard** button opens the iSCSI wizard on the **Targets** screen with the **Fibre Channel** option. The wizard has three screens: + +* **Target** +* **Extent** +* **Protocol Options** + +To access the individual iSCSI screens click on the iSCSI widget header. +The **Targets** screen opens by default. +For more information on iSCSI screens and settings, see [**iSCSI Screens - Fibre Channel**](#iscsi-share-screens---fibre-channel) below. + +**Next** advances to the next wizard screen. **Back** shows the previous wizard screen. **Save** creates the iSCSI share. + +### iSCSI Wizard Target Screen - Fibre Channel + +The **iSCSI Wizard** opens showing the **Target** screen with the **Fibre Channel** option. Select to configure the target for fibre channel. + +{{< trueimage src="/images/SCALE/Shares/iSCSIWizardTargetScreenFC.png" alt="iSCSI Wizard Target Screen - Fibre Channel" id="iSCSI Wizard Target Screen - Fibre Channel" >}} + +The **Target** dropdown shows the default **Create New**. Selecting **Create New** creates a share. Selecting an existing target from the dropdown list allows you to edit that target. + +### iSCSI Wizard Extent Screen - Fibre Channel + +{{< include file="/static/includes/iSCSIWizardExtentScreen.md" >}} + +### iSCSI Wizard Protocol Options Screen - Fibre Channel + +The iSCSI wizard **Protocol Options** screen for fibre channel shows three setting options to configure fibre channel ports and initiators. + +{{< trueimage src="/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenCreateNewVirtualPort.png" alt="iSCSI Wizard Protocol Options Create New Virtual Port" id="iSCSI Wizard Protocol Options Create New Virtual Port" >}} + +{{< expand "Wizard Protocol Options for Fibre Channel Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Do not connect to a fibre channel port** | Select to configure the share to not connect to a fibre channel port. | +| **Use an existing port** | Select to connect the share to an existing fibre channel port. | +| **Create a new virtual port** | Select to create a new virtual port. Shows the **Create a new virtual port** field. Select from the options on the dropdown list. | +{{< /truetable >}} +{{< /expand >}} + +## iSCSI Share Screens - Fibre Channel + +Clicking on the iSCSI widget header opens the iSCSI share screens. + +**Global Target Configuration** opens the iSCSI service configuration screen. + +**Wizard** opens the iSCSI wizard configuration screens. + +The iSCSI shares screen opens showing **Targets** by default. + +Six tabs show for each of the following screens: **Targets**, **Extents**, **Initiators**, **Portals**, **Authorized Access**, and **Fibre Channel Ports**. +Each shows what is configured on the system, and provides access to the add and edit configuration screens for each functional area. + +### iSCSI Global Configuration Screen + +{{< include file="/static/includes/iSCSIGlobalConfigurationScreen.md" >}} + +### Targets Screens - Fibre Channel + +The **iSCSI Targets** screen shows a list of targets configured in the system and provides access to the add and edit configuration screens. Select a target to see details about that item. + +{{< trueimage src="/images/SCALE/Shares/iSCSITargetsScreenwFC.png" alt="iSCSI Targets Screen - Fibre Channel" id="iSCSI Wizard Targets Screen - Fibre Channel" >}} + +**Add** and **Edit** open the configuration screen for the selected target. +**Delete** opens a dialog with delete options. + +#### Details for Target + +The screen shows four widgets on the right side of the screen for the selected target: **Fibre Channel Port**, **Fibre Channel Connections**, **Extents**, and **iSCSI Connections**. + +**Fibre Channel Port** shows the fibre channel port showing the two HA assignments configured on the system, one for the HA primary controller and the other for the standby controller. These are created when you add the targets for an HA system or migrate existing from an earlier TrueNAS (13.0 or 13.3) release to the latest release. + +**Fibre Channel Connections** shows the schema name for the ports assigned to each controller in an HA system. + +**Extents** shows a list of LUNs, and includes two options: [**Associate** button](#associate-dialog) and a [**Remove Extent Association**](#remove-extent-association) link_off icon. + +**iSCSI Connections** shows a list of the connections configured on the system. + +#### Delete Target Dialog + +{{< include file="/static/includes/iSCSITargetDelete.md" >}} + +#### Remove Extent Association Dialog + +{{< include file="/static/includes/iSCSIRemoveExtentAssociation.md" >}} + +#### Associate Dialog + +{{< include file="/static/includes/iSCSITargetAssociate.md" >}} + +#### Add and Edit iSCSI Target Screens - Fibre Channel + +The **Add Target** and **Edit Target** screens show the same configuration settings. + +{{< columns >}} +{{< trueimage src="/images/SCALE/Shares/AddiSCSITargetFC.png" alt="Add iSCSI Target Screen - Fibre Channel" id="Add iSCSI Target Screen - Fibre Channel" >}} +<---> +{{< trueimage src="/images/SCALE/Shares/EditiSCSITargetFC.png" alt="Edit iSCSI Target Screen - Fibre Channel" id="Edit iSCSI Target Screen - Fibre Channel" >}} +{{< /columns >}} + +{{< expand "Target Basic Info Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Target Name** | Enter the name for the target using up to 64 lowercase alphanumeric and special characters. Allowed characters are dot (.), dash (-), and colon (:). A name longer than 64 characters is not allowed. See the “Constructing iSCSI names using the iqn.format” section of [RFC3721](https://tools.ietf.org/html/rfc3721.html). The base name (from Target Global Configuration) is automatically prepended if the target name does not start with iqn. | +| **Target Alias** | Enter an optional user-friendly name. | +| **Mode** | **Mode** shows three options for a target:
  • **iSCSI** - Select to create a standard iSCSI share target.
  • **Fibre Channel** - Select to configure an iSCSI target that includes fibre channel.
  • **Both** - Select to use both modes.
    • | +| **Authorized Networks** | Authorized networks allow communication between initiators (client computers) and iSCSI targets (storage devices) over the IP network. **Add** shows the **Network** field. | +| **Network** | Shows after clicking **Add** to the right of **Authorized Networks**. Enter the IP address for the network and select the netmask (CIDR) from the dropdown list. Adds the network address to the authorized network list. | +| **Do not connect to a fibre channel port** | Select to create an iSCSI share and target withoug fibre channel. | +| **Use an existing port** | Select to use an existing iSCSI port(s) already configured on the system. Select when migrating an existing TrueNAS FreeBSD-based iSCSI fibre channel configuration to a later TruenNAS Debian Linux-based release. Shows a dropdown list with existing ports. | +| **Create new virtual port** | Select to create a new virtual iSCSI port for fibre channel configuration. Use when setting up a new iSCSI share target and fibre channel ports. Shows the **Create a new virtual port** field. Select from the options on the dropdown list. | +{{< /truetable >}} +{{< /expand >}} + +{{< include file="/static/includes/TargetiSCSIGroupSettings.md" >}} + +### Extents Screens - Fibre Channel + +The **Extents** screen shows a table listing extents configured on the system. Extents are shared storage units. + +{{< trueimage src="/images/SCALE/Shares/iSCSIExtentsScreenFC.png" alt="iSCSI Extents Screen - Fibre Channel" id="iSCSI Extents Screen - Fibre Channel" >}} + +**Add** and **Edit** open the configuration screen for the selected target. +**Delete** opens a dialog with delete options. + +#### Delete Extent Dialog + +{{< include file="/static/includes/iSCSIDeleteExtent.md" >}} + +#### Add or Edit Extent Screens - Fibre Channel + +{{< include file="/static/includes/iSCSIAddEditExtentSettings.md" >}} + +### Initiators Screens - Fibre Channel + +The **Initiators Groups** screen shows a table listing initiator groups configured on the system. + +{{< trueimage src="/images/SCALE/Shares/iSCSIInitiatorsScreenFC.png" alt="iSCSI Initiator Screen - Fibre Channel" id="iSCSI Initiator Screen - Fibre Channel" >}} + +**Add** opens the **Add Initiator** screen. +**Edit** opens a version of the **Add Initiator** screen with only two fields. +**Delete** opens a dialog to delete an initiator group. + +#### Add Initiator Screen - Fibre Channel + +{{< include file="/static/includes/iSCSIAddInitiatorSettings.md" >}} + +#### Edit Initiator Screen - Fibre Channel + +{{< include file="/static/includes/iSCSIEditInitiatorSettings.md" >}} + +### Portal Screens - Fibre Channel + +The configuration tabs **Portals** screen displays a list of portal ID groups on the TrueNAS system. + +{{< trueimage src="/images/SCALE/Shares/iSCSIPortalsScreenFC.png" alt="iSCSI Portals Screen - Fibre Channel" id="iSCSI Portals Screen - Fibre Channel" >}} + +**Delete** opens the **Delete** dialog for the selected portal ID. Click **Confirm** and then **Delete** to delete the selected portal. + +**Add** opens the **Add Portal** screen. **Edit** opens the **Edit Portal** screen. Both screens have the same setting options. + +#### Add and Edit Portal Screens - Fibre Channel + +{{< include file="/static/includes/iSCSIAddEditPortalsScreens.md" >}} + +### Authorized Access Screens - Fibre Channel + +The **Authorized Access** screen displays settings to create new authorized access networks or edit existing ones in the list. + +If you have not set up authorized access yet, the **No Authorized Access** screen displays with the **Add Authorized Access** button in the center of the screen. **Add Authorized Access** or **Add** at the top of the screen opens the **Add Authorized Access** screen. + +{{< trueimage src="/images/SCALE/Shares/iSCSAuthorizedAccessScreenFC.png" alt="iSCSI Authorized Access Screen - Fibre Channel" id="iSCSI Authorized Access Screen - Fibre Channel" >}} + +After adding authorized access to the system, the **Authorized Access** screen displays a list of users. +**Delete** opens the **Delete** dialog for the selected portal ID. **Confirm** enables the delete option. +**Delete** deletes the selected portal and closes the dialog. + +**Add** opens the **Add Authorized Access** screen. + +**Edit** opens the **Edit Authorized Access** screen. **Delete** opens a dialog to delete the authorized access for the selected user. + +The **Add** and **Edit** screens display the same settings. + +#### Add Authorized Access Screen - Fibre Channel + +{{< include file="/static/includes/iSCSIAddEditAuthorizedAccesssScreens.md" >}} + +### Fibre Channel Ports Screens + +The **Fibre Channel Ports** screen shows a table listing fibre channels configured on the system. Virtual ports show as child elements to physical ports. + +{{< trueimage src="/images/SCALE/Shares/iSCSIFibreChannelPortsScreen.png" alt="iSCSI Fibre Channel Ports Screen" id="iSCSI Fibre Channel Ports Screen" >}} + +Ports are configured while setting up targets and extents. When migrating from earlier versions of TrueNAS, ports map from the earlier release to the latest TrueNAS release. + +The **Edit** icon opens the **Change Number of Virtual Ports** dialog. + +#### Change Number of Virtual Ports Dialog + +The **Change Number of Virtual Ports** dialog shows the **Virtual Ports** field where you enter a numeric value to specify the number of ports for the selected fibre channel. + +{{< trueimage src="/images/SCALE/Shares/ChangeNumberofVirtualPortsDialog.png" alt="Change Number of Virtual Ports Dialog" id="Change Number of Virtual Ports Dialog" >}} diff --git a/content/SCALE/SCALEUIReference/Shares/iSCSISharesScreens.md b/content/SCALE/SCALEUIReference/Shares/iSCSISharesScreens.md index fea8d582f8..305b2fa72d 100644 --- a/content/SCALE/SCALEUIReference/Shares/iSCSISharesScreens.md +++ b/content/SCALE/SCALEUIReference/Shares/iSCSISharesScreens.md @@ -18,7 +18,7 @@ The **Sharing** screen opens after you click **Shares** on the main navigation p ## Block (iSCSI) Shares Targets Widget The **Block (iSCSI) Shares Targets** widget header shows the status of the iSCSI service, the **Wizard** button, and the more_vert icon button. -**Wizard** opens the **Wizard iSCSI** wizard on the **Target** screen. See []() below. +**Wizard** opens the **Wizard iSCSI** wizard on the **Target** screen. See [Target Screens](#targets-screens) below. {{< trueimage src="/images/SCALE/Shares/iSCSIBlockSharesWidget.png" alt="Block (iSCSI) Share Target Widget Toolbar" id="Block (iSCSI) Share Target Widget Toolbar" >}} @@ -35,56 +35,41 @@ Click anywhere on **Block (iSCSI) Shares Targets la {{< trueimage src="/images/SCALE/Shares/iSCSITargetsScreen.png" alt="iSCSI Target Screen" id="iSCSI Target Screen" >}} **Add** opens the **[Add ISCSI Target](#add-and-edit-iscsi-target-screens)** screen. -**Edit** opens the **[Edit iSCSI Target]()** screen. +**Edit** opens the **[Edit iSCSI Target](#add-or-edit-target-screens)** screen. ## iSCSI Wizard Screens + The **Wizard** button opens the iSCSI wizard on the **Targets** screen. The wizard has three screens: * **Target** * **Extent** * **Protocol Options** -The individual iSCSI screens are accessed by clicking on the iSCSI widget header an alternative to the **iSCSI Wizard**. +The individual iSCSI screens are accessed by clicking on the iSCSI widget header. The **Targets** screen opens by default. -For more information on iSCSI screens and settings, see [**iSCSI Screens**]() below. +For more information on iSCSI screens and settings, see [**Shares iSCSI Screens**](#shares-iscsi-screens) below. + +**Next** advances to the next wizard screen. **Back** shows the previous wizard screen. **Save** creates the iSCSI share. ### iSCSI Wizard Target Screen -The **iSCSI Wizard** opens showing the **Target** screen. -The **Target** dropdown shows the default **Create New**. Select to create a new target, or select an existing target from the dropdown list to edit it. +The **iSCSI Wizard** opens showing the **Target** screen. {{< trueimage src="/images/SCALE/Shares/iSCSIWizardTargetScreen.png" alt="iSCSI Wizard Target Screen" id="iSCSI Wizard Target Screen" >}} +The **Target** dropdown shows the default **Create New**. Selecting **Create New** creates a share, or selecting an existing target from the dropdown list allows you to edit it. + ### iSCSI Wizard Extent Screen -The iSCSI wizard **Extent** screen shows settings to name the share, set the type of extent devices, and the sharing platform for the device. -{{< columns >}} -{{< trueimage src="/images/SCALE/Shares/iSCSIWizardExtentCreateNewDevice.png" alt="iSCSI Wizard Extent Screen Devices Settings" id="iSCSI Wizard Extent Screen Device Settings" >}} -<---> -{{< trueimage src="/images/SCALE/Shares/iSCSIWizardExtendFileType.png" alt="iSCSI Wizard Extent Screen File Settings" id="iSCSI Wizard Extent Screen File Settings" >}} -{{< /columns >}} +{{< include file="/static/includes/iSCSIWizardExtentScreen.md" >}} -{{< expand "Wizard Extent Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Name** | The name given to the iSCSI block share. Enter a name using up to 64 lowercase alphanumeric and special characters. Allowed characters are dot (.), dash (-), and colon (:). A name longer than 64 characters is not allowed. See the "Constructing iSCSI names using the iqn.format" section of [RFC3721](https://tools.ietf.org/html/rfc3721.html). The base name (**from Target Global Configuration**) is automatically prepended if the target name does not start with **iqn**. | -| **Extent Type** | Has two options: **Device** and **File**. Select an option to show other settings for each option. | -| **Device** | Shows if **Extent Type** is set to **Device**. Shows **Create New** or a list of iSCSI devices added to the system. **Create New** shows additional settings. | -| **Pool/Dataset** | Shows after selecting **Create New** in **Device**. Enter or browse to select the path to the mount point. Browsing to select the dataset activates the **Create Dataset** option. Click to open the **Create Dataset** dialog, which creates a zvol. | -| **Size** | Shows after clicking **Create New** in **Device** and after adding the mount point in **Pool/Dataset**. Enter a numerical value and suffix to specify the size of the zvol you are creating. | -| **Path to the Extent** | Shows if **Extent Type** is set to **File**. Enter or browse to select the mount point for the directory the extent uses. If a directory does not exist, after selecting the dataset where you want to add the directory, then enter a **/** followed by the name to add the directory to the dataset. | -| **Filesize** | Shows if the **Extent Type** is set to **File**. Enter the size for the directory. Leaving this set to **0** uses the actual file size and requires the file to exist. Otherwise, specify the file size for the new file. | -| **Sharing Platform** | Shows for both options. Select the platform that matches your use case. Options are:
  • **VMware: Extent block size 512b, TCP enabled, no Zen compat mode, SSD speed**
  • **Xen: Extent block size 512b, TCP enabled, Xen compat mode enabled, SSD speed**
  • **Legacy OS: Extent block size 512b, TCP enabled, no Xen compat mode, SSD speed**
  • **Modern OS: Extent block size 4k, TCP enabled, no Xen compat mode, SSD speed**
    • | -{{< /truetable >}} -{{< /expand >}} - ### iSCSI Wizard Protocol Options Screen + The iSCSI wizard **Protocol Options** screen shows settings to add a portal and initiators. If a portal does not exist, create one by selecting **Create New**. {{< trueimage src="/images/SCALE/Shares/iSCSIWizardProtocolOptionsCreateNewPortal.png" alt="iSCSI Wizard Protocol Options Screen Portal Settings" id="iSCSI Wizard Protocol Options Screen Portal Settings" >}} -{{< expand "Wizard Portal Settings" "v" >}} +{{< expand "Wizard Protocol Options Settings" "v" >}} {{< truetable >}} | Setting | Description | |---------|-------------| @@ -95,31 +80,24 @@ The iSCSI wizard **Protocol Options** screen shows settings to add a portal and {{< /expand >}} ## Shares iSCSI Screens -iSCSI share screens open after clicking on the iSCSI widget header. -The **Global Target Configuration** opens the iSCSI service configuration screen. + +Clicking on the iSCSI widget header opens the iSCSI share screens. + +**Global Target Configuration** opens the iSCSI service configuration screen. + **Wizard** opens the iSCSI wizard configuration screens. -It shows five tabs: *Targets**, **Extents**, **Initiators**, **Portals**, and **Authorized Access**. Each provides access to the iSCSI configuration information, and access to the add and edit configuration screens for each functional area. +The iSCSI shares screen opens showing **Targets** by default. -The **Sharing > iSCSI** screen opens with the **Targets** tab showing. +Five tabs show for each of the following screens: **Targets**, **Extents**, **Initiators**, **Portals**, and **Authorized Access**. +Each shows what is configured on the system, and provides access to the add and edit configuration screens for each functional area. ### iSCSI Global Configuration Screen -The **iSCSI Global Configuration** screen opens when you click **Edit** on the **iSCSI Service** row of the **System > Services** screen, and the **Global Target Configuration** button at the top of all iSCSI share screens. - -{{< trueimage src="/images/SCALE/Shares/iSCSIGlobalConfigurationScreen.png" alt="iSCSI Global Configuration Screen" id="iSCSI Global Configuration Screen" >}} -{{< expand "Global Configuration Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Base Name** | Enter a name using lowercase alphanumeric characters. Allowed special characters are dot (.), dash (-), and colon (:). See the "Constructing iSCSI names using the iqn.format" section [RFC3721](https://tools.ietf.org/html/rfc3721.html) for more information. | -| **ISNS Servers** | Enter host names or IP addresses of the ISNS servers to be registered with the iSCSI targets and portals of the system. Press Enter to separate each entry. | -| **Pool Available Space Threshold (%)** | Generate an alert when the pool reaches this percentage of space remaining. This is typically configured at the pool level when using zvols or at the extent level for both file and device-based extents. | -| **iSCSI listen port** | TCP port used to access the iSCSI target. The default is **3260**. | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/iSCSIGlobalConfigurationScreen.md" >}} ### Targets Screens + The **iSCSI Targets** screen shows a list of targets configured in the system and provides access to the add and edit configuration screens. Select a target to see details about that item. {{< trueimage src="/images/SCALE/Shares/iSCSITargetsScreen.png" alt="iSCSI Targets Screen" id="iSCSI Wizard Targets Screen" >}} @@ -128,6 +106,7 @@ The **iSCSI Targets** screen shows a list of targets configured in the system an **Delete** opens a dialog with delete options. #### Details for Target + The screen shows three widgets on the right side of the screen for the selected target: **iSCSI Authorized Networks**, **Extents**, and **iSCSI Connections**. **iSCSI Authorized Networks** shows a list of authorized networks configured when you create the target. Edit the target to add networks to an existing target. @@ -137,33 +116,19 @@ The screen shows three widgets on the right side of the screen for the selected **iSCSI Connections** shows a list of the connections configured on the system. #### Delete Target Dialog -**Delete** opens a confiration dialog with two options: **Delete *1* associated extent** and **Force Delete**. Select the options to include in the delete operation. -{{< trueimage src="/images/SCALE/Shares/DeleteiSCSITargetdialog.png" alt="iSCSI Target Delete Dialog" id="iSCSI Target Delete Dialog" >}} - -**Delete *1* associated extent** shows the number of associated extend for the selected target. - -**Force Delete** deletes the target even if the share is still in use. - -**Cancel** closes the dialog without deleting. -**Delete** deletes the target but does not delete the iSCSI volumes associated with the extents. +{{< include file="/static/includes/iSCSITargetDelete.md" >}} #### Remove Extent Association Dialog -The **Remove Extent Association** link_off icon opens the **Remove extent association** dialog that shows the LUN link association and two buttons: **Cancel** and **Remove**. Removing the association activates the **Associate** button on the widget. -{{< trueimage src="/images/SCALE/Shares/RemoveExtentAssociationDialog.png" alt="Remove Extent Association Dialog" id="Remove Extent Association Dialog" >}} +{{< include file="/static/includes/iSCSIRemoveExtentAssociation.md" >}} #### Associate Dialog -The **Associate** button is inactive when the extent is associated with a LUN. Removing the association activates the button. Clicking the button opens the **Associate *target*** dialog. -{{< trueimage src="/images/SCALE/Shares/ISCSIExtentAssociateDialog.png" alt="Extent Associate Dialog" id="Extent Associate Dialog" >}} - -Enter a LUN ID between 0 and 1023 into **LUN ID**. SCALE requires at least one LUN 0. -Some initiators expect a value between 0 and 256. Leaving this field blank automatically assigns the next available ID. - -Select the target on the **Extent** dropdown list. +{{< include file="/static/includes/iSCSITargetAssociate.md" >}} #### Add or Edit Target Screens + The **Add Target** and **Edit Target** screens show the same configuration settings. {{< columns >}} @@ -183,19 +148,10 @@ The **Add Target** and **Edit Target** screens show the same configuration setti {{< /truetable >}} {{< /expand >}} -{{< expand "Target iSCSI Group Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Add Groups** | Adds a collection of network interfaces, IP addresses, and TCP ports, on a storage device that an iSCSI initiator can connect to. Groups are also known as target portal groups. **Add** shows a group configuration field each time it is clicked. | -| **Portal Group ID** | Select the ID from the dropdown list. Shows a group for each iSCSI share added to the system with a number assignment, for example, *1 (test2)* for the test2 target/share. Portal groups are created on the **Add Portal** screen. | -| **Initiator Group ID** | Select the group ID from the dropdown list. Shows a group for each portal ID configured on the system, for example, *1 (ALL Initiators Allowed). Initiator groups have access to the target. | -| **Authentication Method** | Select the authentication method from the dropdown list of options. Options are:
  • **None** - Select to allow anonymous discovery. When set to **None** you can leave **Discovery Authentication Group** set to **None** or empty.
  • **CHAP** - Select to use the Challenge Handshake Authentication Protocol (CHAP) method. CHAP verifies the identity of an iSCSI initiator (device trying to access storage) by sending a challenge that only the authentic initiator can correctly respond to. This prevents unauthorized access to the storage target. Think of it like a password-based authentication system for iSCSI connections. When set to CHAP you must enter or create a new group in **Discovery Authentication** on the **Add** or **Edit Authorized Access** screen.
  • **Mutual CHAP**- Select to use CHAP where both the iSCSI initiator (client) and target server mutually authenticate each other using the CHAP method. Each side verifies the identity of the other before establishing a connection. This provides a higher level of security compared to one-way CHAP. When set to mutual CHAP you must enter or create a new group in **Discovery Authentication** on the **Add** or **Edit Authorized Access** screen.
    • | -| **Authentication Group Number** | Select the group from the dropdown list. An authentication group is configured on the **Add Authorized Access** screen. Required when the **Discovery Authentication Method** is set to **CHAP** or **Mutual CHAP**. Select **None** or the value representing the number of the existing authorized accesses. | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/TargetiSCSIGroupSettings.md" >}} ### Extents Screens + The **Extents** screen shows a table listing extents configured on the system. Extents are shared storage units. {{< trueimage src="/images/SCALE/Shares/iSCSIExtentsScreen.png" alt="iSCSI Extents Screen" id="iSCSI Extents Screen" >}} @@ -203,60 +159,16 @@ The **Extents** screen shows a table listing extents configured on the system. E **Add** and **Edit** open the configuration screen for the selected target. **Delete** opens a dialog with delete options. -#### Delete Extend Dialog -The **Delete iSCSI Extent *name*** deletes the specified extend. The name of the extent shows in the dialog title. +#### Delete Extent Dialog -{{< trueimage src="/images/SCALE/Shares/DelteExtentDialog.png" alt="Delete iSCSI Extent Dialog" id="Deleted iSCSI Extent Dialog" >}} - -**Force** allows deleting the extend even if the share is active. - -**Delete** deletes the extent and closes the dialog. **Cancel** closes the dialog without deleting the extent. +{{< include file="/static/includes/iSCSIDeleteExtent.md" >}} #### Add or Edit Extent Screens -The **Add Extent** and **Edit Extent** screens show the same configuration settings. - -{{< columns >}} -{{< trueimage src="/images/SCALE/Shares/AddExtentScreenDeviceType.png" alt="Add iSCSI Extent Device Type" id="Add iSCSI Extent Device Type" >}} -<---> -{{< trueimage src="/images/SCALE/Shares/AddExtentScreenFileType.png" alt="Edit iSCSI Extent File Type" id="Edit iSCSI Extent File type" >}} -{{< /columns >}} - -{{< expand "Extent Basic Info Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Name** | Enter a name for the extent. An **Extent** where the size is not **0**, cannot be an existing file within the pool or dataset. | -| **Description** | Enter any notes about this extent. | -| **Enabled** | Select to enable the iSCSI extent. | -{{< /truetable >}} -{{< /expand >}} -{{< expand "Extent Compatibility Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Enable TCP** | Select to allow an initiator to bypass normal access control and access any scannable target. This allows [xcopy](https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/cc771254(v=ws.11)) operations that are otherwise blocked by access control. | -| **Xen initiator compat mode** | Select when using Xen as the iSCSI initiator. | -| **LUN RPM** | Select the option from the dropdown list. Options are **UNKNOWN**, **SSD**, **5400**, **7200**, **10000** or **15000**. Do *not* change this setting when using Windows as the initiator. Only change LUN RPM in large environments where the number of systems using a specific RPM is needed for accurate reporting statistics. | -| **Read-only** | Select to prevent the initiator from initializing this LUN. | -{{< /truetable >}} -{{< /expand >}} - -{{< expand "Extent Type Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Extent Type** | Provides virtual storage access to zvols, zvol snapshots, or physical devices. Select the extent (zvol) option from the dropdown list. Dropdown options:
  • **Device** - Select to specify a device (default option). **Device** provides virtual storage access to zvols, zvol snapshots, or physical devices. Shows the **Device** field.
  • **File** - Select to specify a path to a file. **File** provides virtual storage access to a single file. Shows the **Path to the Extent** and **Filesize** fields.
    • | -| **Device** | Shows after specifying **Device** in **Extent Type**. Select the unused zvol or zvol snapshot from the dropdown list. | -| **Path to the Extent** | Enter or browse to select the path to an existing file. Enter a slash (/) followed by a file name to create a file in a dataset and append the file name to the path (/*filename.ext*). | -| **Filesize** | Enter 0 to use the actual file size of an existing file, or specify the file size for the new file added in **Path to the Extent**. | -| **Logical Block Size** | Shows the default **512** size. If the initiator requires a different block size, enter the numerical value. | -| **Disable Physical Block Size Reporting** | Select if the initiator does not support physical block size values over 4K (MS SQL). | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/iSCSIAddEditExtentSettings.md" >}} ### Initiators Groups Screen -The **Initiators Groups** screen shows after clicking the **Initiator** tab. It shows a table listing initiator groups configured on the system. +The **Initiators Groups** screen shows after clicking the **Initiator** tab. The table lists initiator groups configured on the system. {{< trueimage src="/images/SCALE/Shares/iSCSIInitiatorsScreen.png" alt="iSCSI Initiator Screen" id="iSCSI Initiator Screen" >}} @@ -265,30 +177,15 @@ The **Initiators Groups** screen shows after clicking the **Initiator** tab. It **Delete** opens a dialog to delete an initiator group. #### Add Initiator Screen -**Add** opens the **Add Initiator** screen showing the settings to create new authorized access client groups or edit existing ones in the list. -{{< trueimage src="/images/SCALE/Shares/AddInitiatorScreen.png" alt="Add Initiator Screen" id="Add Initiator Screen" >}} - -{{< expand "Add Initiator Group Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Allow All Initiators** | Select to allows all initiators. | -| **Allowed Initiators (IQN)** | Enter initiators allowed access to this system. Enter an [iSCSI Qualified Name (IQN)](https://tools.ietf.org/html/rfc3720#section-3.2.6) and click **+** to add it to the list. Example: *iqn.1994-09.org.freebsd:freenas.local*. | -| **Description** | Enter any notes about the initiators. | -| **Connected Initiators** | Shows the list of connected initiators on the system. | -| **Allowed Initiators** | Shows the list of allowed initiators on the system. | -| **Refresh** | Updates the screen. | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/iSCSIAddInitiatorSettings.md" >}} #### Edit Initiator Screen -**Edit** opens the **Add Initiator** edit screen showing two options: **Allow All Initiators** and **Description**. -**Save** saves changes and closes the screen. **Cancel** closes the screen without saving changes. -{{< trueimage src="/images/SCALE/Shares/EditInitiatorScreen.png" alt="Edit Initiator Screen" id="Edit Initiator Screen" >}} +{{< include file="/static/includes/iSCSIEditInitiatorSettings.md" >}} ### Portals Screens + The configuration tabs **Portals** screen displays a list of portal ID groups on the TrueNAS system. {{< trueimage src="/images/SCALE/Shares/iSCSIPortalsScreen.png" alt="iSCSI Portals Screen" id="iSCSI Portals Screen" >}} @@ -297,26 +194,12 @@ The configuration tabs **Portals** screen displays a list of portal ID groups on **Add** opens the **Add Portal** screen. **Edit** opens the **Edit Portal** screen. Both screens have the same setting options. -#### Add or Edit Target Screens -The **Add Target** and **Edit Target** screens show the same configuration settings. +#### Add or Edit Portals Screens -{{< columns >}} -{{< trueimage src="/images/SCALE/Shares/AddPortalScreen.png" alt="Add Portal Screen" id="Add Portal Screen" >}} -<---> -{{< trueimage src="/images/SCALE/Shares/EditPortalScreen.png" alt="Edit Portal Screen" id="Edit Portal Screen" >}} -{{< /columns >}} - -{{< expand "Portal Basic Info Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Description** | Enter an optional description. Portals are automatically assigned a numeric group. | -| **Add Listen** | Click **Add** to show the **IP Address** field where you add the IP address and netmask (CIDR) for the portal. | -| **IP Address** | Shows several options for setting up a portal. Select from these options:
  • **0.0.0.0** - Select to listen on all IPv4 addresses.
  • **::** - Select to listen on all IPv6 addresses.
  • TrueNAS server IP address - Select to use the IPv4 address assigned to the primary network interface for the TrueNAS server being configured.
  • IPv6 address assigned to the system.
    • | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/iSCSIAddEditPortalsScreens.md" >}} ### Authorized Access Screens + The **Authorized Access** screen displays settings to create new authorized access networks or edit existing ones in the list. If you have not set up authorized access yet, the **No Authorized Access** screen displays with the **Add Authorized Access** button in the center of the screen. **Add Authorized Access** or **Add** at the top of the screen opens the **Add Authorized Access** screen. @@ -334,35 +217,5 @@ After adding authorized access to the system, the **Authorized Access** screen d The **Add** and **Edit** screens display the same settings. Both screens have the same setting options. #### Add or Edit Authorized Access Screens -The **Add Target** and **Edit Target** screens show the same configuration settings. - -{{< trueimage src="/images/SCALE/Shares/AddAuthorizedAccessScreen.png" alt="Add Authorized Access Screen" id="Add Authorized Access Screen" >}} - -{{< expand "Authentication Method and Group Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Group ID** | Enter a number. Allows configuring different groups with different authentication profiles. For example, all users with a group ID of *1* inherit the authentication profile associated with *Group 1*. | -| **Discover Authentication** | Select the discovery method for authentication from the dropdown list. iSCSI supports multiple authentication methods that targets use to discover valid devices. Options are:
  • **None** - Select to allow anonymous discovery. When set to **None**, you can leave an iSCSI Group **Authentication Method** set to **None** or empty.
  • **CHAP** - Select to use CHAP as the authentication method. If set to **CHAP** enter or create a new group on the **Add iSCSI Target**screen. | -{{< /truetable >}} -{{< /expand >}} - -{{< expand "User Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **User** | User account to create CHAP authentication with the user on the remote system. Many initiators use the initiator name as the user name. | -| **Secret** | Enter the user password. Secret must be at least 12 and no more than 16 characters long. The screen displays a **Password does not match** error until you enter the same password in **Secret (Confirm)**. | -| **Secret (Confirm)** | Enter the same password to confirm the user password. | -{{< /truetable >}} -{{< /expand >}} -{{< expand "Peer Settings" "v" >}} -{{< truetable >}} -| Setting | Description | -|---------|-------------| -| **Peer User** | (Optional) Enter only when configuring mutual CHAP. Usually the same value as **User**. | -| **Peer Secret** | Enter the mutual secret password. Required if entering a **Peer User**. Peer user must use a different password than the password in **Secret**. | -| **Peer Secret (Confirm)** | Enter the same password to confirm the mutual secret password. | -{{< /truetable >}} -{{< /expand >}} +{{< include file="/static/includes/iSCSIAddEditAuthorizedAccesssScreens.md" >}} diff --git a/static/images/SCALE/Shares/AddiSCSITargetFC.png b/static/images/SCALE/Shares/AddiSCSITargetFC.png new file mode 100644 index 0000000000..c18e0772dc Binary files /dev/null and b/static/images/SCALE/Shares/AddiSCSITargetFC.png differ diff --git a/static/images/SCALE/Shares/ChangeNumberofVirtualPortsDialog.png b/static/images/SCALE/Shares/ChangeNumberofVirtualPortsDialog.png new file mode 100644 index 0000000000..db166d6979 Binary files /dev/null and b/static/images/SCALE/Shares/ChangeNumberofVirtualPortsDialog.png differ diff --git a/static/images/SCALE/Shares/EditiSCSITargetFC.png b/static/images/SCALE/Shares/EditiSCSITargetFC.png new file mode 100644 index 0000000000..e138b1e2cf Binary files /dev/null and b/static/images/SCALE/Shares/EditiSCSITargetFC.png differ diff --git a/static/images/SCALE/Shares/GlobalTargetConfigurationScreeninHA.png b/static/images/SCALE/Shares/GlobalTargetConfigurationScreeninHA.png new file mode 100644 index 0000000000..0740831692 Binary files /dev/null and b/static/images/SCALE/Shares/GlobalTargetConfigurationScreeninHA.png differ diff --git a/static/images/SCALE/Shares/SharesScreenFC.png b/static/images/SCALE/Shares/SharesScreenFC.png new file mode 100644 index 0000000000..d3b70cbdf8 Binary files /dev/null and b/static/images/SCALE/Shares/SharesScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSAuthorizedAccessScreenFC.png b/static/images/SCALE/Shares/iSCSAuthorizedAccessScreenFC.png new file mode 100644 index 0000000000..7b34cfd851 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSAuthorizedAccessScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSIExtentsScreenFC.png b/static/images/SCALE/Shares/iSCSIExtentsScreenFC.png new file mode 100644 index 0000000000..1e14743302 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIExtentsScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSIFibreChannelPortsScreen.png b/static/images/SCALE/Shares/iSCSIFibreChannelPortsScreen.png new file mode 100644 index 0000000000..74886337d4 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIFibreChannelPortsScreen.png differ diff --git a/static/images/SCALE/Shares/iSCSIInitiatorsScreenFC.png b/static/images/SCALE/Shares/iSCSIInitiatorsScreenFC.png new file mode 100644 index 0000000000..283faf27c3 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIInitiatorsScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSIPortalsScreenFC.png b/static/images/SCALE/Shares/iSCSIPortalsScreenFC.png new file mode 100644 index 0000000000..47169e39e1 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIPortalsScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSITargetsScreenwFC.png b/static/images/SCALE/Shares/iSCSITargetsScreenwFC.png new file mode 100644 index 0000000000..594737b6b7 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSITargetsScreenwFC.png differ diff --git a/static/images/SCALE/Shares/iSCSIWizardExtentScreenFCAddNew.png b/static/images/SCALE/Shares/iSCSIWizardExtentScreenFCAddNew.png new file mode 100644 index 0000000000..2eaff41a35 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIWizardExtentScreenFCAddNew.png differ diff --git a/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenCreateNewVirtualPort.png b/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenCreateNewVirtualPort.png new file mode 100644 index 0000000000..9a26aa6ff7 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenCreateNewVirtualPort.png differ diff --git a/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenFC.png b/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenFC.png new file mode 100644 index 0000000000..7f7c9642f3 Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIWizardProtocolOptionsScreenFC.png differ diff --git a/static/images/SCALE/Shares/iSCSIWizardTargetScreenFC.png b/static/images/SCALE/Shares/iSCSIWizardTargetScreenFC.png new file mode 100644 index 0000000000..695d260a6c Binary files /dev/null and b/static/images/SCALE/Shares/iSCSIWizardTargetScreenFC.png differ diff --git a/static/includes/TargetiSCSIGroupSettings.md b/static/includes/TargetiSCSIGroupSettings.md new file mode 100644 index 0000000000..ca0e6068af --- /dev/null +++ b/static/includes/TargetiSCSIGroupSettings.md @@ -0,0 +1,13 @@ + + +{{< expand "Target iSCSI Group Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Add Groups** | Adds a collection of network interfaces, IP addresses, and TCP ports, on a storage device that an iSCSI initiator can connect to. Groups are also known as target portal groups. **Add** shows a group configuration field each time it is clicked. | +| **Portal Group ID** | Select the ID from the dropdown list. Shows a group for each iSCSI share added to the system with a number assignment, for example, *1 (test2)* for the test2 target/share. Portal groups are created on the **Add Portal** screen. | +| **Initiator Group ID** | Select the group ID from the dropdown list. Shows a group for each portal ID configured on the system, for example, *1 (ALL Initiators Allowed). Initiator groups have access to the target. | +| **Authentication Method** | Select the authentication method from the dropdown list of options. Options are:
  • **None** - Select to allow anonymous discovery. When set to **None** you can leave **Discovery Authentication Group** set to **None** or empty.
  • **CHAP** - Select to use the Challenge Handshake Authentication Protocol (CHAP) method. CHAP verifies the identity of an iSCSI initiator (device trying to access storage) by sending a challenge that only the authentic initiator can correctly respond to. This prevents unauthorized access to the storage target. Think of it like a password-based authentication system for iSCSI connections. When set to CHAP you must enter or create a new group in **Discovery Authentication** on the **Add** or **Edit Authorized Access** screen.
  • **Mutual CHAP**- Select to use CHAP where both the iSCSI initiator (client) and target server mutually authenticate each other using the CHAP method. Each side verifies the identity of the other before establishing a connection. This provides a higher level of security compared to one-way CHAP. When set to mutual CHAP you must enter or create a new group in **Discovery Authentication** on the **Add** or **Edit Authorized Access** screen.
    • | +| **Authentication Group Number** | Select the group from the dropdown list. An authentication group is configured on the **Add Authorized Access** screen. Required when the **Discovery Authentication Method** is set to **CHAP** or **Mutual CHAP**. Select **None** or the value representing the number of the existing authorized accesses. | +{{< /truetable >}} +{{< /expand >}} diff --git a/static/includes/iSCSIAddEditAuthorizedAccesssScreens.md b/static/includes/iSCSIAddEditAuthorizedAccesssScreens.md new file mode 100644 index 0000000000..15c0cae3f7 --- /dev/null +++ b/static/includes/iSCSIAddEditAuthorizedAccesssScreens.md @@ -0,0 +1,34 @@ + + +The **Add Target** and **Edit Target** screens show the same configuration settings. + +{{< trueimage src="/images/SCALE/Shares/AddAuthorizedAccessScreen.png" alt="Add Authorized Access Screen" id="Add Authorized Access Screen" >}} + +{{< expand "Authentication Method and Group Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Group ID** | Enter a number. Allows configuring different groups with different authentication profiles. For example, all users with a group ID of *1* inherit the authentication profile associated with *Group 1*. | +| **Discover Authentication** | Select the discovery method for authentication from the dropdown list. iSCSI supports multiple authentication methods that targets use to discover valid devices. Options are:
  • **None** - Select to allow anonymous discovery. When set to **None**, you can leave an iSCSI Group **Authentication Method** set to **None** or empty.
  • **CHAP** - Select to use CHAP as the authentication method. If set to **CHAP** enter or create a new group on the **Add iSCSI Target**screen.
  • Mutual Chap - Select to use the Mutual CHAP two-way authentication method. To show this option, configure the **Peer User** and the password.
    • | +{{< /truetable >}} +{{< /expand >}} + +{{< expand "User Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **User** | User account to create CHAP authentication with the user on the remote system. Many initiators use the initiator name as the user name. | +| **Secret** | Enter the user password. Secret must be at least 12 and no more than 16 characters long. The screen displays a **Password does not match** error until you enter the same password in **Secret (Confirm)**. | +| **Secret (Confirm)** | Enter the same password to confirm the user password. | +{{< /truetable >}} +{{< /expand >}} + +{{< expand "Peer Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Peer User** | (Optional) Enter only when configuring mutual CHAP. Usually the same value as **User**. Configure the peer user name and password to see **Mutual Chap** in the **Discover Authentication** dropdown list. | +| **Peer Secret** | Enter the mutual secret password. Required if entering a **Peer User**. Peer user must use a different password than the password in **Secret**. | +| **Peer Secret (Confirm)** | Enter the same password to confirm the mutual secret password. | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file diff --git a/static/includes/iSCSIAddEditExtentSettings.md b/static/includes/iSCSIAddEditExtentSettings.md new file mode 100644 index 0000000000..56df27dc20 --- /dev/null +++ b/static/includes/iSCSIAddEditExtentSettings.md @@ -0,0 +1,43 @@ + + +The **Add Extent** and **Edit Extent** screens show the same configuration settings. + +{{< columns >}} +{{< trueimage src="/images/SCALE/Shares/AddExtentScreenDeviceType.png" alt="Add iSCSI Extent Device Type" id="Add iSCSI Extent Device Type" >}} +<---> +{{< trueimage src="/images/SCALE/Shares/AddExtentScreenFileType.png" alt="Edit iSCSI Extent File Type" id="Edit iSCSI Extent File type" >}} +{{< /columns >}} + +{{< expand "Extent Basic Info Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Name** | Enter a name for the extent. An **Extent** where the size is not **0**, cannot be an existing file within the pool or dataset. | +| **Description** | Enter any notes about this extent. | +| **Enabled** | Select to enable the iSCSI extent. | +{{< /truetable >}} +{{< /expand >}} + +{{< expand "Extent Compatibility Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Enable TCP** | Select to allow an initiator to bypass normal access control and access any scannable target. This allows [xcopy](https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/cc771254(v=ws.11)) operations that are otherwise blocked by access control. | +| **Xen initiator compat mode** | Select when using Xen as the iSCSI initiator. | +| **LUN RPM** | Select the option from the dropdown list. Options are **UNKNOWN**, **SSD**, **5400**, **7200**, **10000** or **15000**. Do *not* change this setting when using Windows as the initiator. Only change LUN RPM in large environments where the number of systems using a specific RPM is needed for accurate reporting statistics. | +| **Read-only** | Select to prevent the initiator from initializing this LUN. | +{{< /truetable >}} +{{< /expand >}} + +{{< expand "Extent Type Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Extent Type** | Provides virtual storage access to zvols, zvol snapshots, or physical devices. Select the extent (zvol) option from the dropdown list. Dropdown options:
  • **Device** - Select to specify a device (default option). **Device** provides virtual storage access to zvols, zvol snapshots, or physical devices. Shows the **Device** field.
  • **File** - Select to specify a path to a file. **File** provides virtual storage access to a single file. Shows the **Path to the Extent** and **Filesize** fields.
    • | +| **Device** | Shows after specifying **Device** in **Extent Type**. Select the unused zvol or zvol snapshot from the dropdown list. | +| **Path to the Extent** | Enter or browse to select the path to an existing file. Enter a slash (/) followed by a file name to create a file in a dataset and append the file name to the path (/*filename.ext*). | +| **Filesize** | Enter 0 to use the actual file size of an existing file, or specify the file size for the new file added in **Path to the Extent**. | +| **Logical Block Size** | Shows the default **512** size. If the initiator requires a different block size, enter the numerical value. | +| **Disable Physical Block Size Reporting** | Select if the initiator does not support physical block size values over 4K (MS SQL). | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file diff --git a/static/includes/iSCSIAddEditPortalsScreens.md b/static/includes/iSCSIAddEditPortalsScreens.md new file mode 100644 index 0000000000..d08e61eacf --- /dev/null +++ b/static/includes/iSCSIAddEditPortalsScreens.md @@ -0,0 +1,19 @@ + + +The **Add Portal** and **Edit Portal** screens show the same configuration settings. + +{{< columns >}} +{{< trueimage src="/images/SCALE/Shares/AddPortalScreen.png" alt="Add Portal Screen" id="Add Portal Screen" >}} +<---> +{{< trueimage src="/images/SCALE/Shares/EditPortalScreen.png" alt="Edit Portal Screen" id="Edit Portal Screen" >}} +{{< /columns >}} + +{{< expand "Portal Basic Info Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Description** | Enter an optional description. Portals are automatically assigned a numeric group. | +| **Add Listen** | Click **Add** to show the **IP Address** field where you add the IP address and netmask (CIDR) for the portal. | +| **IP Address** | Shows several options for setting up a portal. Select from these options:
  • **0.0.0.0** - Select to listen on all IPv4 addresses.
  • **::** - Select to listen on all IPv6 addresses.
  • TrueNAS server IP address - Select to use the IPv4 address assigned to the primary network interface for the TrueNAS server being configured.
  • IPv6 address assigned to the system.
    • | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file diff --git a/static/includes/iSCSIAddInitiatorSettings.md b/static/includes/iSCSIAddInitiatorSettings.md new file mode 100644 index 0000000000..22c973a580 --- /dev/null +++ b/static/includes/iSCSIAddInitiatorSettings.md @@ -0,0 +1,18 @@ + + +**Add** opens the **Add Initiator** screen showing the settings to create new authorized access client groups or edit existing ones in the list. + +{{< trueimage src="/images/SCALE/Shares/AddInitiatorScreen.png" alt="Add Initiator Screen" id="Add Initiator Screen" >}} + +{{< expand "Add Initiator Group Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Allow All Initiators** | Select to allows all initiators. | +| **Allowed Initiators (IQN)** | Enter initiators allowed access to this system. Enter an [iSCSI Qualified Name (IQN)](https://tools.ietf.org/html/rfc3720#section-3.2.6) and click **+** to add it to the list. Example: *iqn.1994-09.org.freebsd:freenas.local*. | +| **Description** | Enter any notes about the initiators. | +| **Connected Initiators** | Shows the list of connected initiators on the system. | +| **Allowed Initiators** | Shows the list of allowed initiators on the system. | +| **Refresh** | Updates the screen. | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file diff --git a/static/includes/iSCSIDeleteExtent.md b/static/includes/iSCSIDeleteExtent.md new file mode 100644 index 0000000000..23737de6ca --- /dev/null +++ b/static/includes/iSCSIDeleteExtent.md @@ -0,0 +1,9 @@ + + +The **Delete iSCSI Extent *name*** deletes the specified extend. The name of the extent shows in the dialog title. + +{{< trueimage src="/images/SCALE/Shares/DelteExtentDialog.png" alt="Delete iSCSI Extent Dialog" id="Deleted iSCSI Extent Dialog" >}} + +**Force** allows deleting the extend even if the share is active. + +**Delete** deletes the extent and closes the dialog. **Cancel** closes the dialog without deleting the extent. \ No newline at end of file diff --git a/static/includes/iSCSIEditInitiatorSettings.md b/static/includes/iSCSIEditInitiatorSettings.md new file mode 100644 index 0000000000..9d443f2edf --- /dev/null +++ b/static/includes/iSCSIEditInitiatorSettings.md @@ -0,0 +1,6 @@ + + +**Edit** opens the **Add Initiator** edit screen showing two options: **Allow All Initiators** and **Description**. +**Save** saves changes and closes the screen. **Cancel** closes the screen without saving changes. + +{{< trueimage src="/images/SCALE/Shares/EditInitiatorScreen.png" alt="Edit Initiator Screen" id="Edit Initiator Screen" >}} \ No newline at end of file diff --git a/static/includes/iSCSIExtentScreens.md b/static/includes/iSCSIExtentScreens.md new file mode 100644 index 0000000000..3d50bdb67b --- /dev/null +++ b/static/includes/iSCSIExtentScreens.md @@ -0,0 +1,8 @@ + + +The **Extents** screen shows a table listing extents configured on the system. Extents are shared storage units. + +{{< trueimage src="/images/SCALE/Shares/iSCSIExtentsScreen.png" alt="iSCSI Extents Screen" id="iSCSI Extents Screen" >}} + +**Add** and **Edit** open the configuration screen for the selected target. +**Delete** opens a dialog with delete options. \ No newline at end of file diff --git a/static/includes/iSCSIGlobalConfigurationScreen.md b/static/includes/iSCSIGlobalConfigurationScreen.md new file mode 100644 index 0000000000..e7e6208137 --- /dev/null +++ b/static/includes/iSCSIGlobalConfigurationScreen.md @@ -0,0 +1,16 @@ + + +The **iSCSI Global Configuration** screen opens when you click **Edit** on the **iSCSI Service** row of the **System > Services** screen, and after clicking the **Global Target Configuration** button at the top of all iSCSI share screens. + +{{< trueimage src="/images/SCALE/Shares/iSCSIGlobalConfigurationScreen.png" alt="iSCSI Global Configuration Screen" id="iSCSI Global Configuration Screen" >}} + +{{< expand "Global Configuration Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Base Name** | Enter a name using lowercase alphanumeric characters. Allowed special characters are dot (.), dash (-), and colon (:). See the "Constructing iSCSI names using the iqn.format" section [RFC3721](https://tools.ietf.org/html/rfc3721.html) for more information. | +| **ISNS Servers** | Enter host names or IP addresses of the ISNS servers to be registered with the iSCSI targets and portals of the system. Press Enter to separate each entry. | +| **Pool Available Space Threshold (%)** | Generate an alert when the pool reaches this percentage of space remaining. This is typically configured at the pool level when using zvols or at the extent level for both file and device-based extents. | +| **iSCSI listen port** | TCP port used to access the iSCSI target. The default is **3260**. | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file diff --git a/static/includes/iSCSIRemoveExtentAssociation.md b/static/includes/iSCSIRemoveExtentAssociation.md new file mode 100644 index 0000000000..8eb79f43d7 --- /dev/null +++ b/static/includes/iSCSIRemoveExtentAssociation.md @@ -0,0 +1,5 @@ + + +The **Remove Extent Association** link_off icon opens the **Remove extent association** dialog that shows the LUN link association and two buttons: **Cancel** and **Remove**. Removing the association activates the **Associate** button on the widget. + +{{< trueimage src="/images/SCALE/Shares/RemoveExtentAssociationDialog.png" alt="Remove Extent Association Dialog" id="Remove Extent Association Dialog" >}} \ No newline at end of file diff --git a/static/includes/iSCSITargetAssociate.md b/static/includes/iSCSITargetAssociate.md new file mode 100644 index 0000000000..d89e78e919 --- /dev/null +++ b/static/includes/iSCSITargetAssociate.md @@ -0,0 +1,10 @@ + + +The **Associate** button is inactive when the extent is associated with a LUN. Removing the association activates the button. Clicking the button opens the **Associate *target*** dialog. + +{{< trueimage src="/images/SCALE/Shares/ISCSIExtentAssociateDialog.png" alt="Extent Associate Dialog" id="Extent Associate Dialog" >}} + +Enter a LUN ID between 0 and 1023 into **LUN ID**. SCALE requires at least one LUN 0. +Some initiators expect a value between 0 and 256. Leaving this field blank automatically assigns the next available ID. + +Select the target on the **Extent** dropdown list. \ No newline at end of file diff --git a/static/includes/iSCSITargetDelete.md b/static/includes/iSCSITargetDelete.md new file mode 100644 index 0000000000..547163fdba --- /dev/null +++ b/static/includes/iSCSITargetDelete.md @@ -0,0 +1,12 @@ + + +**Delete** opens a confiration dialog with two options: **Delete *1* associated extent** and **Force Delete**. Select the options to include in the delete operation. + +{{< trueimage src="/images/SCALE/Shares/DeleteiSCSITargetdialog.png" alt="iSCSI Target Delete Dialog" id="iSCSI Target Delete Dialog" >}} + +**Delete *1* associated extent** shows the number of associated extend for the selected target. + +**Force Delete** deletes the target even if the share is still in use. + +**Cancel** closes the dialog without deleting. +**Delete** deletes the target but does not delete the iSCSI volumes associated with the extents. \ No newline at end of file diff --git a/static/includes/iSCSIWizardExtentScreen.md b/static/includes/iSCSIWizardExtentScreen.md new file mode 100644 index 0000000000..8544da0cb8 --- /dev/null +++ b/static/includes/iSCSIWizardExtentScreen.md @@ -0,0 +1,24 @@ + + +The iSCSI wizard **Extent** screen shows settings to name the share, set the type of extent devices, and the sharing platform for the device. + +{{< columns >}} +{{< trueimage src="/images/SCALE/Shares/iSCSIWizardExtentCreateNewDevice.png" alt="iSCSI Wizard Extent Screen Devices Settings" id="iSCSI Wizard Extent Screen Device Settings" >}} +<---> +{{< trueimage src="/images/SCALE/Shares/iSCSIWizardExtendFileType.png" alt="iSCSI Wizard Extent Screen File Settings" id="iSCSI Wizard Extent Screen File Settings" >}} +{{< /columns >}} + +{{< expand "Wizard Extent Settings" "v" >}} +{{< truetable >}} +| Setting | Description | +|---------|-------------| +| **Name** | The name given to the iSCSI block share. Enter a name using up to 64 lowercase alphanumeric and special characters. Allowed characters are dot (.), dash (-), and colon (:). A name longer than 64 characters is not allowed. See the "Constructing iSCSI names using the iqn.format" section of [RFC3721](https://tools.ietf.org/html/rfc3721.html). The base name (**from Target Global Configuration**) is automatically prepended if the target name does not start with **iqn**. | +| **Extent Type** | Has two options: **Device** and **File**. Select an option to show other settings for each option. | +| **Device** | Shows if **Extent Type** is set to **Device**. Shows **Create New** or a list of iSCSI devices added to the system. **Create New** shows additional settings. | +| **Pool/Dataset** | Shows after selecting **Create New** in **Device**. Enter or browse to select the path to the mount point. Browsing to select the dataset activates the **Create Dataset** option. Click to open the **Create Dataset** dialog, which creates a zvol. | +| **Size** | Shows after clicking **Create New** in **Device** and after adding the mount point in **Pool/Dataset**. Enter a numerical value and suffix to specify the size of the zvol you are creating. | +| **Path to the Extent** | Shows if **Extent Type** is set to **File**. Enter or browse to select the mount point for the directory the extent uses. If a directory does not exist, after selecting the dataset where you want to add the directory, then enter a **/** followed by the name to add the directory to the dataset. | +| **Filesize** | Shows if the **Extent Type** is set to **File**. Enter the size for the directory. Leaving this set to **0** uses the actual file size and requires the file to exist. Otherwise, specify the file size for the new file. | +| **Sharing Platform** | Shows for both options. Select the platform that matches your use case. Options are:
  • **VMware: Extent block size 512b, TCP enabled, no Zen compat mode, SSD speed**
  • **Xen: Extent block size 512b, TCP enabled, Xen compat mode enabled, SSD speed**
  • **Legacy OS: Extent block size 512b, TCP enabled, no Xen compat mode, SSD speed**
  • **Modern OS: Extent block size 4k, TCP enabled, no Xen compat mode, SSD speed**
    • | +{{< /truetable >}} +{{< /expand >}} \ No newline at end of file