Applicable ESXi versions: All
When using VMware ESXi systems with Zadara VPSAs, we recommend that the timeout values indicated below are set accordingly.
These values are changed for all iSCSI connection types (Software Adapter or Hardware). From the Advanced Options option for that Adapter type under Storage Adapters.
Note: that after modification you must reboot the ESXi host to enforce these settings.
The recommended ESXi config values are:
- LoginRetryMax: 4
- LoginTimeout: 20 seconds
- For versions prior to VMware ESXi 6.5.0, 5969303 - 120 seconds
- For VMware ESXi 6.5.0, 5969303 onwards - 30 seconds
- RecoveryTimeout: 40 seconds
Note: Additionally each Virtual Guest should also be adjusted with guest disk-timeout set at 120 seconds.
Setup for Windows Server Failover Clustering and Microsoft Cluster Service:
If you are using Failover Clustering or Microsoft Cluster Services the recommended value for “Disk I/O timeout" is 120 seconds.
This is configured in the Windows registry here: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Disk\TimeOutValue
Other information regarding VMware ESXi / vSphere configuration settings when using WSFC or MSCS can be found here.
Where VMware tools is installed, disk timeout settings are applied. (Note: VMware releases can change configurations from version to version, at the time of writing the below are correct).
For Windows guests with VMware Tools installed, the disk timeout option as seen in the registry setting
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Disk\TimeOutValue is set to 60 seconds. This should be amended to 120 (ie: seconds).
Note: Where VMware Tools is not in use this value is not present so should be created (as a new dword value) and set to 120 (seconds).
For Linux guests with VMware Tools, the disk timeout option is amended to 180 seconds from the default 60 seconds and this does not require changing.
Note: If not using VMware Tools on the linux guest machine please amend to 120 seconds, this setting will differ between Linux variants ie: for CentOS - see /sys/block/<disk>/device/timeout , for Ubuntu it can be changed via udev -
Create a file /etc/udev/rules.d/20-zadara-timeout.rules
and add this line
KERNEL=="sda", SUBSYSTEM=="block", RUN+="/bin/sh -c '/bin/echo 180 > /sys$DEVPATH/device/timeout'"
Regardless of Linux variant, please ensure your change persists through reboots.
|VM Guest Type||VMware Tools||Action|
|Windows||Y||Manually update disk timeout to 120 seconds. Note: Custom changes ought to persist through vmware tools upgrades.|
|Linux||Y||None required, vmware tools installation sets to 180 seconds|
|Windows||N||Manually add registry option as a dword HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Disk\TimeOutValue
and set to 120 seconds
|Linux||N||Amend disk timeout to 120 seconds, depends on the Linux version.|