DiskSpd Storage Performance Tool

To use VMFleet, install the module from the PowerShell Gallery, import it, and disable the Storage Spaces Direct cache, as it is not currently supported for Arc-enabled VMs.

Commands:

Install-Module -Name "VMFleet"
Import-Module VMFleet
Set-ClusterStorageSpacesDirect -CacheState Disabled;

Sanity Checks:

• Use Get-Module VMFleet to verify installation.
• Use Get-Command -Module VMFleet to list available functions.
• Run Install-Fleet to set up the directory structure within your 'collect' CSV. This creates:
  • Collect/control: Contains arc.json (Arc config) and monitoring scripts.
  • Control.ps1: The control loop script used by VMs.
  • Run.ps1: The script VMs execute for parameter updates.
  • Collect/flag: Directory for 'go', 'pause', and 'done' flag files.
  • Collect/result: Directory for VMFleet test run output files.
  • Collect/tools: Contains preinstalled DiskSpd.

Install-Module -Name "VMFleet"
Import-Module VMFleet
Set-ClusterStorageSpacesDirect -CacheState Disabled;

# Initialize directory structure
Install-Fleet

The Measure-FleetCoreWorkload command requires specific NuGet packages and modules for diagnostic data collection (Get-SDDCDiagnosticInfo).

Warning: The following script temporarily sets the PSGallery repository to Trusted to allow installation, which relaxes the security boundary. It attempts to restore the original installation policy after completion.

$repo = Get-PSRepository -Name PSGallery
if ($null -eq $repo) { Write-Host "The PSGallery is not configured on this system, please address this before continuing" }
else {
    if ($repo.InstallationPolicy -ne 'Trusted') {
        Write-Host "Setting the PSGallery repository to Trusted, original InstallationPolicy: $($repo.InstallationPolicy)"
        Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
    } 

    ### Installing the pre-requisite modules

    Install-PackageProvider NuGet -Force
    Install-Module -Name PrivateCloud.DiagnosticInfo -Force
    Install-Module -Name MSFT.Network.Diag -Force

    if ($repo.InstallationPolicy -ne 'Trusted') {
        Write-Host "Resetting the PSGallery repository to $($repo.InstallationPolicy)"
        Set-PSRepository -Name PSGallery -InstallationPolicy $repo.InstallationPolicy
    } 
}

Use Set-ArcConfig to configure the requirements for creating Arc-enabled Virtual Machines. This command handles resource group creation and stores configuration in arc.json.

Parameters:

• -ResourceGroup: The resource group where Arc VMs will be deployed.
• -AzureRegistrationUser: Azure account credentials.
• -AzureRegistrationPassword: Azure account credentials.
• -StoragePathCsv (optional): Path to the CSV where the storage path resource will be created. Defaults to an existing CSV if omitted.
• -StoragePathName (optional): Name used to create the gallery image. Defaults if omitted.
• -ImageName (optional): Name of the gallery image (currently only Windows gallery images are supported). Defaults if omitted.
• -Enabled: Set to $true to enable Arc-enabled VM creation (defaults to $false).
• -ResetSalt: Resets the 4-character alphanumeric salt used in Arc resource names. Useful for regenerating names if multiple clusters share a subscription/resource group.

Use Set-ArcConfig to set up the configuration required for creating Arc-enabled Virtual Machines. This command manages resource groups, Azure credentials, and storage paths.

Parameters:

• -ResourceGroup: The resource group where ARC VMs will be deployed.
• -AzureRegistrationUser: Azure account credentials (username).
• -AzureRegistrationPassword: Azure account credentials (password).
• -StoragePathCsv (optional): Path to the CSV where storage path resources will be created. If omitted, an existing CSV created earlier is used by default.
• -StoragePathName (optional): Name used to create the gallery image. Defaults to a standard name if omitted.
• -ImageName (optional): Gallery image name used to create Arc-enabled VMs. Defaults to a standard name if omitted.
• -Enabled (optional): Set to $true to enable the creation of Arc-enabled virtual machines. Defaults to $false.
• -ResetSalt (optional): Regenerates the 4-character alphanumeric salt used in Arc resource names (e.g., vm-group-node-salt-001). This is useful for preventing name collisions when running multiple clusters under the same subscription and resource group. Running this overrides the existing salt in arc.json.