PureStorage.CBS.AVS

1.0.206-preview

PureStorage.CBS.AVS.Configuration.ps1

                                function Remove-PCBSStaticiSCSITargets {

    <#

    .SYNOPSIS

    Remove statis iSCSI Targets

    .DESCRIPTION

    Remove statis iSCSI Targets

    .PARAMETER Esxi

   ESXi VMware object

    #>

    Param(

        [Parameter(Position=0,mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi

    )

    $ESXi | Get-VMHostHba -Type iScsi | Get-IScsiHbaTarget | Where {$_.Type -eq "Static"} | Remove-IScsiHbaTarget -Confirm:$false

}

function Set-PCBSVmHostiSCSI {

    <#

    .SYNOPSIS

      Configure FlashArray iSCSI target information on ESXi host

    .DESCRIPTION

      Takes in an ESXi host and configures FlashArray iSCSI target info

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi,

        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]

        $Flasharray,

        [Parameter(Mandatory=$false)]

        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]

        [String]$AzureSubscriptionId,

        [Parameter(Mandatory=$false)]

        [String]$AVSResourceGroup

    )

    if ($esxi.ExtensionData.Runtime.ConnectionState -ne "connected")

    {

        Write-Warning "Host $($esxi.NetworkInfo.HostName) is not in a connected state and cannot be configured."

        return

    }

    $ESXitargets = @()

    $faiSCSItargets = Get-Pfa2NetworkInterface -Array $FlashArray |Where-Object {$_.services -eq "iscsi"} |Where-Object {$_.enabled -eq $true} | Where-Object {$null -ne $_.Eth.address}

    if ($null -eq $faiSCSItargets)

    {

        throw "The target Pure Cloud Block Store does not currently have any iSCSI targets configured."

    }

    $params = @{

        ClusterName = $Cluster.Name;

        ScsiIpAddress = $faiSCSItargets[0].Eth.address

    }

    Invoke-RunScript -CmdletName  "Set-VmfsIscsi" -Parameters $params `

    -AVSCloudName $AVSCloudName -AzureSubscriptionId $AzureSubscriptionId -AVSResourceGroup $AVSResourceGroup

}

function New-PCBSHostFromVmHost {

    <#

    .SYNOPSIS

      Create a FlashArray host from an ESXi vmhost object

    .DESCRIPTION

      Takes in a vCenter ESXi host and creates a FlashArray host

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi,

        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]

        $Flasharray,

        [Parameter(Mandatory=$false)]

        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]

        [String]$AzureSubscriptionId,

        [Parameter(Mandatory=$false)]

        [String]$AVSResourceGroup

    )

    $ArrayName = Get-ArrayName -FlashArray $FlashArray

    Write-Verbose "Creating Pure Cloud Block Store $ArrayName host for VMHost $($Esxi.Name)..."

    $newFaHost = $null

    try {

        $newFaHost = Get-PCBSHostFromVmHost -flasharray $flasharray -esxi $esxi -ErrorAction Stop

    }

    catch {}

    if ($null -eq $newFaHost) {

        Set-PCBSVMHostiSCSI -Cluster $Cluster -esxi $esxi -flasharray $flasharray  `

            -AVSCloudName $AVSCloudName -AzureSubscriptionId $AzureSubscriptionId -AVSResourceGroup $AVSResourceGroup  -ErrorAction Stop | Out-Null

        $iscsiadapter = $esxi | Get-VMHostHBA -Type iscsi | Where-Object { $_.Model -eq "iSCSI Software Adapter" }

        if ($null -eq $iscsiadapter) {

            throw "No Software iSCSI adapter found on host $($esxi.NetworkInfo.HostName)."

        }

        else {

            $iqn = $iscsiadapter.ExtensionData.IScsiName

        }

        try {

            try {

                $newFaHost = New-Pfa2Host -Array $FlashArray -Name ($esxi.NetworkInfo.HostName) -Iqns $iqn -ErrorAction Stop

            }

            catch {

                if ($PSItem.ToString() -like "Host already exists.*") {

                    $randName = $esxi.NetworkInfo.HostName + (Get-Random -Maximum 99999 -Minimum 10000).ToString()

                    $newFaHost = New-Pfa2Host -Array $FlashArray -Name $($randName) -Iqns $iqn

                    Write-Host "Host name $($esxi.NetworkInfo.HostName) is in use. Host $($newFaHost.Name) is created for Esxi $($Esxi.Name)"

                }

                else {

                    throw $PSItem.ToString()

                }

            }

            $arrayInfo =  Get-Pfa2Array -Array $FlashArray

            $majorVersion = [int](($arrayInfo.Version.Split('.'))[0])

            if ($majorVersion -ge 5) {

                Update-Pfa2Host -Array $FlashArray -Name $($newFaHost.name) -Personality "esxi" | Out-Null

            }

        }

        catch {

            Write-Error "$_"

            return $null

        }

    }

    else {

        if ($newFaHost.wwn.count -gt 0) {

            throw "The host $($esxi.NetworkInfo.HostName) is already configured on array $Arrayname with FibreChannel. Multiple-protocols at once are not supported by VMware."

        }

    }

    return $newFaHost

}

function Remove-PCBSUnusedHosts {

    Param (

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$True)]

        $Flasharray

    )

    $hostGroups =  Get-PCBSHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster

    $faHostList = @()

    foreach ($hostGroup in $hostGroups) {

        $faHosts = Get-Pfa2Host -Array $Flasharray | Where-Object{$_.HostGroup.Name -eq $hostGroup.Name} | Where-Object {$_.IsLocal -eq $True}

        $faHostList = $faHostList + $faHosts

    }

    $vmHosts = $Cluster | Get-VMHost

    foreach ($vmHost in $vmHosts) {

        $faHost = Get-PCBSHostFromVmHost -Flasharray $FlashArray -Esxi $vmHost -ErrorAction Ignore

        # Remove used hosts from the list

        $faHostList = $faHostList | Where-Object {$_.Name -ne $faHost.Name}

    }

    foreach ($faHost in $faHostList) {

        Write-Host "Removing unused host '$($faHost.Name)' from host group '$($faHost.HostGroup.Name)'..."

        Update-Pfa2Host -Array $Flasharray -Name $faHost.Name -HostGroupName ''

        # Remove might fail if there is volume in the host. 

        try {

            Remove-Pfa2Host -Array $Flasharray -Name $faHost.Name

        } catch {

            # Write a non-terminating error here if failed to remove the host

            Write-Error "$_" -ErrorAction Continue

        }

    }

}

function New-PCBSHostGroupfromVcCluster {

    <#

    .SYNOPSIS

      Create a host group from an ESXi cluster

    .DESCRIPTION

      Takes in a vCenter Cluster and creates hosts (if needed) and host group

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$True)]

        $Flasharray,

        [Parameter(Mandatory=$false)]

        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]

        [String]$AzureSubscriptionId,

        [Parameter(Mandatory=$false)]

        [String]$AVSResourceGroup

    )

    $updated_hosts = @()

    # We have to use try catch here as adding -ErrorAction SilentlyContinue still throw terminating error

    try {

        $hostGroup =  Get-PCBSHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster

    }

    catch {}

    if ($hostGroup.count -gt 1)

    {

        throw "The cluster already is configured on the Pure Cloud Block Store and spans more than one host group. This cmdlet does not support a multi-hostgroup configuration."

    }

    $hostgroupName = $hostGroup.Name

    $esxiHosts = $cluster | Get-VMHost

    $HostMap = @{}

    foreach ($esxiHost in $esxiHosts)

    {

        $faHost = $null

        try {

            $faHost = Get-PCBSHostFromVmHost -flasharray $Flasharray -esxi $esxiHost -ErrorAction Ignore

            if ($null -ne $faHost.HostGroup.Name)

            {

                if ($null -ne $hostGroup)

                {

                    if ($hostGroup.name -ne $faHost.HostGroup.Name)

                    {

                        Write-Warning "The host $($faHost.name) already exists and is already in the host group $($faHost.hgroup)."

                    }

                }

            }

        }

        catch {

            Write-Host "$_"

        }

        if ($null -ne $faHost)

        {

            if ($fahost.wwns.count -ge 1)

            {

                throw "The host $($esxiHost.NetworkInfo.HostName) is already configured on the Pure Cloud Block Store for FC. Mixed mode is not supported by VMware."

            }

        }

        if ($null -eq $faHost)

        {

            try {

                $faHost = New-PCBSHostFromVmHost -Cluster $Cluster -flasharray $Flasharray -esxi $esxiHost `

                    -AVSCloudName $AVSCloudName -AzureSubscriptionId $AzureSubscriptionId -AVSResourceGroup $AVSResourceGroup -ErrorAction Stop 

                $HostMap[$faHost.Name] = $esxiHost

                $updated_hosts += $esxiHost.Name

            }

            catch {

                Write-Error $Global:Error[0]

                throw "Could not create host. Cannot create host group."

            }

        }

        else {

            $HostMap[$faHost.name] = $esxiHost.Name

        }

    }

    #FlashArray only supports Alphanumeric or the dash - character in host group names. Checking for VMware cluster name compliance and removing invalid characters.

    if ($null -eq $hostGroup)

    {

        if ($cluster.Name -match "^[a-zA-Z0-9\-]+$")

        {

            $hostgroupName = $cluster.Name

        }

        else

        {

            $hostgroupName = $cluster.Name -replace "[^\w\-]", ""

            $hostgroupName = $hostgroupName -replace "[_]", ""

            $hostgroupName = $hostgroupName -replace " ", ""

        }

        $hg = $null

        $hg =  Get-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName -ErrorAction SilentlyContinue | Where-Object {$_.IsLocal -eq $True}

        if ($null -ne $hg)

        {

            if ($hg.hosts.count -ne 0)

            {

                #if host group name is already in use and has only unexpected hosts i will create a new one with a random number at the end

                $nameRandom = Get-random -Minimum 1000 -Maximum 9999

                $hostgroupName = "$($hostgroupName)-$($nameRandom)"

                $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName  -ErrorAction stop

            }

            else {

                $hostGroup = $hg

            }

        }

        else {

                #if there is no host group, it will be created

                $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName  -ErrorAction stop

        }

    }

    $faHostNames = @()

    foreach ($faHostName in $HostMap.Keys)

    {

        $faHost = Get-Pfa2Host -Array $Flasharray -Name $faHostName | Where-Object {$_.IsLocal -eq $True}

        if ($null -eq $faHost.HostGroup.Name)

        {

            $faHostNames += $faHostName

        }

    }

    #any hosts that are not already in the host group will be added

    if ($faHostNames.count -gt 0)

    {

        foreach ($faHostName in $faHostNames)

        {

            Write-Host "Adding $faHostName to $hostgroupName..."

            Update-Pfa2Host -Array $Flasharray -Name $faHostName -HostGroupName $hostgroupName | Out-Null

            if (-not $updated_hosts -contains $HostMap[$faHostName]) {

                $updated_hosts += $HostMap[$faHostName]

            }

        }

    }

    return $updated_hosts

}

# SIG # Begin signature block

# MIIjUgYJKoZIhvcNAQcCoIIjQzCCIz8CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUIo9UGShLBodaHZQ4im21BwmM

# NVCggh14MIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkqhkiG9w0B

# AQsFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVk

# IElEIFJvb3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAwWjByMQsw

# CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu

# ZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQg

# Q29kZSBTaWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA

# +NOzHH8OEa9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6kkPApfmJ

# 1DcZ17aq8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQjZhJUM1B0

# sSgmuyRpwsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5wMWYzcT6s

# cKKrzn/pfMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp6moKq4Tz

# rGdOtcT3jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH5DiLanMg

# 0A9kczyen6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgwBgEB/wIB

# ADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYIKwYBBQUH

# AQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYI

# KwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFz

# c3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmw0

# LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaG

# NGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RD

# QS5jcmwwTwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUHAgEWHGh0

# dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYDVR0OBBYE

# FFrEuXsqCqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6en

# IZ3zbcgPMA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2qB1dHC06

# GsTvMGHXfgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4QpO4/cY5j

# DhNLrddfRHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEpKBo6cSgC

# PC6Ro8AlEeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/DmZAwlCEIy

# sjaKJAL+L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9CBoYs4Gb

# T8aTEAb8B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHvMIIFNzCC

# BB+gAwIBAgIQC4jZOitkx57ksuMgsWXX0jANBgkqhkiG9w0BAQsFADByMQswCQYD

# VQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGln

# aWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29k

# ZSBTaWduaW5nIENBMB4XDTIwMDczMDAwMDAwMFoXDTIzMTAwNDEyMDAwMFowdDEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDU1vdW50

# YWluIFZpZXcxGzAZBgNVBAoTElB1cmUgU3RvcmFnZSwgSW5jLjEbMBkGA1UEAxMS

# UHVyZSBTdG9yYWdlLCBJbmMuMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC

# AQEA6nefE6+A0nNMY82xtkQb+akwI0oxLqEbRY65bE4re+CVQV2xP89/7FIAXooq

# jxNOvrtWicWTGOZjBdAFEXXAUEyu9CkWFOXGLV3/QkcEfY3e3Z3jypa6h1EznSEp

# 3wSQEIVbigi6jR2s7NDnDoSDAKnzcGcSZ8Nz7akXFrN8PAmg3gy8a/rwm2Ko7ClR

# ZUHj1C/OMPXUqiN0Q4FyAsaeFmvg2PX2twxo192WRdNro1dkKNfmDvym2ss6MXcq

# gFEjBcZtHDv3e/i0BjT24Jm1C27IVYZzVf28dqmVfPo7l8bLEHsVKgrRf0VzS2wI

# R08gXiMrohf9tv3AbvtPk7ZaawIDAQABo4IBxTCCAcEwHwYDVR0jBBgwFoAUWsS5

# eyoKo6XqcQPAYPkt9mV1DlgwHQYDVR0OBBYEFJOwFn7S4Lj6QdNnH6tpm3FMFWJI

# MA4GA1UdDwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzB3BgNVHR8EcDBu

# MDWgM6Axhi9odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vc2hhMi1hc3N1cmVkLWNz

# LWcxLmNybDA1oDOgMYYvaHR0cDovL2NybDQuZGlnaWNlcnQuY29tL3NoYTItYXNz

# dXJlZC1jcy1nMS5jcmwwTAYDVR0gBEUwQzA3BglghkgBhv1sAwEwKjAoBggrBgEF

# BQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAIBgZngQwBBAEwgYQG

# CCsGAQUFBwEBBHgwdjAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQu

# Y29tME4GCCsGAQUFBzAChkJodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGln

# aUNlcnRTSEEyQXNzdXJlZElEQ29kZVNpZ25pbmdDQS5jcnQwDAYDVR0TAQH/BAIw

# ADANBgkqhkiG9w0BAQsFAAOCAQEAMVAa7mXxhBHf0dTzf6LKDncN8KnzB59KBvd0

# KvXZc6FoLHGi2Wg6XBSP+9mdDMMYOkohqstSk7RD+reT8xiptrIkSMcVcTog1Z3e

# JjYTK8B7QsSpuu2lo0RWA5rdvqMJ+lVzbbjteTq+uicP4T/EDwv2q+iPAgpXQD8y

# r084ExDWJtMfhvy0cxh555xx88rvFWOhJnXYiFtjaO9dp7f2TnZRJ44rmB98jc9E

# BR/8GLOi/BhyPiiU4nBv8JIHVP1E5zIt8/9PhfpenmiWBbuuP0YLnzrqRhswtJaq

# jJirYNLYojmINrbvdcpEKGK1AitsnuOjFadLI7bc696Y35lUATCCBY0wggR1oAMC

# AQICEA6bGI750C3n79tQ4ghAGFowDQYJKoZIhvcNAQEMBQAwZTELMAkGA1UEBhMC

# VVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0

# LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTIy

# MDgwMTAwMDAwMFoXDTMxMTEwOTIzNTk1OVowYjELMAkGA1UEBhMCVVMxFTATBgNV

# BAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8G

# A1UEAxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEAv+aQc2jeu+RdSjwwIjBpM+zCpyUuySE98orYWcLhKac9

# WKt2ms2uexuEDcQwH/MbpDgW61bGl20dq7J58soR0uRf1gU8Ug9SH8aeFaV+vp+p

# VxZZVXKvaJNwwrK6dZlqczKU0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckgHWMpLc7s

# Xk7Ik/ghYZs06wXGXuxbGrzryc/NrDRAX7F6Zu53yEioZldXn1RYjgwrt0+nMNlW

# 7sp7XeOtyU9e5TXnMcvak17cjo+A2raRmECQecN4x7axxLVqGDgDEI3Y1DekLgV9

# iPWCPhCRcKtVgkEy19sEcypukQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjXWkmkwuap

# oGfdpCe8oU85tRFYF/ckXEaPZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIbZpp0yt5L

# HucOY67m1O+SkjqePdwA5EUlibaaRBkrfsCUtNJhbesz2cXfSwQAzH0clcOP9yGy

# shG3u3/y1YxwLEFgqrFjGESVGnZifvaAsPvoZKYz0YkH4b235kOkGLimdwHhD5QM

# IR2yVCkliWzlDlJRR3S+Jqy2QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIWIgnffEx1

# P2PsIV/EIFFrb7GrhotPwtZFX50g/KEexcCPorF+CiaZ9eRpL5gdLfXZqbId5RsC

# AwEAAaOCATowggE2MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX44LScV1k

# TN8uZz/nupiuHA9PMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgPMA4G

# A1UdDwEB/wQEAwIBhjB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6

# Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDBFBgNVHR8E

# PjA8MDqgOKA2hjRodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1

# cmVkSURSb290Q0EuY3JsMBEGA1UdIAQKMAgwBgYEVR0gADANBgkqhkiG9w0BAQwF

# AAOCAQEAcKC/Q1xV5zhfoKN0Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviHGmlUIu2k

# iHdtvRoU9BNKei8ttzjv9P+Aufih9/Jy3iS8UgPITtAq3votVs/59PesMHqai7Je

# 1M/RQ0SbQyHrlnKhSLSZy51PpwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3A8eHqNJM

# QBk1RmppVLC4oVaO7KTVPeix3P0c2PR3WlxUjG/voVA9/HYJaISfb8rbII01YBwC

# A8sgsKxYoA5AY8WYIsGyWfVVa88nq2x2zm8jLfR+cWojayL/ErhULSd+2DrZ8LaH

# lv1b0VysGMNNn3O3AamfV6peKOK5lDCCBq4wggSWoAMCAQICEAc2N7ckVHzYR6z9

# KGYqXlswDQYJKoZIhvcNAQELBQAwYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERp

# Z2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMY

# RGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MB4XDTIyMDMyMzAwMDAwMFoXDTM3MDMy

# MjIzNTk1OVowYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMu

# MTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2IFRp

# bWVTdGFtcGluZyBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMaG

# NQZJs8E9cklRVcclA8TykTepl1Gh1tKD0Z5Mom2gsMyD+Vr2EaFEFUJfpIjzaPp9

# 85yJC3+dH54PMx9QEwsmc5Zt+FeoAn39Q7SE2hHxc7Gz7iuAhIoiGN/r2j3EF3+r

# GSs+QtxnjupRPfDWVtTnKC3r07G1decfBmWNlCnT2exp39mQh0YAe9tEQYncfGpX

# evA3eZ9drMvohGS0UvJ2R/dhgxndX7RUCyFobjchu0CsX7LeSn3O9TkSZ+8OpWNs

# 5KbFHc02DVzV5huowWR0QKfAcsW6Th+xtVhNef7Xj3OTrCw54qVI1vCwMROpVymW

# Jy71h6aPTnYVVSZwmCZ/oBpHIEPjQ2OAe3VuJyWQmDo4EbP29p7mO1vsgd4iFNmC

# KseSv6De4z6ic/rnH1pslPJSlRErWHRAKKtzQ87fSqEcazjFKfPKqpZzQmiftkaz

# nTqj1QPgv/CiPMpC3BhIfxQ0z9JMq++bPf4OuGQq+nUoJEHtQr8FnGZJUlD0UfM2

# SU2LINIsVzV5K6jzRWC8I41Y99xh3pP+OcD5sjClTNfpmEpYPtMDiP6zj9NeS3YS

# UZPJjAw7W4oiqMEmCPkUEBIDfV8ju2TjY+Cm4T72wnSyPx4JduyrXUZ14mCjWAkB

# KAAOhFTuzuldyF4wEr1GnrXTdrnSDmuZDNIztM2xAgMBAAGjggFdMIIBWTASBgNV

# HRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQWBBS6FtltTYUvcyl2mi91jGogj57IbzAf

# BgNVHSMEGDAWgBTs1+OC0nFdZEzfLmc/57qYrhwPTzAOBgNVHQ8BAf8EBAMCAYYw

# EwYDVR0lBAwwCgYIKwYBBQUHAwgwdwYIKwYBBQUHAQEEazBpMCQGCCsGAQUFBzAB

# hhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQQYIKwYBBQUHMAKGNWh0dHA6Ly9j

# YWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRSb290RzQuY3J0MEMG

# A1UdHwQ8MDowOKA2oDSGMmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2Vy

# dFRydXN0ZWRSb290RzQuY3JsMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG

# /WwHATANBgkqhkiG9w0BAQsFAAOCAgEAfVmOwJO2b5ipRCIBfmbW2CFC4bAYLhBN

# E88wU86/GPvHUF3iSyn7cIoNqilp/GnBzx0H6T5gyNgL5Vxb122H+oQgJTQxZ822

# EpZvxFBMYh0MCIKoFr2pVs8Vc40BIiXOlWk/R3f7cnQU1/+rT4osequFzUNf7WC2

# qk+RZp4snuCKrOX9jLxkJodskr2dfNBwCnzvqLx1T7pa96kQsl3p/yhUifDVinF2

# ZdrM8HKjI/rAJ4JErpknG6skHibBt94q6/aesXmZgaNWhqsKRcnfxI2g55j7+6ad

# cq/Ex8HBanHZxhOACcS2n82HhyS7T6NJuXdmkfFynOlLAlKnN36TU6w7HQhJD5TN

# OXrd/yVjmScsPT9rp/Fmw0HNT7ZAmyEhQNC3EyTN3B14OuSereU0cZLXJmvkOHOr

# pgFPvT87eK1MrfvElXvtCl8zOYdBeHo46Zzh3SP9HSjTx/no8Zhf+yvYfvJGnXUs

# HicsJttvFXseGYs2uJPU5vIXmVnKcPA3v5gA3yAWTyf7YGcWoWa63VXAOimGsJig

# K+2VQbc61RWYMbRiCQ8KvYHZE/6/pNHzV9m8BPqC3jLfBInwAM1dwvnQI38AC+R2

# AibZ8GV2QqYphwlHK+Z/GqSFD/yYlvZVVCsfgPrA8g4r5db7qS9EFUrnEw4d2zc4

# GqEr9u3WfPwwggbCMIIEqqADAgECAhAFRK/zlJ0IOaa/2z9f5WEWMA0GCSqGSIb3

# DQEBCwUAMGMxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjE7

# MDkGA1UEAxMyRGlnaUNlcnQgVHJ1c3RlZCBHNCBSU0E0MDk2IFNIQTI1NiBUaW1l

# U3RhbXBpbmcgQ0EwHhcNMjMwNzE0MDAwMDAwWhcNMzQxMDEzMjM1OTU5WjBIMQsw

# CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xIDAeBgNVBAMTF0Rp

# Z2lDZXJ0IFRpbWVzdGFtcCAyMDIzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAo1NFhx2DjlusPlSzI+DPn9fl0uddoQ4J3C9Io5d6OyqcZ9xiFVjBqZMR

# p82qsmrdECmKHmJjadNYnDVxvzqX65RQjxwg6seaOy+WZuNp52n+W8PWKyAcwZeU

# tKVQgfLPywemMGjKg0La/H8JJJSkghraarrYO8pd3hkYhftF6g1hbJ3+cV7EBpo8

# 8MUueQ8bZlLjyNY+X9pD04T10Mf2SC1eRXWWdf7dEKEbg8G45lKVtUfXeCk5a+B4

# WZfjRCtK1ZXO7wgX6oJkTf8j48qG7rSkIWRw69XloNpjsy7pBe6q9iT1HbybHLK3

# X9/w7nZ9MZllR1WdSiQvrCuXvp/k/XtzPjLuUjT71Lvr1KAsNJvj3m5kGQc3AZEP

# HLVRzapMZoOIaGK7vEEbeBlt5NkP4FhB+9ixLOFRr7StFQYU6mIIE9NpHnxkTZ0P

# 387RXoyqq1AVybPKvNfEO2hEo6U7Qv1zfe7dCv95NBB+plwKWEwAPoVpdceDZNZ1

# zY8SdlalJPrXxGshuugfNJgvOuprAbD3+yqG7HtSOKmYCaFxsmxxrz64b5bV4RAT

# /mFHCoz+8LbH1cfebCTwv0KCyqBxPZySkwS0aXAnDU+3tTbRyV8IpHCj7ArxES5k

# 4MsiK8rxKBMhSVF+BmbTO77665E42FEHypS34lCh8zrTioPLQHsCAwEAAaOCAYsw

# ggGHMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoG

# CCsGAQUFBwMIMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG/WwHATAfBgNV

# HSMEGDAWgBS6FtltTYUvcyl2mi91jGogj57IbzAdBgNVHQ4EFgQUpbbvE+fvzdBk

# odVWqWUxo97V40kwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2NybDMuZGlnaWNl

# cnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0UlNBNDA5NlNIQTI1NlRpbWVTdGFtcGlu

# Z0NBLmNybDCBkAYIKwYBBQUHAQEEgYMwgYAwJAYIKwYBBQUHMAGGGGh0dHA6Ly9v

# Y3NwLmRpZ2ljZXJ0LmNvbTBYBggrBgEFBQcwAoZMaHR0cDovL2NhY2VydHMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0UlNBNDA5NlNIQTI1NlRpbWVTdGFt

# cGluZ0NBLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAgRrW3qCptZgXvHCNT4o8aJzY

# Jf/LLOTN6l0ikuyMIgKpuM+AqNnn48XtJoKKcS8Y3U623mzX4WCcK+3tPUiOuGu6

# fF29wmE3aEl3o+uQqhLXJ4Xzjh6S2sJAOJ9dyKAuJXglnSoFeoQpmLZXeY/bJlYr

# sPOnvTcM2Jh2T1a5UsK2nTipgedtQVyMadG5K8TGe8+c+njikxp2oml101DkRBK+

# IA2eqUTQ+OVJdwhaIcW0z5iVGlS6ubzBaRm6zxbygzc0brBBJt3eWpdPM43UjXd9

# dUWhpVgmagNF3tlQtVCMr1a9TMXhRsUo063nQwBw3syYnhmJA+rUkTfvTVLzyWAh

# xFZH7doRS4wyw4jmWOK22z75X7BC1o/jF5HRqsBV44a/rCcsQdCaM0qoNtS5cpZ+

# l3k4SF/Kwtw9Mt911jZnWon49qfH5U81PAC9vpwqbHkB3NpE5jreODsHXjlY9Hxz

# MVWggBHLFAx+rrz+pOt5Zapo1iLKO+uagjVXKBbLafIymrLS2Dq4sUaGa7oX/cR3

# bBVsrquvczroSUa31X/MtjjA2Owc9bahuEMs305MfR5ocMB3CtQC4Fxguyj/OOVS

# WtasFyIjTvTs0xf7UGv/B3cfcZdEQcm4RtNsMnxYL2dHZeUbc7aZ+WssBkbvQR7w

# 8F/g29mtkIBEr4AQQYoxggVEMIIFQAIBATCBhjByMQswCQYDVQQGEwJVUzEVMBMG

# A1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMTEw

# LwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29kZSBTaWduaW5nIENB

# AhALiNk6K2THnuSy4yCxZdfSMAkGBSsOAwIaBQCgcDAQBgorBgEEAYI3AgEMMQIw

# ADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYK

# KwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQUW7ema9dBrYJJWvMQGC2xMNn36IEw

# DQYJKoZIhvcNAQEBBQAEggEAiB5DsabrXaIY1jOZV0MvhVYsqrdVlniKqk9PLcBM

# crnmoi3HSS0W8TVtelZpfvdXdDedbx66OYpCW/7UnCm6itjJxmoYhUfQRaCu+YV3

# A+FDO+BzGPeulGLxbwAJsPqB8NUrkW5XCPFZFz5vQhS4bNfXmKFmpsm3fCbe23bm

# 8SQ/0gNGXPR35L29haGJF8xYFhf4qoZQOFKLHdTCxXDJgx87YLdPHrzzHFgl2Jtj

# hRPGXVAYo5C/4UV43TkqhuAGrkJuM++IUf7rvtVEut9u3POe7SIxCx9g7QmYOZ2H

# PNGPnvszNa5XVAcZyS4lL3385JeY7L2zzHkPcbFbmklcKKGCAyAwggMcBgkqhkiG

# 9w0BCQYxggMNMIIDCQIBATB3MGMxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdp

# Q2VydCwgSW5jLjE7MDkGA1UEAxMyRGlnaUNlcnQgVHJ1c3RlZCBHNCBSU0E0MDk2

# IFNIQTI1NiBUaW1lU3RhbXBpbmcgQ0ECEAVEr/OUnQg5pr/bP1/lYRYwDQYJYIZI

# AWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJ

# BTEPFw0yMzA5MDUxODEzMzNaMC8GCSqGSIb3DQEJBDEiBCBdKaxHDXf9VJI4/eez

# Mq3iBYrBZFeLxKVJHMD7Da7abDANBgkqhkiG9w0BAQEFAASCAgAh+1rUyv//60Om

# CVeGLjbNKWwvmtS22JsqcBZZ0yvtLRcXmLJFbibH6JUAqXb/KG99yDW8LO2UdiQm

# uBJLu60US8tJijN8GfmhTkk487PmA4n3WfJHScVgWXrEiFolkwSakxft9LNnVgHa

# rvLQQ93Q66kTc9Xk5KFqlnoVxcTHKPi0tia5hh+GSV+G/B1Ml0vEjxpVCLri1FZi

# FovbxkqqavtomPUyI/4WPJ6grWOR4yHGvxJ1VCNCP4/WX6QTBcHcNIBHDCGI9F0g

# vI18ibqzS42zhYN2rDoNcE29yj52mjzgBjc7R1wnhsT/fFyenNXEaVDahq0FvcxG

# 2TkvWDahnQ7RuyHmH92pkG35iZyPA4M8rsWWGw2PPsH/cvzxq8KVndXbMJNEB7vR

# U3wBDI+QrDdqlvJqA8d/j38Lm9nf+Bucyax0UD1+REY7Mudp56S1KuOfQzeu7TDl

# hK54kx28FLfvw0RbhEu4HtoKD0OhX98jjbaf9x/V6nVT0yjBWMR4lxdYSZzZIu+O

# u5keHUOLx/8SeMdfyxiZj+lqov0w5RH2umixthPUY6SLhHcW0ln++9SvpasBPWpm

# 3cRyFzQ9cHXLUg+xZnOpv5jaDzjJEfTjEf7+wxHHPXSNbjGbI96vc0cM8id3qwT5

# 2RSOJLnH4YEGYpsxodTPHrhFT8hjhQ==

# SIG # End signature block