Obs/bin/ObsAgent/lib/Scripts/GenericHelper.psm1
<##############################################################
# # # Copyright (C) Microsoft Corporation. All rights reserved. # # # ##############################################################> function New-ASPath { [CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='Low')] Param ( [Parameter(Mandatory=$true)] [string] $Path, [Parameter(Mandatory=$true)] [string] $Type ) $functionName = $($MyInvocation.MyCommand.Name) if (-not (Test-Path $Path)) { Trace-Progress "$functionName : Creating directory $Path on $($env:COMPUTERNAME)" $null = New-Item -ItemType $Type -Path $Path } } # # Removes the specified path and all child items # function Remove-ASPath { [CmdletBinding()] Param ( [Parameter(Mandatory=$true)] [string] $Path ) $functionName = $($MyInvocation.MyCommand.Name) if (Test-Path $Path -ErrorAction Continue) { Trace-Progress -Message "$functionName : Removing $Path on $($env:COMPUTERNAME)" $null = Remove-Item $Path -Force -Recurse -ErrorAction SilentlyContinue } } # # Writes the progress along with current date and time # Function Trace-Progress { [CmdletBinding()] param( [Parameter(Mandatory=$true)] [string] $Message, [Parameter(Mandatory=$false)] [Switch] $Error, [Parameter(Mandatory=$false)] [Switch] $Warning ) $progressColor = "Cyan" $errorColor = "Red" $warningColor = "DarkYellow" $fullMessage = ((Get-Date).ToUniversalTime().ToString("G") + " " + $Message) if ($Error) { $color = $errorColor $Global:errorList += $fullMessage + "`n" } elseif ($Warning) { $color = $warningColor } else { $color = $progressColor } Write-Host $fullMessage -ForegroundColor $color } # # Writes the progress along with current date and time # Function Trace-EnteringMethod { $callingStack = (Get-PSCallStack)[1] $callingFunctionParams = $callingStack.InvocationInfo.BoundParameters $callingFunction = $callingStack.FunctionName if(($null -ne $callingFunctionParams) -and ($callingFunctionParams.Keys.Count -ne 0)) { Trace-Progress -Message "$callingFunction : Parameters:`r`n $($callingFunctionParams | ConvertTo-Json -Depth 2)" } } # # Test whether the current principal is an Administrator # Function Test-IsElevated { $identity = [Security.Principal.WindowsIdentity]::GetCurrent() $principal = New-Object Security.Principal.WindowsPrincipal $identity $principal.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) } # # Get role to file copy mappping from the configuration file . # function Get-RolePublicInfo { [CmdletBinding()] param( [string] [ValidateNotNull()] $CustomerConfigurationFilePath ) # TODO - Read the json config file and return the has table return $roles } # # Run a script block with optional argument list with timeout. # function Start-MonitoringJob { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] $ScriptBlock, [Parameter(Mandatory=$false)] [hashtable] $ArgumentList, [Parameter(Mandatory=$false)] [Int] $TimeOutInMinutes = 30, [Parameter(Mandatory=$false)] [string] $FunctionName ) $monitorToDate = (Get-Date).AddMinutes($TimeOutInMinutes) $monitoringJob = Start-Job -ScriptBlock $ScriptBlock -ArgumentList $ArgumentList while ($monitoringJob.State -like 'Running' -and (Get-Date) -lt $monitorToDate) { Start-Sleep 1 $monitoringJob | Receive-Job -ErrorAction Continue } if ($monitoringJob.State -like 'Failed') { $null = $newErrorMessage try { $newErrorMessage = $monitoringJob.ChildJobs[0].JobStateInfo.Reason.Message } catch { } Trace-Progress -Message "$functionName : Failed with error: $newErrorMessage." -Error $exceptionMessage = "$functionName : Failed with error: $newErrorMessage." Trace-Progress -Message $exceptionMessage -Error throw $exceptionMessage } elseif ($monitoringJob.State -like 'Completed') { Trace-Progress -Message "$functionName : Completed successfully." } else { Trace-Progress -Message "$functionName : Timed out after running for $TimeOutInMinutes minutes. Job state: $($monitoringJob.State)." -Error } $monitoringJob | Stop-Job $monitoringJob | Remove-Job } # # Get role names from customer config roles based on input filter. # function Get-FilteredRoleName { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] $Roles, [Parameter(Mandatory=$false)] $FilterByRole, [Parameter(Mandatory=$true)] $LogCollectionJobType ) $functionName = $($MyInvocation.MyCommand.Name) if ($FilterByRole) { Trace-Progress "$functionName : Filtering by role(s): $($FilterByRole -join ', ')" $filteredRoles = $() foreach ($f in $filterByRole) { $filteredRoles += @($roles.Keys | Where-Object {$_ -like $f}) } if ($filteredRoles.count -gt 0) { $FilterByRole = $filteredRoles | Microsoft.PowerShell.Utility\Select-Object -Unique } } else { Trace-Progress "$functionName : No role filters specified, getting all roles." $FilterByRole = $roles.keys } # If LogCollectionJobType is scheduled, remove AutonomousLogs role if ($LogCollectionJobType -eq "Scheduled") { $FilterByRole = $FilterByRole | Where-Object { $_ -ne "AutonomousLogs" } } Trace-Progress "$functionName : Processing logs for role(s): $($FilterByRole -join ', ')" Trace-Progress "$functionName : retuning total of role count : $($FilterByRole.Count)" return $FilterByRole } # TODO - Current role table will not have the node names. # # Get node names from customer config roles based on input filter. # function Get-FilteredNodeName { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] $Roles, [Parameter(Mandatory=$false)] $RoleNames, [Parameter(Mandatory=$false)] $FilterByNode ) $functionName = $($MyInvocation.MyCommand.Name) $allNodes = $Roles[$Roles.Keys].PublicConfiguration.Nodes.Node.Name | Microsoft.PowerShell.Utility\Select-Object -Unique $filteredRoleNodes = $Roles[$RoleNames].PublicConfiguration.Nodes.Node.Name | Microsoft.PowerShell.Utility\Select-Object -Unique if ($filteredRoleNodes -eq $null) { $message = "Invalid role / node filters, please check the input and try again." Trace-Progress "$functionName : $message" -Error throw $message } Trace-Progress "$functionName : All nodes of selected roles: $($filteredRoleNodes -join ', ')" if($FilterByNode) { Trace-Progress "$functionName : Filtering by nodes(s): $($FilterByNode -join ', ')" $filteredNodes = $() foreach ($f in $filterByNode) { $filteredNodes += @($allNodes | Where-Object {$_ -like $f}) } if ($filteredNodes.count -gt 0) { $filteredNodes = $filteredNodes | Microsoft.PowerShell.Utility\Select-Object -Unique } $filteredRoleNodes = $filteredRoleNodes | Where-Object { $_ -in $filteredNodes } if (($filteredRoleNodes -eq $null) -or ($filteredNodes | Where-Object { $_ -notin $filteredRoleNodes}).Count -ne 0) { $message = "Invalid role / node filters, please check the input and try again." Trace-Progress "$functionName : $message" -Error throw $message } Trace-Progress "$functionName : Processing logs for node(s): $($filteredNodes -join ', ')" } else { Trace-Progress "$functionName : No node filters specified, getting all nodes for selected roles." $filteredNodes = $filteredRoleNodes } return $filteredNodes } function Get-RoleInfoFromJsonConfig { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] $RoleJsonFile ) $functionName = $($MyInvocation.MyCommand.Name) try { $configFileData = Get-Content -Raw -Path $RoleJsonFile -ErrorAction Stop $jsonConfig = $configFileData | ConvertFrom-Json -ErrorAction Stop $roles = @{} ($jsonConfig).psobject.properties | ForEach-Object { $roles[$_.Name] = $_.Value } return $roles } catch { Trace-Progress -Message "$functionName : Failed Parsing json file : $RoleJsonFile. Exception: $_" -Error throw $_ } } function Get-NodeNamesFromClusterOrDefaultLocalHostName { $clusterName = $null $nodeNames = $env:COMPUTERNAME try { $clusterName = get-cluster -verbose -ErrorAction Stop Trace-Progress -Message "Obtained cluster name [$clustername]" $nodeNames = (Get-ClusterNode -Cluster $clusterName -ErrorAction Stop).Name Trace-Progress -Message "Fetched from cluster, Nodes = $($nodeNames -join ', ')" } catch { Trace-Progress -Error -Message "Failed to get Cluster Nodes - ClusterName [$clusterName]. Returning localhost name as the only clusternode, to facilitate collection of logs from local machine" } return $nodeNames } function Get-InfraVMNames { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] $InfraHostNames ) Trace-EnteringMethod [HashTable]$vmRoleToName = @{} try { # TODO TODO # Change the algorithm below to also filter on vm.notes -eq "AzureStackInfraVM" to ensure these are our own VM's #Get NC VM's with vm name suffix eq -NC01, -NC02, -NC03 only. $ncVms = Get-VM -Name "*-NC01", "*-NC02", "*-NC03" -ComputerName $InfraHostNames -ErrorAction SilentlyContinue Trace-Progress -Message "Obtained NC VM's [$($ncVms.count)] VM's with names $($ncVms.name -join ', ')" if ($ncVms.count) { $vmRoleToName["NC"] = $ncVms.name $vmRoleToName["AllVms"] += $ncVms.name } #Get SLB VM's with vm name suffix eq -sLB01, -SLB02 only. $slbVms = Get-VM -Name "*-SLB01", "*-SLB02" -ComputerName $InfraHostNames -ErrorAction SilentlyContinue Trace-Progress -Message "Obtained SLB VM's [$($slbVms.count)] VM's with names $($slbVms.name -join ', ')" if ($slbVms.count) { $vmRoleToName["SLB"] = $slbVms.name $vmRoleToName["AllVms"] += $slbVms.name } #Get gateway VM's with vm name suffix eq -gwy01, -gwy02, -gwy03 only. $gatewayVms = Get-VM -Name "*-GWY01", "*-GWY02", "*-GWY03" -ComputerName $InfraHostNames -ErrorAction SilentlyContinue Trace-Progress -Message "Obtained Gateway VM's [$($gatewayVms.count)] VM's with names $($gatewayVms.name -join ', ')" if ($gatewayVms.count) { $vmRoleToName["GWY"] = $gatewayVms.name $vmRoleToName["AllVms"] += $gatewayVms.name } } catch { Trace-Progress -Error -Message "Unable to fetch VM information" } return $vmRoleToName } Export-ModuleMember -Function Get-InfraVMNames -Verbose:$false Export-ModuleMember -Function Get-NodeNamesFromClusterOrDefaultLocalHostName -Verbose:$false Export-ModuleMember -Function Trace-EnteringMethod -Verbose:$false Export-ModuleMember -Function Get-RoleInfoFromJsonConfig -Verbose:$false Export-ModuleMember -Function Get-FilteredRoleName -Verbose:$false Export-ModuleMember -Function Get-FilteredNodeName -Verbose:$false Export-ModuleMember -Function Get-RolePublicInfo -Verbose:$false Export-ModuleMember -Function New-ASPath -Verbose:$false Export-ModuleMember -Function Remove-ASPath -Verbose:$false Export-ModuleMember -Function Test-IsElevated -Verbose:$false Export-ModuleMember -Function Trace-Progress -Verbose:$false Export-ModuleMember -Function Start-MonitoringJob -Verbose:$false # SIG # Begin signature block # MIInzgYJKoZIhvcNAQcCoIInvzCCJ7sCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDIwKCMJDbOum25 # cUWLNAzMAuGORzn/N+qOWOeSlW2W1KCCDYUwggYDMIID66ADAgECAhMzAAADri01 # UchTj1UdAAAAAAOuMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwODU5WhcNMjQxMTE0MTkwODU5WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQD0IPymNjfDEKg+YyE6SjDvJwKW1+pieqTjAY0CnOHZ1Nj5irGjNZPMlQ4HfxXG # yAVCZcEWE4x2sZgam872R1s0+TAelOtbqFmoW4suJHAYoTHhkznNVKpscm5fZ899 # QnReZv5WtWwbD8HAFXbPPStW2JKCqPcZ54Y6wbuWV9bKtKPImqbkMcTejTgEAj82 # 6GQc6/Th66Koka8cUIvz59e/IP04DGrh9wkq2jIFvQ8EDegw1B4KyJTIs76+hmpV # M5SwBZjRs3liOQrierkNVo11WuujB3kBf2CbPoP9MlOyyezqkMIbTRj4OHeKlamd # WaSFhwHLJRIQpfc8sLwOSIBBAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhx/vdKmXhwc4WiWXbsf0I53h8T8w # VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMTgzNjAfBgNVHSMEGDAW # gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw # MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx # XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB # AGrJYDUS7s8o0yNprGXRXuAnRcHKxSjFmW4wclcUTYsQZkhnbMwthWM6cAYb/h2W # 5GNKtlmj/y/CThe3y/o0EH2h+jwfU/9eJ0fK1ZO/2WD0xi777qU+a7l8KjMPdwjY # 0tk9bYEGEZfYPRHy1AGPQVuZlG4i5ymJDsMrcIcqV8pxzsw/yk/O4y/nlOjHz4oV # APU0br5t9tgD8E08GSDi3I6H57Ftod9w26h0MlQiOr10Xqhr5iPLS7SlQwj8HW37 # ybqsmjQpKhmWul6xiXSNGGm36GarHy4Q1egYlxhlUnk3ZKSr3QtWIo1GGL03hT57 # xzjL25fKiZQX/q+II8nuG5M0Qmjvl6Egltr4hZ3e3FQRzRHfLoNPq3ELpxbWdH8t # Nuj0j/x9Crnfwbki8n57mJKI5JVWRWTSLmbTcDDLkTZlJLg9V1BIJwXGY3i2kR9i # 5HsADL8YlW0gMWVSlKB1eiSlK6LmFi0rVH16dde+j5T/EaQtFz6qngN7d1lvO7uk # 6rtX+MLKG4LDRsQgBTi6sIYiKntMjoYFHMPvI/OMUip5ljtLitVbkFGfagSqmbxK # 7rJMhC8wiTzHanBg1Rrbff1niBbnFbbV4UDmYumjs1FIpFCazk6AADXxoKCo5TsO # zSHqr9gHgGYQC2hMyX9MGLIpowYCURx3L7kUiGbOiMwaMIIHejCCBWKgAwIBAgIK # YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm # aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw # OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD # VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la # UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc # 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D # dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+ # lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk # kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6 # A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd # X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL # 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd # sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3 # T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS # 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI # bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL # BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD # uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF # BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h # cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA # YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn # 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7 # v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b # pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/ # KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy # CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp # mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi # hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb # BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS # oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL # gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX # cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGZ8wghmbAgEBMIGVMH4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p # Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAOuLTVRyFOPVR0AAAAA # A64wDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw # HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIPdy # HwKXMtfeBGQkgwGsDjjnPA13mb6CXbPzBpKruLAnMEIGCisGAQQBgjcCAQwxNDAy # oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20wDQYJKoZIhvcNAQEBBQAEggEAdyoNDscxxSEr1dOf0TIYol36IqQZ6jJvqwW9 # K+FBaggMmDQnIvh3b2NsBOxstHJnLYoueb6SBagB0wvPiokLDZbUbHs+u0y8uEA4 # TpuRBxq8l5O+AvVmjbEM4WQfnOZqnPedRzQfZXWyM7cygccIj3EFGEhvECB6N8CH # ZCabWE5r9N9QwdgIdy8LlFPLxG213lYr++2efQyTqNSjIGplujVIeyxQNg3WSu2U # C9hmKv+pCG6O7XefKlI0F68OBuZDGCiZLolbX1SBA6lA43lsdzBVYfRWP4WcQqUR # qMLDiLsmLVb07MaOS+JR69Q2aUUOgIQBYmYD+Zb42fLqLDNPEaGCFykwghclBgor # BgEEAYI3AwMBMYIXFTCCFxEGCSqGSIb3DQEHAqCCFwIwghb+AgEDMQ8wDQYJYIZI # AWUDBAIBBQAwggFZBgsqhkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGE # WQoDATAxMA0GCWCGSAFlAwQCAQUABCCR28LyKcXUYAtGyU7law7/C3f0/ASSuIaf # vuSRPZY3JgIGZdYJjmK0GBMyMDI0MDMxMTE4MTcxNC42NzVaMASAAgH0oIHYpIHV # MIHSMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsT # HVRoYWxlcyBUU1MgRVNOOjE3OUUtNEJCMC04MjQ2MSUwIwYDVQQDExxNaWNyb3Nv # ZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIReDCCBycwggUPoAMCAQICEzMAAAHg1Pwf # ExUffl0AAQAAAeAwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAg # UENBIDIwMTAwHhcNMjMxMDEyMTkwNzE5WhcNMjUwMTEwMTkwNzE5WjCB0jELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9z # b2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjoxNzlFLTRCQjAtODI0NjElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKyH # nPOhxbvRATnGjb/6fuBhh3ZLzotAxAgdLaZ/zkRFUdeSKzyNt3tqorMK7GDvcXdK # s+qIMUbvenlH+w53ssPa6rYP760ZuFrABrfserf0kFayNXVzwT7jarJOEjnFMBp+ # yi+uwQ2TnJuxczceG5FDHrII6sF6F879lP6ydY0BBZkZ9t39e/svNRieA5gUnv/Y # cM/bIMY/QYmd9F0B+ebFYi+PH4AkXahNkFgK85OIaRrDGvhnxOa/5zGL7Oiii7+J # 9/QHkdJGlfnRfbQ3QXM/5/umBOKG4JoFY1niZ5RVH5PT0+uCjwcqhTbnvUtfK+N+ # yB2b9rEZvp2Tv4ZwYzEd9A9VsYMuZiCSbaFMk77LwVbklpnw4aHWJXJkEYmJvxRb # cThE8FQyOoVkSuKc5OWZ2+WM/j50oblA0tCU53AauvUOZRoQBh89nHK+m5pOXKXd # YMJ+ceuLYF8h5y/cXLQMOmqLJz5l7MLqGwU0zHV+MEO8L1Fo2zEEQ4iL4BX8YknK # XonHGQacSCaLZot2kyJVRsFSxn0PlPvHVp0YdsCMzdeiw9jAZ7K9s1WxsZGEBrK/ # obipX6uxjEpyUA9mbVPljlb3R4MWI0E2xI/NM6F4Ac8Ceax3YWLT+aWCZeqiIMLx # yyWZg+i1KY8ZEzMeNTKCEI5wF1wxqr6T1/MQo+8tAgMBAAGjggFJMIIBRTAdBgNV # HQ4EFgQUcF4XP26dV+8SusoA1XXQ2TDSmdIwHwYDVR0jBBgwFoAUn6cVXQBeYl2D # 9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3Nv # ZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy # MDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1l # LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUB # Af8EDDAKBggrBgEFBQcDCDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQAD # ggIBAMATzg6R/A0ldO7MqGxD1VJji5yVA1hHb0Hc0Yjtv7WkxQ8iwfflulX5Us64 # tD3+3NT1JkphWzaAWf2wKdAw35RxtQG1iON3HEZ0X23nde4Kg/Wfbx5rEHkZ9bzK # nR/2N5A16+w/1pbwJzdfRcnJT3cLyawr/kYjMWd63OP0Glq70ua4WUE/Po5pU7rQ # RbWEoQozY24hAqOcwuRcm6Cb0JBeTOCeRBntEKgjKep4pRaQt7b9vusT97WeJcfa # VosmmPtsZsawgnpIjbBa55tHfuk0vDkZtbIXjU4mr5dns9dnanBdBS2PY3N3hIfC # PEOszquwHLkfkFZ/9bxw8/eRJldtoukHo16afE/AqP/smmGJh5ZR0pmgW6QcX+61 # rdi5kDJTzCFaoMyYzUS0SEbyrDZ/p2KOuKAYNngljiOlllct0uJVz2agfczGjjsK # i2AS1WaXvOhgZNmGw42SFB1qaloa8Kaux9Q2HHLE8gee/5rgOnx9zSbfVUc7IcRN # odq6R7v+Rz+P6XKtOgyCqW/+rhPmp/n7Fq2BGTRkcy//hmS32p6qyglr2K4OoJDJ # XxFs6lwc8D86qlUeGjUyo7hVy5VvyA+y0mGnEAuA85tsOcUPlzwWF5sv+B5fz35O # W3X4Spk5SiNulnLFRPM5XCsSHqvcbC8R3qwj2w1evPhZxDuNMIIHcTCCBVmgAwIB # AgITMwAAABXF52ueAptJmQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UE # BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc # BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0 # IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1 # WhcNMzAwOTMwMTgzMjI1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O # 1YLT/e6cBwfSqWxOdcjKNVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZn # hUYjDLWNE893MsAQGOhgfWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t # 1w/YJlN8OWECesSq/XJprx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxq # D89d9P6OU8/W7IVWTe/dvI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmP # frVUj9z6BVWYbWg7mka97aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSW # rAFKu75xqRdbZ2De+JKRHh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv # 231fgLrbqn427DZM9ituqBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zb # r17C89XYcz1DTsEzOUyOArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYcten # IPDC+hIK12NvDMk2ZItboKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQc # xWv2XFJRXRLbJbqvUAV6bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17a # j54WcmnGrnu3tz5q4i6tAgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQAB # MCMGCSsGAQQBgjcVAgQWBBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQU # n6cVXQBeYl2D9OXSZacbUzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEw # QTA/BggrBgEFBQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9E # b2NzL1JlcG9zaXRvcnkuaHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQB # gjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/ # MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJ # oEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01p # Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYB # BQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9v # Q2VyQXV0XzIwMTAtMDYtMjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3h # LB9nATEkW+Geckv8qW/qXBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x # 5MKP+2zRoZQYIu7pZmc6U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74p # y27YP0h1AdkY3m2CDPVtI1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1A # oL8ZthISEV09J+BAljis9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbC # HcNhcy4sa3tuPywJeBTpkbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB # 9s7GdP32THJvEKt1MMU0sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNt # yo4JvbMBV0lUZNlz138eW0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3 # rsjoiV5PndLQTHa1V1QJsWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcV # v7TOPqUxUYS8vwLBgqJ7Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A24 # 5oyZ1uEi6vAnQj0llOZ0dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lw # Y1NNje6CbaUFEMFxBmoQtB1VM1izoXBm8qGCAtQwggI9AgEBMIIBAKGB2KSB1TCB # 0jELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMk # TWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1U # aGFsZXMgVFNTIEVTTjoxNzlFLTRCQjAtODI0NjElMCMGA1UEAxMcTWljcm9zb2Z0 # IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAbfPR1fBX6HxYfyPx # 8zYzJU5fIQyggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAN # BgkqhkiG9w0BAQUFAAIFAOmZkQ8wIhgPMjAyNDAzMTEyMjE3NTFaGA8yMDI0MDMx # MjIyMTc1MVowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA6ZmRDwIBADAHAgEAAgIP # qjAHAgEAAgIRxjAKAgUA6ZrijwIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEE # AYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GB # ADC14kWiE7LYTvupAxBJEIhEiCkNlZYw5D/CQ6urvhmcM53+kbvZC0sceoPeNaj5 # cpEqSUKU83mo+6UBZSPhsfDJZdnQZDxT2D7R6qPEbwCocAaMnf+CGqLkVHxHSScX # PEyLrfK41qxVzIPzb9xudy0H71ys4CDaaEIGRivLCQPpMYIEDTCCBAkCAQEwgZMw # fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd # TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHg1PwfExUffl0AAQAA # AeAwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRAB # BDAvBgkqhkiG9w0BCQQxIgQgCoMeJmZ6KyrvrcmxHg+MdE98m9qvjEBTPMO+2ley # qS8wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDj7lK/8jnlbTjPvc77DCCS # b4TZApY9nJm5whsK/2kKwTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI # EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv # ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD # QSAyMDEwAhMzAAAB4NT8HxMVH35dAAEAAAHgMCIEIMJj84ETRXlKB6N3sG/OXcMW # u3HnJmZidgf/rIrNjdRsMA0GCSqGSIb3DQEBCwUABIICACrV9CCoKqjg+im9CfhE # 9RMFD0kjo9W0AaDah5M06axRz7HhwXnw/g8qK8ihs83qjQ+qimbO/kU+QqyiZ9N8 # 3Pyi7n2WupmwmEgcxOIowmRGHmch4pxbihL+DJKYwQEMKFjN4hXTwZyTqConKMu1 # 4Sjik4LbZpIe/+3o5JZH4yt4kbF52SLetFH2T9ILpDo6amd0IVt0NvyCV3Kwa+2j # oiUMbslyc3oWLWQv6cwrjzkgBz2e/QLiqaEXO3pp/XX98yHsCse2awX46Df6mZ3R # GYOFA87EDdVlqAPKPhJD2mMr59kTcBe9XnIlx3Ds9FN2YNnt5Sx9s9OORCWLRF42 # JzlZgR/GTncNvB7BVB0PG2eNnRSqEowdcuFd9CMc/AN9jjhOIdKaHDpjXR+VqQVn # cMC15uv64/MG6TmL52TX4334hnpKBVvYZPRUnLKOJ9jNiT/GjtE3Arj/ZMG+Pqhy # feWmkMptVEBwQOj96grfGPrkmgy5+C5IyXwxCVw3zCFf2Oeuy9EZG88m5537OQQw # H6SyXT7px16RXqRLwzomm+y6NUT7JDZh0gnwzXcznFe0RUj74Y2gVMvZ+JiEgTsx # 7IedGxZAM/CUOEfN3R0cK/YfBptdzmHTlooCfPoCIyY4Hv/pXXrtDNh13+JymlD4 # rXt01/1FHgYEk4ItII389r6K # SIG # End signature block |