Hypervisors

• Any
Always install client tools for the VM’s if available.
• VMWare
For software iSCSI Adapter set the Configuration->Storage Adpaters->Software iSCSI Adapter->Properties->Advanced->Recovery Timeout to 120 seconds.

NOTE: After modifying the iSCSI Adapter “RecoveryTimeout” value, the ESX iSCSI Initiator MUST disconnect and reconnect all StorTrends targets, or simply reboot the ESX server for the change to take effect.

• HyperV
Follow the Windows recommendations below
• Citrix
Follow the Linux recommendations below

Windows (all versions)

• Any system which uses a StorTrends drive either directly or indirectly
This value should be set for both virtual and physical machines whose underlying drive is a StorTrends iSCSI drive even if passed through a hypervisor.
Change the registry key HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Services/Disk/ TimeOutValue to be 190 seconds (BE in hex).* If it is not present, please create the DWORD entry.

NOTE: After changing settings in the registry the Windows server MUST be rebooted for the changes to take effect.

• Additional settings when connecting to a StorTrends drive via Microsoft iSCSI Initiator

These additional registry key changes are for both physical and virtual machines connecting to StorTrends targets via a Microsoft iSCSI Initiator. All other registry settings related to the Microsoft iSCSI Initiator should be left at the default settings. Please refer the Microsoft iSCSI initiator User Guide for default values.
Example: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e97b-e325-11ce-bfc1-08002be10318}\<instance number>\Parameters

Set LinkDownTime to 180 seconds (B4 as hex).*
Set MaxRequestHoldTime to 180 seconds (B4 as hex).* Set SrbTimeoutDelta to the default 15 seconds (F as hex).*
On Windows 8/Windows Server 2012 systems: set the ErrorRecoveryLevel to 0 (zero) to ensure that the initiator reconnects reliably.*
These values may occur multiple times in the registry. Please set all of them the same.

NOTE: After changing settings in the registry the Windows server MUST be rebooted for the changes to take effect.

• Like Disk TimeoutValue for NAS volumes, SMB SessTimeout should be set to 200 seconds on the registry / Request Expiration Timer [MS-SMB2] /Client session timeout (SMB1)

This is the amount of time the client waits for the server to respond to an outstanding request. This timeout value can be adjusted through the following registry setting:
\HKLM\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters\SessTimeout
Value type: Dword
Decimal Value: 200

• Error while copying data to NAS share “Error 0x8007003B unexpected network error”

Increase the timeout setting to 600, if Windows reported “0x7008003B” error code.
From Windows power shell, run “Set-SmbClientConfiguration -SessionTimeout 600”
OR,
Edit the registry to update the following parameter:
\HKLM\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters\SessTimeout
Value type: Dword
Decimal Value: 600

NOTE: After changing settings in the registry the Windows server MUST be rebooted for the changes to take effect.

Linux

• Any system which uses a StorTrends drive either directly or indirectly

When connecting to a StorTrends target the block device timeout needs to be modified to 190 seconds. It needs to be greater than the replacement_timeout value. If being connected to via a Hypervisor as a VM hard drive please use the tools recommended by the Hypervisor as the udev ‘vendor’ and ‘model’ attribute values may be different. E.g. VMTools creates an udev rule for VMDKs with the appropriate timeout as VMDKs have different ‘vendor’ and ‘model’ attributes than StorTrends iSCSI drives.
* This can be done manually each time the target is connected to by running echo 190 > /sys/ block/<device name>/device/timeout. Where, the device name will be known only after the login.
* To automatically set this value when an iSCSI login happens, such as persistent targets during reboot, add a new udev rule. In most distoro’s the path will be /etc/udev/rules.d/99-stortrends-scsi-udev.rules. The new udev rule will only work for new connections; any existing connections will either require a logout/login of the target or the aforementioned manual method.
* UDev rule for Citrix VDisk’s: #Citrix VDisk
ACTION==”add”, SUBSYSTEMS==”scsi”, ATTRS{vendor}==”QENU” , ATTRS{model}==”QEMU HARDDISK”, RUN+=”/bin/sh -c ‘echo 190 >/sys$DEVPATH/device/timeout’”
* UDev rule for RedHat/Fedora and SuSE 11.2 OS: #StorTrends iSCSI
ACTION==”add”, SUBSYSTEMS==”scsi”, ATTRS{vendor}==”AMI” , ATTRS{model}==”StorTrends iTX”, RUN+=”/bin/sh -c ‘echo 190 >/sys$DEVPATH/device/timeout’”
• Additional settings when connecting to a StorTrends drive via OpenISCSI
This value should be set for both virtual and physical machines whose underlying drive is a StorTrends
iSCSI drive. The default configuration file path is “/etc/iscsi/iscsid.conf”. Any existing iSCSI connections will have to be disconnected and removed from the iscsiadm database then logged back into for the new setting to take effect.
– Set node.session.timeo.replacement_timeout to 180 seconds.