StorTrends Timeouts
Hypervisors:
o
Any
 Always install client tools for the VM’s if available.
o
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.
o
o
HyperV
 Follow the Windows recommendations below
Citrix
 Follow the Linux recommendations below
Windows (all versions):
o
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.
o
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 MaxRequestHoldTime to 180 seconds (B4 as hex).*
Set LinkDownTime to 180 seconds (B4 as hex).*
Set SrbTimeoutDelta to the default 15 seconds (F as hex).*
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.
Linux:
o
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’”
o
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.
American Megatrends Inc
5555 Oakbrook Parkway, Bldg. 200
Norcross, GA 30093 | t: 770.246.8600
www.ami.com
Sales & Product Information
[email protected]
800.828.9264
Technical Support
[email protected]
770.246.8761
www.stortrends.com
Performance Storage. Proven Value.
CERTIFIED
©2016 American Megatrends Inc. - Specifications subject to change without notice - w34