HPOneView.420

4.20.2290.1501

Samples/ComposerApplianceConfig_Sample.ps1

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

# ComposerApplianceConfig_Sample.ps1

# - Example scripts for configuring an HPE OneView appliance (networking, NTP, 

#   etc.).

#

#   VERSION 3.0

#

# (C) Copyright 2013-2020 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 COPYWRIGHT 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.

#>

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

[CmdletBinding()]

param

(

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances DHCP Address.")]

    [Alias('vm_ipaddr')]

    [ValidateNotNullorEmpty()]

    [IPAddress]$DhcpAddress,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW Hostname or FQDN.")]

    [String]$Hostname,

    [Parameter (Mandatory, HelpMessage = "Provide a [SecureString] pr [String] object representing the new appliance Administrator password.")]

    [ValidateNotNullorEmpty()]

    [Object]$NewPassword,

    [Parameter (Mandatory, HelpMessage = "Provide the Composer Primary Virtual IP.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$IPv4Address,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW IPv4 Subnet.")]

    [ValidateNotNullorEmpty()]

    [String]$IPv4SubnetMask,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW IPv4 Default Gateway.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$IPv4Gateway,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW IPv4 DNS Servers.")]

    [ValidateNotNullorEmpty()]

    [Array]$IPv4DnsServers,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW DNS Domain Name.")]

    [ValidateNotNullorEmpty()]

    [String]$DnsDomainName,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW DNS Domain Name.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$ServiceIPv4Node1,

    [Parameter (Mandatory, HelpMessage = "Provide the Appliances NEW DNS Domain Name.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$ServiceIPv4Node2,

    [Parameter (Mandatory = $false, HelpMessage = "Provide the Appliances NEW IPv4 NTP Servers.")]

    [ValidateNotNullorEmpty()]

    [Array]$IPv4NtpServers,

    [Parameter (Mandatory = $False, HelpMessage = "Provide the Appliances NEW IPv6 Static Address.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$IPv6Address,

    [Parameter (Mandatory = $False, HelpMessage = "Provide the Appliances NEW IPv6 Static Address.")]

    [ValidateNotNullorEmpty()]

    [Int]$IPv6CidrMask,

    [Parameter (Mandatory = $False, HelpMessage = "Provide the Service IP for Node 1 NEW IPv6 Static Address.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$ServiceIPv6Node1,

    [Parameter (Mandatory = $False, HelpMessage = "Provide the Service IP for Node 2 NEW IPv6 Static Address.")]

    [ValidateNotNullorEmpty()]

    [IPAddress]$ServiceIPv6Node2

)

if (-not (Get-Module HPOneView.410)) 

{

    Import-Module POSH-HPOneView.410

}

#region 

    Write-Host 'Waiting for appliance to respond to network test.' -NoNewline

    While (-not (Test-Connection -ComputerName $DhcpAddress.IPAddressToString -Quiet))

    {

        Write-Host '.' -NoNewline

    }

    Write-Host ""

    #Core Appliance Setup

    # Accept the EULA

    if (-not (Get-HPOVEulaStatus -Appliance $DhcpAddress.IPAddressToString).Accepted ) 

    {

        Write-Host "Accepting EULA..."

        Try

        {

            $ret = Set-HPOVEulaStatus -SupportAccess "yes" -Appliance $DhcpAddress.IPAddressToString

        }

        Catch

        {

            $PSCMdlet.ThrowTerminatingError($_)

        }

    }

    # For initial setup, connect first using "default" Administrator credentials:

    Try 

    { 

        Connect-HPOVMgmt -appliance $DhcpAddress.IPAddressToString -user "Administrator" -password "admin"

    }

    catch [HPOneView.Appliance.PasswordChangeRequired] 

    {

        Write-Host "Set initial password"

        Try

        {

            Set-HPOVInitialPassword -OldPassword "admin" -NewPassword $NewPassword -Appliance $DhcpAddress.IPAddressToString

        }

        Catch

        {

            $PSCMdlet.ThrowTerminatingError($_)

        }

    }

    catch [HPOneView.Appliance.AuthSessionException] 

    {

        Write-Host "Default password was already changed."

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    Write-Host "Reconnect with new password"

    Try

    {

        $ApplianceConnection = Connect-HPOVMgmt -appliance $DhcpAddress.IPAddressToString -user Administrator -password $NewPassword

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    Write-Host "Set appliance networking configuration"

    $params = @{

        Hostname         = $Hostname;

        IPv4Addr         = $IPv4Address.IPAddressToString;

        IPv4Subnet       = $IPv4SubnetMask;

        IPv4Gateway      = $IPv4Gateway.IPAddressToString;

        DomainName       = $DnsDomainName;

        IPv4NameServers  = $IPv4DnsServers;

        ServiceIPv4Node1 = $ServiceIPv4Node1;

        ServiceIPv4Node2 = $ServiceIPv4Node2

    }

    if ($IPv6Address)

    {

        $params.Add('IPv6Type','STATIC')

        $params.Add('IPv6Addr', $IPv6Address)

        $params.Add('IPv6Subnet', $IPv6CidrMask)

        $params.Add('ServiceIPv6Node1', $ServiceIPv6Node1)

        $params.Add('ServiceIPv6Node2', $ServiceIPv6Node2)

    }

    Try

    {

        $task = Set-HPOVApplianceNetworkConfig @params

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    if (-not($Global:ConnectedSessions | ? Name -EQ $Hostname)) 

    { 

        Try

        {

            $ApplianceConnection = Connect-HPOVMgmt -appliance $Hostname -user Administrator -password $NewPassword

        }    

        Catch

        {

            $PSCMdlet.ThrowTerminatingError($_)

        }

    }

    try

    {

        Write-Host 'Setting Appliance NTP Servers'

        $Results = Set-HPOVApplianceDateTime -NtpServers $IPv4NtpServers

    }

    catch

    {

        $PSCmdlet.ThrowTerminatingError($_)

    }

    #Configuring appliance LDAP/AD Security

    $dc1 = New-HPOVLdapServer -Name dc1.domain.local

    $dc2 = New-HPOVLdapServer -Name dc2.domain.local

    $AuthParams = @{

        UserName = "ftoomey@domain.local"

        Password = convertto-securestring -asplaintext "HPinv3nt" -force

    }

    Try

    {

        $LdapAuthDirectory = New-HPOVLdapDirectory -Name 'domain.local' -AD -BaseDN 'dc=domain,dc=local' -servers $dc1,$dc2 @AuthParams

        $LdapGroups = $LdapAuthDirectory | Show-HPOVLdapGroups @AuthParams

        $InfrastructureAdminGroup = $LdapGroups | ? Name -match 'CI Manager Full'

        $ServerAdminGroup  = $LdapGroups | ? Name -match 'CI Manager Server'

        $StorageAdminGroup = $LdapGroups | ? Name -match 'CI Manager Storage'

        $NetworkAdminGroup = $LdapGroups | ? Name -match 'CI Manager Network'

        New-HPOVLdapGroup -d $LdapAuthDirectory -GroupName $InfrastructureAdminGroup -Roles "Infrastructure administrator" @AuthParams

        New-HPOVLdapGroup -d $LdapAuthDirectory -GroupName $NetworkAdminGroup -Roles "Network administrator"  @AuthParams

        New-HPOVLdapGroup -d $LdapAuthDirectory -GroupName $ServerAdminGroup  -Roles "Server administrator"  @AuthParams

        New-HPOVLdapGroup -d $LdapAuthDirectory -GroupName $StorageAdminGroup -Roles "Storage administrator"  @AuthParams

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    Try

    {

        #Upload custom SPP Baseline

        gci \\Server\software\SPP\bp-2016-07-11-00.iso | Add-HPOVBaseline

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    # Create the new users

    New-HPOVUser Nat   -fullName "Nat Network Admin"  -password hpinvent -roles "Network administrator"

    New-HPOVUser Sarah -fullName "Sarah Server Admin" -password hpinvent -roles "Server administrator"

    New-HPOVUser Sandy -fullName "Sandy SAN Admin"    -password hpinvent -roles "Storage administrator"

    New-HPOVUser Rheid -fullName "Rheid Read-Only"      -password hpinvent -roles "Read only"

    New-HPOVUser Bob   -fullName "Bob Backup"          -password hpinvent -roles "Backup administrator"

    New-HPOVUser admin -fullName "admin"              -password hpinvent -roles "Infrastructure administrator"

#endregion 

#region 

    #Resource Configuration    

    $params = @{

        hostname  = "172.18.15.1";

        type      = "BNA";

        username  = "administrator";

        password  = "pasword";

        UseSsl    = $True

    }

    write-host "Importing BNA SAN Manager"

    Try

    {

        Add-HPOVSanManager @params | Wait-HPOVTaskComplete

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    Write-Host "Creating network resources"

    # Management networks

    Try

    {

        New-HPOVNetwork -Name "MLAG VLAN 10" -type "Ethernet" -vlanId 10 -smartlink $true -purpose Management

        # Internal Networks

        New-HPOVNetwork -Name "Internal Live Migration" -type "Ethernet" -vlanId 100 -smartlink $true -purpose VMMigration

        New-HPOVNetwork -Name "Internal Heartbeat" -type "Ethernet" -vlanId 101 -smartlink $true -purpose Management

        New-HPOVNetwork -Name "iSCSI Network" -type "Ethernet" -vlanId 3000 -smartlink $true -purpose ISCSI

        # VM Networks

        20,30,40,50 | % { New-HPOVNetwork -Name "MLAG Prod VLAN $_" -type "Ethernet" -vlanId $_ -smartlink $true -purpose General }

        101,102,103,104,105 | % { New-HPOVNetwork -Name "MLAG Dev VLAN $_" -type "Ethernet" -vlanId $_ -smartlink $true -purpose General }

        $AllMlagDevNetworks = Get-HPOVNetwork -Name "MLAG Dev VLAN"

        $AllMlagNetworks    = Get-HPOVNetwork -Name "MLAG VLAN*"

        $InternalNetworks   = Get-HPOVNetwork -Name Internal*

        # Create the network sets

        New-HPOVNetworkSet -Name "Prod NetSet" -networks $AllMlagNetworks -untaggedNetwork $AllMlagNetworks[0] -typicalBandwidth 2500 -maximumBandwidth 10000 

        New-HPOVNetworkSet -Name "Dev Networks A" -networks $AllMlagDevNetworks -untaggedNetwork $AllMlagDevNetworks[0]  -typicalBandwidth 2500 -maximumBandwidth 10000 

        # Create the FC networks:

        New-HPOVNetwork -Name "Fabric A" -type "FibreChannel" -typicalBandwidth 4000 -autoLoginRedistribution $true #-managedSan "SAN1_0"

        New-HPOVNetwork -Name "Fabric B" -type "FibreChannel" -typicalBandwidth 4000 -autoLoginRedistribution $true #-managedSan "SAN1_1"

        New-HPOVNetwork -Name "DirectAttach A" -type "FibreChannel" -typicalBandwidth 4000 -autoLoginRedistribution $true -fabricType DirectAttach

        New-HPOVNetwork -Name "DirectAttach B" -type "FibreChannel" -typicalBandwidth 4000 -autoLoginRedistribution $true -fabricType DirectAttach

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    $params = @{

        username  = "3paradm";

        password  = "3pardata";

        hostname  = "172.18.11.11";

        domain    = "NO DOMAIN"

    }

    Write-Host "Importing storage array: $($params.hostname)"

    Try

    {

        $Results = Add-HPOVStorageSystem @params | Wait-HPOVTaskComplete

        $Results = Get-HPOVStorageSystem | Add-HPOVStoragePool -Pool 'FST_CPG1','FST_CPG2' | Wait-HPOVTaskComplete

    }

    Catch

    {

        $PSCMdlet.ThrowTerminatingError($_)

    }

    $SynergyLigParams = @{

        Name               = 'Default Synergy LIG';

        InterconnectBaySet = 3;

        FabricModuleType   = 'SEVC40F8';

        FrameCount         = 3;

        InternalNetworks   = $InternalNetworks;

        FabricRedundancy   = 'HighlyAvailable'

        Bays               = @{

                                Frame1 = @{Bay3 = 'SEVC40f8'; Bay6 = 'SE20ILM' }; 

                                Frame2 = @{Bay3 = 'SE20ILM'; Bay6 = 'SEVC40f8'};

                                Frame3 = @{Bay3 = 'SE20ILM'; Bay6 = 'SE20ILM'}

                                }

    }

    $CreatedLogicalInterconnectObject = New-HPOVLogicalInterconnectGroup @SynergyLigParams | Get-HPOVLogicalInterconnectGroup

    $UplinkSetParams = @{

        InputObject = $CreatedLogicalInterconnectObject;

        Name        = 'MLag UplinkSet';

        Type        = 'Ethernet';

        Networks    = $AllMlagNetworks;

        UplinkPorts = "Enclosure1:Bay3:Q1","Enclosure1:Bay3:Q2","Enclosure2:Bay6:Q1","Enclosure2:Bay6:Q2"

    }

    $CreateUplinkSetResults = New-HPOVUplinkSet @UplinkSetParams

    $LIG = Get-HPOVLogicalInterconnectGroup -Name 'Default Synergy LIG'

    $EgParams = @{

        Name                            = 'Synergy Default EG';

        EnclosureCount                  = 3;

        LogicalInterconnectGroupMapping = $LIG;

        IPv4AddressType                 = 'DHCP'

    }

    $CreateEGResults = New-HPOVEnclosureGroup @EgParams

    Disconnect-HPOVMgmt

    Remove-Module HPOneView.410

#endregion

# SIG # Begin signature block

# MIIfIAYJKoZIhvcNAQcCoIIfETCCHw0CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBVgURiDI2XlSrm

# hSGk1ayIJ/smu3SOP1ay0OdGluGQ9qCCGZUwggQUMIIC/KADAgECAgsEAAAAAAEv

# TuFS1zANBgkqhkiG9w0BAQUFADBXMQswCQYDVQQGEwJCRTEZMBcGA1UEChMQR2xv

# YmFsU2lnbiBudi1zYTEQMA4GA1UECxMHUm9vdCBDQTEbMBkGA1UEAxMSR2xvYmFs

# U2lnbiBSb290IENBMB4XDTExMDQxMzEwMDAwMFoXDTI4MDEyODEyMDAwMFowUjEL

# MAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExKDAmBgNVBAMT

# H0dsb2JhbFNpZ24gVGltZXN0YW1waW5nIENBIC0gRzIwggEiMA0GCSqGSIb3DQEB

# AQUAA4IBDwAwggEKAoIBAQCU72X4tVefoFMNNAbrCR+3Rxhqy/Bb5P8npTTR94ka

# v56xzRJBbmbUgaCFi2RaRi+ZoI13seK8XN0i12pn0LvoynTei08NsFLlkFvrRw7x

# 55+cC5BlPheWMEVybTmhFzbKuaCMG08IGfaBMa1hFqRi5rRAnsP8+5X2+7UulYGY

# 4O/F69gCWXh396rjUmtQkSnF/PfNk2XSYGEi8gb7Mt0WUfoO/Yow8BcJp7vzBK6r

# kOds33qp9O/EYidfb5ltOHSqEYva38cUTOmFsuzCfUomj+dWuqbgz5JTgHT0A+xo

# smC8hCAAgxuh7rR0BcEpjmLQR7H68FPMGPkuO/lwfrQlAgMBAAGjgeUwgeIwDgYD

# VR0PAQH/BAQDAgEGMBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFEbYPv/c

# 477/g+b0hZuw3WrWFKnBMEcGA1UdIARAMD4wPAYEVR0gADA0MDIGCCsGAQUFBwIB

# FiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNvbS9yZXBvc2l0b3J5LzAzBgNVHR8E

# LDAqMCigJqAkhiJodHRwOi8vY3JsLmdsb2JhbHNpZ24ubmV0L3Jvb3QuY3JsMB8G

# A1UdIwQYMBaAFGB7ZhpFDZfKiVAvfQTNNKj//P1LMA0GCSqGSIb3DQEBBQUAA4IB

# AQBOXlaQHka02Ukx87sXOSgbwhbd/UHcCQUEm2+yoprWmS5AmQBVteo/pSB204Y0

# 1BfMVTrHgu7vqLq82AafFVDfzRZ7UjoC1xka/a/weFzgS8UY3zokHtqsuKlYBAIH

# MNuwEl7+Mb7wBEj08HD4Ol5Wg889+w289MXtl5251NulJ4TjOJuLpzWGRCCkO22k

# aguhg/0o69rvKPbMiF37CjsAq+Ah6+IvNWwPjjRFl+ui95kzNX7Lmoq7RU3nP5/C

# 2Yr6ZbJux35l/+iS4SwxovewJzZIjyZvO+5Ndh95w+V/ljW8LQ7MAbCOf/9RgICn

# ktSzREZkjIdPFmMHMUtjsN/zMIIEnzCCA4egAwIBAgISESHWmadklz7x+EJ+6RnM

# U0EUMA0GCSqGSIb3DQEBBQUAMFIxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i

# YWxTaWduIG52LXNhMSgwJgYDVQQDEx9HbG9iYWxTaWduIFRpbWVzdGFtcGluZyBD

# QSAtIEcyMB4XDTE2MDUyNDAwMDAwMFoXDTI3MDYyNDAwMDAwMFowYDELMAkGA1UE

# BhMCU0cxHzAdBgNVBAoTFkdNTyBHbG9iYWxTaWduIFB0ZSBMdGQxMDAuBgNVBAMT

# J0dsb2JhbFNpZ24gVFNBIGZvciBNUyBBdXRoZW50aWNvZGUgLSBHMjCCASIwDQYJ

# KoZIhvcNAQEBBQADggEPADCCAQoCggEBALAXrqLTtgQwVh5YD7HtVaTWVMvY9nM6

# 7F1eqyX9NqX6hMNhQMVGtVlSO0KiLl8TYhCpW+Zz1pIlsX0j4wazhzoOQ/DXAIlT

# ohExUihuXUByPPIJd6dJkpfUbJCgdqf9uNyznfIHYCxPWJgAa9MVVOD63f+ALF8Y

# ppj/1KvsoUVZsi5vYl3g2Rmsi1ecqCYr2RelENJHCBpwLDOLf2iAKrWhXWvdjQIC

# KQOqfDe7uylOPVOTs6b6j9JYkxVMuS2rgKOjJfuv9whksHpED1wQ119hN6pOa9PS

# UyWdgnP6LPlysKkZOSpQ+qnQPDrK6Fvv9V9R9PkK2Zc13mqF5iMEQq8CAwEAAaOC

# AV8wggFbMA4GA1UdDwEB/wQEAwIHgDBMBgNVHSAERTBDMEEGCSsGAQQBoDIBHjA0

# MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNvbS9yZXBvc2l0

# b3J5LzAJBgNVHRMEAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMEIGA1UdHwQ7

# MDkwN6A1oDOGMWh0dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20vZ3MvZ3N0aW1lc3Rh

# bXBpbmdnMi5jcmwwVAYIKwYBBQUHAQEESDBGMEQGCCsGAQUFBzAChjhodHRwOi8v

# c2VjdXJlLmdsb2JhbHNpZ24uY29tL2NhY2VydC9nc3RpbWVzdGFtcGluZ2cyLmNy

# dDAdBgNVHQ4EFgQU1KKESjhaGH+6TzBQvZ3VeofWCfcwHwYDVR0jBBgwFoAURtg+

# /9zjvv+D5vSFm7DdatYUqcEwDQYJKoZIhvcNAQEFBQADggEBAI+pGpFtBKY3IA6D

# lt4j02tuH27dZD1oISK1+Ec2aY7hpUXHJKIitykJzFRarsa8zWOOsz1QSOW0zK7N

# ko2eKIsTShGqvaPv07I2/LShcr9tl2N5jES8cC9+87zdglOrGvbr+hyXvLY3nKQc

# MLyrvC1HNt+SIAPoccZY9nUFmjTwC1lagkQ0qoDkL4T2R12WybbKyp23prrkUNPU

# N7i6IA7Q05IqW8RZu6Ft2zzORJ3BOCqt4429zQl3GhC+ZwoCNmSIubMbJu7nnmDE

# Rqi8YTNsz065nLlq8J83/rU9T5rTTf/eII5Ol6b9nwm8TcoYdsmwTYVQ8oDSHQb1

# WAQHsRgwggViMIIESqADAgECAhEAs27OX4AfAEtqySFw10d4pTANBgkqhkiG9w0B

# AQsFADB8MQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVy

# MRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxJDAi

# BgNVBAMTG1NlY3RpZ28gUlNBIENvZGUgU2lnbmluZyBDQTAeFw0xOTA2MTgwMDAw

# MDBaFw0yMDA2MTcyMzU5NTlaMIHSMQswCQYDVQQGEwJVUzEOMAwGA1UEEQwFOTQz

# MDQxCzAJBgNVBAgMAkNBMRIwEAYDVQQHDAlQYWxvIEFsdG8xHDAaBgNVBAkMEzMw

# MDAgSGFub3ZlciBTdHJlZXQxKzApBgNVBAoMIkhld2xldHQgUGFja2FyZCBFbnRl

# cnByaXNlIENvbXBhbnkxGjAYBgNVBAsMEUhQIEN5YmVyIFNlY3VyaXR5MSswKQYD

# VQQDDCJIZXdsZXR0IFBhY2thcmQgRW50ZXJwcmlzZSBDb21wYW55MIIBIjANBgkq

# hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApRUrB4sxRxmcELIDQloMK5Trsf6NaV53

# CZlnWquI9hoSn1D14KyzII0V3/GGSrzefd4UO2NMhi6XuK00Lp/cxiJEk5Y5gCUr

# OWj7rNrH/4ibHUitPle1gEStxkyAduxLSRU5O66hdsOcE6N5YxN1OTIjd7IfPsB/

# TYgfzoJWi2TgpnQbnpAZ6rX+J7E16t0nyhw7o29Vs+DBF3UnRo5yO9wlF+gnkEQG

# C33TRc7k1I1aGut+nrYJcSKbKb7xMdWzpnMEal3mCKhwEyPOwiuF6GRj8QUvixzv

# 1kK1MPfJv4SndHzNtmPNT+2lN6sei9/b+fDdhwp57blr1uPzMvJMEwIDAQABo4IB

# hjCCAYIwHwYDVR0jBBgwFoAUDuE6qFM6MdWKvsG7rWcaA4WtNA4wHQYDVR0OBBYE

# FEWEX+dAgNu/+qq8wUXDWBCEEg2wMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8E

# AjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMBEGCWCGSAGG+EIBAQQEAwIEEDBABgNV

# HSAEOTA3MDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3Nl

# Y3RpZ28uY29tL0NQUzBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsLnNlY3Rp

# Z28uY29tL1NlY3RpZ29SU0FDb2RlU2lnbmluZ0NBLmNybDBzBggrBgEFBQcBAQRn

# MGUwPgYIKwYBBQUHMAKGMmh0dHA6Ly9jcnQuc2VjdGlnby5jb20vU2VjdGlnb1JT

# QUNvZGVTaWduaW5nQ0EuY3J0MCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0

# aWdvLmNvbTANBgkqhkiG9w0BAQsFAAOCAQEAQN9rx8jPwCq7rN0jhoey1CZqKiac

# vgYtr6+/zB0qxhxhmIXvMrKcthVLAb/vp+hiipqZXj9ZEp8wlEkz9PVzgHqXVJ/z

# IA95b16/pwX6mvFq2CgKP8YfuYLRQzok4vfYKqtEjpB8UFkbSBeFSjhu0ryNxOWr

# 9JAqnmgLEmvJNk1KvVCm4jBnxyRC2Ht/GWveMnlEwxbP+vCfB/xVfADj5j/6/m9Z

# cZKIKPg1rJho89psn61Yck5+Jv/4ocaaQfaVGdiKuVxDADPmj6bQ6cRk9wXrms+g

# dPloTD/f+LY3sh0GD3DiXFqq/rhhQVKfgE2LToRlMVn6V/MtlWl1PsfyPzCCBXcw

# ggRfoAMCAQICEBPqKHBb9OztDDZjCYBhQzYwDQYJKoZIhvcNAQEMBQAwbzELMAkG

# A1UEBhMCU0UxFDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVz

# dCBFeHRlcm5hbCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJu

# YWwgQ0EgUm9vdDAeFw0wMDA1MzAxMDQ4MzhaFw0yMDA1MzAxMDQ4MzhaMIGIMQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKTmV3IEplcnNleTEUMBIGA1UEBxMLSmVyc2V5

# IENpdHkxHjAcBgNVBAoTFVRoZSBVU0VSVFJVU1QgTmV0d29yazEuMCwGA1UEAxMl

# VVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZI

# hvcNAQEBBQADggIPADCCAgoCggIBAIASZRc2DsPbCLPQrFcNdu3NJ9NMrVCDYeKq

# IE0JLWQJ3M6Jn8w9qez2z8Hc8dOx1ns3KBErR9o5xrw6GbRfpr19naNjQrZ28qk7

# K5H44m/Q7BYgkAk+4uh0yRi0kdRiZNt/owbxiBhqkCI8vP4T8IcUe/bkH47U5FHG

# EWdGCFHLhhRUP7wz/n5snP8WnRi9UY41pqdmyHJn2yFmsdSbeAPAUDrozPDcvJ5M

# /q8FljUfV1q3/875PbcstvZU3cjnEjpNrkyKt1yatLcgPcp/IjSufjtoZgFE5wFO

# RlObM2D3lL5TN5BzQ/Myw1Pv26r+dE5px2uMYJPexMcM3+EyrsyTO1F4lWeL7j1W

# /gzQaQ8bD/MlJmszbfduR/pzQ+V+DqVmsSl8MoRjVYnEDcGTVDAZE6zTfTen6106

# bDVc20HXEtqpSQvf2ICKCZNijrVmzyWIzYS4sT+kOQ/ZAp7rEkyVfPNrBaleFoPM

# uGfi6BOdzFuC00yz7Vv/3uVzrCM7LQC/NVV0CUnYSVgaf5I25lGSDvMmfRxNF7zJ

# 7EMm0L9BX0CpRET0medXh55QH1dUqD79dGMvsVBlCeZYQi5DGky08CVHWfoEHpPU

# JkZKUIGy3r54t/xnFeHJV4QeD2PW6WK61l9VLupcxigIBCU5uA4rqfJMlxwHPw1S

# 9e3vL4IPAgMBAAGjgfQwgfEwHwYDVR0jBBgwFoAUrb2YejS0Jvf6xCZU7wO94CTL

# VBowHQYDVR0OBBYEFFN5v1qqK0rPVIDh2JvAnfKyA2bLMA4GA1UdDwEB/wQEAwIB

# hjAPBgNVHRMBAf8EBTADAQH/MBEGA1UdIAQKMAgwBgYEVR0gADBEBgNVHR8EPTA7

# MDmgN6A1hjNodHRwOi8vY3JsLnVzZXJ0cnVzdC5jb20vQWRkVHJ1c3RFeHRlcm5h

# bENBUm9vdC5jcmwwNQYIKwYBBQUHAQEEKTAnMCUGCCsGAQUFBzABhhlodHRwOi8v

# b2NzcC51c2VydHJ1c3QuY29tMA0GCSqGSIb3DQEBDAUAA4IBAQCTZfY3g5UPXsOC

# HB/Wd+c8isCqCfDpCybx4MJqdaHHecm5UmDIKRIO8K0D1gnEdt/lpoGVp0baglep

# lZLFto8DImwzd8F7MhduB85aFEE6BSQb9hQGO6glJA67zCp13blwQT980GM2IQcf

# Rv9gpJHhZ7zeH34ZFMljZ5HqZwdrtI+LwG5DfcOhgGyyHrxThX3ckKGkvC3vRnJX

# NQW/u0a7bm03mbb/I5KRxm5A+I8pVupf1V8UU6zwT2Hq9yLMp1YL4rg0HybZexkF

# aD+6PNQ4BqLT5o8O47RxbUBCxYS0QJUr9GWgSHn2HYFjlp1PdeD4fOSOqdHyrYqz

# jMchzcLvMIIF9TCCA92gAwIBAgIQHaJIMG+bJhjQguCWfTPTajANBgkqhkiG9w0B

# AQwFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNV

# BAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsx

# LjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkw

# HhcNMTgxMTAyMDAwMDAwWhcNMzAxMjMxMjM1OTU5WjB8MQswCQYDVQQGEwJHQjEb

# MBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgw

# FgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxJDAiBgNVBAMTG1NlY3RpZ28gUlNBIENv

# ZGUgU2lnbmluZyBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAIYi

# jTKFehifSfCWL2MIHi3cfJ8Uz+MmtiVmKUCGVEZ0MWLFEO2yhyemmcuVMMBW9aR1

# xqkOUGKlUZEQauBLYq798PgYrKf/7i4zIPoMGYmobHutAMNhodxpZW0fbieW15dR

# hqb0J+V8aouVHltg1X7XFpKcAC9o95ftanK+ODtj3o+/bkxBXRIgCFnoOc2P0tbP

# BrRXBbZOoT5Xax+YvMRi1hsLjcdmG0qfnYHEckC14l/vC0X/o84Xpi1VsLewvFRq

# nbyNVlPG8Lp5UEks9wO5/i9lNfIi6iwHr0bZ+UYc3Ix8cSjz/qfGFN1VkW6KEQ3f

# BiSVfQ+noXw62oY1YdMCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaAFFN5v1qqK0rP

# VIDh2JvAnfKyA2bLMB0GA1UdDgQWBBQO4TqoUzox1Yq+wbutZxoDha00DjAOBgNV

# HQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHSUEFjAUBggrBgEF

# BQcDAwYIKwYBBQUHAwgwEQYDVR0gBAowCDAGBgRVHSAAMFAGA1UdHwRJMEcwRaBD

# oEGGP2h0dHA6Ly9jcmwudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FDZXJ0aWZp

# Y2F0aW9uQXV0aG9yaXR5LmNybDB2BggrBgEFBQcBAQRqMGgwPwYIKwYBBQUHMAKG

# M2h0dHA6Ly9jcnQudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FBZGRUcnVzdENB

# LmNydDAlBggrBgEFBQcwAYYZaHR0cDovL29jc3AudXNlcnRydXN0LmNvbTANBgkq

# hkiG9w0BAQwFAAOCAgEATWNQ7Uc0SmGk295qKoyb8QAAHh1iezrXMsL2s+Bjs/th

# AIiaG20QBwRPvrjqiXgi6w9G7PNGXkBGiRL0C3danCpBOvzW9Ovn9xWVM8Ohgyi3

# 3i/klPeFM4MtSkBIv5rCT0qxjyT0s4E307dksKYjalloUkJf/wTr4XRleQj1qZPe

# a3FAmZa6ePG5yOLDCBaxq2NayBWAbXReSnV+pbjDbLXP30p5h1zHQE1jNfYw08+1

# Cg4LBH+gS667o6XQhACTPlNdNKUANWlsvp8gJRANGftQkGG+OY96jk32nw4e/gdR

# EmaDJhlIlc5KycF/8zoFm/lv34h/wCOe0h5DekUxwZxNqfBZslkZ6GqNKQQCd3xL

# S81wvjqyVVp4Pry7bwMQJXcVNIr5NsxDkuS6T/FikyglVyn7URnHoSVAaoRXxrKd

# sbwcCtp8Z359LukoTBh+xHsxQXGaSynsCz1XUNLK3f2eBVHlRHjdAd6xdZgNVCT9

# 8E7j4viDvXK6yz067vBeF5Jobchh+abxKgoLpbn0nu6YMgWFnuv5gynTxix9vTp3

# Los3QqBqgu07SqqUEKThDfgXxbZaeTMYkuO1dfih6Y4KJR7kHvGfWocj/5+kUZ77

# OYARzdu1xKeogG/lU9Tg46LC0lsa+jImLWpXcBw8pFguo/NbSwfcMlnzh6cabVgx

# ggThMIIE3QIBATCBkTB8MQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBN

# YW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExp

# bWl0ZWQxJDAiBgNVBAMTG1NlY3RpZ28gUlNBIENvZGUgU2lnbmluZyBDQQIRALNu

# zl+AHwBLaskhcNdHeKUwDQYJYIZIAWUDBAIBBQCgfDAQBgorBgEEAYI3AgEMMQIw

# ADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYK

# KwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgw3J/8ATny0bVf3irxlwq+L2UGocq

# PwXbe/OfrFfbelYwDQYJKoZIhvcNAQEBBQAEggEAf8MbDwer5Q1pfWMUFurAoILW

# 5Jl01zoJkLKAkCS8ejTb1k9rcmpe90XLgkNaPGvG3ADBqt4UFReRrOvQLGLbc6FK

# HTvkPttPZ12ZcaoTwmP2AhHxCdxr73BpzS5kqzn/rstC+NUpza4OYqUj9JHZjjO5

# vm5BkbF47kFsKJKC0vvfROTrPlTTuttozz6SUoPtQBtvXj2llOs9ug4u6zk4Fnrg

# +uZjRat2RWYUA3vQTiWS2j/ELL5tXz9N/qBnox1UmerG1PSsVRvMmOAz8alfAL3l

# t/XumGXVSDDwy1woO9KKq9i+jD4xayK86cBgYzK2IqGlhymOGpmK544PDEFULKGC

# AqIwggKeBgkqhkiG9w0BCQYxggKPMIICiwIBATBoMFIxCzAJBgNVBAYTAkJFMRkw

# FwYDVQQKExBHbG9iYWxTaWduIG52LXNhMSgwJgYDVQQDEx9HbG9iYWxTaWduIFRp

# bWVzdGFtcGluZyBDQSAtIEcyAhIRIdaZp2SXPvH4Qn7pGcxTQRQwCQYFKw4DAhoF

# AKCB/TAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0y

# MDAxMTEyMDU4NDhaMCMGCSqGSIb3DQEJBDEWBBRwpMiBoG6yXORbHLuTqLmtA6sJ

# 8DCBnQYLKoZIhvcNAQkQAgwxgY0wgYowgYcwgYQEFGO4L6th9YOQlpUFCwAknFAp

# M+x5MGwwVqRUMFIxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52

# LXNhMSgwJgYDVQQDEx9HbG9iYWxTaWduIFRpbWVzdGFtcGluZyBDQSAtIEcyAhIR

# IdaZp2SXPvH4Qn7pGcxTQRQwDQYJKoZIhvcNAQEBBQAEggEADzl2yxACNHfcv/pf

# NNcdAN8YYGt1cJifKDMBieOXz7TnqSXVmy6dvqdMZ1PKBcGfAjJkUIXGeiYlTnGy

# IbfZjZlgkgSkcsxnN9y5mw7uaGtHlWtOqCSkQ95emcd5umuolEtQ5tYt8/Ntk/um

# ofAg59169Q+cm4UVSsLc7LnrOg+LIO0WJU2xWg73a7RkaUuzJjh/vLo3Ze1K/Wda

# XrY9M9mIEZ5qIudMam3BiyqsNFmT1tYuf7+zfiLwLO9Z/u3CzYbqd8eq87c+rqKo

# EcPqiJ9Z3PbphYHgtsNjiN6jnUBwQGmi8j+6bx+2++lNq/QHhzRgq72NqaMDdZ/D

# phKFOQ==

# SIG # End signature block