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 # MIIoKQYJKoZIhvcNAQcCoIIoGjCCKBYCAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGgkwghoFAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # 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/n3FLWhOKGCF5MwghePBgorBgEEAYI3AwMBMYIXfzCC # F3sGCSqGSIb3DQEHAqCCF2wwghdoAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCD6NiwwmKBHe1Q95NbFdMgOjpcsjRMVntZmBrkhgH569wIGZ9wqcX8M # GBMyMDI1MDMyMDIwMTEzMS4yMjNaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODYwMy0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHpMIIHIDCCBQigAwIBAgITMwAAAgcsETmJzYX7xQABAAACBzANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTAxMzAxOTQy # NTJaFw0yNjA0MjIxOTQyNTJaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODYwMy0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQDFP/96dPmcfgODe3/nuFveuBst/JmSxSkOn89ZFytH # Qm344iLoPqkVws+CiUejQabKf+/c7KU1nqwAmmtiPnG8zm4Sl9+RJZaQ4Dx3qtA9 # mdQdS7Chf6YUbP4Z++8laNbTQigJoXCmzlV34vmC4zpFrET4KAATjXSPK0sQuFhK # r7ltNaMFGclXSnIhcnScj9QUDVLQpAsJtsKHyHN7cN74aEXLpFGc1I+WYFRxaTgq # SPqGRfEfuQ2yGrAbWjJYOXueeTA1MVKhW8zzSEpfjKeK/t2XuKykpCUaKn5s8sqN # bI3bHt/rE/pNzwWnAKz+POBRbJxIkmL+n/EMVir5u8uyWPl1t88MK551AGVh+2H4 # ziR14YDxzyCG924gaonKjicYnWUBOtXrnPK6AS/LN6Y+8Kxh26a6vKbFbzaqWXAj # zEiQ8EY9K9pYI/KCygixjDwHfUgVSWCyT8Kw7mGByUZmRPPxXONluMe/P8CtBJMp # uh8CBWyjvFfFmOSNRK8ETkUmlTUAR1CIOaeBqLGwscShFfyvDQrbChmhXib4nRMX # 5U9Yr9d7VcYHn6eZJsgyzh5QKlIbCQC/YvhFK42ceCBDMbc+Ot5R6T/Mwce5jVyV # CmqXVxWOaQc4rA2nV7onMOZC6UvCG8LGFSZBnj1loDDLWo/I+RuRok2j/Q4zcMnw # kQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFHK1UmLCvXrQCvR98JBq18/4zo0eMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQDju0quPbnix0slEjD7j2224pYOPGTmdDvO # 0+bNRCNkZqUv07P04nf1If3Y/iJEmUaU7w12Fm582ImpD/Kw2ClXrNKLPTBO6nfx # vOPGtalpAl4wqoGgZxvpxb2yEunG4yZQ6EQOpg1dE9uOXoze3gD4Hjtcc75kca8y # ivowEI+rhXuVUWB7vog4TGUxKdnDvpk5GSGXnOhPDhdId+g6hRyXdZiwgEa+q9M9 # Xctz4TGhDgOKFsYxFhXNJZo9KRuGq6evhtyNduYrkzjDtWS6gW8akR59UhuLGsVq # +4AgqEY8WlXjQGM2OTkyBnlQLpB8qD7x9jRpY2Cq0OWWlK0wfH/1zefrWN5+be87 # Sw2TPcIudIJn39bbDG7awKMVYDHfsPJ8ZvxgWkZuf6ZZAkph0eYGh3IV845taLkd # LOCvw49Wxqha5Dmi2Ojh8Gja5v9kyY3KTFyX3T4C2scxfgp/6xRd+DGOhNVPvVPa # /3yRUqY5s5UYpy8DnbppV7nQO2se3HvCSbrb+yPyeob1kUfMYa9fE2bEsoMbOaHR # gGji8ZPt/Jd2bPfdQoBHcUOqPwjHBUIcSc7xdJZYjRb4m81qxjma3DLjuOFljMZT # YovRiGvEML9xZj2pHRUyv+s5v7VGwcM6rjNYM4qzZQM6A2RGYJGU780GQG0QO98w # +sucuTVrfTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNM # MIICNAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjg2MDMtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQDT # vVU/Yj9lUSyeDCaiJ2Da5hUiS6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA64ao6zAiGA8yMDI1MDMyMDE0NDcw # N1oYDzIwMjUwMzIxMTQ0NzA3WjBzMDkGCisGAQQBhFkKBAExKzApMAoCBQDrhqjr # AgEAMAYCAQACAU8wBwIBAAICEh0wCgIFAOuH+msCAQAwNgYKKwYBBAGEWQoEAjEo # MCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG # 9w0BAQsFAAOCAQEAgR3VXtHhITIM0Sv/lcKB5HjHWplbsd4654W8HaVHsvXd5NlR # L3PAS8emW9A/H63EuYM9kqXwwpqk1py0SqV6TShNuN2wfvg7U27f0IQbmxYT30+3 # YEdkvqO0MOBhHOqOdlqliyTE3CWksD5zEq/cM296Ohg1mhpiPjc2qGp5rDnxhH4D # HNwCcIeub3Wrn0f0gi26AyAru5tmF9A09W3DWtXSqHFPhnZmYr5WoLtq4K8MPc4u # sT3pzAITfK5ZAdO0Tk6ZHdhRRzPLgbqjF6xD9QWvGT1DhEfI6b/O8kU5yrcJuAZL # ppi1UFUHb5YfYGsMeKEdc4pIcjm/iLM1wT3VgDGCBA0wggQJAgEBMIGTMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACBywROYnNhfvFAAEAAAIHMA0G # CWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJ # KoZIhvcNAQkEMSIEIJxW2MLh8rKuN6kyY36gvQRmO77kjdt7tID2wsCGnK1MMIH6 # BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgL/fU0dB2zUhnmw+e/n2n6/oGMEOC # gM8jCICafQ8ep7MwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx # MAITMwAAAgcsETmJzYX7xQABAAACBzAiBCD0aIkJSCNQt5WxdyNhGz6hPAnMrYTp # 38/J28bVEsMzHTANBgkqhkiG9w0BAQsFAASCAgBgdW/15JbC8VDKhZPOZKfij3hI # n9LgjHQznR9ge8dzuKshhzooPjRPIvDDDgRR6oTocdHjrcR7N6ka5KP7yrebHjf1 # 18+Yu+Agr4DYx0CqQnVteOSiEBYm/hbxE8LsizNEE2PlOr/wMF/4ShRzUye+/Qs7 # Q0N0WT2s7Zz3hEwM0/MtrBOAngrb2BBdYqvmaqw49DGLmhTgsZvPDDYZ8yEwzLQl # C2ddGmV0raoAX7IEOk+zrI0xgpsIeOh7+loNutPV0yPKdMWmnznI1FfhYi2lmZDE # jJSiAt5q+H7Jbi4O9jPwfnTnrIQKB301uj8W/DcUg71IrmSbnjo3QaZt0iALwyb4 # ecv5U3Ig9YA1cSAmGsJGulnk5s0YuhyxM8YOOxx2OBMrv4hjglDRPPAyLH0Ivatj # Q2jpXrvbRNENPO601nKO88CAK7iMWxyJhIEP0C9YZJ1Jd6KQ/jmQKwHaCmlhNWJn # yiKKfc7emtr0Bd2iyIOYXIWdceLe2hcE57eKYWmo6AXtdBcO4XEu3yO4oK8D/Qp6 # vr58O0khdD6NrjUB0NN48c+ECW7Yz7zVivPHou9ZTyum6lOL+H/4DRtq5tHHtaut # /9e18lpi1tScG8BbTMIBQSN3qXjKPcTTlhLGs7fIKmN24oyQX3NqOgSag+KXW2Ep # 3diYVlroUQ5ZVX3ZHw== # SIG # End signature block |