Obs/bin/ObsDep/content/Powershell/Roles/Common/Servicing/Scripts/Modules/AzureStackUpdate.psm1

<###################################################
 # #
 # Copyright (c) Microsoft. All rights reserved. #
 # #
 ##################################################>


<#
This file implements the copying of the Azure Stack Update
payload into the respective product VHDs attached to the VMs.
#>


#region CustomerConfig functions
<#
.SYNOPSIS
 Finds the CustomerConfigFile relative to the current location of the module.
 The modules path is:
 \\su1_fileserver\SU1_ManagementLibrary_1\CloudMedia\Roles\Common\Servicing\Modules
 
 The CustomerConfigFile exists at:
 \\su1_fileserver\SU1_ManagementLibrary_1\CloudMedia
#>

function Get-CustomerConfigFilePath
{
    [CmdletBinding()]
    param ()

    $cloudMediaPath = Join-Path $PSScriptRoot "..\..\..\.."
    Write-Verbose "cloudMediaPath: $cloudMediaPath."

    $customerConfigFilePath = Join-Path $cloudMediaPath "CustomerConfig.xml"
    if (Test-Path $customerConfigFilePath)
    {
        Write-Verbose "Found the CustomerConfig file at: '$customerConfigFilePath'."
        return $customerConfigFilePath
    }
    throw "CustomerConfig file not found at '$customerConfigFilePath'."    
}

<#
.SYNOPSIS
 This function processes CustomerConfig file and returns a hash table with all the parsed values.
 Any data we would need later from CustomerConfig file should all be processed here and add to the hash table.
#>

function Import-CustomerConfigFile
{
    [CmdletBinding()]
    param ()

    $customerConfigFilePath = Get-CustomerConfigFilePath
    $customerConfigXML = [xml] (Get-Content $customerConfigFilePath)
    $fabricRole = $customerConfigXML.CustomerConfiguration.Role.Roles.Role | ? id -eq 'Fabric' 
    $virtualMachines = $fabricRole.Roles.Role | ? id -eq 'VirtualMachines'
    $vmNames = $virtualMachines.Nodes.Node | % Name
   
    $vmToVhdMap = @{} 
    foreach ($vmName in $vmNames)
    {
        $vmNode = $virtualMachines.Nodes.Node | ? Name -eq $vmName
        $vmToVhdMap.$vmName = $vmNode.Vhds.Vhd.Path
    }

    $customerConfigData = @{
        LocalSourceImagePath = $virtualMachines.PrivateInfo.LocalSourceImagePath.Path
        VmToVhdMap = $vmToVhdMap
        LibrarySharePath = $virtualMachines.PrivateInfo.LibraryShare.Path
        InfrastructureSharePath = $virtualMachines.PrivateInfo.InfrastructureShare.Path
    }

    return $customerConfigData
}
#endregion CustomerConfig functions

<#
.SYNOPSIS
 Creates a mapped drive of the network path with the drive name provided, using "net use" command.
 Throws an exception, if the command fails.
#>

function New-MappedDrive
{
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true, Position=0)]
        [string]
        $Drive,

        [Parameter(Mandatory=$true, Position=1)]
        [ValidateScript({ Test-Path $_ })]
        [string]
        $Path
    )
    
    $output = net use $Drive $Path  2>&1 | % ToString | Out-String
    if ($LASTEXITCODE)
    {
        throw "net use '$Drive' '$Path' failed with error code '$LASTEXITCODE'.`r`nThe command output was:`r`n$output."
    }

    # Workaround for a PowerShell issue. The newly mapped drive is not visible sometimes.
    # Enumerating the drives rebuilds the cache and makes the new drive visible.
    Get-PSDrive | Out-Null
}

<#
.SYNOPSIS
 Deletes a mapped drive of the network path with the drive name provided, using "net use" command.
 Throws an exception, if the command fails.
#>

function Remove-MappedDrive
{
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true)]
        [string]
        $Drive
    )

    $output = net use $Drive /d 2>&1 | % ToString | Out-String
    if ($LASTEXITCODE)
    {
        throw "net use '$Drive' /d failed with error code '$LASTEXITCODE'.`r`nThe command output was:`r`n$output."
    }
}

<#
.SYNOPSIS
 Parse the manifest file in the Update and find the VHDs which need to be updated.
 Based on the VHDs find the VMs, whose mounted VHDs need to be updated.
 Then copy the directories/files from the respective nuget directories into the respective paths of mounted VHDs.
 We access the mounted VHDs using the VM name and the d drive. say the VM name is MAS-XRP01, then the path of the mounted
 VHD is \\MAS-XRP01\D$. The content from the update overrides the content in the mounted VHD (if it exists).
#>

function Copy-AzureStackUpdatePayload
{
    [CmdletBinding(SupportsShouldProcess=$true)]
    param (
        [parameter (Mandatory=$true)]
        [ValidateScript({ Test-Path $_ })]
        [string]
        $ExtractedUpdatePath
    )

    Import-Module (Join-Path $PSScriptRoot "Get-FreeDriveLetter.psm1")
    $Verbose = (Get-PSCallStack).Arguments -join '' -match 'Verbose=True' 
    try 
    {
        # Process the CustomerConfig data to get the vm to vhd map and other information
        $customerConfigData = Import-CustomerConfigFile
        $vmToVhdMap =  $customerConfigData["VmToVhdMap"]
        Write-Verbose "VM to VHD Path after processing CustomerConfig file: $($vmToVhdMap | Out-String)"
        $manifestFile = "manifest.xml"
        $manifestFilePath = Join-Path $ExtractedUpdatePath $manifestFile

        if (-not (Test-Path $manifestFilePath))
        {
            throw "Manifest file $manifestFilePath missing from the package."
        }

        $manifestxml = [xml] (Get-Content $manifestFilePath)
        $dataImages = $manifestxml.ImageBuildManifest.DataImage | Select Name, FileName, NuGetPackage


        foreach ($dataImage in $dataImages)
        {
            $vhdName = [System.IO.Path]::GetFileNameWithoutExtension($dataImage.FileName)
            $vhdExtension = [System.IO.Path]::GetExtension($dataImage.FileName)
            $vhdName = $vhdName+"-Product"+$vhdExtension

            Write-Verbose "VHD being updated: '$vhdName'."
            # TODO : Offline update VHDs...
            # $vhdPath = Join-Path $customerConfigData["localSourceImagePath"] $vhdname

            $vmsToUpdate = $vmToVhdMap.Keys | where { $vmToVhdMap.$_ -contains $vhdname } 
            Write-Verbose "VMs to be updated: '$vmsToUpdate'."

            foreach ($vm in $vmsToUpdate)
            {
                # The product VHDs are guaranteed to be mounted as D drive.
                # If that changes, this part of code needs to change.
                $updatePath = "\\" + $vm +"\D$"
                Write-Verbose "VM being updated: '$vm' and the path being updated: '$updatePath'."

                foreach ($nuget in $dataImage.NuGetPackage)
                {
                    $nugetPath = $nuget.Name
                    if ($nuget.Version)
                    {
                        $nugetPath = $nugetPath +"."+ $nuget.Version
                    }
                    $nugetSource = Join-Path $ExtractedUpdatePath $nugetPath

                    # Due to long path issues with the filenames, direct copy
                    # of the files to the destination fails. Hence we create mapped
                    # drives to both source and destination and use them for the copy.
                    $sourceDrive = $null
                    $destinationDrive = $null

                    if ($nuget.Directory)
                    {
                        foreach ($directory in $nuget.Directory)
                        {
                            $source = Join-Path $nugetSource $directory.SourceSubdirectory

                            $sourceDrive = Get-FreeDriveLetter -MakePath
                            New-MappedDrive -Drive $sourceDrive -Path $source
                            $sourceDrivePath = Join-Path $sourceDrive "\*"

                            if (!(Test-Path $sourceDrivePath))
                            {
                                throw "Unable to access the path '$sourceDrivePath' ($source)."
                            }

                            $destination = Join-Path $updatePath  $directory.Destination

                            $destinationDrive = Get-FreeDriveLetter -MakePath
                            New-MappedDrive -Drive $destinationDrive -Path $destination
                            
                            if ($PSCmdlet.ShouldProcess("Copy-Item -Path $sourceDrivePath ($source) -Destination $destinationDrive ($destination) -Recurse -Force", "Update Directory on $vm."))
                            {
                                Write-Verbose "Copying '$sourceDrivePath' ($source) recursively to '$destinationDrive' ($destination)."
                                Copy-Item -Path $sourceDrivePath -Destination $destinationDrive -Recurse -Force
                            }
                      
                            if ($sourceDrive)
                            {
                                Remove-MappedDrive -Drive $sourceDrive
                                $sourceDrive = $null
                            }

                            if ($destinationDrive)
                            {
                                Remove-MappedDrive -Drive $destinationDrive
                                $destinationDrive = $null
                            }
                        }
                    }
                    elseif ($nuget.File)
                    {
                        foreach ($file in $nuget.File)
                        {

                            $source = Join-Path $nugetSource $file.Source

                            $sourceDirectory = Split-Path $source -Parent
                            $sourceFileName = Split-Path $source -Leaf
                            $sourceDrive = Get-FreeDriveLetter -MakePath
                            New-MappedDrive -Drive $sourceDrive -Path $sourceDirectory
                            

                            $sourcePath = Join-Path $sourceDrive $sourceFileName
                            $destination = Join-Path $updatePath  $directory.Destination

                            $destinationDrive = Get-FreeDriveLetter -MakePath
                            New-MappedDrive -Drive $destinationDrive -Path $destination

                            if ($PSCmdlet.ShouldProcess("Copy-Item -Path $sourceDrivePath -Destination $destinationDrive -Force", "Update file on $vm."))
                            {
                                Write-Verbose "Copying '$sourcePath' ($source) to '$destinationDrive' ($destination)."
                                Copy-Item -path $sourcePath -Destination $destinationDrive -Force
                            }
                            
                            if ($sourceDrive)
                            {
                                Remove-MappedDrive -Drive $sourceDrive
                                $sourceDrive = $null
                            }

                            if ($destinationDrive)
                            {
                                Remove-MappedDrive -Drive $destinationDrive
                                $destinationDrive = $null
                            }
                        }
                    }
                }
            }
        }
    }
    catch
    {
        $ex = $_ | Select-Object *
        throw "Copying the payload for the Azure Stack Update failed.`r`n$ex."
    }
    finally
    {
        if ($sourceDrive)
        {
            Remove-MappedDrive -Drive $sourceDrive
        }

        if ($destinationDrive)
        {
            Remove-MappedDrive -Drive $destinationDrive
        }
    } 
}

<#
.SYNOPSIS
Expands the Azure Stack Update Package.
 
.DESCRIPTION
Given a Package, expand package to directory of same name (without the .zip extension) in the same location as the package.
 
.PARAMETER Path
The full path to the Azure Stack Update Package.
#>

function Expand-AzureStackUpdate
{
    [CmdletBinding(SupportsShouldProcess=$true)]
    param (
        [parameter (Mandatory=$true)]
        [ValidateScript({ Test-Path $_ })]
        [string]
        $Path
    )

    Import-Module (Join-Path $PSScriptRoot "ZipFiles.psm1")
    Import-Module (Join-Path $PSScriptRoot "Get-FreeDriveLetter.psm1")
    $drive = $null
    try
    {
        $Verbose = (Get-PSCallStack).Arguments -join '' -match 'Verbose=True' 

        $dirName = [System.IO.Path]::GetDirectoryName($Path)
        Write-Verbose "Directory name is: '$dirName'."

        $fileName = [System.IO.Path]::GetFileName($Path)
        Write-Verbose "File name is: '$fileName'."

          $fileNameWithoutExtension = [System.IO.Path]::GetFileNameWithoutExtension($Path)  
        Write-Verbose "File name without extension is: '$fileNameWithoutExtension'." 

        $drive = Get-FreeDriveLetter -MakePath
        New-MappedDrive -Drive $drive -Path $dirName

        $shortPath = Join-Path $drive $fileName
        Write-Verbose "Short path name is: '$shortPath'."
        
        $destShortPath = Join-Path $drive $fileNameWithoutExtension

        Write-Verbose "Expanding the package '$shortPath' to '$destShortPath'."
        Expand-ZipFile -Source $shortPath -Destination $destShortPath -Force

        $destOriginalPath = Join-Path $dirName $fileNameWithoutExtension 

        if (Test-Path $destOriginalPath)
        {
            return $destOriginalPath
        }
        else
        {
            throw "Expanding package '$Path' failed to extract to '$destOriginalPath'."
        }
    }
    catch
    {
        $ex = $_ | Select-Object *
        throw "Expanding the Azure Stack Update failed.`r`n$ex."
    }
    finally
    {
        if ($drive)
        {
            Remove-MappedDrive -Drive $drive
        }
    }
}

Export-ModuleMember -Function Copy-AzureStackUpdatePayload
Export-ModuleMember -Function Expand-AzureStackUpdate
# SIG # Begin signature block
# MIInvwYJKoZIhvcNAQcCoIInsDCCJ6wCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAuyVyaoyfeJofS
# Y1cF1kCAWoNmxRrpCoWlO6LiXQjrvqCCDXYwggX0MIID3KADAgECAhMzAAADTrU8
# esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU
# p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1
# 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm
# WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa
# +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq
# jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk
# mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31
# TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2
# kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d
# hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM
# pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh
# JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX
# UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir
# IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8
# 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A
# Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H
# tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg
# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03
# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr
# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg
# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy
# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9
# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh
# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k
# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB
# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn
# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90
# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w
# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o
# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD
# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa
# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny
# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG
# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV
# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG
# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl
# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb
# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l
# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6
# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0
# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560
# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam
# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa
# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah
# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA
# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt
# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr
# /Xmfwb1tbWrJUnMTDXpQzTGCGZ8wghmbAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIFJCtNZ+O2BgPRNe4dcrXfzA
# UcaUQxKewF47JM8ASh/sMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAx+NlhmRL4nu5s8//KE2CuVsthZTs1MzErfrEeMN3vWHoEdzs0UIqSejm
# uap3O/bBQ9VUP5iWLpzKhGxuev6veEd0cwGitXYfTymzyRhLxBFyPwGLxnHxKk2o
# IntPRvyaSm1XlbKFG2hBd0/jdQumAc8Y2GfPhwsoqp9d7gv/7YqRoQj2LG2PeVzn
# rw5HK8xzCX8dsD+ImDslk08AtiZo9K8DbOFSgcu09XqXKzvrkRiQ8py0juBuBdjJ
# MQVXe3fckTPAMWjbShBWsWch4h4BwCY0naEUo5kBWDhZIGJK/LSpQlIDb2Yz8fxG
# U8l1+XyNqRLGTV2q1y38mVshO3MgKqGCFykwghclBgorBgEEAYI3AwMBMYIXFTCC
# FxEGCSqGSIb3DQEHAqCCFwIwghb+AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq
# hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDYPTrNbQJySr0CdhxyhxTA4G3EquDhUcFbQnoyZ3CofQIGZQtY1EKy
# GBMyMDIzMDkyMjA4MzEwMi40MDVaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO
# Ojg2REYtNEJCQy05MzM1MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNloIIReDCCBycwggUPoAMCAQICEzMAAAG3IScaB6IqhkYAAQAAAbcwDQYJ
# KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjIw
# OTIwMjAyMjE0WhcNMjMxMjE0MjAyMjE0WjCB0jELMAkGA1UEBhMCVVMxEzARBgNV
# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv
# c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl
# cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4NkRGLTRC
# QkMtOTMzNTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC
# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMf9z1dQNBNkTBq3HJclypjQ
# cJIlDAgpvsw4vHJe06n532RKGkcn0V7p65OeA1wOoO+8NsopnjPpVZ8+4s/RhdMC
# MNPQJXoWdkWOp/3puIEs1fzPBgTJrdmzdyUYzrAloICYx722gmdpbNf3P0y5Z2gR
# O48sWIYyYeNJYch+ZfJzXqqvuvq7G8Nm8IMQi8Zayvx+5dSGBM5VYHBxCEjXF9EN
# 6Qw7A60SaXjKjojSpUmpaM4FmVec985PNdSh8hOeP2tL781SBan92DT19tfNHv9H
# 0FAmE2HGRwizHkJ//mAZdS0s6bi/UwPMksAia5bpnIDBOoaYdWkV0lVG5rN0+ltR
# z9zjlaH9uhdGTJ+WiNKOr7mRnlzYQA53ftSSJBqsEpTzCv7c673fdvltx3y48Per
# 6vc6UR5e4kSZsH141IhxhmRR2SmEabuYKOTdO7Q/vlvAfQxuEnJ93NL4LYV1IWw8
# O+xNO6gljrBpCOfOOTQgWJF+M6/IPyuYrcv79Lu7lc67S+U9MEu2dog0MuJIoYCM
# iuVaXS5+FmOJiyfiCZm0VJsJ570y9k/tEQe6aQR9MxDW1p2F3HWebolXj9su7zrr
# ElNlHAEvpFhcgoMniylNTiTZzLwUj7TH83gnugw1FCEVVh5U9lwNMPL1IGuz/3U+
# RT9wZCBJYIrFJPd6k8UtAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUs/I5Pgw0JAVh
# DdYB2yPII8l4tOwwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD
# VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j
# cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG
# CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw
# MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD
# CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAA2dZMybhVxSXTbJ
# zFgvNiMCV5/Ayn5UuzJU495YDtcefold0ehR9QBGBhHmAMt10WYCHz2WQUyM3mQD
# 4IsHfEL1JEwgG9tGq71ucn9dknLBHD30JvbQRhIKcvFSnvRCCpVpilM8F/YaWXC9
# VibSef/PU2GWA+1zs64VFxJqHeuy8KqrQyfF20SCnd8zRZl4YYBcjh9G0GjhJHUP
# AYEx0r8jSWjyi2o2WAHD6CppBtkwnZSf7A68DL4OwwBpmFB3+vubjgNwaICS+fkG
# VvRnP2ZgmlfnaAas8Mx7igJqciqq0Q6An+0rHj1kxisNdIiTzFlu5Gw2ehXpLrl5
# 9kvsmONVAJHhndpx3n/0r76TH+3WNS9UT9jbxQkE+t2thif6MK5krFMnkBICCR/D
# VcV1qw9sg6sMEo0wWSXlQYXvcQWA65eVzSkosylhIlIZZLL3GHZD1LQtAjp2A5F7
# C3Iw4Nt7C7aDCfpFxom3ZulRnFJollPHb3unj9hA9xvRiKnWMAMpS4MZAoiV4O29
# zWKZdUzygp7gD4WjKK115KCJ0ovEcf92AnwMAXMnNs1o0LCszg+uDmiQZs5eR7jz
# dKzVfF1z7bfDYNPAJvm5pSQdby3wIOsN/stYjM+EkaPtUzr8OyMwrG+jpFMbsB4c
# fN6tvIeGtrtklMJFtnF68CcZZ5IAMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ
# mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh
# dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1
# WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB
# BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK
# NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg
# fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp
# rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d
# vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9
# 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR
# Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu
# qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO
# ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb
# oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6
# bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t
# AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW
# BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb
# UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz
# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku
# aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA
# QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2
# VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu
# bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw
# LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93
# d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt
# MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q
# XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6
# U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt
# I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis
# 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp
# kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0
# sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e
# W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ
# sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7
# Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0
# dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ
# tB1VM1izoXBm8qGCAtQwggI9AgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh
# bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4
# NkRGLTRCQkMtOTMzNTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaIjCgEBMAcGBSsOAwIaAxUAyGdBGMObODlsGBZmSUX2oWgfqcaggYMwgYCk
# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF
# AOi3KKQwIhgPMjAyMzA5MjIwNDQwMDRaGA8yMDIzMDkyMzA0NDAwNFowdDA6Bgor
# BgEEAYRZCgQBMSwwKjAKAgUA6LcopAIBADAHAgEAAgIKmjAHAgEAAgISEjAKAgUA
# 6Lh6JAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAID
# B6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAECO5laKqKLCnIOukl5E
# k5GLTffJnr51w1yN1F4035G4UhhNu7PicVibckByJmzSegWE2Fvk4ZOLQAqENZGp
# pjnkVGuCzaeJtiC4ciBO5JPXipDSquW4Jv0fKOYTZ6xoK6HN7qItPdRegNmHfsx3
# JOlWNbtWxuDNT7alEAy+jfkDMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
# U3RhbXAgUENBIDIwMTACEzMAAAG3IScaB6IqhkYAAQAAAbcwDQYJYIZIAWUDBAIB
# BQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQx
# IgQgSQY3e6+hg0JhxNwIF4brcNcZBERpxR8mNRmSsoZ+f2owgfoGCyqGSIb3DQEJ
# EAIvMYHqMIHnMIHkMIG9BCBsJ3jTsh7aL8hNeiYGL5/8IBn8zUfr7/Q7rkM8ic1w
# QTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABtyEn
# GgeiKoZGAAEAAAG3MCIEINkdmaQbxevriOmGg4cmW1GUc1+gqpOinWVkpG+TekR+
# MA0GCSqGSIb3DQEBCwUABIICAAPNhOBw4YVPEsSG+t4HgMCjS6EuK6yeGm/5KtjX
# 20gb5uNe+5zdVx+sO6/8Z77HdZhALvdnd9Lt2I+VX9Eev4JsptnSq8QHUrAbJ1A2
# i/kFxhSpODLyDVBu7Dihb4thjDML40l60dwX/PZbGZZcAaO2jAz0mKvk6jJm4dTm
# rZxO3+7TpWqIVJCbBbaj5P42/qlBFR92kXJseIIBBKX9Uf7+4ziy1wan8Lj4B5qC
# c4mU6jlAdnrcQV3Y4vJb3COhYprMTy8T/zjLXlCViJ4RDLJoZFym5OtJtfhto76s
# N7gwSQx7IuWAjxOsRrWSUR+qUhdvO15T/Vsasyo5LUJk43KjvrdbE8xnhHmfk7q3
# Q7yac1xHJLOb9+9IkE+yQuiNSZ1hQCs4cXCETS1pW8/90v7EZK8Delqfm3zXYBf2
# 7wUKtFFtP+aKWAKqXd4C181bPeBhX2TkV6ZI9wBB7g1423HfoktjBnNR7+RXAMTj
# jmAEKiBjxT8ANkQ5X6ISPwrJjMjB4nK1ZsrIFrCDvo3FLgRTwgmjs2KRZ3VrgraE
# pLArQAEB4yMnhtwrAC0RBvxW+rBeJjaWExp8cLacL/Jf9Fx0+jhjIH2qMikXLfD5
# ksKXgq7kdmRfbrrO+SQJ7LQNJ2ZXl9rYIUxZtdj9XfRE1rYZYc3TWtiKQLjQRJvV
# qd6v
# SIG # End signature block