PureStorage.FlashArray.Backup

1.0.99

Utils.CrashCons.ps1

                                function Get-InitiatorPorts {

    Param(

        [parameter(Mandatory = $true)]

        [System.Management.Automation.Runspaces.PSSession]

        $Session,

        [parameter(Mandatory = $true)]

        [string[]]

        $iqns

    )

    $FunctionName = $MyInvocation.MyCommand

    Write-Log -Level INFO -FunctionName $FunctionName -Msg "Entering with parameter: $(Get-Parameter $MyInvocation)"

    $ports = @()

    $initiatorPorts = SafeInvokeRemote -Session $Session -ScriptBlock {

        return Get-InitiatorPort

    }

    $validIscsiConnection = SafeInvokeRemote -ArgumentList @(,$iqns) -Session $Session -ScriptBlock {

        param($iqns)

        $validConnections = @()

        # check if the initiator port has valid connections with the target FlashArray iqns

        foreach ($iqn in $iqns) {

            # SilentlyContinue because it might not have any connections to this iqn

            $validConnections += @(Get-IScsiTarget -NodeAddress $iqn -ErrorAction SilentlyContinue | Where-Object {$_.IsConnected})

        }

        if($validConnections.Count -eq 0) {return $false}

        else {return $true}

    }

    Write-Log -Level INFO -FunctionName $FunctionName -Msg "initiatorPorts: $initiatorPorts"

    foreach ($initiatorPort in $initiatorPorts) {

        if ($initiatorPort.ConnectionType -eq 'iSCSI' -or $initiatorPort.ConnectionType -eq 2) {

            # we can only use iSCSI if there is a valid connection to the target FlashArray

            if(-not $validIscsiConnection) {

                Write-Log -Level INFO -FunctionName $FunctionName -Msg "No valid iSCSI connections found for initiator port $($initiatorPort.NodeAddress)"

                continue

            }

            $ports += $initiatorPort.NodeAddress

        }

        elseif ($initiatorPort.ConnectionType -eq 'Fibre Channel' -or $initiatorPort.ConnectionType -eq 1) {

            $ports += $initiatorPort.PortAddress.ToUpper()

        }

    }

    Write-Log -Level INFO -FunctionName $FunctionName -Msg "Exiting with result: $ports"

    return $ports

}

function Get-MatchingHosts {

    Param (

        $Hostports,

        $RestClient

    )

    $FAHosts = Get-Pfa2host -Array $RestClient -Filter "is_local='True'"

    $matchingHosts = @()

    foreach ($fahost in $FAHosts) {

        $iqn = $fahost.Iqns

        $wwn = $fahost.Wwns

        $allports = $iqn + $wwn

        $intersect = $Hostports | ?{$allports -contains $_}   #intersection

        if($intersect.Count -gt 0) {

            $matchingHosts += $fahost

        }

    }

    if ($matchingHosts.Count -gt 0) {

        return $matchingHosts

    }

    return $null

}

function Get-MatchingHostGroups {

    Param (

        $matchingHosts

    )

    $matchingHGs = @()

    if($matchingHosts.Count -gt 0) {

        foreach ($fahost in $matchingHosts) {

            if($fahost.HostGroup.Name -and (-not ($fahost.HostGroup.Name -in $matchingHGs))){

                $matchingHGs += $fahost.HostGroup.Name

            }

        }

    }

    if($matchingHGs.Count -gt 0) {

        return $matchingHGs

    }

    return $null

}

function Connect-VolToHost {

    Param (

        $volumeName,

        $matchingHosts,

        $matchingHGs,

        $RestClient

    )

    if (-not $matchingHosts) {

        # We assume the host already exists

        ThrowErrorCode -ErrorCode $ErrorCode_HostNotFound -params @($hostports,$FlashArrayAddress)

    }

    if ($matchingHGs) {

        # if there are any hostgroups connects volume to the first one

        New-Pfa2Connection -Array $RestClient -VolumeNames $volumeName -HostGroupNames ($matchingHGs | Select-Object -First 1) | Out-Null

    }

    else {

        # if there are no hostgroups connects volume to first host

        New-Pfa2Connection -Array $RestClient -VolumeNames $volumeName -HostNames ($matchingHosts | Select-Object -First 1).Name | Out-Null

    }

}

function Disconnect-VolHosts {

    Param (

        $volumeName,

        $RestClient

    )

    $FAConnections = get-pfa2Connection -Array $RestClient -VolumeNames $volumeName

    # disconnect vol-host

    $FAHostConnections = $FAConnections | where {[string]::IsNullOrEmpty($_.HostGroup)}

    $FAHosts = $FAHostConnections.Host.Name | Sort-object | get-unique

    foreach ($FAHost in $FAHosts) {

        Remove-Pfa2Connection -Array $RestClient -VolumeNames $volumeName -HostNames $FAHost | Out-Null

    }

    # disconnect vol-hostgroup

    $FAHostGroupConnections = $FAConnections | where {-not [string]::IsNullOrEmpty($_.HostGroup.Name)}

    $FAHostGroups = $FAHostGroupConnections.HostGroup.Name | Sort-object | get-unique

    foreach ($FAHostGroup in $FAHostGroups) {

        Remove-Pfa2Connection -Array $RestClient -VolumeNames $volumeName -HostGroupNames $FAHostGroup | Out-Null

    }

}

function Expose-Disks {

    Param(

            # Serials

            [Parameter(Mandatory = $true)]

            [string[]] 

            $Serials,

            # Paths

            [Parameter(Mandatory = $true)]

            [string[]] 

            $Paths,

            # Computer session

            [parameter(Mandatory = $true)]

            [System.Management.Automation.Runspaces.PSSession]

            $Session,

            [Parameter(Mandatory = $false)]

            [string] 

            $VolumeType,

            [parameter(Mandatory = $false)]

            [int]

            $DiskTimeout = 5,

            [parameter(Mandatory = $false)]

            [int]

            $DiskLoadRetries = 5

    )

    $FunctionName = $MyInvocation.MyCommand

    Write-Log -Level INFO -FunctionName $FunctionName -Msg "Entering with parameter: $(Get-Parameter $MyInvocation)"

    SafeInvokeRemote -Session $Session -ArgumentList $Serials,$Paths,$DiskTimeout,$DiskLoadRetries -ScriptBlock {

        param ($Serials, $Paths, $DiskTimeout, $DiskLoadRetries)

        # rescan disks

        Update-HostStorageCache

        for( $i =0; $i -lt $Serials.Count; $i++) {

            # bring disk online

            # TODO: get-disk -SerialNumber doesn't work in some machines, why?

            $disk =  get-disk | Where-object {$_.SerialNumber -eq $Serials[$i]} -ErrorAction Stop

            # throw error if disk is null

            if (-not $disk) {

                ThrowErrorCode -ErrorCode $ErrorCode_MountDiskNotFound -params @($Serials[$i])

            }

            Set-Disk -UniqueId $disk.UniqueId -IsReadOnly $False

            Set-Disk -UniqueId $disk.UniqueId -IsOffline $False

            if ("VVOL" -eq $VolumeType) {

                # Generate a unique disk id

                do {

                    $newid = ([guid]::NewGuid()).ToString()

                    # Signature only accepts uint32

                    $new_signature = Get-Random -Minimum 0 -Maximum ([uint32]::MaxValue)

                    $matching_disks = Get-Disk | Where-Object {$_.Guid -eq "{$newid}" -or $_.Signature -eq $new_signature}

                } while ($null -ne $matching_disks)

                $disk = Get-Disk -UniqueId $vmHardDiskUuid

                if ("GPT" -eq $disk.PartitionStyle) {

                    # For GPT formatted disks, unique id is the GUID

                    Set-Disk  -UniqueId $vmHardDiskUuid -Guid "{$newid}"

                }

                elseif ("MBR" -eq $disk.PartitionStyle) {

                    # For MBR formatted disks, Signature is the unique id

                    Set-Disk  -UniqueId $vmHardDiskUuid -Signature $new_signature

                }

                else {

                    ThrowErrorCode -ErrorCode $ErrorCode_UnsupportedDiskType -params @($disk.PartitionStyle)

                }

            }

            # get partition to expose

            $partition = $disk | Get-Partition | Where-Object {$_.AccessPaths}

            # wait a few seconds if partition is not ready

            $retries = 0

            while($partition.Count -eq 0){

                if ($retries -gt $DiskLoadRetries){

                    ThrowErrorCode -ErrorCode $ErrorCode_NoPartitionsFound

                }

                start-sleep -seconds $DiskTimeout

                $retries += 1

                $partition = $disk | Get-Partition | Where-Object {$_.AccessPaths}

            }

            if($partition.Count -gt 1){

                ThrowErrorCode -ErrorCode $ErrorCode_MultiPartitionsMounted

            }

            $assignedpath = @($Paths)[$i]

            if($assignedpath.Length -gt 1){

                #mount point

                if(-not (test-path -Path $assignedpath)){

                    ThrowErrorCode -ErrorCode $ErrorCode_MPMissing -params @($assignedpath)

                }

                if($partition.DriveLetter){

                    $partition | Remove-PartitionAccessPath -AccessPath "$($partition.DriveLetter):"

                }

                Set-Partition -DiskId $partition.DiskId -Offset $partition.Offset -NoDefaultDriveLetter $true

                $partition | Add-PartitionAccessPath -AccessPath $assignedpath

            }

            else{

                #drive letter

                if ($partition.DriveLetter -ne $assignedpath) {

                    Set-Partition -DiskId $partition.DiskId -Offset $partition.Offset -NewDriveLetter $assignedpath

                }

            }

        }

    }

}

function Unexpose-Disks {

    Param(

            # Paths

            [Parameter(Mandatory = $true)]

            [string[]] 

            $Paths,

            # SerialNumbers

            [Parameter(Mandatory = $false)]

            [string[]] 

            $VolumeSerialNumbers,

            # Computer session

            [parameter(Mandatory = $true)]

            [System.Management.Automation.Runspaces.PSSession]

            $Session

    )

    $FunctionName = $MyInvocation.MyCommand

    Write-Log -Level INFO -FunctionName $FunctionName -Msg "Entering with parameter: $(Get-Parameter $MyInvocation)"

    $msgs = SafeInvokeRemote -Session $Session -ArgumentList ($Paths, $VolumeSerialNumbers) -ScriptBlock {

        param ([string[]] $Paths, [string[]] $VolumeSerialNumbers)

        $msgs = @()

        foreach( $mountPath in $Paths) {

            $partition = $null

            if($mountPath.Length -gt 1){

                #mount point

                $ResolvedPath = (Resolve-Path -Path $mountPath).Path

                if ($ResolvedPath[$ResolvedPath.Length -1] -ne '\') {

                    $ResolvedPath = $ResolvedPath + '\'

                }

                $WmiVol = Get-WmiObject win32_volume | Where-Object {$_.Name -eq $ResolvedPath}

                $CimVol = get-volume | Where-Object {$_.path -eq $WmiVol.DeviceID}

                $partition = get-partition -Volume $CimVol 

                $partition | Remove-PartitionAccessPath -AccessPath $ResolvedPath

            }

            else{

                #drive letter

                # get disk info

                $partition = Get-Partition -DriveLetter $mountPath -ErrorAction SilentlyContinue

                $partition | Remove-PartitionAccessPath -AccessPath "$($mountPath):"

            }

            if($partition) {

                $disk = $partition | Get-Disk -ErrorAction Stop

                if($VolumeSerialNumbers -and (-not ($disk.SerialNumber -in $VolumeSerialNumbers))){

                    ThrowErrorCode -ErrorCode $ErrorCode_MountVolsSerialError -params @($disk.SerialNumber,$mountPath,$Session.ComputerName,$VolumeSerialNumbers)

                }

                # bring disk offline

                Set-Disk -Number $disk.Number -IsOffline $True

            }

            else{

                # if partition is null then it's already unexposed

                $msgs += "Path $mountPath not found, disk already unexposed."

            }

        }

        return $msgs

    }

    foreach ($msg in $msgs){

        Write-Log -Level INFO -FunctionName $FunctionName -Msg $msg

    }

    return ($msgs.Count -eq 0)

}

# SIG # Begin signature block

# MIIn+AYJKoZIhvcNAQcCoIIn6TCCJ+UCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUaVmWYqzchP1afk2b4LicjLtH

# /WuggiEoMIIFjTCCBHWgAwIBAgIQDpsYjvnQLefv21DiCEAYWjANBgkqhkiG9w0B

# AQwFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVk

# IElEIFJvb3QgQ0EwHhcNMjIwODAxMDAwMDAwWhcNMzExMTA5MjM1OTU5WjBiMQsw

# CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu

# ZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz

# 7MKnJS7JIT3yithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS

# 5F/WBTxSD1Ifxp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7

# bXHiLQwb7iDVySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfI

# SKhmV1efVFiODCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jH

# trHEtWoYOAMQjdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14

# Ztk6MUSaM0C/CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2

# h4mXaXpI8OCiEhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt

# 6zPZxd9LBADMfRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPR

# iQfhvbfmQ6QYuKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ER

# ElvlEFDrMcXKchYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4K

# Jpn15GkvmB0t9dmpsh3lGwIDAQABo4IBOjCCATYwDwYDVR0TAQH/BAUwAwEB/zAd

# BgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wHwYDVR0jBBgwFoAUReuir/SS

# y4IxLVGLp6chnfNtyA8wDgYDVR0PAQH/BAQDAgGGMHkGCCsGAQUFBwEBBG0wazAk

# BggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEMGCCsGAQUFBzAC

# hjdodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURS

# b290Q0EuY3J0MEUGA1UdHwQ+MDwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0

# LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwEQYDVR0gBAowCDAGBgRV

# HSAAMA0GCSqGSIb3DQEBDAUAA4IBAQBwoL9DXFXnOF+go3QbPbYW1/e/Vwe9mqyh

# hyzshV6pGrsi+IcaaVQi7aSId229GhT0E0p6Ly23OO/0/4C5+KH38nLeJLxSA8hO

# 0Cre+i1Wz/n096wwepqLsl7Uz9FDRJtDIeuWcqFItJnLnU+nBgMTdydE1Od/6Fmo

# 8L8vC6bp8jQ87PcDx4eo0kxAGTVGamlUsLihVo7spNU96LHc/RzY9HdaXFSMb++h

# UD38dglohJ9vytsgjTVgHAIDyyCwrFigDkBjxZgiwbJZ9VVrzyerbHbObyMt9H5x

# aiNrIv8SuFQtJ37YOtnwtoeW/VvRXKwYw02fc7cBqZ9Xql4o4rmUMIIGrjCCBJag

# AwIBAgIQBzY3tyRUfNhHrP0oZipeWzANBgkqhkiG9w0BAQsFADBiMQswCQYDVQQG

# EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl

# cnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMjIw

# MzIzMDAwMDAwWhcNMzcwMzIyMjM1OTU5WjBjMQswCQYDVQQGEwJVUzEXMBUGA1UE

# ChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQg

# UlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEAxoY1BkmzwT1ySVFVxyUDxPKRN6mXUaHW0oPRnkyibaCw

# zIP5WvYRoUQVQl+kiPNo+n3znIkLf50fng8zH1ATCyZzlm34V6gCff1DtITaEfFz

# sbPuK4CEiiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW1OcoLevTsbV15x8GZY2UKdPZ

# 7Gnf2ZCHRgB720RBidx8ald68Dd5n12sy+iEZLRS8nZH92GDGd1ftFQLIWhuNyG7

# QKxfst5Kfc71ORJn7w6lY2zkpsUdzTYNXNXmG6jBZHRAp8ByxbpOH7G1WE15/teP

# c5OsLDnipUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCYJn+gGkcgQ+NDY4B7dW4nJZCY

# OjgRs/b2nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucfWmyU8lKVEStYdEAoq3NDzt9K

# oRxrOMUp88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLcGEh/FDTP0kyr75s9/g64ZCr6

# dSgkQe1CvwWcZklSUPRR8zZJTYsg0ixXNXkrqPNFYLwjjVj33GHek/45wPmyMKVM

# 1+mYSlg+0wOI/rOP015LdhJRk8mMDDtbiiKowSYI+RQQEgN9XyO7ZONj4KbhPvbC

# dLI/Hgl27KtdRnXiYKNYCQEoAA6EVO7O6V3IXjASvUaetdN2udIOa5kM0jO0zbEC

# AwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFLoW2W1N

# hS9zKXaaL3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX44LScV1kTN8uZz/nupiuHA9P

# MA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB3BggrBgEFBQcB

# AQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBBBggr

# BgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1

# c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybDMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcmwwIAYDVR0gBBkwFzAI

# BgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQB9WY7Ak7Zv

# mKlEIgF+ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJLKftwig2qKWn8acHPHQfpPmDI

# 2AvlXFvXbYf6hCAlNDFnzbYSlm/EUExiHQwIgqgWvalWzxVzjQEiJc6VaT9Hd/ty

# dBTX/6tPiix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2MvGQmh2ySvZ180HAKfO+ovHVP

# ulr3qRCyXen/KFSJ8NWKcXZl2szwcqMj+sAngkSumScbqyQeJsG33irr9p6xeZmB

# o1aGqwpFyd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJxLafzYeHJLtPo0m5d2aR8XKc

# 6UsCUqc3fpNTrDsdCEkPlM05et3/JWOZJyw9P2un8WbDQc1PtkCbISFA0LcTJM3c

# HXg65J6t5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SVe+0KXzM5h0F4ejjpnOHdI/0d

# KNPH+ejxmF/7K9h+8kaddSweJywm228Vex4Ziza4k9Tm8heZWcpw8De/mADfIBZP

# J/tgZxahZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJDwq9gdkT/r+k0fNX2bwE+oLe

# Mt8EifAAzV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr5n8apIUP/JiW9lVUKx+A+sDy

# Divl1vupL0QVSucTDh3bNzgaoSv27dZ8/DCCBrAwggSYoAMCAQICEAitQLJg0pxM

# n17Nqb2TrtkwDQYJKoZIhvcNAQEMBQAwYjELMAkGA1UEBhMCVVMxFTATBgNVBAoT

# DERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UE

# AxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MB4XDTIxMDQyOTAwMDAwMFoXDTM2

# MDQyODIzNTk1OVowaTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ

# bmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBS

# U0E0MDk2IFNIQTM4NCAyMDIxIENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC

# AgoCggIBANW0L0LQKK14t13VOVkbsYhC9TOM6z2Bl3DFu8SFJjCfpI5o2Fz16zQk

# B+FLT9N4Q/QX1x7a+dLVZxpSTw6hV/yImcGRzIEDPk1wJGSzjeIIfTR9TIBXEmtD

# mpnyxTsf8u/LR1oTpkyzASAl8xDTi7L7CPCK4J0JwGWn+piASTWHPVEZ6JAheEUu

# oZ8s4RjCGszF7pNJcEIyj/vG6hzzZWiRok1MghFIUmjeEL0UV13oGBNlxX+yT4Us

# SKRWhDXW+S6cqgAV0Tf+GgaUwnzI6hsy5srC9KejAw50pa85tqtgEuPo1rn3MeHc

# reQYoNjBI0dHs6EPbqOrbZgGgxu3amct0r1EGpIQgY+wOwnXx5syWsL/amBUi0nB

# k+3htFzgb+sm+YzVsvk4EObqzpH1vtP7b5NhNFy8k0UogzYqZihfsHPOiyYlBrKD

# 1Fz2FRlM7WLgXjPy6OjsCqewAyuRsjZ5vvetCB51pmXMu+NIUPN3kRr+21CiRshh

# WJj1fAIWPIMorTmG7NS3DVPQ+EfmdTCN7DCTdhSmW0tddGFNPxKRdt6/WMtyEClB

# 8NXFbSZ2aBFBE1ia3CYrAfSJTVnbeM+BSj5AR1/JgVBzhRAjIVlgimRUwcwhGug4

# GXxmHM14OEUwmU//Y09Mu6oNCFNBfFg9R7P6tuyMMgkCzGw8DFYRAgMBAAGjggFZ

# MIIBVTASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQWBBRoN+Drtjv4XxGG+/5h

# ewiIZfROQjAfBgNVHSMEGDAWgBTs1+OC0nFdZEzfLmc/57qYrhwPTzAOBgNVHQ8B

# Af8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYIKwYBBQUHAQEEazBpMCQG

# CCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQQYIKwYBBQUHMAKG

# NWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRSb290

# RzQuY3J0MEMGA1UdHwQ8MDowOKA2oDSGMmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNv

# bS9EaWdpQ2VydFRydXN0ZWRSb290RzQuY3JsMBwGA1UdIAQVMBMwBwYFZ4EMAQMw

# CAYGZ4EMAQQBMA0GCSqGSIb3DQEBDAUAA4ICAQA6I0Q9jQh27o+8OpnTVuACGqX4

# SDTzLLbmdGb3lHKxAMqvbDAnExKekESfS/2eo3wm1Te8Ol1IbZXVP0n0J7sWgUVQ

# /Zy9toXgdn43ccsi91qqkM/1k2rj6yDR1VB5iJqKisG2vaFIGH7c2IAaERkYzWGZ

# gVb2yeN258TkG19D+D6U/3Y5PZ7Umc9K3SjrXyahlVhI1Rr+1yc//ZDRdobdHLBg

# XPMNqO7giaG9OeE4Ttpuuzad++UhU1rDyulq8aI+20O4M8hPOBSSmfXdzlRt2V0C

# FB9AM3wD4pWywiF1c1LLRtjENByipUuNzW92NyyFPxrOJukYvpAHsEN/lYgggnDw

# zMrv/Sk1XB+JOFX3N4qLCaHLC+kxGv8uGVw5ceG+nKcKBtYmZ7eS5k5f3nqsSc8u

# pHSSrds8pJyGH+PBVhsrI/+PteqIe3Br5qC6/To/RabE6BaRUotBwEiES5ZNq0RA

# 443wFSjO7fEYVgcqLxDEDAhkPDOPriiMPMuPiAsNvzv0zh57ju+168u38HcT5uco

# P6wSrqUvImxB+YJcFWbMbA7KxYbD9iYzDAdLoNMHAmpqQDBISzSoUSC7rRuFCOJZ

# DW3KBVAr6kocnqX9oKcfBnTn8tZSkP2vhUgh+Vc7tJwD7YZF9LRhbr9o4iZghurI

# r6n+lB3nYxs6hlZ4TjCCBsIwggSqoAMCAQICEAVEr/OUnQg5pr/bP1/lYRYwDQYJ

# KoZIhvcNAQELBQAwYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ

# bmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2

# IFRpbWVTdGFtcGluZyBDQTAeFw0yMzA3MTQwMDAwMDBaFw0zNDEwMTMyMzU5NTla

# MEgxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjEgMB4GA1UE

# AxMXRGlnaUNlcnQgVGltZXN0YW1wIDIwMjMwggIiMA0GCSqGSIb3DQEBAQUAA4IC

# DwAwggIKAoICAQCjU0WHHYOOW6w+VLMj4M+f1+XS512hDgncL0ijl3o7Kpxn3GIV

# WMGpkxGnzaqyat0QKYoeYmNp01icNXG/OpfrlFCPHCDqx5o7L5Zm42nnaf5bw9Yr

# IBzBl5S0pVCB8s/LB6YwaMqDQtr8fwkklKSCGtpqutg7yl3eGRiF+0XqDWFsnf5x

# XsQGmjzwxS55DxtmUuPI1j5f2kPThPXQx/ZILV5FdZZ1/t0QoRuDwbjmUpW1R9d4

# KTlr4HhZl+NEK0rVlc7vCBfqgmRN/yPjyobutKQhZHDr1eWg2mOzLukF7qr2JPUd

# vJscsrdf3/Dudn0xmWVHVZ1KJC+sK5e+n+T9e3M+Mu5SNPvUu+vUoCw0m+PebmQZ

# BzcBkQ8ctVHNqkxmg4hoYru8QRt4GW3k2Q/gWEH72LEs4VGvtK0VBhTqYggT02ke

# fGRNnQ/fztFejKqrUBXJs8q818Q7aESjpTtC/XN97t0K/3k0EH6mXApYTAA+hWl1

# x4Nk1nXNjxJ2VqUk+tfEayG66B80mC866msBsPf7Kobse1I4qZgJoXGybHGvPrhv

# ltXhEBP+YUcKjP7wtsfVx95sJPC/QoLKoHE9nJKTBLRpcCcNT7e1NtHJXwikcKPs

# CvERLmTgyyIryvEoEyFJUX4GZtM7vvrrkTjYUQfKlLfiUKHzOtOKg8tAewIDAQAB

# o4IBizCCAYcwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/

# BAwwCgYIKwYBBQUHAwgwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcB

# MB8GA1UdIwQYMBaAFLoW2W1NhS9zKXaaL3WMaiCPnshvMB0GA1UdDgQWBBSltu8T

# 5+/N0GSh1VapZTGj3tXjSTBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsMy5k

# aWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGltZVN0

# YW1waW5nQ0EuY3JsMIGQBggrBgEFBQcBAQSBgzCBgDAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuZGlnaWNlcnQuY29tMFgGCCsGAQUFBzAChkxodHRwOi8vY2FjZXJ0

# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGlt

# ZVN0YW1waW5nQ0EuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCBGtbeoKm1mBe8cI1P

# ijxonNgl/8ss5M3qXSKS7IwiAqm4z4Co2efjxe0mgopxLxjdTrbebNfhYJwr7e09

# SI64a7p8Xb3CYTdoSXej65CqEtcnhfOOHpLawkA4n13IoC4leCWdKgV6hCmYtld5

# j9smViuw86e9NwzYmHZPVrlSwradOKmB521BXIxp0bkrxMZ7z5z6eOKTGnaiaXXT

# UOREEr4gDZ6pRND45Ul3CFohxbTPmJUaVLq5vMFpGbrPFvKDNzRusEEm3d5al08z

# jdSNd311RaGlWCZqA0Xe2VC1UIyvVr1MxeFGxSjTredDAHDezJieGYkD6tSRN+9N

# UvPJYCHEVkft2hFLjDLDiOZY4rbbPvlfsELWj+MXkdGqwFXjhr+sJyxB0JozSqg2

# 1Llyln6XeThIX8rC3D0y33XWNmdaifj2p8flTzU8AL2+nCpseQHc2kTmOt44Owde

# OVj0fHMxVaCAEcsUDH6uvP6k63llqmjWIso765qCNVcoFstp8jKastLYOrixRoZr

# uhf9xHdsFWyuq69zOuhJRrfVf8y2OMDY7Bz1tqG4QyzfTkx9HmhwwHcK1ALgXGC7

# KP845VJa1qwXIiNO9OzTF/tQa/8Hdx9xl0RBybhG02wyfFgvZ0dl5Rtztpn5aywG

# Ru9BHvDwX+Db2a2QgESvgBBBijCCB2cwggVPoAMCAQICEATd+82EVAN2YngfhA+f

# z/UwDQYJKoZIhvcNAQELBQAwaTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lD

# ZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IENvZGUgU2ln

# bmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENBMTAeFw0yMzEwMDQwMDAwMDBaFw0y

# NjExMTUyMzU5NTlaMG8xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MREwDwYDVQQHEwhCZWxsZXZ1ZTEbMBkGA1UEChMSUHVyZSBTdG9yYWdlLCBJbmMu

# MRswGQYDVQQDExJQdXJlIFN0b3JhZ2UsIEluYy4wggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQCdhXqOLFS3HR5KD2RtAOzGdwKU0mMGGHfU7qUo1YFvDCN8

# vF/X8LDhouGtsZPdIfd298orsXHfXYElTgBo91gba7SqKBWi9xdXTqMR5vpt41K/

# a554AgiQp02nfYwuspZoAGnt//mDJ6ErP1jUFiWuwHsYsxk0gFEayp5xIKzmj3q4

# 9g+AenKpktbDn6HPpXZPdvg+g+GR9lPpiJo7Z40SIqzaacJsVcl5MhPfbFdLeP1s

# n0MBW3BiYLyz4CEUq8IA2vJ2557N0uB0UzWERE31brL0mBn5gB1g8Zij9VsI9J5+

# Q+THKYIgwknlnXFiSwQhQbJ3Cn7IVotei1M/D011XjUR66kNHm02VVDsbxX92xLf

# qIX7BZ0e6shMsOFVakkdM00nXhfRscDkRqEQ+IwgC3vcyJgp/QRX0SfWaaD5G0fi

# ECMBZtmq5hijTJ18MAW2KaFePW0PIn9IRnoXS3tx9coXVJMTFwnLYdIukelF4jIW

# 779IP5lQH7IBNHS01BgysjWVaQhPYxWZYtsxyRUX3gVRjFChhOtBNCAy2S+YYjUS

# TOM7CdUNTtCARX/HgcRYxxU7UTOYXPYyabdQu3mFF8yD5YNkarlgc4TQ+H1PWnIU

# l7pq3P0ZSaE5Est24ApVi6wlZC/Q3jQRKPziRg8x7Zv1TZX8TfxPDmE0Nsd+BwID

# AQABo4ICAzCCAf8wHwYDVR0jBBgwFoAUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHQYD

# VR0OBBYEFCvH/lBQxrVtiuuihv+e6+2VgDPXMD4GA1UdIAQ3MDUwMwYGZ4EMAQQB

# MCkwJwYIKwYBBQUHAgEWG2h0dHA6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAOBgNV

# HQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwgbUGA1UdHwSBrTCBqjBT

# oFGgT4ZNaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0

# Q29kZVNpZ25pbmdSU0E0MDk2U0hBMzg0MjAyMUNBMS5jcmwwU6BRoE+GTWh0dHA6

# Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5n

# UlNBNDA5NlNIQTM4NDIwMjFDQTEuY3JsMIGUBggrBgEFBQcBAQSBhzCBhDAkBggr

# BgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMFwGCCsGAQUFBzAChlBo

# dHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2Rl

# U2lnbmluZ1JTQTQwOTZTSEEzODQyMDIxQ0ExLmNydDAJBgNVHRMEAjAAMA0GCSqG

# SIb3DQEBCwUAA4ICAQCrjkZxw1B2w/pYu4siB36x5J9Xate13IDt57bxZvc7OGgz

# limeUq1/HObzW4Vej9tESBpT6a5FBuVSXQXvYQntQczEFBBksRXyad3tx5/xElHA

# LaE6BCZUtPKu3/CSrgsvVi7OgWNybOFWF2Xk9K1djImG55J7jOY+8ZKegUSlHPjB

# 8HF9G4VdS85L2SuFaRzOMTEIW+h0Ihkp6Js1rbe0YLZu/ad6VWFKoX++FDg3cbM8

# FLf482p+XCmuX/qZuFmySYDQQ4jvNiecEiyZ4m6HUryx9Fagc0NBADiOJc1R2p2I

# QbBasyndhn8KWlGSudJ+uCfuzD6ukGVe4kOpYlqkzVeOscetaY0/5v+896yP4FA8

# NS68I2eMuKbis2ouOIrAVkNPdymBjaEW1U6q979upeEG22UjjrRkq5qSdO+nk2tK

# NL1ZIc92bqIs132yuwVZ6A7Dvez03VSitT2UVBMz0BKNy1EnZ4hjqBrApU+Bbcwc

# 7nPV9hKKbEFKCcCNLpkAP8SCVX6r7qMyqYhAl+XKSfCkMpxRD2LykRup5mz54cQP

# RPoy86iVhFhWUez1O3t371sgYulMuxaff5mXK3xlzYZUHpJGkOYntQ2VlqUpl/VO

# KcNTXWnuPOyuUZY0b9tWU0Ofs8Imp7+lULJ7XUbrJoY1bUa22ce912PVBsWOojGC

# BjowggY2AgEBMH0waTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ

# bmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBS

# U0E0MDk2IFNIQTM4NCAyMDIxIENBMQIQBN37zYRUA3ZieB+ED5/P9TAJBgUrDgMC

# GgUAoHAwEAYKKwYBBAGCNwIBDDECMAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcC

# AQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYE

# FK1AqU8cWEwugICUehrANbL8y5TbMA0GCSqGSIb3DQEBAQUABIICAH0telc2FuNd

# uc9PZXy5xh7UIL4tE0GXp3rTEvtxGKbTVjmvr6AF5g/JLiIRLy3hKgXDvZnQLQz1

# vGnpvRw8FObdrO4uf9Dvt+dp2TLcRS22DrExX7mKdUtAYUtmApgsGKfQbJmnGisc

# mMz4slNcykTF/5PVbf01QmhexNy9YSyBZBetWSQP5/nIZ3kXNjKyXq2akgrHFRwk

# uVP3wUEFBBgnQt3AGL3LLq0uKKt+DnlSWovnx5sS+iz+hbB2FpYeU6TzogOM/b4r

# 872b0ouioDl+hQTiRELEiXdYlCEjOi85G4DP4BRNhuoxmZ9GSSSuK3KJ6qLTGVfT

# ckYT0OUi1Cf0FwGknOn7AduaJ3Ucv/ki73gtDshTA+7YYVwOsNmzueEO5MQOsski

# 8FQGfwMJrdLvymFJwn7/8D0nCuEc9qzrE8HARkNePvpLxJa1uoZa35HMInz/rLjc

# Ap18duJlyD01Gy3GVR0SiilA5KGkQ3v0dJfF/BAjH2C+fK2bK3WnQkBceaF7NcL4

# cEAvOLH1WJLrZafQsr0mOZjB/9dQZDi2ESs0fdIbnX6J1MWZJgoqa1BpYiwpBO1U

# GI/03rwv6X6P/3Lp+O7HoSD8XkFlXv7xPrNT2pNZ43oPO8vOp/Q7qwuhzhAiZy0F

# mltSxoNV9m/07CIyrqHtdUTZkA3vIEImoYIDIDCCAxwGCSqGSIb3DQEJBjGCAw0w

# ggMJAgEBMHcwYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMu

# MTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2IFRp

# bWVTdGFtcGluZyBDQQIQBUSv85SdCDmmv9s/X+VhFjANBglghkgBZQMEAgEFAKBp

# MBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIzMTEx

# MDAwMjY0NVowLwYJKoZIhvcNAQkEMSIEIGRJYX/6cmkgw+D8XWMx9sp51szkyM19

# vrmKqDH49imHMA0GCSqGSIb3DQEBAQUABIICAKCQ1ZjNmJEciGlRKGY9nUCUYbQg

# K4SJp9gzl52Au5HMn75RyEvyBw2/nZw4XJq9gHH+HYKjwbR2mqOfA9Gj1TBlWwVW

# 3b9kbRd5LWuLdGIy1HzA8cA4BQpSxKzRc0eqOhV2YQRk0gaEU/3+7X2xmT5NwMWX

# Cx5HNVshDXxMfkrfaI+Zg/Mfbdxn9uRVqObvuiUERD6vCiejh4A9nyfX7AFMN9j2

# GghixWKv7r51fbYjZnwjxQunAJA1oZlJNU/L7w0HyGzWlPxi3brdlVkEnKkbSMyB

# n4JrXhXHpl/SeyWp4ubQoXRJ5vqW2NKwWZ6+K6FxsKQ34X3UKzcnjB5cCsm0Ssly

# KUzygX8ysmaQasNmyM0aloyxwo9rnUwqQ+08cOYP/fRBSrLM1x5msOHLHRxyGi/l

# cO/iUzwwMXArToKTT5AnrF3wiswd1eAcUJ145OZR9LUk0iVorirF9UzkYKY3zUi1

# CnnhsonJJAix7b3kNM6sA7uf87kLzHNzSarxIkOIE8gYBra3GCsWu+Q4tNVn65E3

# Av+mdfIyl/qTJobhEar50Jcdd+Faks8qpkOzp3iY0YmDAcxggRWEGokBmgVXq+cW

# JVQIbIx5GFAwjuFBGmS5lFUZLQxsok+zwI5oymvzHLA41YyJg9lqYlZbQ/0bmkPc

# 8874d4DxESdrf8xe

# SIG # End signature block