Share via


CiB Raid Controller Kit Tests

The tests help validate that a Continuously Available (CA) storage controller and drivers meet all applicable requirements. The tests conduct various end-to-end test scenarios by running I/O workloads, data integrity tests against the cluster during a planned or unplanned failover, and validates that the hardware platform under test meets CA hardware requirements.

Test details

Associated requirements

Device.Storage.Controller.Raid.ContinuousAvailability Device.Storage.Controller.Raid.ContinuousAvailability.ActiveMode Device.Storage.Controller.Raid.ContinuousAvailability.FailoverClustering Device.Storage.Controller.Raid.ContinuousAvailability.LunAccess Device.Storage.Controller.Raid.ContinuousAvailability.RAID Device.Storage.Controller.Raid.ContinuousAvailability.RecoveryProcessing

See the device hardware requirements.

Platforms

Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows Server 2012 R2

Expected run time

~270 minutes

Categories

Basic Certification Reliability

Type

Automated

 

Running the test

Before you run the test, complete the test setup as described in the test requirements for the type of storage controller that you are testing: Storage Adapter or Controller Testing Overview.

Hardware requirements

The following network requirements on the cluster nodes and test clients must be met:

  • A minimum of two 1-Gigabit Ethernet adapters plus a private network for cluster communications.

  • We recommend one 10Gigabit Ethernet adapter.

  • All cluster nodes must have IP addresses that are provided by DHCP.

  • DNS resolution for all cluster nodes and test clients.

The following requirements on the cluster and cluster nodes must be met:

  • The cluster nodes must meet the Failover Clustering hardware requirements for Windows Server 2008 R2, Windows Server 2012, and Windows Server 2012 R2.

  • The cluster nodes must meet the hardware requirements for Windows Server 2008 R2, Windows Server 2012, and Windows Server 2012 R2.

  • The cluster nodes must have approximately 100 GB of free space on the local hard drive.

  • Cluster names should not exceed 9 characters.

The following requirements on the test clients must be met:

  • The test client must meet the hardware requirements for Windows Server 2008 R2, Windows Server 2012, and Windows Server 2012 R2.

  • The test client must have approximately 100 GB of free space on the local hard drive.

  • The test client must have at least 32 GB of memory.

  • We recommend that the test client have at least two quad core processors.

The following shared storage requirements must be met:

  • Must have at least 22 shared LUNs.

  • Must have a minimum LUN size of 1 GB.

  • Must be using either RAID1, RAID5, RAID6, or RAID10.

  • All LUNs must be visible on all cluster nodes.

  • All LUNs must be initialized and formatted as NTFS volumes with appropriate drive letters.

Software requirements

The following Active Directory Domain Services requirements must be met:

  • Windows Server 2008 R2 and Windows Server 2012 Active Directory Domain Services

  • All nodes must be joined to the same domain.

  • You must have logged in as a member of the Domain Admins security group on the test clients.

The following operating system requirements must be met:

The following role services and feature must be installed on the cluster nodes and test clients:

  • File Server

  • iSCSI Target Server

  • Server for NFS

  • Failover Clustering

  • Active Directory Domain Service (test clients only)

  • Client for NFS

To start the tests

  1. Run the following commands from an elevated command prompt:

    pushd "%ProgramFiles(x86)%\Windows Kits\8.1\Hardware Certification Kit\Tests\amd64\NTTEST\BASETEST\core_file_services\Shared_tests\CiBValidationKit\Tests"copy /y StressLog_Copy.dll StressLog.dllpopd
    
  2. Open Windows HCK Studio.

  3. Create a project.

  4. In Device Manager, search for “raid” and select your controllers for the test pool.

  5. Right-click each selected target. Click Add new features, select Device.Storage.Controller.Raid.ContinuousAvailability, and then click OK.

  6. Click the Tests tab, select CiB Raid Controller Test, and click Run Selected. Assign TestMachine to the client test machine.

  7. Assign the remaining node to the remaining machine.

  8. In the parameters, change the domain name, username, and cluster name.

  9. Click OK to schedule the test.

Troubleshooting

For troubleshooting information, see Troubleshooting Device.Storage Testing.

An error similar to “Cluster failure: test case ### failure” indicates that the cluster has not properly configured. Make sure that your shared disks are initialized and formatted as NTFS volumes to ensure a cluster can be formed and that no clusters or resource groups exist with the name specified in the cluster parameter.

If failures are found in the reboot fault scenario, you can increase the wait time by editing the configuration xml file as detailed below:

  1. On the Windows HCK Controller, find the .xml file to edit in the following folder: C:\Program Files (x86)\Windows Kits\8.1\Hardware Certification Kit\Tests\amd64\NTTEST\BASETEST\core_file_services\Shared_tests\CiBValidationKit\ IHVTestKit_Configuration.xml.

  2. In the file, there are instances of “WaitPeriodInSeconds=”120”/>” for each failure action. There are instances for the MoveGoup, Reboot, KernelCrash and DualActive failure scenarios.

    Find the sections in the .xml file that state the wait period in seconds and change them from 120 to 300, as shown in the following example:

    FailureScenario              ID="Reboot"Requirement="LUNAccess"        Type="Software" Name="Node software failure via OS reboot" FailoverExpected="Yes"Iterations="2"><PreAction Command="Identifies and performs an OS reboot on the active cluster node"WaitPeriodInSeconds="10" /><FailureAction Command="FailOverSimulator.ps1 -FailType RebootMachine -ResourceGroup $ResourceGroup$"WaitPeriodInSeconds="120" />  INVALID USE OF SYMBOLS-Make it 300<PostAction Command="PostAction: Reboot_Node"WaitPeriodInSeconds="10" /></FailureScenario>
    
  3. If failures are found in other tests cases, you can review the logs to get additional details about the failures. The logs are on the Windows HCK Controller and can be found in the following folders:

    • HCK studio\Results\Run Eval Quality tests\Logs\te.wtl

    • HCK studio\Results\Run Raid Controller tests\Logs\te.wtl

More information

Parameters

Parameter Description

AutomatedOnly

Specify true if this test should not run any manual tests.

NODE1

The first node in the cluster.

NODE2

The second node in the cluster.

Domain

The name of the domain to which the cluster nodes are joined.

UserName

The user name of a user in the Domain Admins security group.

Password

The password of the user in the Domain Admins security group.

 

 

 

Send comments about this topic to Microsoft