staging VM Fleet 2.0.1 updates (#164)

* staging VM Fleet 2.0.1 updates

add better description to vmfleet module for PS Gallery
disable windows recovery console in fleet vms - avoid getting trapped under normal (for the fleet) running conditions
use autoranging timespan -> str for time-taken displays
need to clean up session for commonjob (try/finally/etc.)
RS5: handle absence of dynamic cache parameter refresh (setcachebehavior)
use self-ref to Get-FleetVersion to discover module version; Get-Module will return multiple answers on rolling updates that preserve older versions
get-access node must return a plain node name string; simplify to a cluster-always implementation
RS5: internally parameterize the smb info cache timeout; must pay attention to this when dropping flags/run files - recomment this similar to original vm fleet logic
in vm control loop, ignore unmodified files which slide lastwrite up - there is some process by which this happens by about 150ms, and we can avoid being spoofed
add unique content to profile run file to trigger hash check in the correct/expected case
rework set-fleetpause to default to waiting for direct ack from vms (-timeout 0 to simply set); guarantee vms in stable state after pause
show-fleet needs to bucket all disks/initiators for vms together; count one per vm, not per disk
new getlogman facility; be willing to clean up leaked/stale logman collectors, don't error out unnecesarily
change done flag consumption to be directed at the expected/running vms for the iteration; faster as completions come in, and allows for direct logging of VMs which did not respond
fix try/finally cleanup of eap/powerscheme so we cann't touch unset vars; cfdev login issue exposed this since get-fleetversion threw (before originalPowerScheme was set)
don't throw error out of error directory production and drop the original error on the floor
throw error inclusive of all bad XML files in processing DISKSPD results
read cache warmup io size must be under the l1 aging limiter (use 56KiB)
remove conflicting perfctr blg in all cases

* update README for 2.0.2
update version to release (even bld#)

Co-authored-by: Dan Lovinger <[email protected]>

Author: dl2n

Frameworks/VMFleet/VMFleet.Tests.ps1

@@ -702,4 +702,27 @@ InModuleScope VMFleet {
             $f['*1'].MaxOffset | Should Be 0
         }
     }
+
+    Describe "TimespanToString" {
+
+        BeforeAll {
+            $t0 = [datetime] '7/31/1996 12:00PM'
+        }
+
+        It "Seconds" {
+            TimespanToString ($t0.AddMilliseconds(1500) - $t0) | Should Be "01.5s"
+        }
+
+        It "Minutes" {
+            TimespanToString ($t0.AddMinutes(15) - $t0) | Should Be "15m:00.0s"
+        }
+
+        It "Hours" {
+            TimespanToString ($t0.AddHours(15) - $t0) | Should Be "15h:00m:00.0s"
+        }
+
+        It "Days" {
+            TimespanToString ($t0.AddDays(15) - $t0) | Should Be "15d.00h:00m:00.0s"
+        }
+    }
 }

Frameworks/VMFleet/VMFleet.psd1

@@ -36,8 +36,8 @@ SOFTWARE.
 # Script module or binary module file associated with this manifest.
 RootModule = 'VMFleet.psm1'
 
-# Version number of this module.
-ModuleVersion = '2.0.0.0'
+# Version number of this module. Even build# is release, odd pre-release (Mj.Mn.Bd.Rv)
+ModuleVersion = '2.0.2.0'
 
 # Supported PSEditions
 # CompatiblePSEditions = @()
@@ -55,7 +55,7 @@ CompanyName = 'Microsoft Corporation'
 Copyright = '(c) 2021 Microsoft Corporation. All rights reserved.'
 
 # Description of the functionality provided by this module
-Description = 'VM Fleet'
+Description = 'VM Fleet is a performance characterization and analyst framework for exploring the storage capabilities of Windows Server Hyper-Converged environments with Storage Spaces Direct'
 
 # Minimum version of the Windows PowerShell engine required by this module
 PowerShellVersion = '5.1'
@@ -173,7 +173,7 @@ PrivateData = @{
         # LicenseUri = ''
 
         # A URL to the main website for this project.
-        # ProjectUri = ''
+        ProjectUri = 'https://www.github.com/microsoft/diskspd'
 
         # A URL to an icon representing this module.
         # IconUri = ''