TurnKeySdn

0.0.32

Utils.psm1

Import-Module $PSScriptRoot\ClusUtils.psm1
Import-Module $PSScriptRoot\Logger.psm1
Import-Module $PSScriptRoot\PsHelper.psm1

function Copy-FileToRemote {
    param(
        [parameter(Mandatory=$true)][string] $srcPath,
        [parameter(Mandatory=$true)][string] $srcFile,
        [parameter(Mandatory=$true)][string] $destMachine,
        [parameter(Mandatory=$true)][pscredential] $destMachineCred,
        [parameter(Mandatory=$true)][string] $destDirectory
    )

    $s = New-ReliablePsSession -ComputerName $destMachine -Credential $destMachineCred
    try {
        $fileExist = Invoke-Command -Session $s -ScriptBlock {
            param($destDirectory, $destFile)
            if (-not $(Test-Path $destDirectory)) {
                New-Item $destDirectory -ItemType Directory -Force -ErrorAction Stop | Out-Null
                return $false
            } 
            $dest = Join-Path $destDirectory $destFile 
            Test-Path $dest        
        } -ArgumentList ($destDirectory, $srcFile) -ErrorAction Stop

        if ($fileExist) {
            return
        }
        $src = Join-Path $srcPath $srcFile
        if (Test-IsCsvPath -path $destDirectory) {
            Copy-Item -Path $src -Destination $destDirectory
            return
        }
        $fileSharePath = Join-Path "\\$destMachine" $destDirectory.Replace(":","$")
        if (Test-Path $fileSharePath) {
            Copy-Item -Path $src -Destination $fileSharePath
            return
        }
        Copy-Item -Path $src -Destination $destDirectory -ToSession $s
        
    } finally {
        if ($s -ne $null ) {
            $s | Remove-PSSession
        }
    }
}

function Test-FileExist {

    param(
        [parameter(Mandatory=$true)][string] $path
    )

    if (-not $(Test-Path $path)) {
        throw "File $path not found"
    }
}

function Test-VMSwitchExist {
    param(
        [array] $computerName,
        [pscredential] $credential = [pscredential]::Empty,
        [string] $switchName
    )

    $err = Invoke-Command -ComputerName $computerName -credential $credential -ScriptBlock {
        param($switchName)

        if($(Get-VMSwitch -Name $switchName -ErrorAction SilentlyContinue) -eq $null) {
            return "$(hostName)"
        }
    } -ArgumentList $switchName -ErrorAction Stop

    if ($err -ne $null) {
        throw "Switch $switchName not found on host(s) $err"
    }
}

function Test-InternetConnectivity {

    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty,
        [string] $srcAddress
    )

    Write-TraceLog "Test-InternetConnectivity: Testing on $computerName from $srcAddress"

    $result = Invoke-ReliableCommand -ComputerName $computerName -Credential $credential -ScriptBlock {
        param($srcAddress)

        $destIP = (Resolve-DnsName bing.com -Type A -ErrorAction SilentlyContinue | Select -First 1).IPAddress

        if ($destIP -eq $null) {
            return $false
        }

        if ([string]::IsNullOrEmpty($srcAddress)) {
            $result = ping $destIP -n 2
        } else {
            $result = ping -S $srcAddress $destIP -n 2
        }

        if (($result | Select-String "unreachable" | Select -First 1) -ne $null) {
            return $false
        }

        return ($result | Select-String "Received = 0") -eq $null
    } -ArgumentList ($srcAddress)

    return $result -eq $true
}

function Resolve-InternetSwitch {
    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty
    )

    $switches = Invoke-ReliableCommand -ComputerName $computerName -Credential $credential -ScriptBlock {
        $switches = (Get-VMSwitch).Name
        return $switches
    }

    foreach ($s in $switches) {
        Write-TraceLog "Resolve-InternetSwitch: Checking switch $s on computer $computerName"

        $ips = Invoke-ReliableCommand -ComputerName $computerName -Credential $credential -ScriptBlock {
            param($s)
            $nics = (Get-VMNetworkAdapter -SwitchName $s -ManagementOS).name
            $allProbableOutBoundIPs = @()
            foreach ($n in $nics) {                 
                $adapter = Get-NetAdapter | Where-Object {$_.Name -like "*$n*" -and $_.Status -eq "up"};  
                
                if ($adapter -eq $null) {
                    continue
                }
                
                $ip = (Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 -ErrorAction SilentlyContinue | `
                    Where-Object {-not ($_.IPaddress.StartsWith("169"))}).IPAddress | Select -First 1
                    
                if ($ip -ne $null) {
                    $allProbableOutBoundIPs += $ip
                }
            }    
            return $allProbableOutBoundIPs   
        } -ArgumentList($s)
        
        foreach($ip in $ips) {
            $result = Test-InternetConnectivity -srcAddress $ip -computerName $computerName -credential $credential
            if ($result) {
                Write-TraceLog "Resolve-InternetSwitch: Switch $s on computer $computerName selected"
                return $s
            }
        }
    }

    Write-TraceLog "Resolve-SdnSwitch: No suitable internet switch found on computer $computerName"
}

function New-InternetSwitch {
    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty,
        [string] $name 
    )

    $iswitch = Resolve-InternetSwitch -computerName $computerName -credential $credential

    if ($iswitch -ne $null) {
        return $true
    }

    $ifIndex = Get-InternetAdapterIndex -computerName $computerName -credential $credential

    if ($ifIndex -eq $null) {
        return $false
    }

    $scriptBlock = {
        param($ifIndex, $name)
        $ifdesc = (Get-NetAdapter -InterfaceIndex $ifIndex).InterfaceDescription
        # remove any existing switch with the same name, in case there is a stale one
        remove-vmswitch -name $name -ErrorAction SilentlyContinue
        new-vmswitch -Name $name -InterfaceDescription $ifdesc | out-null
    } 

    Invoke-ReliableCommand -ComputerName $computerName -credential $credential `
        -ScriptBlock $scriptBlock -ArgumentList @($ifIndex, $name)

    return $true

}
function Resolve-SdnSwitch {
    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty
    )

    $result = Invoke-ReliableCommand -ComputerName $computerName -Credential $credential -ScriptBlock {

        $allSwitches = Get-VMSwitch -ErrorAction SilentlyContinue
        foreach ($s in $allSwitches) {
            foreach($e in $s.Extensions) {
                if ($e.Name -eq "Microsoft Azure VFP Switch Extension" -and $e.Enabled -eq $true) {
                    $sdnSwitch = $s.Name
                }
            }
        }
        
        # if there is VFP enabled switch, use it
        if (-not [String]::IsNullOrEmpty($sdnSwitch)) {
            return $sdnSwitch, "VFP"
        }            

        # if there is a switch on mellanox nic, use it. A common pattern for test setups.
        $sdnSwitch = ($allSwitches | `
            Where-Object { $_.NetAdapterInterfaceDescriptions -ilike "*Mellanox*" }).Name
        
        if (-not [String]::IsNullOrEmpty($sdnSwitch)) {
            return $sdnSwitch, "MellanoxNic"
        }

        # best effort, a common pattern for naming sdn switch in test setups.
        $sdnSwitch = ($allSwitches | `
            Where-Object {$_.Name -ilike "*sdnswitch*"}).Name

        if (-not [String]::IsNullOrEmpty($sdnSwitch)) {
            return $sdnSwitch, "NamePattern"
        }
        
    }   
    
    if ($result -ne $null -and -not [String]::IsNullOrEmpty($result[0])) {
        Write-TraceLog "Resolve-SdnSwitch: Selected $($result[0]) on computer $computerName, Reason $($result[1])"
        return $result[0]
    }

    Write-TraceLog "Resolve-SdnSwitch: No suitable sdn switch found on computer $computerName"
}

function New-SdnSwitch {
    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty,
        [string] $name 
    )

    $sdnswitch = Resolve-SdnSwitch -computerName $computerName -credential $credential

    if ($sdnswitch -ne $null) {
        return $true
    }

    $scriptBlock = {
        param($name)

        $mellanoxNic = (Get-NetAdapter -InterfaceDescription *Mellanox* | Sort-Object -Property InterfaceDescription | Where-Object {$_.Status -eq "Up"} | Select-Object -Last 2).InterfaceDescription
                
        if ($mellanoxNic -eq $null) {
            return $false
        }

        remove-vmswitch -name $name -ErrorAction SilentlyContinue
        new-vmswitch -Name $name -InterfaceDescription $mellanoxNic | out-null
        return $true
    } 

    $result = Invoke-ReliableCommand -ComputerName $computerName -credential $credential `
        -ScriptBlock $scriptBlock -ArgumentList @($name)

    return $result

}

function Disable-LinkLocalNics {
    param (
        [string] $computerName = (hostname),
        [pscredential] $credential = [pscredential]::Empty
    )

    $scriptBlock = {
        $indexes = (Get-NetIPAddress | Where-Object {$_.IPaddress.StartsWith("169") }).InterfaceIndex

        foreach($index in $indexes) {
            $netAdapter = Get-NetAdapter -InterfaceIndex $index -ErrorAction SilentlyContinue
            
            if ($netAdapter.Name -ilike "*SMB*") {
                continue
            }

            if ($netAdapter -ne $null) {
               $netAdapter | Disable-NetAdapter -ErrorAction SilentlyContinue -Confirm:$false
            }
        }
    }

    Invoke-ReliableCommand -computerName $computerName -credential $credential -scriptblock $scriptBlock
}

function Get-InternetAdapterIndex
{
    param(
        [array]$computerName,
        [pscredential] $credential = [pscredential]::Empty
    )

    $scriptBlock = {
        $retry = 0
        while ($true) {
            try {
                $dnsRes = Resolve-DnsName bing.com -Type A -ErrorAction Stop -DnsOnly | select -First 1
                break
            } catch {
                if ($retry -lt 3) { 
                    $retry++ 
                    Write-Error "Failed to resolve dns, retrying"
                    Start-Sleep 1
                    continue
                }
                Write-Error "Failed to resolve dns halting. Make sure the machine has internet access"
                Write-Error $_ -ErrorAction Stop
            }
        }

        
        $ip = $dnsRes.IpAddress
        $corpInterface = (Test-NetConnection -ErrorAction SilentlyContinue).InterfaceAlias
        
        if ($corpInterface -eq $null) {
            $connect = Test-NetConnection -ComputerName $ip -Port 80
            $corpInterface = $connect.InterfaceAlias
        }

        $adapter = Get-NetAdapter -Name $corpInterface -ErrorAction Stop
        return $adapter.ifIndex
    }

    $index = Invoke-ReliableCommand -computerName $computerName -credential $credential -scriptblock $scriptBlock
    return $index
    
}

function Update-CorpNicDnsServerAddress
{
    param(
        [array]$hosts,
        [pscredential] $credential = [pscredential]::Empty,
        [array] $dnsServers
    )

    if ($dnsServers -eq $null -or $dnsServers.Count -eq 0) {
        return
    }
    
    $updateDns = {
        param(
            $index,
            [array]$dnsServers
        )
        Set-DnsClientServerAddress -ServerAddresses $dnsServers -InterfaceIndex $index -ErrorAction Stop -Verbose
    } 

    $getIfIndex = {
        [array]$ifIndexes = (Get-DnsClientServerAddress | `
            Where-Object  { $_.AddressFamily -eq 2 -and $_.ServerAddresses.Count -gt 0}).InterfaceIndex | `
            Select-Object -Unique
        return $ifIndexes
    }

    $hosts | ForEach-Object {
        Write-TraceLog "Update-CorpNicDnsServerAddress: Host ($_), fetching adapters to update"
        $ifIndexes = Invoke-ReliableCommand -computerName $_ -credential $credential -scriptblock $getIfIndex
        foreach($ifIndex in $ifIndexes) {       
            Write-TraceLog "Update-HostDnsServerAddress: Host ($_) adapter $ifIndex with dns $dnsServers"
            Invoke-ReliableCommand -computerName $_ -credential $credential -scriptblock $updateDns -ArgumentList @($ifIndex, $dnsServers)
        }
    }
}

function Get-NextMacAddress
{
    param(
        [String] $MacAddress
    )

    return ("{0:X12}" -f ([convert]::ToInt64($MacAddress.ToUpper().Replace(":", "").Replace("-", ""), 16) + 1)).Insert(2, "-").Insert(5, "-").Insert(8, "-").Insert(11, "-").Insert(14, "-")
}

function Restart-LanmanWorkstationService {

    Write-TraceLog "Restart-LanmanWorkstationService: Restarting LanmanWorkstation service"
    Get-SmbMapping | Remove-SmbMapping -Force | Out-Null
    Restart-Service LanmanWorkstation -Force | Out-Null

    $notStarted = $true
    $retryCount = 10
    while($notStarted) {
        $retryCount--
        Write-TraceLog "Restart-LanmanWorkstationService: Waiting for LanmanWorkstation service to start"
        Start-Sleep 5
        $notStarted = (get-service LanmanWorkstation).Status -ne "Running"

        if ($retryCount -lt 0) {
            throw "Restart-LanmanWorkstationService: Failed waiting for LanmanWorkstation service to start"
        }
    }
}

function Connect-SMBShare {
    param (
        [Parameter(Mandatory=$true)] [pscredential] $Credential,
        [Parameter(Mandatory=$true)] [string] $RemotePath,
        [Parameter(Mandatory=$false)] [switch] $RestartLanManServer
    )

    Write-TraceLog "Connect-SMBShare: Connecting to $RemotePath, User: $($Credential.UserName)"
    # net use sometimes hung with multiple connections etc, restart the service to fix it

    if ($RestartLanManServer.IsPresent) {
      Restart-LanmanWorkstationService
    }

    $retry = $true
    while($true) {
        try {
            New-SmbMapping -RemotePath $RemotePath -UserName $($Credential.UserName) -Password $($Credential.GetNetworkCredential().Password) -Persistent $true | Out-Null
            break
        } catch {
 
            Write-TraceLog "Connect-SMBShare: Failed to connect to $RemotePath"
            Write-TraceLog "Connect-SMBShare: Error $_"
            if ($_.Exception.Message -like "*Multiple connections to a server*" -and $retry) {
                $retry = $false
                Write-TraceLog "Connect-SMBShare: restarting lanmanworkstation service and retry"
                Restart-LanmanWorkstationService
                continue
            }

            return $false
        }
    }

    if($(Test-Path  $RemotePath)) {
        Write-TraceLog "Connect-SMBShare: Connected to $RemotePath"
    } else {
        Write-TraceLog "Connect-SMBShare: Failed to connect to $RemotePath"
        return $false
    }

    return $true
}

function Get-VMHostName {
    param (
       [Parameter(Mandatory=$true)] [array] $Computers,
       [Parameter(Mandatory=$true)] [pscredential] $Credential,
       [Parameter(Mandatory=$true)] [string] $VMName
       )

   foreach($c in $Computers) {
       $scriptBlock = {
           param($VMName)
           $vm = Get-VM -Name $VMName -ErrorAction SilentlyContinue
           return ($vm -ne $null)
       }

       $result = Invoke-ReliableCommand -ComputerName $c -Credential $Credential -ScriptBlock $scriptBlock -ArgumentList $VMName 

       if ($result) {
           return $c
       }
   }

   return $null
}

function Install-SshKey {
    param(
        [Parameter(Mandatory=$true)] [array] $Computers,
        [Parameter(Mandatory=$true)] [pscredential] $Credential,
        [Parameter(Mandatory=$true)] [string] $SshKey,
        [Parameter(Mandatory=$true)] [string] $KeyPath
    )

    $scriptBlock = {
        param($SshKey, $KeyPath, $KeyUser)
        $startLine = "-----BEGIN OPENSSH PRIVATE KEY-----`n"
        $endLine = "-----END OPENSSH PRIVATE KEY-----`n"
        
        $content = $startLine
        
        $SshKey.Replace(" ", "`n") | ForEach-Object { 
            $content+= $_ 
        }

        $content += "`n"
        $content += $endLine

        Remove-Item $KeyPath -ErrorAction SilentlyContinue
        $Utf8NoBomEncoding = New-Object System.Text.UTF8Encoding $False
        [System.IO.File]::WriteAllLines($KeyPath, $content, $Utf8NoBomEncoding)
        $acl = Get-Acl $KeyPath
        $acl.SetAccessRuleProtection($true,$false)
        $accessRule = New-Object System.Security.AccessControl.FileSystemAccessRule($KeyUser, "FullControl", "Allow")
        $acl.SetAccessRule($accessRule)
        $acl | Set-Acl $KeyPath
    }

    foreach($c in $Computers) {
        Invoke-ReliableCommand -ComputerName $c -Credential $Credential -ScriptBlock $scriptBlock -ArgumentList @($SshKey, $KeyPath, $Credential.UserName) | Out-Null
    }
}

function Enable-DefaultFirewallRules {
    param(
        [Parameter(Mandatory=$true)] [array] $ComputerName,
        [Parameter(Mandatory=$false)] [pscredential] $Credential = [pscredential]::Empty
    )

    foreach($c in $ComputerName) {
        Invoke-ReliableCommand -ComputerName $c -Credential $Credential -ScriptBlock {
            Import-Module NetSecurity
            Set-NetFirewallRule -Name "FPS-*" -enabled True
        }
    }
}

function Remove-NCResources {
    param(
        [Parameter(Mandatory=$true)] [string] $NCUri,
        [Parameter(Mandatory=$false)] [pscredential] $Credential = [pscredential]::Empty
    )

    Write-TraceLog "Remove-NCResources: Removing NC resources"
    $nics = Get-NetworkControllerNetworkInterface -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException

    foreach($nic in $nics)
    {
        if ($nic.ResourceId -ilike "*gw*backend" -or  $nic.ResourceId -ilike "*gw*frontend") {
            continue
        }
        
        Write-TraceLog "Remove-NCResources: Removing nic $($nic.ResourceId)"
        Remove-NetworkControllerNetworkInterface -ConnectionUri $NCUri -ResourceId $nic.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }


    $vnets = Get-NetworkControllerVirtualNetwork -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException
    foreach($vnet in $vnets)
    {
        Write-TraceLog "Remove-NCResources: Removing vnet $($vnet.ResourceId)"
        Remove-NetworkControllerVirtualNetwork -ConnectionUri $NCUri -ResourceId $vnet.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

    $lbs = Get-NetworkControllerLoadBalancer -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException
    foreach($lb in $lbs)
    {
        Write-TraceLog "Remove-NCResources: Removing lb $($lb.ResourceId)"
        Remove-NetworkControllerLoadBalancer -ConnectionUri $NCUri -ResourceId $lb.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

    $vgs = Get-NetworkControllerVirtualGateway -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException

    foreach($vg in $vgs)
    {
        Write-TraceLog "Remove-NCResources: Removing vg $($vg.ResourceId)"
        Remove-NetworkControllerVirtualGateway -ConnectionUri $NCUri -ResourceId $vg.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

    $firewalls = Get-NetworkControllerAccessControlList -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException

    foreach($rule in $firewalls) {
        Write-TraceLog "Remove-NCResources: Removing firewall $($rule.ResourceId)"
        Remove-NetworkControllerAccessControlList -ConnectionUri $NCUri -ResourceId $rule.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

    $lnets = Get-NetworkControllerLogicalNetwork -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException

    foreach($lnet in $lnets) {
        if ($lnet.ResourceId -ieq "HNVPA" -or $lnet.ResourceId -ieq "PublicVip" -or $lnet.ResourceId -eq "PrivateVip") {
            continue
        }
        Write-TraceLog "Remove-NCResources: Removing lnet $($lnet.ResourceId)"
        Remove-NetworkControllerLogicalNetwork -ConnectionUri $NCUri -ResourceId $lnet.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

    $publicIps = Get-NetworkControllerPublicIPAddress -ConnectionUri $NCUri -ErrorAction SilentlyContinue -PassInnerException

    foreach($publicIp in $publicIps) {
        Write-TraceLog "Remove-NCResources: Removing public ip $($publicIp.ResourceId)"
        Remove-NetworkControllerPublicIPAddress -ConnectionUri $NCUri -ResourceId $publicIp.ResourceId -Force -ErrorAction SilentlyContinue -PassInnerException
    }

}

function Enable-HostStorageNetwork {

    <#
    .SYNOPSIS
    Enables RDMA on the host and creates vnics for RDMA traffic
    #>

    param(
        [Parameter(Mandatory=$true)] [Array] $ComputerName,
        [Parameter(Mandatory=$false)] [pscredential] $Credential = [pscredential]::Empty,
        [Parameter(Mandatory=$true)] [string] $switchName
    )

    $scriptBlock ={

        param($switchName)

        $team = Get-VMSwitch -name $switchName | Get-VMSwitchTeam -ErrorAction SilentlyContinue
        
        if ($team -eq $null) {
            return
        }

        $rdmaNics = Get-NetAdapter -ErrorAction SilentlyContinue | `
            Where-Object { $_.ComponentID -eq "vms_mp" } | `
            Get-NetAdapterRdma -ErrorAction SilentlyContinue | Where-Object {$_.Enabled -eq $True }
        
        if ($rdmaNics -ne $null -and $rdmaNics.Count -gt 0) {
            return
        }

        $state = (Get-WindowsFeature -Name "Data-Center-Bridging" ).InstallState

        if ($state -ne "Installed") {
            Install-WindowsFeature -Name "Data-Center-Bridging"
        }
        
        $nicDesc = $team.NetAdapterInterfaceDescription
        $nics = (Get-NetAdapter | Where-Object { $nicDesc -contains $_.InterfaceDescription }).Name
        
        $policy = Get-NetQosPolicy -Name "SMB" -ErrorAction SilentlyContinue
        if ($policy -eq $null) {
            New-NetQosPolicy "SMB" -NetDirectPortMatchCondition 445 -PriorityValue8021Action 3
            Enable-NetQosFlowControl -priority 3
        }
        $trafficClass = Get-NetQosTrafficClass "SMB" -ErrorAction SilentlyContinue
        if ($trafficClass -eq $null) {
            New-NetQosTrafficClass "SMB" -priority 3 -bandwidthpercentage 50 -algorithm ETS
        }

        Enable-NetAdapterQos -InterfaceAlias $nics
        Set-NetQosDcbxSetting -InterfaceAlias $_ -Willing $false -Confirm:$false

        $defaultPolicy = Get-NetQosPolicy -Name "DEFAULT" -ErrorAction SilentlyContinue
        if ($defaultPolicy -eq $null) {
            New-NetQosPolicy "DEFAULT" -Default -PriorityValue8021Action 0
            Disable-NetQosFlowControl -priority 0,1,2,4,5,6,7
        }

        Enable-NetAdapterRdma $nics

        $smbNic1 = Get-VMNetworkAdapter -Name "SMB1" -ManagementOS -ErrorAction SilentlyContinue
        if ($smbNic1 -eq $null) {
            Add-VMNetworkAdapter -SwitchName $switchName -Name "SMB1" -managementOS
        }

        $smbNic2 = Get-VMNetworkAdapter -Name "SMB2" -ManagementOS -ErrorAction SilentlyContinue
        if ($smbNic2 -eq $null) {
            Add-VMNetworkAdapter -SwitchName $switchName -Name "SMB2" -managementOS
        }

        Disable-NetAdapterBinding -Name "vEthernet (SMB1)","vEthernet (SMB2)" -DisplayName "Internet Protocol Version 4 (TCP/IPv4)"

        Enable-NetAdapterRDMA -Name "vEthernet (SMB1)","vEthernet (SMB2)"
    }

    foreach($c in $ComputerName) {
        Write-TraceLog "Enable-HostStorageNetwork: Enabling host storage network on $c, switch $switchName" 
        $s = New-ReliablePsSession -ComputerName $c -Credential $Credential
        Invoke-Command -Session $s -ScriptBlock $scriptBlock -ArgumentList @($switchName) | Out-Null
    }
}

function Invoke-PowershellCommandOnVm {
    param(

        [ValidateNotNullOrEmpty()]
        [string] $vmName,

        [ValidateNotNullOrEmpty()]
        [string] $hostName,

        [ValidateNotNullOrEmpty()]
        [string] $cmd,

        [pscredential] $hostCred,
        [pscredential] $vmCred
    )


    Invoke-PowershellCommandOnVmInternal -vmName $vmName `
         -hostName $hostName `
         -hostCred $hostCred `
         -vmCred $vmCred `
         -scriptBlock $scriptBlock `
         -cmd $cmd
}

function Get-HostProcessorCount {
    $logicalCores = ((Get-CimInstance -ClassName Win32_Processor).NumberOfLogicalProcessors | Measure-Object -Sum).Sum
    return $logicalCores
}

function Get-HostMemory {
    return [Math]::Round((Get-WmiObject -Class Win32_ComputerSystem).TotalPhysicalMemory / 1GB)
}

function Disable-IPv6AutoConfig {
    param(
        [Parameter(Mandatory=$true)] [array] $ComputerName,
        [Parameter(Mandatory=$false)] [pscredential] $Credential = [pscredential]::Empty
    )

    foreach($c in $ComputerName) {
        Write-TraceLog "Disable-IPv6AutoConfig: Disabling IPv6 on $c" 
        Invoke-ReliableCommand -ComputerName $c -Credential $Credential -ScriptBlock {
            [array]$interfaces = Get-NetIpInterface | Where-Object { $_.AddressFamily -eq "IPv6" -and $_.RouterDiscovery -eq "Enabled"}
            
            if ($interfaces.Count -eq 0) {
                return
            }

            foreach($iface in $interfaces) {
                
                if ($iface.ifIndex -eq 1) {
                    continue
                }

                Set-NetIpInterface -InterfaceIndex $iface.ifIndex -RouterDiscovery Disabled
            }
        }
    }
}

function Parse-TurnkeyBoolean {
    
    <#
    .SYNOPSIS
     Parses a string to a boolean value
    .Parameter value
    The string to parse
    #>

    param(
        [string] $value
    )

    if ($value -eq "true" -or $value -eq "1") {
        return $true
    }

    return $false
}
# SIG # Begin signature block
# MIIoDAYJKoZIhvcNAQcCoIIn/TCCJ/kCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAn9hR415xgSFCa
# w5k16rfyX8X+Wgea2ovI0f7rGdtMM6CCDXYwggX0MIID3KADAgECAhMzAAAEBGx0
# Bv9XKydyAAAAAAQEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTE0WhcNMjUwOTExMjAxMTE0WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQC0KDfaY50MDqsEGdlIzDHBd6CqIMRQWW9Af1LHDDTuFjfDsvna0nEuDSYJmNyz
# NB10jpbg0lhvkT1AzfX2TLITSXwS8D+mBzGCWMM/wTpciWBV/pbjSazbzoKvRrNo
# DV/u9omOM2Eawyo5JJJdNkM2d8qzkQ0bRuRd4HarmGunSouyb9NY7egWN5E5lUc3
# a2AROzAdHdYpObpCOdeAY2P5XqtJkk79aROpzw16wCjdSn8qMzCBzR7rvH2WVkvF
# HLIxZQET1yhPb6lRmpgBQNnzidHV2Ocxjc8wNiIDzgbDkmlx54QPfw7RwQi8p1fy
# 4byhBrTjv568x8NGv3gwb0RbAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU8huhNbETDU+ZWllL4DNMPCijEU4w
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMjkyMzAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAIjmD9IpQVvfB1QehvpC
# Ge7QeTQkKQ7j3bmDMjwSqFL4ri6ae9IFTdpywn5smmtSIyKYDn3/nHtaEn0X1NBj
# L5oP0BjAy1sqxD+uy35B+V8wv5GrxhMDJP8l2QjLtH/UglSTIhLqyt8bUAqVfyfp
# h4COMRvwwjTvChtCnUXXACuCXYHWalOoc0OU2oGN+mPJIJJxaNQc1sjBsMbGIWv3
# cmgSHkCEmrMv7yaidpePt6V+yPMik+eXw3IfZ5eNOiNgL1rZzgSJfTnvUqiaEQ0X
# dG1HbkDv9fv6CTq6m4Ty3IzLiwGSXYxRIXTxT4TYs5VxHy2uFjFXWVSL0J2ARTYL
# E4Oyl1wXDF1PX4bxg1yDMfKPHcE1Ijic5lx1KdK1SkaEJdto4hd++05J9Bf9TAmi
# u6EK6C9Oe5vRadroJCK26uCUI4zIjL/qG7mswW+qT0CW0gnR9JHkXCWNbo8ccMk1
# sJatmRoSAifbgzaYbUz8+lv+IXy5GFuAmLnNbGjacB3IMGpa+lbFgih57/fIhamq
# 5VhxgaEmn/UjWyr+cPiAFWuTVIpfsOjbEAww75wURNM1Imp9NJKye1O24EspEHmb
# DmqCUcq7NqkOKIG4PVm3hDDED/WQpzJDkvu4FrIbvyTGVU01vKsg4UfcdiZ0fQ+/
# V0hf8yrtq9CkB8iIuk5bBxuPMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg
# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03
# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr
# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg
# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy
# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9
# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh
# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k
# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB
# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn
# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90
# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w
# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o
# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD
# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa
# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny
# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG
# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV
# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG
# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl
# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb
# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l
# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6
# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0
# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560
# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam
# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa
# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah
# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA
# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt
# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr
# /Xmfwb1tbWrJUnMTDXpQzTGCGewwghnoAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB
# BQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIE
# ILhOntrFO0RDIpWWHXy81rrnbpkID6eTvHIR7yBMVPfSMEIGCisGAQQBgjcCAQwx
# NDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29m
# dC5jb20wDQYJKoZIhvcNAQEBBQAEggEALQD/RMXnsVnc37P6y4cxcOYtw4aZQEBc
# mR3/EC+T5FyfUKOhfCZ04V9iyEV7sQ2b9yk9B04EHKwNCrJgfuDzHk5WFtsexluk
# lDKGqvg/z2RfMgMyTBbGLytv5OB41Xo8cgm+fHA8jKq2V5+f9wD1OYLix0UO/jLe
# i2fQ8V9rU46VSFrjtdCOESVqLX/bvWOKm5dxLuUi74FdD9By0nSkpP4bgtF9B3Ym
# X/lc4HBLhcb8CA64PV0URG7NDBcmZ+WvzMJGIpmKq7HxzF3/0PczsWj0XlbKMuWY
# uWFs/Flk/Fkq99DiWekPMTHqh9vIyhJmK752gVwe+zDxhKKxN3VHVKGCF5QwgheQ
# BgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20wghdpAgEDMQ8wDQYJ
# YIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYB
# BAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCC1reJsjDT/q4EaOl95DdifvmVIl8/f
# BfWMlqojNYBWaQIGZ98FnWNrGBMyMDI1MDMyODIwNDcwOC4yMTdaMASAAgH0oIHR
# pIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYD
# VQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hp
# ZWxkIFRTUyBFU046ODYwMy0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU
# aW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgITMwAAAgcsETmJzYX7
# xQABAAACBzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg
# MjAxMDAeFw0yNTAxMzAxOTQyNTJaFw0yNjA0MjIxOTQyNTJaMIHLMQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQg
# QW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODYw
# My0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp
# Y2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDFP/96dPmcfgODe3/n
# uFveuBst/JmSxSkOn89ZFytHQm344iLoPqkVws+CiUejQabKf+/c7KU1nqwAmmti
# PnG8zm4Sl9+RJZaQ4Dx3qtA9mdQdS7Chf6YUbP4Z++8laNbTQigJoXCmzlV34vmC
# 4zpFrET4KAATjXSPK0sQuFhKr7ltNaMFGclXSnIhcnScj9QUDVLQpAsJtsKHyHN7
# cN74aEXLpFGc1I+WYFRxaTgqSPqGRfEfuQ2yGrAbWjJYOXueeTA1MVKhW8zzSEpf
# jKeK/t2XuKykpCUaKn5s8sqNbI3bHt/rE/pNzwWnAKz+POBRbJxIkmL+n/EMVir5
# u8uyWPl1t88MK551AGVh+2H4ziR14YDxzyCG924gaonKjicYnWUBOtXrnPK6AS/L
# N6Y+8Kxh26a6vKbFbzaqWXAjzEiQ8EY9K9pYI/KCygixjDwHfUgVSWCyT8Kw7mGB
# yUZmRPPxXONluMe/P8CtBJMpuh8CBWyjvFfFmOSNRK8ETkUmlTUAR1CIOaeBqLGw
# scShFfyvDQrbChmhXib4nRMX5U9Yr9d7VcYHn6eZJsgyzh5QKlIbCQC/YvhFK42c
# eCBDMbc+Ot5R6T/Mwce5jVyVCmqXVxWOaQc4rA2nV7onMOZC6UvCG8LGFSZBnj1l
# oDDLWo/I+RuRok2j/Q4zcMnwkQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFHK1UmLC
# vXrQCvR98JBq18/4zo0eMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1Gely
# MF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv
# cHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNy
# bDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBD
# QSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYB
# BQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQDju0quPbni
# x0slEjD7j2224pYOPGTmdDvO0+bNRCNkZqUv07P04nf1If3Y/iJEmUaU7w12Fm58
# 2ImpD/Kw2ClXrNKLPTBO6nfxvOPGtalpAl4wqoGgZxvpxb2yEunG4yZQ6EQOpg1d
# E9uOXoze3gD4Hjtcc75kca8yivowEI+rhXuVUWB7vog4TGUxKdnDvpk5GSGXnOhP
# DhdId+g6hRyXdZiwgEa+q9M9Xctz4TGhDgOKFsYxFhXNJZo9KRuGq6evhtyNduYr
# kzjDtWS6gW8akR59UhuLGsVq+4AgqEY8WlXjQGM2OTkyBnlQLpB8qD7x9jRpY2Cq
# 0OWWlK0wfH/1zefrWN5+be87Sw2TPcIudIJn39bbDG7awKMVYDHfsPJ8ZvxgWkZu
# f6ZZAkph0eYGh3IV845taLkdLOCvw49Wxqha5Dmi2Ojh8Gja5v9kyY3KTFyX3T4C
# 2scxfgp/6xRd+DGOhNVPvVPa/3yRUqY5s5UYpy8DnbppV7nQO2se3HvCSbrb+yPy
# eob1kUfMYa9fE2bEsoMbOaHRgGji8ZPt/Jd2bPfdQoBHcUOqPwjHBUIcSc7xdJZY
# jRb4m81qxjma3DLjuOFljMZTYovRiGvEML9xZj2pHRUyv+s5v7VGwcM6rjNYM4qz
# ZQM6A2RGYJGU780GQG0QO98w+sucuTVrfTCCB3EwggVZoAMCAQICEzMAAAAVxedr
# ngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRp
# ZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4
# MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV
# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG
# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3
# DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qls
# TnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLA
# EBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrE
# qv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyF
# Vk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1o
# O5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg
# 3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2
# TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07B
# MzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJ
# NmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6
# r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+
# auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3
# FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl
# 0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUH
# AgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0
# b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMA
# dQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAW
# gBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8v
# Y3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRf
# MjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRw
# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEw
# LTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL
# /Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu
# 6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5t
# ggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfg
# QJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8s
# CXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCr
# dTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZ
# c9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2
# tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8C
# wYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9
# JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDB
# cQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMC
# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV
# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFt
# ZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjg2MDMt
# MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
# oiMKAQEwBwYFKw4DAhoDFQDTvVU/Yj9lUSyeDCaiJ2Da5hUiS6CBgzCBgKR+MHwx
# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt
# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA65Fs
# izAiGA8yMDI1MDMyODE4NDQyN1oYDzIwMjUwMzI5MTg0NDI3WjB0MDoGCisGAQQB
# hFkKBAExLDAqMAoCBQDrkWyLAgEAMAcCAQACAimzMAcCAQACAhPgMAoCBQDrkr4L
# AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSCh
# CjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBABKLu8B0lFNAzxtCJIWK2nUt
# SJ+fpohlO13OT3u0Zwypu+JxzUpuChwCgQ4/ZkA7cUf4tAlR0Dn9IIQHn0PUVuIo
# AmnbR8VLN8SNzIQ8R7YBoKxonto2HriUE0mC0k8/kSVZYasfmkocCU06gssQ9Kjy
# FlQ5up3nUtJsequZEYvECwmXfTlEo6lpyPL4bqf2ki/cunanH2z6XUiHbs+o9szz
# GIMCNqk+x3qBaFY/Xpy3ku1AMXe7MeG0QOSq1zycfQk8C7BiW+KwhI1NnOsc3RXM
# /SWg3b8y7whbapkI+vERtkqQVe0WBMMhuASDSgV6Tb/G4xGM9Xc25hSAGJkLEdox
# ggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv
# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0
# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA
# AgcsETmJzYX7xQABAAACBzANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkD
# MQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCD5j9v/lDZzN3Cr0Ryxw0Y7
# HcKf0PxmfkqpuEt3rjSWxDCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIC/3
# 1NHQds1IZ5sPnv59p+v6BjBDgoDPIwiAmn0PHqezMIGYMIGApH4wfDELMAkGA1UE
# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc
# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0
# IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIHLBE5ic2F+8UAAQAAAgcwIgQgHiuq
# 6n4P4ihcnAIkFsd02w9F2Q0KZbVeoPj46JhBL98wDQYJKoZIhvcNAQELBQAEggIA
# bQPxrgD7vo9c09xb35088FopckW/6hcSFUt/onj6l4QhxbutBW10WNcfps5xnj2d
# cESQ5XQJZmnTRPhbdgEsfJlk4HUWCw79Uf/742Ed2esqgyadzXlUhZIAxQNyZae/
# tRvmI3QaK0hyLr+vZHAWX1hTSydoTzcDUt+sZgoleOm1yQSjB03TJwpY6FFecRHe
# 2n/VqdR5Xj+ZHELfVe2cidEK8CiVSa42FLBuVqlVm+Bie9014Hc6T+EMlI+hj0TH
# DaOmb+ubthcYqPWsKOqQlMfNpqXDueYC2L4BBc7yeN5cjtrDjcLIdAZYuqx9cJ7r
# 3jhDC2YpTcVPawfDlwNFIK4z6hLx85UDRDYGlbQZsPxSoEBVBz9xXSBmiV1qyLOr
# L4C5jcfBG4Apvlu8oiz1kYiGpOTWR5FIuNDBzgsOTrAnI5xHpKBI2oRtiFbxXcgz
# NjXFIKvRved76aWkY8NJOFdtwS4e1WaBUuIEtStPZyNE8qsVAevEzMErGYpdbvWl
# d31AacDOu3r1ivcB/AXF4dWs+uXdmnrnpQy9TD8tzJylfSDd6rIv93KfnoZenQux
# o02KYuyYmmYruRsuCgA0e2lM81MFGwuW4oId+qzz0CrUwliJMqSRwKsOwkdowo6K
# 1GQ7iRCCxBW2aVXqEwaRvb8+NHGVyHgXMOuGJ00vIJI=
# SIG # End signature block