Search

StarWind Virtual SAN for vSphere 3-Node Hyperconverged Scenario with VMware vSphere

Annotation 

Relevant Products 

StarWind Virtual SAN (VSAN) 

Purpose 

This guide details the deployment and configuration of StarWind Virtual SAN for vSphere in a 3-node hyperconverged scenario within a VMware vSphere environment. The process involves pre-configuring servers, setting up network and storage configurations as per best practices, and installing the StarWind Virtual SAN as a Controller Virtual Machine on each ESXi host. 

Audience 

This guide is aimed at system administrators, virtualization specialists, and IT professionals managing VMware vSphere environments. 

Expected Result 

Following this guide, users should achieve a seamless integration of StarWind Virtual SAN with VMware vSphere, resulting in a high-performance and fault-tolerant storage pool across three nodes.  

StarWind Virtual SAN for vSphere VM requirements

Prior to installing StarWind Virtual SAN Virtual Machines, please make sure that the system meets the requirements, which are available via the following link: https://www.starwindsoftware.com/system-requirements

Storage provisioning guidelines: https://knowledgebase.starwindsoftware.com/guidance/how-to-provision-physical-storage-to-starwind-virtual-san-controller-virtual-machine/

Recommended RAID settings for HDD and SSD disks:
https://knowledgebase.starwindsoftware.com/guidance/recommended-raid-settings-for-hdd-and-ssd-disks/

Please read StarWind Virtual SAN Best Practices document for additional information: https://www.starwindsoftware.com/resource-library/starwind-virtual-san-best-practices

Pre-Configuring the Servers

The diagram below illustrates the network and storage configuration of the solution:

 

 

1. ESXi hypervisor should be installed on each host.

2. The vCenter server should be deployed.

3. StarWind Virtual SAN for vSphere VM should be deployed on each  ESXi  host from an OVF template, downloaded on this page: https://www.starwindsoftware.com/release-notes-build-vsan-for-vmware-vsphere

4. The network interfaces on each node for Synchronization and iSCSI/StarWind heartbeat interfaces should be in different subnets and connected directly according to the network diagram above. Here, 172.16.10.x, 172.16.11.x, 172.16.12.x subnets are used for the iSCSI/StarWind heartbeat traffic, while 172.16.20.x, 172.16.21.x,  172.16.20.x subnets are used for the Synchronization traffic.

NOTE: Do not use ISCSI/Heartbeat and Synchronization channels over the same physical link. Synchronization and iSCSI/Heartbeat links and can be connected either via redundant switches or directly between the nodes.

Preparing Environment for StarWind VSAN Deployment

Configuring Networks

Configure network interfaces on each node to make sure that Synchronization and iSCSI/StarWind heartbeat interfaces are in different subnets and connected physically according to the network diagram above. All actions below should be applied to each ESXi server.
NOTE: Virtual Machine Port Group should be created for both iSCSI/ StarWind Heartbeat and the Synchronization vSwitches. VMKernel port should be created only for iSCSI traffic. Static IP addresses should be assigned to VMKernel ports.
NOTE: It is recommended to set MTU to 9000 on vSwitches and VMKernel ports for iSCSI and Synchronization traffic. Additionally, vMotion can be enabled on VMKernel ports.

1. Using the VMware ESXi web console, create two standard vSwitches: one for the iSCSI/ StarWind Heartbeat channel (vSwitch1) and the other one for the Synchronization channel (vSwitch2).

Create vSwitch

2. Create a VMKernel port for the iSCSI/ StarWind Heartbeat channel.

 

3. Add a Virtual Machine Port Groups on the vSwitch for iSCSI traffic (vSwtich1) and on the vSwitch for Synchronization traffic (vSwitch2).

Add port group
4. Repeat steps 1-3 for any other links intended for Synchronization and iSCSI/Heartbeat traffic on ESXi hosts.

Installing StarWind Virtual SAN for vSphere

1. Download zip archive that contains StarWind Virtual SAN for vSphere.
https://www.starwindsoftware.com/starwind-virtual-san#download

2. Extract virtual machine files.

3. Deploy a virtual machine to the vSphere. Right-click on the host and select “Deploy OVF template” from a drop-down menu.

StarWind VSAN for vSphere
4. In the first step of the wizard, point to the location of the OVF template. Select VM files and click Next.

Installing StarWind Virtual SAN for vSphere
5. Specify the name and location for the StarWind Virtual SAN VM.

Installing StarWind Virtual SAN for vSphere
6. Select a resource for the StarWind Virtual SAN VM.

Installing StarWind Virtual SAN for vSphere
7. Review the information about the VM.

8. Select the storage for the VM.

Installing StarWind Virtual SAN for vSphere
9. Select networks for the VM.

Installing StarWind Virtual SAN for vSphere
10. Click Finish to start the deployment process.

11. Add additional network interfaces for iSCSI and SYNC (can be configured for redundancy or 3-way replica, if required)

StarWind VSAN for vSphere

12. Repeat all the steps from this section on the other ESXi hosts
NOTE: When using StarWind with the synchronous replication feature inside of a Virtual Machine, it is recommended not to make backups and/or snapshots of the Virtual Machine with the StarWind VSAN service installed, as this could pause the StarWind Virtual Machine. Pausing the Virtual Machines while the StarWind VSAN service in under load may lead to split-brain issues in synchronous replication devices, thus to data corruption.

Configuring StarWind Virtual SAN VM settings

By default, the StarWind Virtual SAN virtual machine receives an IP address automatically via DHCP. It is recommended to create a DHCP reservation and set a static IP address for this VM. In order to access StarWind Virtual SAN VM from the local network, the virtual machine must have access to the network. In case there is no DHCP server, the connection to the VM can be established using the VMware console and static IP address can be configured manually.

1. Open a web browser and enter the IP address of the VM, which it had received via DHCP (or had it assigned manually), and log in to StarWind Virtual SAN for vSphere using the following default credentials:

Username: user
Password: rds123RDS
NOTE:  Make sure to tick Reuse my password for privileged tasks check box.

Login_screen

2. After the successful login, on the left sidebar, click Accounts.

3. Select a user and click Set Password.

Set_password
4.
 On the left sidebar, click Networking.

Networking

Here, the Management IP address of the StarWind Virtual SAN Virtual Machine, as well as IP addresses for iSCSI and Synchronization networks can be configured.
In case the Network interface is inactive, click on the interface, turn it on, and set it to “Connect automatically“.

Networking_auto

5. Click on Automatic (DHCP) to set the IP address (DNS and gateway – for Management).

Networking_IPv4_Settings

6. The result should look like on the picture below:

Networking_result
NOTE: It is recommended to set MTU to 9000 on interfaces, dedicated for iSCSI and Synchronization traffic. Change Automatic to 9000, if required.

Networking_MTU

6. Alternatively, log in to the VM via the VMware console and assign a static IP address by editing the configuration file of the interface located by the following path: /etc/sysconfig/network-scripts

Networking_manual

7. Open the file, corresponding to the Management interface  using text editor, for example:
sudo nano /etc/sysconfig/network-scripts/ifcfg-ens192

8. Edit the file:

Change the line BOOTPROTO=dhcp to: BOOTPROTO=static

Add the IP settings needed to the file:
IPADDR=192.168.12.10
NETMASK=255.255.255.0
GATEWAY=192.168.12.1
DNS1=192.168.1.1
By default, the Management link should have an ens192 interface name. The configuration file should look as follows

Networking_edit
9.
Restart interface using the following cmdlet: sudo ifdown ens192 sudo ifup ens192 or restart the VM.

10. Change the Host Name from the System tab by clicking on it

Host_Name
11. Change System time and NTP settings if required

System_Time
12.  Repeat the steps above on each StarWind VSAN VM.

Configuring StarWind Management Console

1. Install StarWind Management Console on a workstation with Windows OS (Windows 7 or higher, Windows Server 2008 R2 and higher) using the installator available here.
NOTE: StarWind Management Console and PowerShell Management Library components are required.

2. Select the appropriate option to apply the StarWind License key.
Once the appropriate license key has been received, it should be applied to StarWind Virtual SAN service via Management Console or PowerShell.

3. Open StarWind Management Console and click Add Server.

Add Server
4. Type the IP address of the StarWind Virtual SAN in the pop-up window and click OK.

Add new StarWind server
5. Select the server and click Connect.

6. Click Apply Key… on the pop-up window.

Apply key
7. Select Load license from file and click the Load button.

8. Select the appropriate license key.
As an alternative, PowerShell can be used. Open StarWind InstallLicense.ps1 script with PowerShell ISE as administrator. It can be found here:
C:\Program Files\StarWind Software\StarWind\StarWindX\Samples\powershell\InstallLicense.ps1
Type the IP address of StarWind Virtual SAN VM and credentials of StarWind Virtual SAN service (defaults login: root, password: starwind).
Add the path to the license key.

Configuring StarWind Management Console
9. After the license key is applied, StarWind devices can be created.
NOTE: In order to manage StarWind Virtual SAN service (e.g. create ImageFile devices, VTL devices, etc.), StarWind Management Console can be used.

Configuring StarWind VMs Startup/Shutdown

1. Setup the VMs startup policy on both ESXi hosts from Manage -> System tab in the ESXi web console. In the appeared window, check Yes to enable the option and choose the stop action as Shut down. Click Save to proceed.

VM_Auto_Start

2. To configure a VM autostart, right-click on the VM, navigate to Autostart and click Enable.

VM_Auto_Start_Enable

3. Complete the actions above on StarWind VM located on all ESXi hosts.

4. Start the virtual machines on all ESXi hosts.

 

Configuring Storage

StarWind Virtual SAN for vSphere can work on top of Hardware RAID or Linux Software RAID (MDADM) inside of the Virtual Machine.
Please select the required option:

Configuring StarWind Storage on Top of Hardware RAID

1. Add a new virtual disk to the StarWind Virtual SAN VM. Make sure it is Thick Provisioned Eager Zeroed. Virtual Disk should be located on the datastore provided by hardware RAID.

Add a new virtual disk to the StarWind Virtual SAN VM

NOTE: Alternatively, the disk can be added to StarWind VSAN VM as RDM. The link to VMware documentation is below:
https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-4236E44E-E11F-4EDD-8CC0-12BA664BB811.html
NOTE: If a separate RAID controller is available, it can be used as dedicated storage for StarWind VM, and RAID controller can be added to StarWind VM as a PCI device. In this case RAID volume will be available as a virtual disk in the Drives section in the Web console. Follow the instructions in the section below on how to add RAID controller as PCI device to StarWind VM.

2. Login to StarWind VSAN VM web console and find in the Storage section under Drives the Virtual Disk that was recently added and choose it.

Add a new virtual disk to the StarWind Virtual SAN VM_2
3. The added disk does not have any partitions and filesystem. Press Create partition table and press Format afterward to create the partition and format it.

NOTE: It is not necessary to overwrite data while creating partition. 

Virtual Disk

4. Create the XFS partition. Specify the name and erase option. The mount point should be as following: /mnt/%yourdiskname% . Click Format. To enable OS boot when mount point is missing (e.g., hardware failure), add nofail as a boot option. 

StarWind VSAN

5. On the storage page of the disk, navigate to the Filesystem tab. Click Mount.

Filesystem tab

6. Connect to StarWind Virtual SAN from the StarWind Management Console. Click Yes.

StarWind Management Console
7. Select the disk which was recently mounted.

select the mounted disk

Configuring StarWind Storage on top of Software RAID

Make sure that the prerequisites for deploying Software RAID with StarWind Virtual SAN are met:

  • the ESXi hosts have all the drives connected through HBA or RAID controller in HBA mode
  • StarWind Virtual SAN for vSphere is installed on the ESXi server
  • StarWind Virtual SAN must be installed on a separate storage device available to the ESXi host (e.g. SSD, HDD etc.)
  • HBA or RAID controller will be added via a DirectPath I/O passthrough device to a StarWind VM
  • vCenter is installed in the environment to manage ESXi hosts

PCI Device Configuration

1. Login to the vCenter via vSphere Client. Select the host where StarWind Virtual SAN VM is installed.

vCenter via vSphere Client

 

Select the host

2. Go to the Configure tab. In the Hardware section, select PCI Devices. Click Edit.

select PCI Devices

3. Locate the HBA/RAID Controller of the ESXi host. Check the box on the appropriate PCI device. Click OK.

PCI device

4. The device will appear in the Direct I/O PCI Devices Available to VMs table in the Available (pending) status.

Direct I/O PCI Devices Available to VMs table

5. Reboot ESXi host. After the reboot, the status changes to Available.

ESXi host

6. Right-click on the StarWind Virtual SAN VM. Select Edit Settings.

Edit Settings

7. Click ADD NEW DEVICE. Select PCI Device.

ADD NEW DEVICE

8. Add HBA/RAID Controller to the VM. Reserve memory for the StarWind Virtual Machine. Click OK.

9. Boot StarWind Virtual SAN VM.

10. Repeat steps 1-8 for all hosts where StarWind Virtual SAN for vSphere is deployed.

11. Login to StarWind Virtual SAN VM via IP. The default credentials:

Login: user
Password: rds123RDS
NOTE: 
Please make sure that the default password is changed.

StarWind Virtual SAN VM

12. Go to the Storage page. The Drives section shows the drives connected to HBA/RAID Controller (if available). For each disk, create partition table. 

Drives section

13. Click “+” in the RAID Devices section to create Software RAID. (In the current example, RAID 10 will be created with 4 HDD drives). StarWind recommendations of RAID configurations depending on the number of disks, chunk size, and array level are shown in the table below:

RAID Level Chunk size for HDD Arrays Chunk size for SSD Arrays

0

Disk quantity * 4Kb

Disk quantity * 8Kb

5

(Disk quantity – 1) * 4Kb

(Disk quantity – 1) * 8Kb

6

(Disk quantity – 2) * 4Kb

(Disk quantity – 2) * 8Kb

10 (Disk quantity * 4Kb)/2 (Disk quantity * 8Kb)/2

StarWind Software RAID recommended settings can be found here:
https://knowledgebase.starwindsoftware.com/guidance/recommended-raid-settings-for-hdd-and-ssd-disks/

14.
 Select the drives to add to the array.

Select the drives to add to the array

15. After the synchronization is finished, find the RAID array created. Press Create partition table and press Format afterward to create the partition and format it.

NOTE: It is not necessary to overwrite data while creating a partition.

RAID array created

16. Create the XFS partition. Mount point should be as follows: /mnt/%yourdiskname% . Select the Custom mounting option and type noatime. To enable OS boot when mount point is missing (e.g., hardware failure), add nofail as a boot option.  Click Format.

Mount point

17. On the storage page of the disk, navigate to the Filesystem tab. Click Mount.

Filesystem tab

18. Connect to StarWind Virtual SAN from StarWind Management Console or from Web Console. Click Yes.

StarWind Management Console

 19. Select the disk recently mounted.

mounted disk

Creating StarWind devices

1. In the StarWind Management Console click to Add Device (advanced) button and open Add Device (advanced) Wizard.

2. Select Hard Disk Device as the type of device to be created.

3. Select Virtual Disk.

4. Specify a virtual disk Name, Location, and Size.


5. Select the Thick provisioned disk type and block size.
NOTE: Use 4096 sector size for targets, connected on Windows-based systems and 512 bytes sector size for targets, connected on Linux-based systems (ESXi/Xen/KVM).

6. Define a caching policy and specify a cache size (in MB). Also, the maximum available cache size can be specified by selecting the appropriate checkbox. Optionally, define the L2 caching policy and cache size.

Device Wizard

7. Specify Target Parameters. Select the Target Name checkbox to enter a custom target name. Otherwise, the name is generated automatically in accordance with the specified target alias.

Device Wizard StarWind

8. Click Create to add a new device and attach it to the target.

Device Wizard StarWind

9. Click Close to finish the device creation.

10. The successfully added devices appear in the StarWind Management Console.

 

Select the Required Replication Mode

The replication can be configured using Synchronous “Two-Way” Replication mode:
Synchronous or active-active replication ensures real-time synchronization and load balancing of data between two or three cluster nodes. Such a configuration tolerates the failure of two out of three storage nodes and enables the creation of an effective business continuity plan. With synchronous mirroring, each write operation requires control confirmation from both storage nodes. It guarantees the reliability of data transfers but is demanding in bandwidth since mirroring will not work on high-latency networks.

Synchronous “Two-Way” replication

1. Right-click the recently created device and select Replication Manager from the shortcut menu.

2. Select the Add Replica button in the top menu.

StarWind Replication Manager

3. Select Synchronous “Two-Way” replication as a replication mode.

4. Specify a partner Host name or IP address and Port Number.

Selecting the Failover Strategy

StarWind provides 2 options for configuring a failover strategy:

Heartbeat

The Heartbeat failover strategy allows avoiding the “split-brain” scenario when the HA cluster nodes are unable to synchronize but continue to accept write commands from the initiators independently. It can occur when all synchronization and heartbeat channels disconnect simultaneously, and the partner nodes do not respond to the node’s requests. As a result, StarWind service assumes the partner nodes to be offline and continues operations on a single-node mode using data written to it.
If at least one heartbeat link is online, StarWind services can communicate with each other via this link. The device with the lowest priority will be marked as not synchronized and get subsequently blocked for the further read and write operations until the synchronization channel resumption. At the same time, the partner device on the synchronized node flushes data from the cache to the disk to preserve data integrity in case the node goes down unexpectedly. It is recommended to assign more independent heartbeat channels during the replica creation to improve system stability and avoid the “split-brain” issue.
With the heartbeat failover strategy, the storage cluster will continue working with only one StarWind node available.

Node Majority

The Node Majority failover strategy ensures the synchronization connection without any additional heartbeat links. The failure-handling process occurs when the node has detected the absence of the connection with the partner.
The main requirement for keeping the node operational is an active connection with more than half of the HA device’s nodes. Calculation of the available partners is based on their “votes”.
In case of a two-node HA storage, all nodes will be disconnected if there is a problem on the node itself, or in communication between them. Therefore, the Node Majority failover strategy requires the addition of the third Witness node or file share (SMB) which participates in the nodes count for the majority, but neither contains data on it nor is involved in processing clients’ requests. In case an HA device is replicated between 3 nodes, no Witness node is required.
With Node Majority failover strategy, failure of only one node can be tolerated. If two nodes fail, the third node will also become unavailable to clients’ requests.
Please select the required option:

Heartbeat

1. Select Failover Strategy.


2. Select Create new Partner Device and click Next.

3. Select a partner device Location and click Next.

4. Select Synchronization Journal Strategy and click Next.
NOTE: There are several options – RAM-based journal (default) and Disk-based journal with failure and continuous strategy, that allow to avoid full synchronization cases.


RAM-based (default)
synchronization journal is placed in RAM. Synchronization with RAM journal provides good I/O performance in any scenario. Full synchronization could occur in the cases described in this KB: https://knowledgebase.starwindsoftware.com/explanation/reasons-why-full-synchronization-may-start/

Disk-based journal placed on a separate disk from StarWind devices. It allows to avoid full synchronization for the devices where it’s configured even when StarWind service is being stopped on all nodes. Disk-based synchronization journal should be placed on a separate, preferably faster disk from StarWind devices. SSDs and NVMe disks are recommended as the device performance is defined by the disk speed, where the journal is located. For example, it can be placed on the OS boot volume.
It is required to allocate 2 MB of disk space for the synchronization journal per 1 TB of HA device size with a disk-based journal configured with 2-way replication and 4MB per 1 TB of HA device size for 3-way replication.

Failure journal
The strategy provides good I/O performance, as a RAM-based journal, while all device nodes are in a healthy synchronized state. If a device on one node went into a not synchronized state, the disk-based journal activates and a performance drop could occur as the device performance is defined by the disk speed, where the journal is located. Fast synchronization is not guaranteed in all cases. For example, if a simultaneous hard reset of all nodes occurs, full synchronization will occur.
Continuous journal
The strategy guarantees fast synchronization and data consistency in all cases. Although, this strategy has the worst I/O performance, because of frequent write operations to the journal, located on the disk, where the journal is located.

Synchronization_Journal_Setup

5. Click Change Network Settings.


6. Specify the interfaces for Synchronization and Heartbeat Channels. Click OK and then click Next.


7. In Select Partner Device Initialization Mode, select Synchronize from existing Device and click Next.

8. Click Create Replica. Click Finish to close the wizard.

The successfully added device appears in StarWind Management Console.

9. Choose device, open Replication Manager and click Add replica again.

10. Select Synchronous “Two-Way” Replication as a replication mode. Click Next to proceed.

11. Specify a partner Host name or IP address and Port Number.

12. Select Failover Strategy.


13. Select Create new Partner Device and click Next.

14. Select a partner device Location and Synchronization Journal Strategy and click Next.

15. Click Change Network Settings.

16. Specify the interfaces for Synchronization and Heartbeat Channels. Click OK and then click Next.

NOTE: It is not recommended to configure the Heartbeat and iSCSI channels on the same interfaces to avoid the split-brain issue. If the Synchronization and Heartbeat interfaces are located on the same network adapter, it is recommended to assign one more Heartbeat interface to a separate adapter.

17. In Select Partner Device Initialization Mode, select Synchronize from existing Device and click Next.

18. Click Create Replica. Click Finish to close the wizard.img

The successfully added device appears in StarWind Management Console.

19. Follow the similar procedure for the creation of other virtual disks that will be used as storage repositories.

StarWind management Console

NOTE: To extend an Image File or a StarWind HA device to the required size, please check the article below:
https://knowledgebase.starwindsoftware.com/maintenance/how-to-extend-image-file-or-high-availability-device/

Node Majority

1. Select the Node Majority failover strategy and click Next.

Node Majority

2. Choose Create new Partner Device and click Next.

3. Specify the partner device Location and modify the target name if necessary. Click Next.

4. Select Synchronization Journal Strategy and click Next.
NOTE: There are several options – RAM-based journal (default) and Disk-based journal with failure and continuous strategy, that allow to avoid full synchronization cases.


RAM-based (default)
synchronization journal is placed in RAM. Synchronization with RAM journal provides good I/O performance in any scenario. Full synchronization could occur in the cases described in this KB: https://knowledgebase.starwindsoftware.com/explanation/reasons-why-full-synchronization-may-start/

Disk-based journal placed on a separate disk from StarWind devices. It allows to avoid full synchronization for the devices where it’s configured even when StarWind service is being stopped on all nodes. Disk-based synchronization journal should be placed on a separate, preferably faster disk from StarWind devices. SSDs and NVMe disks are recommended as the device performance is defined by the disk speed, where the journal is located. For example, it can be placed on the OS boot volume.
It is required to allocate 2 MB of disk space for the synchronization journal per 1 TB of HA device size with a disk-based journal configured with 2-way replication and 4MB per 1 TB of HA device size for 3-way replication.

Failure journal
The strategy provides good I/O performance, as a RAM-based journal, while all device nodes are in a healthy synchronized state. If a device on one node went into a not synchronized state, the disk-based journal activates and a performance drop could occur as the device performance is defined by the disk speed, where the journal is located. Fast synchronization is not guaranteed in all cases. For example, if a simultaneous hard reset of all nodes occurs, full synchronization will occur.

Continuous journal
The strategy guarantees fast synchronization and data consistency in all cases. Although, this strategy has the worst I/O performance, because of frequent write operations to the journal, located on the disk, where the journal is located.

5. In Network Options for Replication, press the Change network settings button and select the synchronization channel for the HA device.

6. In Specify Interfaces for Synchronization Channels, select the checkboxes with the appropriate networks and click OK. Then click Next.

7. Select Synchronize from existing Device as the partner device initialization mode.

8. Press the Create Replica button and close the wizard.

9. The added devices will appear in StarWind Management Console.

10. Choose device, open Replication Manager and click Add replica again.

11. Select Synchronous “Two-Way” Replication as a replication mode. Click Next to proceed.

12. Specify a partner Host name or IP address and Port Number.

13. Select the Node Majority failover strategy and click Next.

Node Majority

14. Choose Create new Partner Device and click Next.

15. Specify the partner device Location and modify the target name if necessary. Click Next.

16. Select Synchronization Journal Strategy and click Next.

17. In Network Options for Replication, press the Change network settings button and select the synchronization channel for the HA device.

18. In Specify Interfaces for Synchronization Channels, select the checkboxes with the appropriate networks and click OK. Then click Next.

19. Select Synchronize from existing Device as the partner device initialization mode.

20. Press the Create Replica button and close the wizard.

21. The added devices will appear in StarWind Management Console.

Repeat the steps above to create other virtual disks if necessary.
NOTE: To extend an Image File or a StarWind HA device to the required size, please check the article below:
https://knowledgebase.starwindsoftware.com/maintenance/how-to-extend-image-file-or-high-availability-device/

 

Preparing Datastores

Adding Discover Portals

1. To connect the previously created devices to the ESXi host, click on the Storage -> Adapters -> Configure iSCSI and choose the Enabled option to enable Software iSCSI storage adapter.

Discover Portal

2. In the Configure iSCSI window, under Dynamic Targets, click on the Add dynamic target button to specify iSCSI interfaces.

Add port

3. Enter the iSCSI IP addresses of all StarWind nodes for the iSCSI traffic.

Add dynamic target ESXI

Add dynamic target ESXI

Confirm the actions by pressing Save configuration.

4. The result should look like in the image below:

Configure iSCSI

5. Click on the Rescan button to rescan storage.

Rescan

6. Now, the previously created StarWind devices are visible to the system.

7. Repeat all the steps from this section on the other ESXi host, specifying corresponding IP addresses for the iSCSI subnet.

Creating Datastores

1. Open the Storage tab on one of your hosts and click on New Datastore.

Select creation type

2. Specify the Datastore name, select the previously discovered StarWind device, and click Next.

Select device

3. Enter datastore size and click Next.

Enter datastore size

4. Verify the settings and click Finish.

5. Add another Datastore (DS2) in the same way but select the second device for the second datastore.

6. Verify that your storages (DS1, DS2) are connected to both hosts. Otherwise, rescan the storage adapter.

storages


NOTE: 
Path Selection Policy changing for Datastores from Most Recently Used (VMware) to Round Robin (VMware) is added into the Rescan Script, and this action is performed automatically. For checking and changing this parameter manually, the hosts should be connected to vCenter.
Multipathing configuration can be checked only from vCenter. To check it, click the Configure button, choose the Storage Devices tab, select the device, and click the Edit Multipathing button.

StarWind edit multipath

 

StarWind Edit multipath

Configuring an Automatic Storage Rescan

1. Open the Terminal page.

2. Edit file /opt/StarWind/StarWindVSA/drive_c/StarWind/hba_rescan.ps1 with the following command:
sudo nano /opt/StarWind/StarWindVSA/drive_c/StarWind/hba_rescan.ps1

Modify_Rescan_Script
3. In the appropriate lines, specify the IP address and login credentials of the ESXi host (see NOTE below) on which the current StarWind VM is stored and running:
$ESXiHost = “IP address”
$ESXiUser = “Login”
$ESXiPassword = “Password”

NOTE:  In some cases the rescan script can be changed and storage rescan added for another ESXi host. Appropriate lines should be duplicated and changed with properly edited variables if required.
NOTE: In some cases, it makes sense to create a separate ESXi user for storage rescans. To create the user, please follow the steps below:

Log in to ESXi with the VMware Host Client. Click Manage, and under Security & users tab, in the Users section click Add user button. In the appeared window, enter a user name, and a password.

ESXi_Add_User
Create a new Role, under Roles section, and click New Role button. Type a name for the new role. Select privileges for the role and click OK.
The following privileges might be assigned: Host – Inventory, Config, Local Cim, and Global – Settings.

ESXi_Add_Role

Assign permission to the storage rescan user for an ESXi host  – right-click Host in the VMware Host Client inventory and click Permissions. In the appeared window click Add user.
Click the arrow next to the Select a user text box and select the user that you want to assign a role to. Click the arrow next to the Select a role text box and select a role from the list.


(Optional) Select Propagate to all children or Add as group. Click Add user and click Close.

ESXi_Manage_Permissions_Add_User_for_Host

Make sure that rescan script is working and execute it from the VM: sudo /opt/StarWind/StarWindVSA/drive_c/StarWind/hba_rescan.ps1

4. Repeat all steps from this section on the other ESXi hosts.

Performance Tweaks

1. Click on the Configuration tab on all of the ESXi hosts and choose Advanced Settings.

Advanced Settings
2. Select Disk and change the Disk.DiskMaxIOSize parameter to 512.

Disk.DiskMaxIOSize

3. To optimize  performance change I/O scheduler options according to the article below:
https://knowledgebase.starwindsoftware.com/guidance/starwind-vsan-for-vsphere-changing-linux-i-o-scheduler-to-optimize-storage-performance/ 

NOTE: Changing Disk.DiskMaxIOSize to 512 might cause startup issues with Windows-based VMs, located on the datastore where specific ESX builds are installed. If the issue with VMs start appears, leave this parameter as default or update the ESXi host to the next available build.
NOTE: To provide high availability for clustered VMs, deploy vCenter and add ESXi hosts to the cluster.
Click on Cluster -> Configure -> Edit and check the turn on vSphere HA option if it’s licensed.

vSphere HA option

Conclusion

The Configuration Guide for StarWind Virtual SAN in a 3-node hyperconverged scenario with VMware vSphere offers detailed steps for enhancing virtualized environments through advanced storage solutions. By leveraging StarWind Virtual SAN, organizations can significantly optimize their VMware clusters, ensuring a resilient, efficient, and scalable infrastructure suitable for various virtualization workloads. 

 

Hey! Don’t want to tinker with configuring all the settings? Looking for a fast-track to VSAN deployment?
Dmytro Malynka
Dmytro Malynka StarWind Virtual SAN Product Manager
We've got you covered! First off, all trial and commercial StarWind customers are eligible for installation and configuration assistance services. StarWind engineers will help you spin up the PoC setup to properly evaluate the solution and will assist with the production deployment after the purchase. Secondly, once deployed, StarWind VSAN is exceptionally easy to use and maintain. Hard to believe? Wait no more and book a StarWind VSAN demo now to see it in action!