Share via

Block Storage SMAPI Test

  • Article

This automated test verifies block storage management on a Storage Area Network (SAN) device. It does this by testing Storage Management API (SMAPI) connectivity from the SAN device (iSCSI target) to the HLK client computer (iSCSI initiator) through a storage provider.

Test details

   
Specifications
  • System.Server.StorageManageability.Smapi.FileStorage.BasicFunction
  • System.Server.StorageManageability.Smapi.BlockStorage.BasicFunction
Platforms
  • Windows Server 2016 (x64)
Supported Releases
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 2
Category Compatibility
Timeout (in minutes) 120
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before running the test, you'll need the following:

  • Hardware
    • A SAN array (and its provider) connected as an iSCSI target with the HLK client computer acting as the iSCSI initiator.
    • Ethernet connectivity between the SAN array/provider and the host (HLK client computer).
  • Software
    • The Windows Standards-Based Storage Management feature. If this package is not installed, the test will automatically install it. The HLK client computer requires internet connectivity for the package to be installed.
    • The Microsoft iSCSI Initiator Service (MSiSCSI). This service comes preinstalled on the Windows operating system. If for any reason this is not installed, install it manually. The test will automatically start the MSiSCSI service if it is not running.

For this test, you must configure a SAN array connected as an iSCSI target to an iSCSI initiator (which is the HLK client computer in this case). The HLK client computer must have the Microsoft iSCSI Initiator Service installed. This service is preinstalled on a Windows operating system. If this service is not running, the test will automatically start the service.

These SAN arrays are not directly connected to host. They connect to the host through a storage provider. A storage provider can provide connectivity to one or more storage arrays.

The test requires a set of parameters to be passed before running the test. These parameters are specific to the SAN array and how it is connected to the host. The following section provides parameter details.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

A value of 0 indicates that the test was successful. A value of 1 indicates that the test failed. The HLK controller will capture this return code, and will show whether the HLK job passed or failed.

Review the test log files saved at TestDestFolder referenced in the parameter list on the HLK client computer, and fix the setup issue that is causing the test to fail.

More information

Parameters

Parameter name Parameter description
ProviderName Name of the provider
ProvisioningType Provisioning Type
Username Provider User Name
Password Provider Password
Netname Provider URI
Port Port Number
StorageSubsystem Name of Storage Subsytem
TargetPortalIP TargetPortal IP Address
StoragePool Storage Pool
HostName Host name of windows server
TestDestFolder Test Destination Folder