HPEStoragePowerShellToolkit

3.1.0.0

CLI/Flashcache.psm1

                                ####################################################################################

##     © 2020,2021 Hewlett Packard Enterprise Development LP

##

##     Permission is hereby granted, free of charge, to any person obtaining a

##     copy of this software and associated documentation files (the "Software"),

##     to deal in the Software without restriction, including without limitation

##     the rights to use, copy, modify, merge, publish, distribute, sublicense,

##     and/or sell copies of the Software, and to permit persons to whom the

##     Software is furnished to do so, subject to the following conditions:

##

##     The above copyright notice and this permission notice shall be included

##     in all copies or substantial portions of the Software.

##

##     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

##     IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

##     FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL

##     THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR

##     OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,

##     ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

##     OTHER DEALINGS IN THE SOFTWARE.

##

##    File Name:        Flashcache.psm1

##    Description:     Flash cache cmdlets 

##        

##    Created:        November 2019

##    Last Modified:    November 2019

##    History:        v3.0 - Created    

#####################################################################################

$Info = "INFO:"

$Debug = "DEBUG:"

$global:VSLibraries = Split-Path $MyInvocation.MyCommand.Path

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

############################################################################################################################################

## FUNCTION Test-CLIObject

############################################################################################################################################

Function Test-CLIObject 

{

Param(     

    [string]$ObjectType, 

    [string]$ObjectName ,

    [string]$ObjectMsg = $ObjectType, 

    $SANConnection = $global:SANConnection

    )

    $IsObjectExisted = $True

    $ObjCmd = $ObjectType -replace ' ', '' 

    $Cmds = "show$ObjCmd $ObjectName"

    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmds

    if ($Result -like "no $ObjectMsg listed")

    {

        $IsObjectExisted = $false

    }

    return $IsObjectExisted

} # End FUNCTION Test-CLIObject

##########################################################################

######################### FUNCTION New-FlashCache ####################

##########################################################################

Function New-FlashCache()

{

<#

  .SYNOPSIS

   New-FlashCache - Creates flash cache for the cluster.

  .DESCRIPTION

   The New-FlashCache command creates flash cache of <size> for each node pair. The flash cache will be created from SSD drives.

  .EXAMPLE

  .PARAMETER Sim

   Specifies that the Adaptive Flash Cache will be run in simulator mode. The simulator mode does not require the use of SSD drives.

  .PARAMETER RAIDType

   Specifies the RAID type of the logical disks for Flash Cache; r0 for RAID-0 or r1 for RAID-1. If no RAID type is specified, the default is chosen by the storage system.

  .PARAMETER Size

    Specifies the size for the flash cache in MiB for each node pair. The flashcache size should be a multiple of 16384 (16GiB), and be an integer. 

    The minimum size of the flash cache is 64GiB. The maximum size of the flash cache is based on the node types, ranging from 768GiB up to 12288GiB (12TiB).

    An optional suffix (with no whitespace before the suffix) will modify the units to GiB (g or G suffix) or TiB (t or T suffix).

  .Notes

    NAME: New-FlashCache

    LASTEDIT 19/11/2019

    KEYWORDS: New-FlashCache

  .Link

    http://www.hpe.com

 #Requires PS -Version 3.0

#>

[CmdletBinding()]

 param(

     [Parameter(Position=0, Mandatory=$false , ValueFromPipeline=$true)]

     [switch]

     $Sim,

     [Parameter(Position=1, Mandatory=$false , ValueFromPipeline=$true)]

     [System.String]

     $RAIDType,

     [Parameter(Position=2, Mandatory=$true , ValueFromPipeline=$true)]

     [System.String]

     $Size,

     [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]

     $SANConnection = $global:SANConnection

 )

 Write-DebugLog "Start: In New-FlashCache - validating input values" $Debug 

 #check if connection object contents are null/empty

 if(!$SANConnection)

 {

    #check if connection object contents are null/empty

    $Validate1 = Test-CLIConnection $SANConnection

    if($Validate1 -eq "Failed")

    {

        #check if global connection object contents are null/empty

        $Validate2 = Test-CLIConnection $global:SANConnection

        if($Validate2 -eq "Failed")

        {

            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect.  Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "

            Write-DebugLog "Stop: Exiting New-FlashCache since SAN connection object values are null/empty" $Debug 

            Return "Unable to execute the cmdlet New-FlashCache since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."

        }

    }

 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection

 if($plinkresult -match "FAILURE :")

 {

   write-debuglog "$plinkresult"

   Return $plinkresult

 }

 $Cmd = " createflashcache "

 if($Sim)

 {

    $Cmd += " -sim "

 }

 if($RAIDType)

 {

    $Cmd += " -t $RAIDType "

 }

 if($Size)

 {

    $Cmd += " $Size "

 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd

 Write-DebugLog "Executing Function : New-FlashCache Command -->" INFO: 

 Return $Result

} ##  End-of New-FlashCache

##########################################################################

######################### FUNCTION Set-FlashCache ####################

##########################################################################

Function Set-FlashCache()

{

<#

  .SYNOPSIS

   Set-FlashCache - Sets the flash cache policy for virtual volumes

  .DESCRIPTION

   The Set-FlashCache command allows you to set the policy of the flash cache for virtual volumes. The policy is set by using virtual volume sets(vvset). 

   The sys:all is used to enable the policy on all virtual volumes in the system.

  .EXAMPLE

   Set-FlashCache

  .PARAMETER Enable

    Will turn on the flash cache policy for the target object.

  .PARAMETER Disable

    Will turn off flash cache policy for the target object.

  .PARAMETER Clear

    Will turn off policy and can only be issued against the sys:all target.

  .PARAMETER vvSet

    vvSet refers to the target object name as listed in the showvvset command. Pattern is glob-style (shell-style) patterns (see help on sub,globpat).

    Note(set Name Should de is the same formate Ex:  vvset:vvset1 )

  .PARAMETER All

    The policy is applied to all virtual volumes.

  .Notes

    NAME: Set-FlashCache

    LASTEDIT 19/11/2019

    KEYWORDS: 3parVersion

  .Link

    http://www.hpe.com

 #Requires PS -Version 3.0

#>

[CmdletBinding()]

 param(

     [Parameter(Position=0, Mandatory=$false, ValueFromPipeline=$true)]

     [switch]

     $Enable,

     [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]

     [switch]

     $Disable,

     [Parameter(Position=2, Mandatory=$false, ValueFromPipeline=$true)]

     [switch]

     $Clear,

     [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]

     [System.String]

     $vvSet,

     [Parameter(Position=4, Mandatory=$false, ValueFromPipeline=$true)]

     [switch]

     $All,

     [Parameter(Position=5, Mandatory=$false, ValueFromPipeline=$true)]

     $SANConnection = $global:SANConnection

 )

 Write-DebugLog "Start: In Set-FlashCache - validating input values" $Debug 

 #check if connection object contents are null/empty

 if(!$SANConnection)

 {

    #check if connection object contents are null/empty

    $Validate1 = Test-CLIConnection $SANConnection

    if($Validate1 -eq "Failed")

    {

        #check if global connection object contents are null/empty

        $Validate2 = Test-CLIConnection $global:SANConnection

        if($Validate2 -eq "Failed")

        {

            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect.  Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "

            Write-DebugLog "Stop: Exiting Set-FlashCache since SAN connection object values are null/empty" $Debug 

            Return "Unable to execute the cmdlet Set-FlashCache since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."

        }

    }

 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection

 if($plinkresult -match "FAILURE :")

 {

   write-debuglog "$plinkresult"

   Return $plinkresult

 }

 $Cmd = " setflashcache "

 if($Enable)

 {

    $Cmd += " enable "

 }

 elseif($Disable)

 {

    $Cmd += " disable "

 }

 elseif($Clear)

 {

    $Cmd += " clear "

 }

 else

 {

    return "Select at least one from [ Enable | Disable | Clear] "

 }

 if($vvSet)

 {

    $Cmd += " $vvSet "

 }

  if($All)

 {

    $Cmd += " sys:all "

 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd

 Write-DebugLog "Executing Function : Set-FlashCache Command -->" INFO: 

 Return $Result

} ##  End-of Set-FlashCache

##########################################################################

######################### FUNCTION Remove-FlashCache #####################

##########################################################################

Function Remove-FlashCache()

{

<#

  .SYNOPSIS

   Remove-FlashCache - Removes flash cache from the cluster.

  .DESCRIPTION

   The Remove-FlashCache command removes the flash cache from the cluster and will stop use of the extended cache.

  .EXAMPLE

   Remove-FlashCache

  .PARAMETER F

   Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.

  .Notes

    NAME: Remove-FlashCache

    LASTEDIT 19/11/2019

    KEYWORDS: Remove-FlashCache

  .Link

    http://www.hpe.com

 #Requires PS -Version 3.0

#>

[CmdletBinding()]

 param(

     [Parameter(Position=0, Mandatory=$false)]

     [switch]

     $F,

     [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]

     $SANConnection = $global:SANConnection

 )

 Write-DebugLog "Start: In Remove-FlashCache - validating input values" $Debug 

 #check if connection object contents are null/empty

 if(!$SANConnection)

 {

    #check if connection object contents are null/empty

    $Validate1 = Test-CLIConnection $SANConnection

    if($Validate1 -eq "Failed")

    {

        #check if global connection object contents are null/empty

        $Validate2 = Test-CLIConnection $global:SANConnection

        if($Validate2 -eq "Failed")

        {

            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect.  Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "

            Write-DebugLog "Stop: Exiting Remove-FlashCache since SAN connection object values are null/empty" $Debug 

            Return "Unable to execute the cmdlet Remove-FlashCache since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."

        }

    }

 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection

 if($plinkresult -match "FAILURE :")

 {

   write-debuglog "$plinkresult"

   Return $plinkresult

 }

 $Cmd = " removeflashcache "

 if($F)

 {

    $Cmd += " -f "

 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd

 Write-DebugLog "Executing Function : Remove-FlashCache Command -->" INFO: 

 Return $Result

} ##  End-of Remove-FlashCache

Export-ModuleMember New-FlashCache , Set-FlashCache , Remove-FlashCache

# SIG # Begin signature block

# MIIhEAYJKoZIhvcNAQcCoIIhATCCIP0CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCATEIu651/2aJoQ

# XEP8J+ErI9s0HFwpxsfsJKaF2BRLfaCCEKswggUpMIIEEaADAgECAhB4Lu4fcD9z

# xUgD+jf1OoqlMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAkdCMRswGQYDVQQI

# ExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGDAWBgNVBAoT

# D1NlY3RpZ28gTGltaXRlZDEkMCIGA1UEAxMbU2VjdGlnbyBSU0EgQ29kZSBTaWdu

# aW5nIENBMB4XDTIxMDUyODAwMDAwMFoXDTIyMDUyODIzNTk1OVowgZAxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMRIwEAYDVQQHDAlQYWxvIEFsdG8x

# KzApBgNVBAoMIkhld2xldHQgUGFja2FyZCBFbnRlcnByaXNlIENvbXBhbnkxKzAp

# BgNVBAMMIkhld2xldHQgUGFja2FyZCBFbnRlcnByaXNlIENvbXBhbnkwggEiMA0G

# CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDmclZSXJBXA55ijwwFymuq+Y4F/quF

# mm2vRdEmjFhzRvTpnGjIYtVcG11ka4JGCROmNVDZGAelnqcXn5DKO710j5SICTBC

# 5gXOLwga7usifs21W+lVT0BsZTiUnFu4hEhuFTlahJIEvPGVgO1GBcuItD2QqB4q

# 9j15GDI5nGBSzIyJKMctcIalxsTSPG1kiDbLkdfsIivhe9u9m8q6NRqDUaYYQTN+

# /qGCqVNannMapH8tNHqFb6VdzUFI04t7kFtSk00AkdD6qUvA4u8mL2bUXAYz8K5m

# nrFs+ckx5Yqdxfx68EO26Bt2qbz/oTHxE6FiVzsDl90bcUAah2l976ebAgMBAAGj

# ggGQMIIBjDAfBgNVHSMEGDAWgBQO4TqoUzox1Yq+wbutZxoDha00DjAdBgNVHQ4E

# FgQUlC56g+JaYFsl5QWK2WDVOsG+pCEwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB

# /wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwMwEQYJYIZIAYb4QgEBBAQDAgQQMEoG

# A1UdIARDMEEwNQYMKwYBBAGyMQECAQMCMCUwIwYIKwYBBQUHAgEWF2h0dHBzOi8v

# c2VjdGlnby5jb20vQ1BTMAgGBmeBDAEEATBDBgNVHR8EPDA6MDigNqA0hjJodHRw

# Oi8vY3JsLnNlY3RpZ28uY29tL1NlY3RpZ29SU0FDb2RlU2lnbmluZ0NBLmNybDBz

# BggrBgEFBQcBAQRnMGUwPgYIKwYBBQUHMAKGMmh0dHA6Ly9jcnQuc2VjdGlnby5j

# b20vU2VjdGlnb1JTQUNvZGVTaWduaW5nQ0EuY3J0MCMGCCsGAQUFBzABhhdodHRw

# Oi8vb2NzcC5zZWN0aWdvLmNvbTANBgkqhkiG9w0BAQsFAAOCAQEAY+1n2UUlQU6Z

# VoEVaZKqZf/zrM/d7Kbx+S/t8mR2E+uNXStAnwztElqrm3fSr+5LMRzBhrYiSmea

# w9c/0c7qFO9mt8RR2q2uj0Huf+oAMh7TMuMKZU/XbT6tS1e15B8ZhtqOAhmCug6s

# DuNvoxbMpokYevpa24pYn18ELGXOUKlqNUY2qOs61GVvhG2+V8Hl/pajE7yQ4diz

# iP7QjMySms6BtZV5qmjIFEWKY+UTktUcvN4NVA2J0TV9uunDbHRt4xdY8TF/Clgz

# Z/MQHJ/X5yX6kupgDeN2t3o+TrColetBnwk/SkJEsUit0JapAiFUx44j4w61Qanb

# Zmi0tr8YGDCCBYEwggRpoAMCAQICEDlyRDr5IrdR19NsEN0xNZUwDQYJKoZIhvcN

# AQEMBQAwezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3Rl

# cjEQMA4GA1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQx

# ITAfBgNVBAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczAeFw0xOTAzMTIwMDAw

# MDBaFw0yODEyMzEyMzU5NTlaMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKTmV3

# IEplcnNleTEUMBIGA1UEBxMLSmVyc2V5IENpdHkxHjAcBgNVBAoTFVRoZSBVU0VS

# VFJVU1QgTmV0d29yazEuMCwGA1UEAxMlVVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0

# aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIAS

# ZRc2DsPbCLPQrFcNdu3NJ9NMrVCDYeKqIE0JLWQJ3M6Jn8w9qez2z8Hc8dOx1ns3

# KBErR9o5xrw6GbRfpr19naNjQrZ28qk7K5H44m/Q7BYgkAk+4uh0yRi0kdRiZNt/

# owbxiBhqkCI8vP4T8IcUe/bkH47U5FHGEWdGCFHLhhRUP7wz/n5snP8WnRi9UY41

# pqdmyHJn2yFmsdSbeAPAUDrozPDcvJ5M/q8FljUfV1q3/875PbcstvZU3cjnEjpN

# rkyKt1yatLcgPcp/IjSufjtoZgFE5wFORlObM2D3lL5TN5BzQ/Myw1Pv26r+dE5p

# x2uMYJPexMcM3+EyrsyTO1F4lWeL7j1W/gzQaQ8bD/MlJmszbfduR/pzQ+V+DqVm

# sSl8MoRjVYnEDcGTVDAZE6zTfTen6106bDVc20HXEtqpSQvf2ICKCZNijrVmzyWI

# zYS4sT+kOQ/ZAp7rEkyVfPNrBaleFoPMuGfi6BOdzFuC00yz7Vv/3uVzrCM7LQC/

# NVV0CUnYSVgaf5I25lGSDvMmfRxNF7zJ7EMm0L9BX0CpRET0medXh55QH1dUqD79

# dGMvsVBlCeZYQi5DGky08CVHWfoEHpPUJkZKUIGy3r54t/xnFeHJV4QeD2PW6WK6

# 1l9VLupcxigIBCU5uA4rqfJMlxwHPw1S9e3vL4IPAgMBAAGjgfIwge8wHwYDVR0j

# BBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYDVR0OBBYEFFN5v1qqK0rPVIDh

# 2JvAnfKyA2bLMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MBEGA1Ud

# IAQKMAgwBgYEVR0gADBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsLmNvbW9k

# b2NhLmNvbS9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDA0BggrBgEFBQcBAQQo

# MCYwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmNvbW9kb2NhLmNvbTANBgkqhkiG

# 9w0BAQwFAAOCAQEAGIdR3HQhPZyK4Ce3M9AuzOzw5steEd4ib5t1jp5y/uTW/qof

# nJYt7wNKfq70jW9yPEM7wD/ruN9cqqnGrvL82O6je0P2hjZ8FODN9Pc//t64tIrw

# kZb+/UNkfv3M0gGhfX34GRnJQisTv1iLuqSiZgR2iJFODIkUzqJNyTKzuugUGrxx

# 8VvwQQuYAAoiAxDlDLH5zZI3Ge078eQ6tvlFEyZ1r7uq7z97dzvSxAKRPRkA0xdc

# Ods/exgNRc2ThZYvXd9ZFk8/Ub3VRRg/7UqO6AZhdCMWtQ1QcydER38QXYkqa4Ux

# FMToqWpMgLxqeM+4f452cpkMnf7XkQgWoaNflTCCBfUwggPdoAMCAQICEB2iSDBv

# myYY0ILgln0z02owDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpOZXcgSmVyc2V5MRQwEgYDVQQHEwtKZXJzZXkgQ2l0eTEeMBwGA1UEChMV

# VGhlIFVTRVJUUlVTVCBOZXR3b3JrMS4wLAYDVQQDEyVVU0VSVHJ1c3QgUlNBIENl

# cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTE4MTEwMjAwMDAwMFoXDTMwMTIzMTIz

# NTk1OVowfDELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3Rl

# cjEQMA4GA1UEBxMHU2FsZm9yZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQw

# IgYDVQQDExtTZWN0aWdvIFJTQSBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3

# DQEBAQUAA4IBDwAwggEKAoIBAQCGIo0yhXoYn0nwli9jCB4t3HyfFM/jJrYlZilA

# hlRGdDFixRDtsocnppnLlTDAVvWkdcapDlBipVGREGrgS2Ku/fD4GKyn/+4uMyD6

# DBmJqGx7rQDDYaHcaWVtH24nlteXUYam9CflfGqLlR5bYNV+1xaSnAAvaPeX7Wpy

# vjg7Y96Pv25MQV0SIAhZ6DnNj9LWzwa0VwW2TqE+V2sfmLzEYtYbC43HZhtKn52B

# xHJAteJf7wtF/6POF6YtVbC3sLxUap28jVZTxvC6eVBJLPcDuf4vZTXyIuosB69G

# 2flGHNyMfHEo8/6nxhTdVZFuihEN3wYklX0Pp6F8OtqGNWHTAgMBAAGjggFkMIIB

# YDAfBgNVHSMEGDAWgBRTeb9aqitKz1SA4dibwJ3ysgNmyzAdBgNVHQ4EFgQUDuE6

# qFM6MdWKvsG7rWcaA4WtNA4wDgYDVR0PAQH/BAQDAgGGMBIGA1UdEwEB/wQIMAYB

# Af8CAQAwHQYDVR0lBBYwFAYIKwYBBQUHAwMGCCsGAQUFBwMIMBEGA1UdIAQKMAgw

# BgYEVR0gADBQBgNVHR8ESTBHMEWgQ6BBhj9odHRwOi8vY3JsLnVzZXJ0cnVzdC5j

# b20vVVNFUlRydXN0UlNBQ2VydGlmaWNhdGlvbkF1dGhvcml0eS5jcmwwdgYIKwYB

# BQUHAQEEajBoMD8GCCsGAQUFBzAChjNodHRwOi8vY3J0LnVzZXJ0cnVzdC5jb20v

# VVNFUlRydXN0UlNBQWRkVHJ1c3RDQS5jcnQwJQYIKwYBBQUHMAGGGWh0dHA6Ly9v

# Y3NwLnVzZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggIBAE1jUO1HNEphpNve

# aiqMm/EAAB4dYns61zLC9rPgY7P7YQCImhttEAcET7646ol4IusPRuzzRl5ARokS

# 9At3WpwqQTr81vTr5/cVlTPDoYMot94v5JT3hTODLUpASL+awk9KsY8k9LOBN9O3

# ZLCmI2pZaFJCX/8E6+F0ZXkI9amT3mtxQJmWunjxucjiwwgWsatjWsgVgG10Xkp1

# fqW4w2y1z99KeYdcx0BNYzX2MNPPtQoOCwR/oEuuu6Ol0IQAkz5TXTSlADVpbL6f

# ICUQDRn7UJBhvjmPeo5N9p8OHv4HURJmgyYZSJXOSsnBf/M6BZv5b9+If8AjntIe

# Q3pFMcGcTanwWbJZGehqjSkEAnd8S0vNcL46slVaeD68u28DECV3FTSK+TbMQ5Lk

# uk/xYpMoJVcp+1EZx6ElQGqEV8aynbG8HArafGd+fS7pKEwYfsR7MUFxmksp7As9

# V1DSyt39ngVR5UR43QHesXWYDVQk/fBO4+L4g71yuss9Ou7wXheSaG3IYfmm8SoK

# C6W59J7umDIFhZ7r+YMp08Ysfb06dy6LN0KgaoLtO0qqlBCk4Q34F8W2WnkzGJLj

# tXX4oemOCiUe5B7xn1qHI/+fpFGe+zmAEc3btcSnqIBv5VPU4OOiwtJbGvoyJi1q

# V3AcPKRYLqPzW0sH3DJZ84enGm1YMYIPuzCCD7cCAQEwgZAwfDELMAkGA1UEBhMC

# R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9y

# ZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQwIgYDVQQDExtTZWN0aWdvIFJT

# QSBDb2RlIFNpZ25pbmcgQ0ECEHgu7h9wP3PFSAP6N/U6iqUwDQYJYIZIAWUDBAIB

# BQCgfDAQBgorBgEEAYI3AgEMMQIwADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg

# J0QsGQ3WIfzvexG2xNMTXSJHDsuNTv173NM6YxXQMZ4wDQYJKoZIhvcNAQEBBQAE

# ggEA5HOxF3e78qUrbx3cdwoXIJ+gINEf4sofl5DPvOEjo6WR+N+IsomjsEVPgGgx

# aCBMLtKdgUD8+8jnLazdKB6MsXRVHoOFLM6aS+eohNAWgIr4+Mro/Y4bIzZMCnel

# bd7Nl/HfI9GpmM+Z3Sf5GtNf6jGYw+1ddS77W1VaerFBX8o5+J7/7Z4JUYRPrkzo

# EDUbEQet4nmJLEWTl6zsCqU6JLt5kYrXaEq9PuTonx9q1Xpb0HwFR6IFJ63/UTq+

# eYqN28fD74ZoYHktagTOeyAFz4OUKVAJphW650yVwe8lKDDkmxm5MuqzgOeazETu

# 95AL4kUe7Y4s/XYgH8YHAkd2JqGCDX0wgg15BgorBgEEAYI3AwMBMYINaTCCDWUG

# CSqGSIb3DQEHAqCCDVYwgg1SAgEDMQ8wDQYJYIZIAWUDBAIBBQAwdwYLKoZIhvcN

# AQkQAQSgaARmMGQCAQEGCWCGSAGG/WwHATAxMA0GCWCGSAFlAwQCAQUABCCt6bTl

# xlAoQrao7LSERbegOJdbVKhhpAy9BXZLCl0X0QIQWIU0bx9QW7dZicN1TzYfaBgP

# MjAyMTA2MTkwNDA4NDlaoIIKNzCCBP4wggPmoAMCAQICEA1CSuC+Ooj/YEAhzhQA

# 8N0wDQYJKoZIhvcNAQELBQAwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lD

# ZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGln

# aUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQTAeFw0yMTAxMDEw

# MDAwMDBaFw0zMTAxMDYwMDAwMDBaMEgxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5E

# aWdpQ2VydCwgSW5jLjEgMB4GA1UEAxMXRGlnaUNlcnQgVGltZXN0YW1wIDIwMjEw

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDC5mGEZ8WK9Q0IpEXKY2tR

# 1zoRQr0KdXVNlLQMULUmEP4dyG+RawyW5xpcSO9E5b+bYc0VkWJauP9nC5xj/TZq

# gfop+N0rcIXeAhjzeG28ffnHbQk9vmp2h+mKvfiEXR52yeTGdnY6U9HR01o2j8aj

# 4S8bOrdh1nPsTm0zinxdRS1LsVDmQTo3VobckyON91Al6GTm3dOPL1e1hyDrDo4s

# 1SPa9E14RuMDgzEpSlwMMYpKjIjF9zBa+RSvFV9sQ0kJ/SYjU/aNY+gaq1uxHTDC

# m2mCtNv8VlS8H6GHq756WwogL0sJyZWnjbL61mOLTqVyHO6fegFz+BnW/g1JhL0B

# AgMBAAGjggG4MIIBtDAOBgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAWBgNV

# HSUBAf8EDDAKBggrBgEFBQcDCDBBBgNVHSAEOjA4MDYGCWCGSAGG/WwHATApMCcG

# CCsGAQUFBwIBFhtodHRwOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwHwYDVR0jBBgw

# FoAU9LbhIB3+Ka7S5GGlsqIlssgXNW4wHQYDVR0OBBYEFDZEho6kurBmvrwoLR1E

# Nt3janq8MHEGA1UdHwRqMGgwMqAwoC6GLGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNv

# bS9zaGEyLWFzc3VyZWQtdHMuY3JsMDKgMKAuhixodHRwOi8vY3JsNC5kaWdpY2Vy

# dC5jb20vc2hhMi1hc3N1cmVkLXRzLmNybDCBhQYIKwYBBQUHAQEEeTB3MCQGCCsG

# AQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wTwYIKwYBBQUHMAKGQ2h0

# dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURU

# aW1lc3RhbXBpbmdDQS5jcnQwDQYJKoZIhvcNAQELBQADggEBAEgc3LXpmiO85xrn

# IA6OZ0b9QnJRdAojR6OrktIlxHBZvhSg5SeBpU0UFRkHefDRBMOG2Tu9/kQCZk3t

# aaQP9rhwz2Lo9VFKeHk2eie38+dSn5On7UOee+e03UEiifuHokYDTvz0/rdkd2Nf

# I1Jpg4L6GlPtkMyNoRdzDfTzZTlwS/Oc1np72gy8PTLQG8v1Yfx1CAB2vIEO+MDh

# XM/EEXLnG2RJ2CKadRVC9S0yOIHa9GCiurRS+1zgYSQlT7LfySmoc0NR2r1j1h9b

# m/cuG08THfdKDXF+l7f0P4TrweOjSaH6zqe/Vs+6WXZhiV9+p7SOZ3j5Npjhyyja

# W4emii8wggUxMIIEGaADAgECAhAKoSXW1jIbfkHkBdo2l8IVMA0GCSqGSIb3DQEB

# CwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNV

# BAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQg

# SUQgUm9vdCBDQTAeFw0xNjAxMDcxMjAwMDBaFw0zMTAxMDcxMjAwMDBaMHIxCzAJ

# BgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k

# aWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBU

# aW1lc3RhbXBpbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9

# 0DLuS82Pf92puoKZxTlUKFe2I0rEDgdFM1EQfdD5fU1ofue2oPSNs4jkl79jIZCY

# vxO8V9PD4X4I1moUADj3Lh477sym9jJZ/l9lP+Cb6+NGRwYaVX4LJ37AovWg4N4i

# Pw7/fpX786O6Ij4YrBHk8JkDbTuFfAnT7l3ImgtU46gJcWvgzyIQD3XPcXJOCq3f

# QDpct1HhoXkUxk0kIzBdvOw8YGqsLwfM/fDqR9mIUF79Zm5WYScpiYRR5oLnRlD9

# lCosp+R1PrqYD4R/nzEU1q3V8mTLex4F0IQZchfxFwbvPc3WTe8GQv2iUypPhR3E

# HTyvz9qsEPXdrKzpVv+TAgMBAAGjggHOMIIByjAdBgNVHQ4EFgQU9LbhIB3+Ka7S

# 5GGlsqIlssgXNW4wHwYDVR0jBBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8wEgYD

# VR0TAQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYB

# BQUHAwgweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5k

# aWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0

# LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4

# oDaGNGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJv

# b3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2Vy

# dEFzc3VyZWRJRFJvb3RDQS5jcmwwUAYDVR0gBEkwRzA4BgpghkgBhv1sAAIEMCow

# KAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCwYJYIZI

# AYb9bAcBMA0GCSqGSIb3DQEBCwUAA4IBAQBxlRLpUYdWac3v3dp8qmN6s3jPBjdA

# hO9LhL/KzwMC/cWnww4gQiyvd/MrHwwhWiq3BTQdaq6Z+CeiZr8JqmDfdqQ6kw/4

# stHYfBli6F6CJR7Euhx7LCHi1lssFDVDBGiy23UC4HLHmNY8ZOUfSBAYX4k4YU1i

# RiSHY4yRUiyvKYnleB/WCxSlgNcSR3CzddWThZN+tpJn+1Nhiaj1a5bA9FhpDXzI

# AbG5KHW3mWOFIoxhynmUfln8jA/jb7UBJrZspe6HUSHkWGCbugwtK22ixH67xCUr

# RwIIfEmuE7bhfEJCKMYYVs9BNLZmXbZ0e/VWMyIvIjayS6JKldj1po5SMYIChjCC

# AoICAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZ

# MBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNlcnQgU0hB

# MiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQQIQDUJK4L46iP9gQCHOFADw3TAN

# BglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwHAYJ

# KoZIhvcNAQkFMQ8XDTIxMDYxOTA0MDg0OVowKwYLKoZIhvcNAQkQAgwxHDAaMBgw

# FgQU4deCqOGRvu9ryhaRtaq0lKYkm/MwLwYJKoZIhvcNAQkEMSIEID8sndnDe28i

# 1TIqwW6cS0xvaGb0ALiAHF4NRCuw34zxMDcGCyqGSIb3DQEJEAIvMSgwJjAkMCIE

# ILMQkAa8CtmDB5FXKeBEA0Fcg+MpK2FPJpZMjTVx7PWpMA0GCSqGSIb3DQEBAQUA

# BIIBALPStTJbGOsAOByN//3oQ5eXndmmLe7pry5lAelpH3rT0O/xbT1FHSRBcY90

# pTpQFBlg3xikBUyzZhM7twb+VElWbYmXSzwKNyuuc/6xIMblvIUpvMIg2QEHdsd9

# NGhFwOPUIoks5ziNSKmf9PMS/35ZyPvbf7rtvWolUTHAsDjZPw9npzTZhhfYsuGY

# pB4N4WDgwK4LrAOXxg2yL3MhWhr6rf7/g2Hr59XMDVfYyFg0FVgFGU3SNU7qVd7v

# erpc0qQVq+2NQIOd6PZH3sMGHWnXjL12UlJkKi02AH5ufCKgdGPHv11Fvj0OVSBw

# UVRqhTo/rHpJ6bL+C6x1WB73j/s=

# SIG # End signature block