You can customize your OEM installation of the storage appliance through the registry. The customization options provided here should be used to fully customize the branding associated with Microsoft iSCSI Software Target 3.2. This topic contains the registry settings that relate to customizing the storage appliance.

HKLM\Software\Microsoft\iSCSI Target

This is the root key for the Microsoft iSCSI Software Target. OEMs can add subkeys for customizations to Microsoft iSCSI Software Target under this key.

Name Type OEM access Description

Guid

REG_SZ

Custom

The iSCSI target (subsystem) unique identifier.

DescriptiveName

REG_SZ

Custom

This value contains the friendly name that describes the iSCSI target (subsystem). The descriptive name is configurable by using the VDS Hardware Provider.

AutoIQNFormat

REG_SZ

Custom

(default: iqn.1991-05.com.microsoft:%S-%T-target)

The value uses a similar format as the C run-time library printf function. Microsoft iSCSI Software Target 3.2 will replace the variables with the appropriate value when it generates the target IQN.

The supported variables are:

  • %G - A unique identifier for the iSCSI target network entity.

  • %P - An OEM-definable product ID that can be configured via the registry (see ProductId).

  • %S - The storage appliance host name (not a fully-qualified domain name).

  • %T - The friendly name for the iSCSI target. This name is unique within the storage appliance. This variable is required to ensure the auto-generated IQN is unique within the system.

  • %V - An OEM-definable product revision that can be configured in the registry (see ProductRevision).

VendorId

REG_SZ

Custom

(default: MSFT)

This value is returned as the Vendor Id in the standard INQUIRY data. This value has a maximum length of 8 characters. If there are fewer than 8 characters, the remaining characters are padded with spaces.

ProductId

REG_SZ

Custom

(default: Virtual HD)

This value is returned as the Product Id in the standard INQUIRY data. This value has a maximum length of 16 characters. If there are fewer than 16 characters, the remaining characters are padded with spaces.

ProductRevision

REG_SZ

Custom

(default: 3.2)

This value is returned as the Product Revision in the standard INQUIRY data. This value has a maximum length of 4 characters. If there are fewer than 4 characters, the remaining characters are padded with spaces.

VendorOUI

REG_DWORD

Custom

(default: 0x0003FF)

This value is used to construct the Logical Unit Identification Descriptor that is returned as part of the INQUIRY Vital Product Data - Device Identification Page (Page 0x83). Only 24-bits of this value are valid.

VendorSpecificIdLow

REG_DWORD

Custom

If the value is 0 or does not exist, Microsoft iSCSI Software Target 3.2 will create a random value.

This value is used to construct the Logical Unit Identification Descriptor that is returned as part of the INQUIRY Vital Product Data - Device Identification Page (Page 0x83). This value is 36-bits in length and spans two registry values. The OEM can use this value as the "box serial number".

VendorSpecificIdHigh

REG_DWORD

Custom

If the value is 0 or does not exist, Microsoft iSCSI Software Target 3.2 will create a random value.

The lowest nibble of this value will be prepended to the VendorSpecificIdLow value (above) as the highest nibble to form a 36-bit value.