# Copyright (c) Microsoft Corporation. All rights reserved. # # StartDagServerMaintenenance.ps1 # .SYNOPSIS # Calls Suspend-MailboxDatabaseCopy on the database copies. # Pauses the node in Failover Clustering so that it can not become the Primary Active Manager. # Suspends database activation on each mailbox database. # Sets the DatabaseCopyAutoActivationPolicy to Blocked on the server. # Moves databases and cluster group off of the designated server. # # If there's a failure in any of the above, the operations are undone, with # the exception of successful database moves. # # Can be run remotely, but it requires the cluster administrative tools to # be installed (RSAT-Clustering). # .PARAMETER serverName # The name of the server on which to start maintenance. FQDNs are valid # .PARAMETER whatif # Does not actually perform any operations, but logs what would be executed # to the verbose stream. # .PARAMETER overrideMinimumTwoCopies # Allows users to override the default minimum number of database copies to require # to be up after shutdown has completed. This is meant to allow upgrades # in situations where users only have 2 copies of a database in their dag. Param( [Parameter(Mandatory=$true)] [System.Management.Automation.ValidateNotNullOrEmptyAttribute()] [string] $serverName, [string] $Force = 'false', [Parameter(Mandatory=$false)] [switch] $whatif = $false, [Parameter(Mandatory=$false)] [switch] $overrideMinimumTwoCopies = $false ) # Global Values $ServerCountinTwoServerDAG = 2 $RetryCount = 2 $HAComponent = 'HighAvailability' Import-LocalizedData -BindingVariable StartDagServerMaintenance_LocalizedStrings -FileName StartDagServerMaintenance.strings.psd1 # Define some useful functions. # Load the Exchange snapin if it's no already present. function LoadExchangeSnapin { if (! (Get-PSSnapin Microsoft.Exchange.Management.PowerShell.E2010 -ErrorAction:SilentlyContinue) ) { Add-PSSnapin Microsoft.Exchange.Management.PowerShell.E2010 -ErrorAction:Stop } } # Handle Cluster Error Codes during Start-DagServerMaintenance function HandleClusterErrorCode ([string]$Server = $servername, [int]$ClusterErrorCode, [string]$Action) { switch ($ClusterErrorCode) { # 0 is success 0 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0026 -f $Server,$Action,"Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 5 is returned when the Server is powered down 5 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"Server powered down","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 70 is ERROR_SHARING_PAUSED - The remote server has been paused or is in the process of being started 70 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"ERROR_SHARING_PAUSED","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 1753 is EPT_S_NOT_REGISTERED 1753 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"EPT_S_NOT_REGISTERED","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 1722 is RPC_S_SERVER_UNAVAILABLE 1722 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"RPC_S_SERVER_UNAVAILABLE","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 5042 is ERROR_CLUSTER_NODE_NOT_FOUND 5042 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"ERROR_CLUSTER_NODE_NOT_FOUND","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 5043 is ERROR_CLUSTER_LOCAL_NODE_NOT_FOUND 5043 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"ERROR_CLUSTER_LOCAL_NODE_NOT_FOUND","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # 5050 is ERROR_CLUSTER_NODE_DOWN 5050 { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0025 -f $Server,$Action,"ERROR_CLUSTER_NODE_DOWN","Start-DagServerMaintenance") # clear $LastExitCode cmd /c "exit 0" } # Best effort to pause the node. Not a known code, so warning at this point. default {Log-Warning ($StartDagServerMaintenance_LocalizedStrings.res_0004 -f $Server,$Action,$ClusterErrorCode,"Start-DagServerMaintenance") -stop} } } # The meat of the script! &{ # Get the current script name. The method is different if the script is # executed or if it is dot-sourced, so do both. $thisScriptName = $myinvocation.scriptname if ( ! $thisScriptName ) { $thisScriptName = $myinvocation.MyCommand.Path } # Many of the script libraries already use $DagScriptTesting if ( $whatif ) { $DagScriptTesting = $true; } # Load the Exchange cmdlets. & LoadExchangeSnapin # Load some of the common functions. . "$(split-path $thisScriptName)\DagCommonLibrary.ps1"; Test-RsatClusteringInstalled # Allow an FQDN to be passed in, but strip it to the short name. $shortServerName = $serverName; if ( $shortServerName.Contains( "." ) ) { $shortServerName = $shortServerName -replace "\..*$" } # Variables to keep track of what needs to be rolled back in the event of failure. $pausedNode = $false; $activationBlockedOnServer = $false; $serverComponentStateSet = $false; $serverComponentStateOrg = $null; $scriptCompletedSuccessfully = $false; try { # Stage 1 - block auto activation on the server. # Also set HA server component state to Inactive (in AD and registry). This will block actives from moving back to the server. log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0008 -f $shortServerName) if ($DagScriptTesting) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0009 -f $shortServerName,"Set-MailboxServer","-Identity","-DatabaseCopyAutoActivationPolicy") } else { Set-MailboxServer -Identity $shortServerName -DatabaseCopyAutoActivationPolicy:Blocked $activationBlockedOnServer = $true; } log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0029 -f $shortServerName) if ($DagScriptTesting) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0030 -f $shortServerName,"Set-ServerComponentState","-Component HighAvailability","-State Inactive") } else { # Get-ServerComponentState test to see if HighAvailability component exists on the server # If it doesn't exist skip calling Set-ServerComponentState # For all other cases suppress the error and let Set-ServerComponentState run $componentExists = $true try { $Error.Clear() $serverComponentStateOrg = Get-ServerComponentState $serverName -Component $HAComponent -ErrorAction:Stop; } catch { if ($Error.Exception.Gettype().Name -ilike 'ArgumentException') { $componentExists = $false } $Error.Clear() } if ($componentExists) { if($serverComponentStateOrg -and $serverComponentStateOrg.State -eq 'Active') { Set-ServerComponentState $serverName -Component $HAComponent -Requester "Maintenance" -State Inactive $serverComponentStateSet = $true; } } else { Log-Warning ($StartDagServerMaintenance_LocalizedStrings.res_0034 -f $HAComponent, $shortServerName) } } # Stage 2 - pause the node in the cluster to stop it becoming the PAM # Explicitly connect to clussvc running on serverName. This script could # easily be run remotely. log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0000 -f $shortServerName); if ( $DagScriptTesting ) { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0001 ) } else { # Try to fetch $dagName if we can. $dagName = $null $mbxServer = get-mailboxserver $serverName -erroraction:silentlycontinue if ( $mbxServer -and $mbxServer.DatabaseAvailabilityGroup ) { $dagName = $mbxServer.DatabaseAvailabilityGroup.Name; } # Start with $serverName (which may or may not be a FQDN) before # falling back to the (short) names of the DAG. $outputStruct = Call-ClusterExe -dagName $dagName -serverName $serverName -clusterCommand "node $shortServerName /pause" $LastExitCode = $outputStruct[ 0 ]; $output = $outputStruct[ 1 ]; HandleClusterErrorCode -ClusterErrorCode $LastExitCode -Action "Pause" $pausedNode = $true; } # Stage 3 - move all the resources off the server log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0005 -f $shortServerName,"Start-DagServerMaintenance") $criticalMailboxResources = @(GetCriticalMailboxResources $shortServerName ) $numCriticalResources = ($criticalMailboxResources | Measure-Object).Count log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0006 -f $numCriticalResources,"Start-DagServerMaintenance") if ( $criticalMailboxResources ) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0007 -f ( PrintCriticalMailboxResourcesOutput($criticalMailboxResources)),$shortServerName) } # Move the critical resources off the specified server. # This includes Active Databases, and the Primary Active Manager. # If any error occurs in this stage, script execution will halt. # (If we don't assign the result to a variable then the script will # print out 'True') $try = 0 $dagObject = Get-DatabaseAvailabilityGroup $dagName $dagServers = $dagObject.Servers.Count $stoppedDagServers = $dagObject.StoppedMailboxServers.Count $ignoredResult = "" while (($numCriticalResources -gt 0) -and ($try -lt $RetryCount)) { # Sleep for 60 seconds if this is not the first move attempt if ($try -gt 0) { Sleep-ForSeconds 60 } $moveComment = "StartDAGMaintenanceScript" $ignoredResult = Move-CriticalMailboxResources -Server $shortServerName -MoveComment $moveComment # Check again to see if the moves were successful. (Unless -whatif was # specified, then it's pretty likely it will fail). if ( !$DagScriptTesting ) { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0013 -f $shortServerName,"Start-DagServerMaintenance") if (($dagServers - $stoppedDagServers) -eq $ServerCountinTwoServerDAG -or $overrideMinimumTwoCopies) { $criticalMailboxResources = @(GetCriticalMailboxResources $shortServerName -AtleastNCriticalCopies ($ServerCountinTwoServerDAG - 1)) } else { $criticalMailboxResources = @(GetCriticalMailboxResources $shortServerName) } $numCriticalResources = ($criticalMailboxResources | Measure-Object).Count } $try++ } if( $numCriticalResources -gt 0 ) { Log-CriticalResource $criticalMailboxResources write-error ($StartDagServerMaintenance_LocalizedStrings.res_0014 -f ( PrintCriticalMailboxResourcesOutput($criticalMailboxResources)),$shortServerName, $ignoredResult) -erroraction:stop } $scriptCompletedSuccessfully = $true; } finally { # Rollback only if something failed and Force flag was not used if ( !$scriptCompletedSuccessfully) { if ($Force -ne 'true') { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0015 -f "Start-DagServerMaintenance") # Create a new script block so that $ErrorActionPreference only # affects this scope. &{ # Cleanup code is run with "Continue" ErrorActionPreference $ErrorActionPreference = "Continue" if ( $pausedNode ) { # Explicitly connect to clussvc running on serverName. This script could # easily be run remotely. log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0018 -f $serverName,$shortServerName,$serverName); if ( $DagScriptTesting ) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0019 ) } else { $outputStruct = Call-ClusterExe -dagName $dagName -serverName $serverName -clusterCommand "node $shortServerName /resume" $LastExitCode = $outputStruct[ 0 ]; $output = $outputStruct[ 1 ]; HandleClusterErrorCode -ClusterErrorCode $LastExitCode -Action "Resume" } } if ( $activationBlockedOnServer ) { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0016 -f $shortServerName) if ( $DagScriptTesting ) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0017 -f "set-mailboxserver") } else { Set-MailboxServer -Identity $shortServerName -DatabaseCopyAutoActivationPolicy:Unrestricted } } if ( $serverComponentStateSet -and $serverComponentStateOrg -and $serverComponentStateOrg.State -eq 'Active') { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0031 -f $shortServerName) if ( $DagScriptTesting ) { write-host ($StartDagServerMaintenance_LocalizedStrings.res_0032 -f "Set-ServerComponentState") } else { Set-ServerComponentState $serverName -Component 'HighAvailability' -Requester "Maintenance" -State Active } } } } else { log-verbose ($StartDagServerMaintenance_LocalizedStrings.res_0027 -f "Start-DagServerMaintenance") } } } } # SIG # Begin signature block # MIIaywYJKoZIhvcNAQcCoIIavDCCGrgCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQU2cLcKgFX2RxWqQ12sXFMzU+b # wtegghV6MIIEuzCCA6OgAwIBAgITMwAAAFnWc81RjvAixQAAAAAAWTANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTQwNTIzMTcxMzE1 # WhcNMTUwODIzMTcxMzE1WjCBqzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # DTALBgNVBAsTBE1PUFIxJzAlBgNVBAsTHm5DaXBoZXIgRFNFIEVTTjpGNTI4LTM3 # NzctOEE3NjElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC # ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMZsTs9oU/3vgN7oi8Sx8H4H # zh487AyMNYdM6VE6vLawlndC+v88z+Ha4on6bkIAmVsW3QlkOOJS+9+O+pOjPbuH # j264h8nQYE/PnIKRbZEbchCz2EN8WUpgXcawVdAn2/L2vfIgxiIsnmuLLWzqeATJ # S8FwCee2Ha+ajAY/eHD6du7SJBR2sq4gKIMcqfBIkj+ihfeDysVR0JUgA3nSV7wT # tU64tGxWH1MeFbvPMD/9OwHNX3Jo98rzmWYzqF0ijx1uytpl0iscJKyffKkQioXi # bS5cSv1JuXtAsVPG30e5syNOIkcc08G5SXZCcs6Qhg4k9cI8uQk2P6hTXFb+X2EC # AwEAAaOCAQkwggEFMB0GA1UdDgQWBBRbKBqzzXUNYz39mfWbFQJIGsumrDAfBgNV # HSMEGDAWgBQjNPjZUkZwCu1A+3b7syuwwzWzDzBUBgNVHR8ETTBLMEmgR6BFhkNo # dHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNyb3Nv # ZnRUaW1lU3RhbXBQQ0EuY3JsMFgGCCsGAQUFBwEBBEwwSjBIBggrBgEFBQcwAoY8 # aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNyb3NvZnRUaW1l # U3RhbXBQQ0EuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUA # A4IBAQB68A30RWw0lg538OLAQgVh94jTev2I1af193/yCPbV/cvKdHzbCanf1hUH # mb/QPoeEYnvCBo7Ki2jiPd+eWsWMsqlc/lliJvXX+Xi2brQKkGVm6VEI8XzJo7cE # N0bF54I+KFzvT3Gk57ElWuVDVDMIf6SwVS3RgnBIESANJoEO7wYldKuFw8OM4hRf # 6AVUj7qGiaqWrpRiJfmvaYgKDLFRxAnvuIB8U5B5u+mP0EjwYsiZ8WU0O/fOtftm # mLmiWZldPpWfFL81tPuYciQpDPO6BHqCOftGzfHgsha8fSD4nDkVJaEmLdaLgb3G # vbCdVP5HC18tTir0h+q1D7W37ZIpMIIE7DCCA9SgAwIBAgITMwAAAMps1TISNcTh # VQABAAAAyjANBgkqhkiG9w0BAQUFADB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBD # QTAeFw0xNDA0MjIxNzM5MDBaFw0xNTA3MjIxNzM5MDBaMIGDMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMQ0wCwYDVQQLEwRNT1BSMR4wHAYDVQQD # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCWcV3tBkb6hMudW7dGx7DhtBE5A62xFXNgnOuntm4aPD//ZeM08aal # IV5WmWxY5JKhClzC09xSLwxlmiBhQFMxnGyPIX26+f4TUFJglTpbuVildGFBqZTg # rSZOTKGXcEknXnxnyk8ecYRGvB1LtuIPxcYnyQfmegqlFwAZTHBFOC2BtFCqxWfR # +nm8xcyhcpv0JTSY+FTfEjk4Ei+ka6Wafsdi0dzP7T00+LnfNTC67HkyqeGprFVN # TH9MVsMTC3bxB/nMR6z7iNVSpR4o+j0tz8+EmIZxZRHPhckJRIbhb+ex/KxARKWp # iyM/gkmd1ZZZUBNZGHP/QwytK9R/MEBnAgMBAAGjggFgMIIBXDATBgNVHSUEDDAK # BggrBgEFBQcDAzAdBgNVHQ4EFgQUH17iXVCNVoa+SjzPBOinh7XLv4MwUQYDVR0R # BEowSKRGMEQxDTALBgNVBAsTBE1PUFIxMzAxBgNVBAUTKjMxNTk1K2I0MjE4ZjEz # LTZmY2EtNDkwZi05YzQ3LTNmYzU1N2RmYzQ0MDAfBgNVHSMEGDAWgBTLEejK0rQW # WAHJNy4zFha5TJoKHzBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNDb2RTaWdQQ0FfMDgtMzEtMjAx # MC5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1p # Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY0NvZFNpZ1BDQV8wOC0zMS0yMDEwLmNy # dDANBgkqhkiG9w0BAQUFAAOCAQEAd1zr15E9zb17g9mFqbBDnXN8F8kP7Tbbx7Us # G177VAU6g3FAgQmit3EmXtZ9tmw7yapfXQMYKh0nfgfpxWUftc8Nt1THKDhaiOd7 # wRm2VjK64szLk9uvbg9dRPXUsO8b1U7Brw7vIJvy4f4nXejF/2H2GdIoCiKd381w # gp4YctgjzHosQ+7/6sDg5h2qnpczAFJvB7jTiGzepAY1p8JThmURdwmPNVm52Iao # AP74MX0s9IwFncDB1XdybOlNWSaD8cKyiFeTNQB8UCu8Wfz+HCk4gtPeUpdFKRhO # lludul8bo/EnUOoHlehtNA04V9w3KDWVOjic1O1qhV0OIhFeezCCBbwwggOkoAMC # AQICCmEzJhoAAAAAADEwDQYJKoZIhvcNAQEFBQAwXzETMBEGCgmSJomT8ixkARkW # A2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9z # b2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTEwMDgzMTIyMTkzMloX # DTIwMDgzMTIyMjkzMloweTELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEjMCEGA1UEAxMaTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EwggEiMA0G # CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCycllcGTBkvx2aYCAgQpl2U2w+G9Zv # zMvx6mv+lxYQ4N86dIMaty+gMuz/3sJCTiPVcgDbNVcKicquIEn08GisTUuNpb15 # S3GbRwfa/SXfnXWIz6pzRH/XgdvzvfI2pMlcRdyvrT3gKGiXGqelcnNW8ReU5P01 # lHKg1nZfHndFg4U4FtBzWwW6Z1KNpbJpL9oZC/6SdCnidi9U3RQwWfjSjWL9y8lf # RjFQuScT5EAwz3IpECgixzdOPaAyPZDNoTgGhVxOVoIoKgUyt0vXT2Pn0i1i8UU9 # 56wIAPZGoZ7RW4wmU+h6qkryRs83PDietHdcpReejcsRj1Y8wawJXwPTAgMBAAGj # ggFeMIIBWjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTLEejK0rQWWAHJNy4z # Fha5TJoKHzALBgNVHQ8EBAMCAYYwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEE # AYI3FQIEFgQU/dExTtMmipXhmGA7qDFvpjy82C0wGQYJKwYBBAGCNxQCBAweCgBT # AHUAYgBDAEEwHwYDVR0jBBgwFoAUDqyCYEBWJ5flJRP8KuEKU5VZ5KQwUAYDVR0f # BEkwRzBFoEOgQYY/aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJv # ZHVjdHMvbWljcm9zb2Z0cm9vdGNlcnQuY3JsMFQGCCsGAQUFBwEBBEgwRjBEBggr # BgEFBQcwAoY4aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNy # b3NvZnRSb290Q2VydC5jcnQwDQYJKoZIhvcNAQEFBQADggIBAFk5Pn8mRq/rb0Cx # MrVq6w4vbqhJ9+tfde1MOy3XQ60L/svpLTGjI8x8UJiAIV2sPS9MuqKoVpzjcLu4 # tPh5tUly9z7qQX/K4QwXaculnCAt+gtQxFbNLeNK0rxw56gNogOlVuC4iktX8pVC # nPHz7+7jhh80PLhWmvBTI4UqpIIck+KUBx3y4k74jKHK6BOlkU7IG9KPcpUqcW2b # Gvgc8FPWZ8wi/1wdzaKMvSeyeWNWRKJRzfnpo1hW3ZsCRUQvX/TartSCMm78pJUT # 5Otp56miLL7IKxAOZY6Z2/Wi+hImCWU4lPF6H0q70eFW6NB4lhhcyTUWX92THUmO # Lb6tNEQc7hAVGgBd3TVbIc6YxwnuhQ6MT20OE049fClInHLR82zKwexwo1eSV32U # jaAbSANa98+jZwp0pTbtLS8XyOZyNxL0b7E8Z4L5UrKNMxZlHg6K3RDeZPRvzkbU # 0xfpecQEtNP7LN8fip6sCvsTJ0Ct5PnhqX9GuwdgR2VgQE6wQuxO7bN2edgKNAlt # HIAxH+IOVN3lofvlRxCtZJj/UBYufL8FIXrilUEnacOTj5XJjdibIa4NXJzwoq6G # aIMMai27dmsAHZat8hZ79haDJLmIz2qoRzEvmtzjcT3XAH5iR9HOiMm4GPoOco3B # oz2vAkBq/2mbluIQqBC0N1AI1sM9MIIGBzCCA++gAwIBAgIKYRZoNAAAAAAAHDAN # BgkqhkiG9w0BAQUFADBfMRMwEQYKCZImiZPyLGQBGRYDY29tMRkwFwYKCZImiZPy # LGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQDEyRNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp # Y2F0ZSBBdXRob3JpdHkwHhcNMDcwNDAzMTI1MzA5WhcNMjEwNDAzMTMwMzA5WjB3 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhN # aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCfoWyx39tIkip8ay4Z4b3i48WZUSNQrc7dGE4kD+7Rp9FMrXQwIBHr # B9VUlRVJlBtCkq6YXDAm2gBr6Hu97IkHD/cOBJjwicwfyzMkh53y9GccLPx754gd # 6udOo6HBI1PKjfpFzwnQXq/QsEIEovmmbJNn1yjcRlOwhtDlKEYuJ6yGT1VSDOQD # LPtqkJAwbofzWTCd+n7Wl7PoIZd++NIT8wi3U21StEWQn0gASkdmEScpZqiX5NMG # gUqi+YSnEUcUCYKfhO1VeP4Bmh1QCIUAEDBG7bfeI0a7xC1Un68eeEExd8yb3zuD # k6FhArUdDbH895uyAc4iS1T/+QXDwiALAgMBAAGjggGrMIIBpzAPBgNVHRMBAf8E # BTADAQH/MB0GA1UdDgQWBBQjNPjZUkZwCu1A+3b7syuwwzWzDzALBgNVHQ8EBAMC # AYYwEAYJKwYBBAGCNxUBBAMCAQAwgZgGA1UdIwSBkDCBjYAUDqyCYEBWJ5flJRP8 # KuEKU5VZ5KShY6RhMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/Is # ZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmlj # YXRlIEF1dGhvcml0eYIQea0WoUqgpa1Mc1j0BxMuZTBQBgNVHR8ESTBHMEWgQ6BB # hj9odHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9taWNy # b3NvZnRyb290Y2VydC5jcmwwVAYIKwYBBQUHAQEESDBGMEQGCCsGAQUFBzAChjho # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jvc29mdFJvb3RD # ZXJ0LmNydDATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQUFAAOCAgEA # EJeKw1wDRDbd6bStd9vOeVFNAbEudHFbbQwTq86+e4+4LtQSooxtYrhXAstOIBNQ # md16QOJXu69YmhzhHQGGrLt48ovQ7DsB7uK+jwoFyI1I4vBTFd1Pq5Lk541q1YDB # 5pTyBi+FA+mRKiQicPv2/OR4mS4N9wficLwYTp2OawpylbihOZxnLcVRDupiXD8W # mIsgP+IHGjL5zDFKdjE9K3ILyOpwPf+FChPfwgphjvDXuBfrTot/xTUrXqO/67x9 # C0J71FNyIe4wyrt4ZVxbARcKFA7S2hSY9Ty5ZlizLS/n+YWGzFFW6J1wlGysOUzU # 9nm/qhh6YinvopspNAZ3GmLJPR5tH4LwC8csu89Ds+X57H2146SodDW4TsVxIxIm # dgs8UoxxWkZDFLyzs7BNZ8ifQv+AeSGAnhUwZuhCEl4ayJ4iIdBD6Svpu/RIzCzU # 2DKATCYqSCRfWupW76bemZ3KOm+9gSd0BhHudiG/m4LBJ1S2sWo9iaF2YbRuoROm # v6pH8BJv/YoybLL+31HIjCPJZr2dHYcSZAI9La9Zj7jkIeW1sMpjtHhUBdRBLlCs # lLCleKuzoJZ1GtmShxN1Ii8yqAhuoFuMJb+g74TKIdbrHk/Jmu5J4PcBZW+JC33I # acjmbuqnl84xKf8OxVtc2E0bodj6L54/LlUWa8kTo/0xggS7MIIEtwIBATCBkDB5 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpN # aWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQQITMwAAAMps1TISNcThVQABAAAAyjAJ # BgUrDgMCGgUAoIHUMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQB # gjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBQ1UKKqy4xEB0K1 # xtpEz1uD7Gn0xjB0BgorBgEEAYI3AgEMMWYwZKA8gDoAUwB0AGEAcgB0AEQAYQBn # AFMAZQByAHYAZQByAE0AYQBpAG4AdABlAG4AYQBuAGMAZQAuAHAAcwAxoSSAImh0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9leGNoYW5nZSAwDQYJKoZIhvcNAQEBBQAE # ggEAej1VWwyBOsYUQYE0di+sytw8ReNme8Bk2xQr9S/X3o00wVc6fehvpJ/RpxuU # dMNzlpIWDp4aZpTR7cOhsd9t9EqstvAPVhSaiYQSb0zm2nrj+zjH0abNnf97A3MQ # 8+k6afKxzErg6+9LcHV9e4jjSZ3xHekQqXWNayOUVzuyBVoPYkoWQ+/+duQwzdTn # 83RxSeJhiDpw2SxJOLQBiItBHd0bKRfyH/FVM4e1mISMQQ9H8MBraxKLSgdBm6Ob # CJoCaNE2Ual1S8RH2780VLP3k8/tmvfAv03KWSNE+AiGknTnribpZ01/ark16aOR # 4pFknUFcXzGGW/JhOkZcIciPhKGCAigwggIkBgkqhkiG9w0BCQYxggIVMIICEQIB # ATCBjjB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYD # VQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0ECEzMAAABZ1nPNUY7wIsUAAAAA # AFkwCQYFKw4DAhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZI # hvcNAQkFMQ8XDTE0MDcxMTA1MDUwN1owIwYJKoZIhvcNAQkEMRYEFEhWq3KdAw8Q # ijzg3EfWkZwDr/lkMA0GCSqGSIb3DQEBBQUABIIBAHtXLPvFlQBWDtWFRLdjcKWW # 0aenBgG4vkdNjkh3JabNFydCZ3nrbW74XUhabgDexodrk/RILuREgkc5y2liy8fv # WmBhAvAsMKBWbgAISafNNLom+ZxeYbbZ9SRbyoleGTwn35eGVBW0mda2XjRh8dVY # esULj6l+jIb41QpnwotM5n27HxlG0EjUAXO49/2t+FXPmy4W9paLLyuWeHIeB8qE # CkVYReBLxwcmsixhBp+go+G0eM9Yknc7+paWLT5IxIaEbnNmSUgiPi/3DSOODdE6 # cyBXPnXUn9kf2ddeiAKB7LosPmXX3DTwvbITiok7QNUaIRCV+ClED/8g/pDwVAc= # SIG # End signature block