HLK-Driver.psm1
Import-Module $PSScriptRoot\TurnKeySdn.psd1 -Force Import-Module $PSScriptRoot\ConfigManager.psm1 -Force # Driver Module for HLK + TurnKey Installation # addressPrefix should be a /16 prefix # 192.168.1.0/24 > management network # 192.168.2.0/24 > HNV PA network # 192.168.3.0/24 > VIP network $script:LogFileName = "HLK-Deployment.log" $script # Init-HLKSDNWorkload -NetworkPrefix "173.20.0.1/16" -VLANID 8 -NCNodeCount 1 -CSVFolderPath C:\ClusterStorage\SdnSpace\ -VHDPath C:\ClusterStorage\SdnSpace\VHDs\ -VHDFileName 23h2.vhdx -SdnSwitchname sdnswitch -InternetSwitchName "corp" -DomainName CFDEV.NTTEST.MICROSOFT.COM -DomainUserName wolfpack -DomainPassword wolfpack -WorkloadUserName administrator -WorkloadPassword administrator function Init-HLKSDNWorkload { param( [parameter(Mandatory=$true)][string] $NetworkPrefix, [parameter(Mandatory=$true)][int] $VLANID, [parameter(Mandatory=$true)][int] $NCNodeCount, [parameter(Mandatory=$true)][string] $CSVFolderPath, [parameter(Mandatory=$true)][string] $VHDPath, [parameter(Mandatory=$true)][string] $VHDFileName, [parameter(Mandatory=$true)][string] $SdnSwitchname, [parameter(Mandatory=$true)][string] $InternetSwitchName, [parameter(Mandatory=$true)][string] $DomainName, [parameter(Mandatory=$true)][string] $DomainUserName, [parameter(Mandatory=$true)][string] $DomainPassword, [parameter(Mandatory=$false)][string] $WorkloadUserName = "administrator", [parameter(Mandatory=$false)][string] $WorkloadPassword, [parameter(Mandatory=$false)][string[]] $ManagementDNSIpAddresses = @() ) try { $logFolder = Get-HLKLogFolder -CSVFolderPath $CSVFolderPath $logFileFullPath = Join-Path $logFolder $script:LogFileName if( (test-Path -path $logFolder) -eq $false) { mkdir $logFolder -force } try { Start-Transcript -Path $logFileFullPath -Force -Append -IncludeInvocationHeader } catch { # continue, even if transcripting fails } Write-Host "Starting Init-HLKSDNWorkload" #test cluster path if( -not (Test-Path $CSVFolderPath -Verbose)) { throw "CSVFolderPath does not exist" } Write-Host "Validated path $CSVFolderPath" # setup workload VM credentials if(-not [string]::IsNullOREmpty($WorkloadUserName) -and -not [string]::IsNullOrEmpty($WorkloadPassword)) { $Env:TURNKEY_WORKLOAD_USERNAME = $WorkloadUserName $Env:TURNKEY_WORKLOAD_PASSWORD = $WorkloadPassword } else { $Env:TURNKEY_WORKLOAD_USERNAME = $WorkloadUserName $Env:TURNKEY_WORKLOAD_PASSWORD = $WorkloadUserName } [Environment]::SetEnvironmentVariable("TURNKEY_WORKLOAD_USERNAME", $WorkloadUserName, "Machine") [Environment]::SetEnvironmentVariable("TURNKEY_WORKLOAD_PASSWORD", $WorkloadPassword, "Machine") Write-Host "Workload VM credentials setup complete" # check and setup domain name if([string]::IsNullOREmpty($DomainName)) { throw "DomainName cannot be null" } else { $Env:TEST_DOMAIN = $DomainName [Environment]::SetEnvironmentVariable("TEST_DOMAIN", $DomainName, "Machine") } Write-Host "Domain name setup complete" # initialize domain credentials if(-not [string]::IsNullOREmpty($DomainUserName) -and -not [string]::IsNullOrEmpty($DomainPassword)) { $env:TEST_USERNAME = $DomainUserName [Environment]::SetEnvironmentVariable("TEST_USERNAME", $DomainUserName, "Machine") $env:TEST_PASSWORD = $DomainPassword [Environment]::SetEnvironmentVariable("TEST_PASSWORD", $DomainPassword, "Machine") } else { throw "DomainUserName or DomainPassword cannot be null" } Write-Host "Domain credentials setup complete" Copy-OrGetCtsTraffficExe -SourceFolder "$PSScriptRoot\..\" # this deployment will be similar to CTL, where management and PA networks are carved from the same range if($NetworkPrefix -notmatch "\/16") { throw "NetworkPrefix must be a /16 prefix" } Write-Host "Validated NetworkPrefix $NetworkPrefix" $configOverrideFile = Join-Path -Path $CSVFolderPath -ChildPath "SDNHLKConfig.json" if ($(Test-Path $configOverrideFile)) { Write-Host "Override file found, loading config" $configOverride = Get-Content $configOverrideFile | ConvertFrom-Json } if ($configOverride.reuseTopology -eq 'true' -and $(Test-IsTurnKeySdnInstalled)) { Write-Host "Reusing existing topology, return" return } try { Uninstall-TurnkeySdn -Force } catch { Write-Host "Uninstall failed with $_" } Set-SdnExpressPath -SdnExpressPath $PSScriptRoot\..\SdnExpress $depconfig = Get-TurnKeySdnDeploymentConfig # set SDN switchname $depconfig.sdnSwitchName = $SdnSwitchname $depconfig.internetSwitchName = $InternetSwitchName # disable address randomization $depconfig.randomizeAddresses = $false if (-not [String]::IsNullOrEmpty($configOverride.windowsServerProductKey)) { $depconfig.productKey = $configOverride.windowsServerProductKey } else { $productKeyFile = Join-Path $VHDPath "productkey.txt" if ($(Test-Path $productKeyFile)) { [array]$content = Get-Content $productKeyFile if ($content.Count -eq 0) { Write-Host "Product key file is empty" } else { $productKey = $content[0].Trim() $depconfig.productKey = $productKey } } } if (-not [String]::IsNullOrEmpty($configOverride.torVMConfig.IPAddress)) { $depconfig.torVMConfig = $configOverride.torVMConfig } $depConfig.bypassTORForLBDataPath = $true Set-TurnKeySdnDeploymentConfig -Config $depconfig $ipTokens = $NetworkPrefix -split "/" #just to ensure that IP address is valid $ip_Addr = [ipaddress]::Parse($ipTokens[0]) $t = $ipTokens[0].Split(".") # todo: ask for different networks in future, for now we carve out subnets from a larger pool of prefix $defaultGatway_management = "$($t[0]).$($t[1]).1.1" $defaultGatway_PA = "$($t[0]).$($t[1]).2.1" $defaultGatway_PublicVIP = "$($t[0]).$($t[1]).3.1" $defaultGatway_PrivateVIP = "$($t[0]).$($t[1]).4.1" $ipPoolStart_management = "$($t[0]).$($t[1]).1.20" $ipPoolEnd_management = "$($t[0]).$($t[1]).1.100" $ipPoolStart_PA = "$($t[0]).$($t[1]).2.20" $ipPoolEnd_PA = "$($t[0]).$($t[1]).2.100" $ipPoolStart_PublicVIP = "$($t[0]).$($t[1]).3.20" $ipPoolEnd_PublicVIP = "$($t[0]).$($t[1]).3.100" $ipPoolStart_PrivateVIP = "$($t[0]).$($t[1]).4.20" $ipPoolEnd_PrivateVIP = "$($t[0]).$($t[1]).4.100" $managementPrefix = "$($t[0]).$($t[1]).1.0/24" $paPrefix = "$($t[0]).$($t[1]).2.0/24" $publicVipPrefix = "$($t[0]).$($t[1]).3.0/24" $privateVipPrefix = "$($t[0]).$($t[1]).4.0/24" # fix config (management network) Write-Host "Setting up management network with VLAN $VLANID and default gateway $defaultGatway_management" $mgmtNetwork = Get-TurnKeySdnManagementNetwork $mgmtNetwork.properties.subnets[0].properties.vlanID = $VLANID $mgmtNetwork.properties.subnets[0].properties.defaultGateways = @($defaultGatway_management) $mgmtNetwork.properties.subnets[0].properties.ipPools[0].properties.startIpAddress = $ipPoolStart_management $mgmtNetwork.properties.subnets[0].properties.ipPools[0].properties.endIpAddress = $ipPoolEnd_management $mgmtNetwork.properties.subnets[0].properties.addressPrefix = $managementPrefix if($null -ne $ManagementDNSIpAddresses -and $ManagementDNSIpAddresses.Count -gt 0) { Write-Host "Assigning management DNS IP addresse(s) $ManagementDNSIpAddresses" $mgmtNetwork.properties.subnets[0].properties.dnsServers = $ManagementDNSIpAddresses } Set-TurnKeySdnManagementNetwork -Network $mgmtNetwork Write-Host "Management network setup complete" # fix config (pa network) $paNetwork = Get-TurnKeySdnHNVPANetwork Write-Host "Setting up PA network with VLAN $VLANID and default gateway $defaultGatway_PA and ip pool $ipPoolStart_PA - $ipPoolEnd_PA" $paNetwork.properties.subnets[0].properties.vlanID = $VLANID $paNetwork.properties.subnets[0].properties.defaultGateways = @($defaultGatway_PA) $paNetwork.properties.subnets[0].properties.ipPools[0].properties.startIpAddress = $ipPoolStart_PA $paNetwork.properties.subnets[0].properties.ipPools[0].properties.endIpAddress = $ipPoolEnd_PA $paNetwork.properties.subnets[0].properties.addressPrefix = $paPrefix Set-TurnKeySdnHNVPANetwork -Network $paNetwork $publicVipNetwork = Get-TurnKeySdnPublicVIPNetwork Write-Host "Setting up Public network with default gateway $defaultGatway_PublicVIP and ip pool $ipPoolStart_PublicVIP - $ipPoolEnd_PublicVIP" $publicVipNetwork.properties.subnets[0].properties.defaultGateways = @($defaultGatway_PublicVIP) $publicVipNetwork.properties.subnets[0].properties.ipPools[0].properties.startIpAddress = $ipPoolStart_PublicVIP $publicVipNetwork.properties.subnets[0].properties.ipPools[0].properties.endIpAddress = $ipPoolEnd_PublicVIP $publicVipNetwork.properties.subnets[0].properties.addressPrefix = $publicVipPrefix Set-TurnKeySdnPublicVIPNetwork -Network $publicVipNetwork $privateVipNetwork = Get-TurnKeySdnPrivateVIPNetwork Write-Host "Setting up private network with default gateway $defaultGatway_PrivateVIP and ip pool $ipPoolStart_PrivateVIP - $ipPoolEnd_PrivateVIP" $privateVipNetwork.properties.subnets[0].properties.defaultGateways = @($defaultGatway_PrivateVIP) $privateVipNetwork.properties.subnets[0].properties.ipPools[0].properties.startIpAddress = $ipPoolStart_PrivateVIP $privateVipNetwork.properties.subnets[0].properties.ipPools[0].properties.endIpAddress = $ipPoolEnd_PrivateVIP $privateVipNetwork.properties.subnets[0].properties.addressPrefix = $privateVipPrefix Set-TurnKeySdnPrivateVIPNetwork -Network $privateVipNetwork Write-Host "PA network setup complete" Set-TurnKeySdnGatewayConfig -NodeCount 0 Write-Host "Gateway node count set to 0" Set-TurnKeySdnNCConfig -UseSF -nodecount 1 Write-Host "NC node count set to 1" $sdnVmPath = (Join-Path -Path $CSVFolderPath -ChildPath "SDNVMs") Write-Host "Setting SDN VM path to $sdnVmPath" Set-TurnKeySdnDeploymentPath -DeploymentPath $sdnVmPath Set-TurnKeySdnDeploymentVhd -vhdPath $VHDPath -vhdFile $VHDFileName -setDefaultForWorkload Set-TurnKeySdnMuxConfig -NodeCount 1 # force reload of properties Initialize-TurnKeySdnDeployment Install-TurnKeySdn } catch { Write-Host "Error Occurred during validation: $_" Write-Host "ExceptionDetails: $($_.ToString())" Write-Host "ExceptionSrc: $($MyInvocation.MyCommand.Name)" Write-Host "ExceptionLine: $($Error[0].InvocationInfo.ScriptLineNumber)" if($null -ne $_.Exception ) { Write-Host "`t InnerException: $($_.Exception.ToString())" if( $null -ne $_.Exception.InnerException) { Write-Host "`t `t InnerException: $($_.Exception.InnerException.ToString())" } } throw $_ } finally { Write-Host "Init-HLKSDNWorkload: exit & stopping transcript" Stop-Transcript } } function Start-HLKTracingSession { param( [string] $CSVFolderPath ) Write-Host "Start-HLKTracingSession: storage root path: $CSVFolderPath" if([string]::IsNullOrEmpty($CSVFolderPath)) { throw "CSVFolderPath cannot be null" } $logFolder = Get-HLKLogFolder -CSVFolderPath $CSVFolderPath mkdir $logFolder -Force -ErrorAction SilentlyContinue -Verbose| Out-Null Write-Host "Start-HLKTracingSession: hlk log root path: $logFolder" $logFileFullPath = Join-Path $logFolder $script:LogFileName if( (test-Path -path $logFolder) -eq $false) { mkdir $logFolder -force } $vfpTraceFolderRoot = Get-HLKLogVfpTracesFolder -CSVFolderPath $CSVFolderPath Write-Host "Start-HLKTracingSession: vfptrace root path: $vfpTraceFolderRoot" [Environment]::SetEnvironmentVariable("VFPDATAPATH_LOGROOT", $vfpTraceFolderRoot, "Machine") $Env:VFPDATAPATH_LOGROOT = $vfpTraceFolderRoot try { Start-Transcript -Path $logFileFullPath -Force -Append -IncludeInvocationHeader } catch { # continue, even if transcripting fails } Write-Host "Start-HLKTracingSession: exit" } function Start-HlkValidationTraffic { param( [string] $CSVFolderPath, [ValidateSet("LB-INBOUND", "LB-OUTBOUND", "ALL", "VNET", "LB-LBRULE","LIVEMIGRATION")] [string] $TestType ) if([string]::IsNullOrEmpty($CSVFolderPath)) { throw "Start-HlkValidationTraffic: CSVFolderPath cannot be null" } try { Start-HLKTracingSession -CSVFolderPath $CSVFolderPath Start-TurnKeySdnTrafficTests -WorkloadType $TestType } catch { Write-Host "Error Occurred during validation: $_" Write-Host "ExceptionDetails: $($_.ToString())" if($null -ne $_.Exception ) { Write-Host "`t InnerException: $($_.Exception)" Write-Host "`t InnerException: $($_.Exception.ToString())" if( $null -ne $_.Exception.InnerException) { Write-Host "`t `t InnerException: $($_.Exception.InnerException)" Write-Host "`t `t InnerException: $($_.Exception.InnerException.ToString())" } } throw $_ } finally { Write-Host "Start-HlkValidationTraffic: exit & stopping transcript" try { stop-transcript -ErrorAction SilentlyContinue | Out-Null } catch { Write-Host "Error Occurred during stop-transcript: $_" } } } function Get-SdnDiagnosticsOfflinePath { $sdnDiag = Join-Path $PSScriptRoot "..\SdnDiagnostics" $sdnDiagPsd1 = Join-Path $sdnDiag "SdnDiagnostics.psd1" if ($(Test-Path $sdnDiagPsd1)) { return $sdnDiag } return $null } function Get-SdnDiagnostics { param( [string] $storageRoot = "C:\clusterstorage\sdnspace" ) $creds = Get-TurnKeySdnCred $ncName = ((get-clustergroup -name *NC*) | select -First 1).Name $logFolder = Get-HLKLogFolder -CSVFolderPath $storageRoot mkdir $logFolder -Force -ErrorAction SilentlyContinue | Out-Null $modulePath = Get-SdnDiagnosticsOfflinePath if ($null -eq $modulePath) { Install-Module -Name SdnDiagnostics -Force -Confirm:$false Update-Module -Name SdnDiagnostics -Force -Confirm:$false } else { Write-Verbose "Importing SdnDiagnostics module from $modulePath" Import-Module "$modulePath\SdnDiagnostics.psd1" -Force } Start-SdnDataCollection -NetworkController $ncName -Credential $creds -OutputDirectory $logFolder -Role NetworkController,Server,LoadBalancerMux -IncludeNetView -IncludeLogs Compress-Archive -Path $logFolder -DestinationPath "$logFolder.zip" -Force Remove-Item -Path $logFolder -Recurse -Force } function Get-HLKLogFolder { param( [string] $CSVFolderPath ) return Join-Path $CSVFolderPath "\logs\" } function Get-HLKLogVfpTracesFolder { param( [string] $CSVFolderPath ) return Join-Path (Get-HLKLogFolder -CSVFolderPath $CSVFolderPath) "\vfptraces\" } # SIG # Begin signature block # MIIoQwYJKoZIhvcNAQcCoIIoNDCCKDACAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB52d4DCON8EP90 # JZECOWGj8Jt/dOx7l6JSYajJqmExsKCCDXYwggX0MIID3KADAgECAhMzAAAEBGx0 # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGiMwghofAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMivA17bxkMoZzLK7V3X1Wsh # 3/W71mz0mB/CTJMnoKZXMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEASamr7SUWONREKXIN9ZKV5MF7Ob/DqV2CUA79F4Ty3bdnNHwloD5VX2ge # BYkv9r7JPXWiaM+wyArPBrTX7h8/b6t8JqpgEh5XRHSnCsSyQ5FPLMvog3e/npRq # wuEakfMXje2dPsjZ+NXln3DJKtCYosZMvQbHgGmJW2eW7HlIELmYlqmKy1aATP0N # YCOpaJboPoXFNhbEjvW3n+0ciw2jvGKv0f+Py+i3zqw6nR/WA2GEy23EbZpA8uX/ # UfLdIowBd+30H/L0WvzycU9Jb4sKbcxiPcyolW3GdAbtMhUELzlQXFjm0PqGMUTz # nFVPiwHLFyrosD/rslEj6/n3FLWhOKGCF60wghepBgorBgEEAYI3AwMBMYIXmTCC # F5UGCSqGSIb3DQEHAqCCF4YwgheCAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsq # hkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCD6NiwwmKBHe1Q95NbFdMgOjpcsjRMVntZmBrkhgH569wIGZ7Y0thjl # GBMyMDI1MDMyMDIzNTUyMS4xNDZaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT # Tjo0MDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg # U2VydmljZaCCEfswggcoMIIFEKADAgECAhMzAAAB/tCowns0IQsBAAEAAAH+MA0G # CSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI0 # MDcyNTE4MzExOFoXDTI1MTAyMjE4MzExOFowgdMxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9w # ZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjQwMUEt # MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl # MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAvLwhFxWlqA43olsE4PCe # gZ4mSfsH2YTSKEYv8Gn3362Bmaycdf5T3tQxpP3NWm62YHUieIQXw+0u4qlay4AN # 3IonI+47Npi9fo52xdAXMX0pGrc0eqW8RWN3bfzXPKv07O18i2HjDyLuywYyKA9F # mWbePjahf9Mwd8QgygkPtwDrVQGLyOkyM3VTiHKqhGu9BCGVRdHW9lmPMrrUlPWi # YV9LVCB5VYd+AEUtdfqAdqlzVxA53EgxSqhp6JbfEKnTdcfP6T8Mir0HrwTTtV2h # 2yDBtjXbQIaqycKOb633GfRkn216LODBg37P/xwhodXT81ZC2aHN7exEDmmbiWss # jGvFJkli2g6dt01eShOiGmhbonr0qXXcBeqNb6QoF8jX/uDVtY9pvL4j8aEWS49h # KUH0mzsCucIrwUS+x8MuT0uf7VXCFNFbiCUNRTofxJ3B454eGJhL0fwUTRbgyCbp # LgKMKDiCRub65DhaeDvUAAJT93KSCoeFCoklPavbgQyahGZDL/vWAVjX5b8Jzhly # 9gGCdK/qi6i+cxZ0S8x6B2yjPbZfdBVfH/NBp/1Ln7xbeOETAOn7OT9D3UGt0q+K # iWgY42HnLjyhl1bAu5HfgryAO3DCaIdV2tjvkJay2qOnF7Dgj8a60KQT9QgfJfwX # nr3ZKibYMjaUbCNIDnxz2ykCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBRvznuJ9SU2 # g5l/5/b+5CBibbHF3TAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBf # BgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz # L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmww # bAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29m # dC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El # MjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF # BwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAiT4NUvO2lw+0 # dDMtsBuxmX2o3lVQqnQkuITAGIGCgI+sl7ZqZOTDd8LqxsH4GWCPTztc3tr8AgBv # sYIzWjFwioCjCQODq1oBMWNzEsKzckHxAzYo5Sze7OPkMA3DAxVq4SSR8y+TRC2G # cOd0JReZ1lPlhlPl9XI+z8OgtOPmQnLLiP9qzpTHwFze+sbqSn8cekduMZdLyHJk # 3Niw3AnglU/WTzGsQAdch9SVV4LHifUnmwTf0i07iKtTlNkq3bx1iyWg7N7jGZAB # RWT2mX+YAVHlK27t9n+WtYbn6cOJNX6LsH8xPVBRYAIRVkWsMyEAdoP9dqfaZzwX # GmjuVQ931NhzHjjG+Efw118DXjk3Vq3qUI1re34zMMTRzZZEw82FupF3viXNR3DV # OlS9JH4x5emfINa1uuSac6F4CeJCD1GakfS7D5ayNsaZ2e+sBUh62KVTlhEsQRHZ # RwCTxbix1Y4iJw+PDNLc0Hf19qX2XiX0u2SM9CWTTjsz9SvCjIKSxCZFCNv/zpKI # lsHx7hQNQHSMbKh0/wwn86uiIALEjazUszE0+X6rcObDfU4h/O/0vmbF3BMR+45r # AZMAETJsRDPxHJCo/5XGhWdg/LoJ5XWBrODL44YNrN7FRnHEAAr06sflqZ8eeV3F # uDKdP5h19WUnGWwO1H/ZjUzOoVGiV3gwggdxMIIFWaADAgECAhMzAAAAFcXna54C # m0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp # Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMy # MjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH # EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV # BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0B # AQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51 # yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY # 6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9 # cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN # 7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDua # Rr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74 # kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2 # K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5 # TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZk # i1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q # BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3Pmri # Lq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUC # BBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJl # pxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIB # FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9y # eS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUA # YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU # 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny # bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw # MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/yp # b+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulm # ZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM # 9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECW # OKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4 # FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3Uw # xTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPX # fx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVX # VAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGC # onsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU # 5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG # ahC0HVUzWLOhcGbyoYIDVjCCAj4CAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT # Tjo0MDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg # U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAhGNHD/a7Q0bQLWVG9JuGxgLRXseggYMw # gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsF # AAIFAOuG7EkwIhgPMjAyNTAzMjAxOTM0MzNaGA8yMDI1MDMyMTE5MzQzM1owdDA6 # BgorBgEEAYRZCgQBMSwwKjAKAgUA64bsSQIBADAHAgEAAgJO9DAHAgEAAgISzjAK # AgUA64g9yQIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQCCeXo6JYHHsMmF # q4nAQAbXyIogqxIbucVExwacYat3bDFHLsyBfcxAjtdk9olCSer7TYqrwq05J778 # gaY7qOq01SWXtkDyyzIklgiMVQQN77jYHF3ow6idpmSG8KJaP8mFElKpK+KWCHdh # 16akt/BwzBDfhZXwaOSIGny4GqsgwXwY/2bwkyfIFgxIEe/iPE6vYq3uasvGiG4K # dzKVS9Qno+LRnylKtZJcTyeTIbmKTeYuzYfbsDzZ4U0/h+WSh758zKb4mXeIP2pm # FCsHsnppVi/CzsxzuTf2qxpu7bSm9z3Lhi/H+9p+IYjKjQ+pbWUch2RBoieqW3UN # R6MdK6yzMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTACEzMAAAH+0KjCezQhCwEAAQAAAf4wDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG # SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg/SLgyaPDdPwd # 2XbbEMdXkXZkkpgr3TXbrxfqX/yIB5AwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk # MIG9BCARhczd/FPInxjR92m2hPWqc+vGOG1+/I0WtkCstyh0eTCBmDCBgKR+MHwx # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p # Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB/tCowns0IQsBAAEAAAH+ # MCIEIE3HWEvf1NAwNZLAK7FxTC+67QTjfEtzJIPr5j2lwQmmMA0GCSqGSIb3DQEB # CwUABIICAADaHfXMWk/h9gVk3IWBnx2r/gimWHe9LjLWX2uqx+K5HR1cGuX97XLW # 3K02fYVPq2+FxCiafA74tgn4Ckh9ICOMQjoxaksUF9A3M+x/4eieBmlIbWVezW9j # XsuMjsaS7E1TcpBt/HGeO/2gXMhT5SRUZnfaeO59q5zhe1A/UqGpaydK+gYO1UB2 # Y7AsZCUZxIXnLAfo7Fs5coCa1MUf03Jczu62p+aTetTJOKg4BxGKG+242UKTir9B # Me3te6KejPbd9TQjHKLenH1VGoPAPI00Mlaj6CR9QTBeaDKOulSzmQZhARWQjrjD # XYRgNts9yIfgVrewbCvyKCe3H+EA3/asY4SOXkl2S3Ih+DLaY1qljv4WZcCI949L # xdYSKxt6PtaljY+WLbkDhuU9WsOIxN/JV2reBgBNJhDgHflF/sxQmtlz4D3fJDBk # aJVy+ZTgxDcAzBiORPwnhPsQL58OolSoRj6Db2lkxIqrw6UOuoIREeFccTDiiDDL # WUSbbBqiClxFKnPSbmFV8lt7Dh8prJQ0OQYYn+73C09ECU3AKPzncb6LfhEPqyp+ # Ai1v/ErQsiQ6QOgdRVDADPQN1SjNebvv9N9a8O4+e1WHdzzn7KCDwek0SR6IYFA3 # nfYRm6cUYTjwWgYy0R+9bN0AGromJ3etc3XIWa940wGiSBKBrj6S # SIG # End signature block |