Obs/bin/ObsAgent/lib/Scripts/InvokeLogCollection.psm1

<##############################################################
 # #
 # Copyright (C) Microsoft Corporation. All rights reserved. #
 # #
 ##############################################################>


#
# Get logs from various roles of AzureStack.
#

# Do not change the order of imports
Import-Module $PSScriptRoot\LogCollectionHelper.psm1 -Force -Verbose:$false
Import-Module $PSScriptRoot\GenericHelper.psm1 -Force -Verbose:$false

function GetFileOrFolderSize
{
    Param
    (
        [Parameter(Mandatory=$true)]
        [string]
        $RootPath
    )
    $size = [long] (Get-ChildItem -Recurse $RootPaTh -ErrorAction SilentlyContinue -force | Where-Object { -not $_.PSIsContainer }  | Measure-Object -Sum Length ).Sum
    return $size
}
function Convert-UtctoLocal
{ 
    param( 
            [parameter(Mandatory=$true)] 
            [DateTime] $UtcdateTime 
        )
        
        if ($UtcdateTime.Kind -eq [DateTimeKind]::Utc) {
            return [System.TimeZoneInfo]::ConvertTimeFromUtc($UtcdateTime, (Get-TimeZone))
        }

        # Override
        # Using (Get-Date) will get the local time, so assuming user adjusted the time to UTC
        # need to convert it into string to remove the kind property which is local if we use get-date
        return [System.TimeZoneInfo]::ConvertTimeFromUtc($UtcdateTime.tostring(), (Get-TimeZone))
}
function Invoke-GarbageCollector
{
    $functionName = $($MyInvocation.MyCommand.Name)

    if(((Get-Date) - $Global:LastGarbageCollectedTime).TotalSeconds -gt 60 ) {
        Trace-Progress -Message "$functionName : Invoking Garbage Collector"
        [System.GC]::Collect()
        $Global:LastGarbageCollectedTime = Get-Date
    } else {
        Trace-Progress -Message "$functionName : Skipping Garbage Collector invocation"
    }
}

function Write-RoleTime
{
    param (
        [string]$RoleName,
        [int]$Empty,
        [int]$Filled,
        [float]$Duration
    )
    #no role name is > 32 charaters currently
    $roleFiller = (32 - $RoleName.Length)
    $RoleName = ' '*$roleFiller + $RoleName

    <# This will print double line
    switch($Filled)
    {
        1 {$line = '║'}
        default {$line = '╠'+'═'*($Filled-2)+'╣'}
    }
    #>

    switch($Filled)
    {
        1 {$line = '║'}
        default {$line = '├'+'─'*($Filled-2)+'┤'}
    }

    $d ="{0:00.0}" -f $Duration
    [String]$printLine = "[$RoleName][$d]" + ' '*$Empty + $line
    Write-Host $printLine
}


function Show-RoleTime
{
    param(
        [string]$roleTimesCsvFilePath
    )

    $functionName = $($MyInvocation.MyCommand.Name)

    try{
        $fileContent = Get-Content -Path $roleTimesCsvFilePath
        $expectedFirstLine = "RoleName, StartTime, EndTime, Minutes"

        if (($fileContent.GetType().Name -eq "String") -and ($fileContent -eq $expectedFirstLine))
        {
            Trace-Progress "$functionName : There is no role time data. Cannot show role timeline." 
            return
        }

        $f = @()
        if($fileContent[0] -ne $expectedFirstLine)
        {
            $f += $expectedFirstLine
            $f += $fileContent
            $fileContent = $f
        }

        $rawData = $fileContent| ConvertFrom-Csv
        $SortedData = $rawData | Sort-Object StartTime

        [System.Globalization.CultureInfo]$provider = [System.Globalization.CultureInfo]::InvariantCulture
        $format = 'MM/dd/yyyy HH:mm:ss'
        [ref]$parsedDate = get-date
        foreach ($obj in $SortedData)
        {
            $IsDateStartTime = [DateTime]::TryParseExact($obj.StartTime, $format,$provider,[System.Globalization.DateTimeStyles]::None,$parseddate)
            $IsDateEndTime = [DateTime]::TryParseExact($obj.EndTime, $format,$provider,[System.Globalization.DateTimeStyles]::None,$parseddate)
            $RoleNullOrEmpty =  [string]::IsNullOrEmpty($obj.RoleName)
            $IsMinutesFloat = $obj.Minutes -match "^[\d\.]+$"

            $errorMessage = [System.Text.StringBuilder]::new()
            if (!$IsDateStartTime)
            {
                [void]$errorMessage.Append("Start Time of $($obj.StartTime) is not a valid date. ")
            }
            if (!$IsDateEndTime)
            {
                [void]$errorMessage.Append("End Time of $($obj.EndTime) is not a valid date. ")
            }
            if ($RoleNullOrEmpty)
            {
                [void]$errorMessage.Append("Role Name is null or empty. ")
            }
            if (!$IsMinutesFloat)
            {
                [void]$errorMessage.Append("Minutes of $($obj.Minutes) is not a valid float. ")
            }
            if ($errorMessage.Length -ne 0)
            {
                $errorMessageStart = "Role Time Information for role $($obj.RoleName) is invalid : "
                $errorMessageEnd = " Cannot show role timeline."
                $fullErrorMessage = $errorMessageStart + $errorMessage.ToString() + $errorMessageEnd
                Trace-Progress "$functionName : $fullErrorMessage" -error
                return
            }
        }

        $allData = @()
        $allData += $SortedData | ForEach-Object {     $element = @{
                                    RoleName  = $_.RoleName
                                    StartTime = Get-Date -Date $_.StartTime
                                    EndTime   = Get-Date -Date $_.EndTime
                                    Duration  = [float]$_.Minutes
                                }
                            return $element }

        $data = $allData

        $minStartime    = ($data.StartTime | Measure-Object -Minimum).Minimum
        $maxEndtime     = ($data.EndTime | Measure-Object -Maximum).Maximum
        $TotalDuration  = ($maxEndtime - $minStartime).TotalMinutes

        #Lets assume screen has 160 + 32 + few characters for printing name and timetime
        $multiplier = (160/$TotalDuration)

        Write-Host '**********************Get AzureStackLog Role Timeline**********************'
        foreach($role in $data)
        {
            $empty = [math]::Ceiling((($role.StartTime - $minStartime).TotalMinutes)*$multiplier)
            $fill = [math]::Ceiling(($role.Duration)*$multiplier)
            Write-RoleTime -RoleName $role.RoleName -Empty $empty -Filled $fill -Duration $role.Duration
        }
        Write-Host $printLine
        Write-Host '***************************************************************************'
    }
    catch {
        Trace-Progress -Message "$functionName : Failed to graph times for each role exception : $_" 
    }
}

function TerminateJobAndCopyTempFilesToOutputPath
{
    param
    (
    [Parameter(Mandatory=$true)]
    [System.Management.Automation.Job]$JobToTerminate,

    [Parameter(Mandatory=$true)]
    [string] $TempFolderPath,

    [Parameter(Mandatory=$true)]
    [string] $OutputPath,

    [string]
    $SharePath,

    [string]
    $SasUri

    )
    $functionName = $($MyInvocation.MyCommand.Name)
    #we do not want to copy all role* folders bcoz, we have few roles with same prefix as
    # ACS, ACSFabric,ACSWac etc..
    # Which could be all running parallel, we need to copy only folders with pattern "$role", "$role-"
    Trace-Progress -Message "$functionName_$($JobToTerminate.Name) : Forcibly stopping the job "
    $JobToTerminate | Stop-Job  # Force the job to Terminate
    Trace-Progress -Message "$functionName_$($JobToTerminate.Name) : Stopped, current state = [$($JobToTerminate.State)] ...."
    Start-Sleep 60 # Give few seconds for child processes to terminate, this can be upto 60 seconds
    $JobToTerminate | Receive-Job
    <#
    #copy files from temp and destination to outputpath for current role only.
    $RoleFoldersInTemp1 = $TempFolderPath + "\" + $JobToTerminate.Name + "*" # this will capture Storage, Storage-part2, Storage-Uncompressed, Storage-Uncompressed-Part2
 
    $roleFoldersOnly = Get-ChildItem -Path $RoleFoldersInTemp1 -Directory
    Trace-Progress -message "$functionName_$($JobToTerminate.Name) : [$($roleFoldersOnly.count)] exist at the time job was terminated. `n folder list = [$roleFoldersOnly]"
    #note this will get the files and folders if they are non empty.
 
    if($roleFoldersOnly.count)
    {
        foreach( $folderPath in $roleFoldersOnly.FullName)
        {
            $tempFiles = Get-ChildItem -Path $folderPath -Recurse -ErrorAction SilentlyContinue -Verbose
            Trace-Progress -message "$functionName_$($JobToTerminate.Name) : $($tempFiles.count) files/folders to copy"
            #Copy-Item -Path $RoleFoldersInTemp1 -Destination "$OutputPath\FilesCopiedOnTermination\$($JobToTerminate.Name)\" -Recurse -Force -ErrorAction SilentlyContinue -Verbose
            #Remove-Item -Path $RoleFoldersInTemp1 -Recurse -ErrorAction SilentlyContinue -verbose
            if($tempFiles)
            {
                #$folderPath
                if((split-path $folderPath -leaf) -match 'UnCompressed')
                {
                    $CompressionLevel = [System.IO.Compression.CompressionLevel]::NoCompression
                } else {
                    $CompressionLevel = [System.IO.Compression.CompressionLevel]::Optimal
                }
 
                $output = Get-FolderAsZip -SourceFolder $folderPath -DestinationFolder "$OutputPath\FilesCopiedOnTermination\$($JobToTerminate.Name)\" -RoleName $JobToTerminate.Name -CompressionLevel $CompressionLevel -SharePath $SharePath -SasUri $SasUri
                Trace-Progress -message "$functionName_$($JobToTerminate.Name) : created and copied zip [($output.Path)] - [$($output.success)]"
             } else {
                Trace-Progress -message "$functionName_$($JobToTerminate.Name) : [$folderPath] is empty, skipping copy"
             }
         }
     }else {
        Trace-Progress -message "$functionName_$($JobToTerminate.Name) : [$RoleFoldersInTemp1] is empty, nothing to copy upon termination"
     }
     #>

}

function Invoke-AzureStackLogCollection
{
    [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingComputerNameHardcoded','')]

    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterByRole,

        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterByNode,

        [Parameter(Mandatory=$false)]
        [ValidateSet('File','CSV','WindowsEvent','ContainerState')]
        [String[]]
        $FilterByLogType,

        [Parameter(Mandatory=$false)]
        [ValidateNotNullOrEmpty()]
        [string]
        $CustomerConfigurationFilePath,

        # This will get the logs starting from last hour
        [Parameter(Mandatory=$false)]
        [DateTime]
        $FromDate = ([DateTime]::UtcNow).AddHours(-1),

        # This will get the logs until the current date
        [Parameter(Mandatory=$false)]
        [DateTime]
        $ToDate = ([DateTime]::UtcNow),

        # Whether the log collection is autonomous
        [Parameter(Mandatory=$false)]
        [bool]
        $IsAutonomous = $false,

        # Log Collection Job type
        [Parameter(Mandatory=$false)]
        [string]
        $LogCollectionJobType = "OnDemand",

        # Log Collection output path
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $OutputPath,

        # Whether to only collect logs from the localhost
        [Parameter(Mandatory=$false)]
        [bool]
        $LocalMode = $false,

        # Whether we are pushing logs to an SMBShare
        [Parameter(Mandatory=$false)]
        [bool]
        $ToSMBShare = $false
    )
    Trace-EnteringMethod

    # Let start time be the first garbage collection time.
    $Global:LastGarbageCollectedTime = Get-Date
    $logCollectionStartDate = Get-Date
    $logCollectionPerfResult = @{}
    $Error.Clear()

    $functionName = $($MyInvocation.MyCommand.Name)

    $azsLogFolderPrefix = "ASZLogs-" + ((Get-Date).ToString('yyyyMMddHHmmss'))
    # Adding this OutputFolderName variable to have azsLogFolderPrefix and env name together.
    $OutputFolderName = "$azsLogFolderPrefix-$env:ComputerName"

    #User has provided the outputpath, lets add AzureStackLog-yyyyMMddHHmmss to the path.
    $OutputPath = Join-Path -Path $OutputPath -ChildPath "$OutputFolderName"

    $transcriptPath = "$OutputPath\Get-AzureStackLog_Output.log"
    Start-Transcript -Path $transcriptPath -Verbose

    Trace-Progress -Message "$functionName : Outputpath = [$OutputPath]"
    Trace-Progress -Message "$functionName : transcriptPath = [$transcriptPath]"

    $collectionDetails = @{}
    $collectionDetails.Reason = "User Initiated"

    $maxJobTimeInSec = 15600 # 260min = 15600sec
    $maxJobLimit = 6

    Trace-Progress -Message "$functionName : Running on Machine = [$($env:COMPUTERNAME)] with max parallel jobs =[$maxJobLimit]"
    #$filterOnlyRoles = $FilterByRole -and -not $FilterByResourceProvider
    #$filterOnlyRps = $FilterByResourceProvider -and -not $FilterByRole

    # Prepare and send telemetry event
    $telActivityId = New-Guid
    if ($null -eq $FilterByRole)
    {
        $telRoles = ""
    }
    else
    {
        $telRoles = [string]$FilterByRole
    }

    $telParameters = $MyInvocation.BoundParameters.Keys
    $telParameters = $telParameters -join ','

    $message = ("$functionName : Started new InvokeLogCollection instance with activity ID '{0}'" -f $telActivityId)
    Trace-Progress -Message $message

    # Convert UTC times to local time
    $ToDate = Convert-UtctoLocal -UtcdateTime $ToDate
    $FromDate = Convert-UtctoLocal -UtcdateTime $FromDate

    if ($ToDate -gt (Get-Date).addMinutes(5))
    {   
        $OldToDate = $ToDate
        $ToDate = (Get-Date)
        $warningMessage = "$functionName : Log Collection To Date cannot be greater than current datetime. Changed Log Collection ToDate from $OldToDate to $ToDate"
        Trace-Progress -Message $warningMessage -Warning
    }

    if ($FromDate -gt (Get-Date))
    {
        $errorMessage = "$functionName : Log Collection From Date cannot be greater than current datetime. Aborting log collection."
        Trace-Progress -Message $errorMessage -Error
        Stop-Transcript
        return
    }

    if ($ToDate -le $FromDate)
    {
        $errorMessage = "$functionName : ToDate cannot be less than or equal to FromDate. Aborting log collection."
        Trace-Progress -Message $errorMessage -Error
        Stop-Transcript
        return
    }

    $telDate = Get-Date
    # Send-InstanceStartEvent -ActivityId $telActivityId -Timestamp $telDate -Roles $telRoles -OutputParameters $telParameters -FromRange $FromDate -ToRange $ToDate -AlertBased $AlertBased

    $collectionDetails.computerName = $env:COMPUTERNAME
    $collectionDetails.computerOS = [environment]::OSVersion.VersionString
    $collectionDetails.activityId = $telActivityId
    $collectionDetails.telParams = $telParameters
    $collectionDetails.fromDate = $FromDate
    $collectionDetails.toDate = $ToDate
    $collectionDetails.rolesSelected = $telRoles
    $collectionDetails.outputFolderName = $OutputFolderName
    $collectionDetails.invokeTime = $telDate
    $collectionDetails.filterOnlyRoles = $filterOnlyRoles
    $collectionDetails.filterOnlyRps = $filterOnlyRps

    if (-not (Test-IsElevated))
    {
        $errorMessage = "$functionName : Collecting logs requires elevation. Aborting."
        Trace-Progress -Message $errorMessage -Error
        #Send-InstanceFinishEvent -ActivityId $telActivityId -Timestamp (Get-Date) -TerminalError $errorMessage
        return
    }

    #Input object pipeline for parameters
    $argumentsObject = [PSCustomObject]@{}

    $isArcAEnv = $false

    # Get domain information
    $domain = $env:USERDNSDomain
    if ($null -eq $domain -and $env:COMPUTERNAME -like "IRVM*") {
        $isArcAEnv = $true
        $localMode = $true
    }

    Trace-Progress -Message "$functionName : Domain name fetched from environment variable = $domain"
    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "domain" -Value $domain

    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "functionName" -Value $functionName
    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "OutputPath" -Value $OutputPath

    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "FromDate" -Value $FromDate
    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "ToDate" -Value $ToDate

    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "localMode" -Value $LocalMode
    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "isArcAEnv" -Value $isArcAEnv
    Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "toSMBShare" -Value $ToSMBShare

    try
    {
        $FromDateG = $FromDate.ToString("G")
        $ToDateG = $ToDate.ToString("G")
        Trace-Progress -Message "$functionName : Collecting logs from $FromDateG to $ToDateG"
        Trace-Progress -Message "$functionName : Local time zone is $(([TimeZoneInfo]::Local).DisplayName)"

        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "FromDateG" -Value $FromDateG
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "ToDateG" -Value $ToDateG

        if(-not $CustomerConfigurationFilePath) {
            if ($isArcAEnv) {
                $CustomerConfigurationFilePath = "$PSScriptRoot\ArcADiagnosticLogRoleConfiguration.json"
            }
            else {
                $CustomerConfigurationFilePath = "$PSScriptRoot\DiagnosticLogRoleConfiguration.json"
            }
        }

        $roles = Get-RoleInfoFromJsonConfig -RoleJsonFile $CustomerConfigurationFilePath 

        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "roles" -Value $roles

        $roleNames = Get-FilteredRoleName -Roles $roles -FilterByRole $FilterByRole -LogCollectionJobType $LogCollectionJobType
        $nodeNames = Get-NodeNamesFromClusterOrDefaultLocalHostName
        $vmRoleNames = Get-InfraVMNames -InfraHostNames $nodeNames

        # TODOTODO suppress node filtering for now.
        <# $nodeNames = Get-FilteredNodeName -Roles $roles -RoleNames $roleNames -FilterByNode $FilterByNode
 
         $roleNamesAfterNodeFilter = $roleNames | Where-Object { ($roles[$_].PublicConfiguration.Nodes.Node.Name | Where-Object { $nodeNames -contains $_}).Count -gt 0 }
         Trace-Progress "$functionName : Role names after applying node filter: $($roleNamesAfterNodeFilter -join ', ')"
         $collectionDetails.nodeFilteredRoles = $roleNamesAfterNodeFilter
 
        if ($FilterByRole -and $FilterByNode)
        {
            if (($null -eq $roleNamesAfterNodeFilter) -or ($null -ne (Compare-Object $roleNames $roleNamesAfterNodeFilter)))
            {
                $message = "Invalid role / node filters, please check the input and try again."
                Trace-Progress "$functionName : $message" -Error
                throw $message
            }
        }
 
        $roleNames = $roleNamesAfterNodeFilter
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "nodeNames" -Value $nodeNames
        #>


        # nodenames = list of baremetal nodes
        # if LocalMode, ensure we are only collecting logs on the local node.
        if ($LocalMode)
        {
            Trace-progress -Message "$functionName : In LocalMode. LocalMode will override filterByNode parameter to make sure it is the local node only."
            $filterByNode = @($env:COMPUTERNAME)
        }
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "filterByNode" -Value $FilterByNode
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "nodeNames" -Value $nodeNames
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "roleNames" -Value $roleNames
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "vmRoleNames" -Value $vmRoleNames

        if (-not $FilterByLogType)
        {
            Trace-Progress "$functionName : No log type filters specified, getting all log types."
            $FilterByLogType = @('File','CSV','WindowsEvent')

            if ($isArcAEnv)
            {
                $FilterByLogType += 'ContainerState'
            }
        }

        Trace-Progress -Message "$functionName : Collecting $($FilterByLogType -join ', ') logs"
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "FilterByLogType" -Value $FilterByLogType

        <# Get cluster information (including multiple clusters) clusternames, fileservername, ismanagementcluster, diagnosticshare full path
        $allClusterInfo = Get-StorageClusterInformation -AllRoles $roles
        Add-Member -InputObject $argumentsObject -MemberType NoteProperty -Name "allClusterInfo" -Value $allClusterInfo
        #>


        # Job array to track background jobs created
        $jobArray = New-Object -TypeName System.Collections.ArrayList

        <#
            Creating scriptblock this way expands $psscriptroot,
            using powershell way of defining scriptblock delays expansion of $psscriptroot and fails if used inside a job init block
        #>

        Trace-Progress "$functionName : INITBLOCK - $PSScriptRoot"

        $initblock = [ScriptBlock]::Create("Import-Module -Name '$PSScriptRoot\LogCollectionHelper.psm1' -Force; Import-Module -Name '$PSScriptRoot\GenericHelper.psm1' -Force")

        # TimeTracker for each job
        $roleTimeLog = "$OutputPath\RoleTime_Output.csv"
        Trace-Progress -Message "Adding header to file [$roleTimeLog]"
        #Add header for csv file, makes it easier to open the file in excel
        Add-Content -Path $roleTimeLog -Value "RoleName, StartTime, EndTime, Minutes"

        ##TODO - try ?? or remove {}
        try {
            $logCollectionPerfResult.Add("SetupTime", ((Get-Date) - $logCollectionStartDate).TotalMinutes)

            # role count info
            $roleCount = $roleNames.Count
            Trace-Progress -Message "$functionName : Total number of roles $roleCount"

            foreach ($role in $roleNames)
            {
                $alljobs = Get-Job
                foreach($j in $alljobs)
                {
                    $jobToBeRemoved = $null
                    if($j.State -in @('Completed')) # let the failed, Suspended and Disconnected jobs be in the list
                    {
                        $j | Receive-Job
                        $j |Stop-Job
                        $jobToBeRemoved = $true
                    }
                    elseif (($jobTime = ((Get-date) - $j.PSBeginTime).Totalseconds) -gt $maxJobTimeInSec ) {
                        #Time to terminate the job
                        Trace-Progress -Message "$functionName : job [$($j.Name)] exceeded maximum time for individual job [$jobTime] seconds - Terminating Job forcefully...." -Error
                        $jobToBeRemoved = $true
                        # TerminateJobAndCopyTempFilesToOutputPath -JobToTerminate $j -TempFolderPath $destPath -OutputPath $OutputPath -SharePath $DestinationSharePath -SasUri $OutputSasUri
                    }
                    if ($jobToBeRemoved)
                    {
                        Trace-Progress -Message "$functionName : job $($j.Name) completed with state = $($j.State)"
                        if ($j.State -ne 'Completed') {
                            $errorMessage = $j.ChildJobs.JobStateInfo.Reason.Message
                            if($errorMessage) {
                                Trace-Progress -message "$functionName : child job- $($j.Name) errors = $errorMessage"
                            }
                        }

                        $j |ForEach-Object {Add-Content -Path $roleTimeLog -Value "$($_.Name), $($_.PSBeginTime), $($_.PSEndTime), $(($_.PSEndTime - $_.PSBeginTime).TotalMinutes)"}
                        $logCollectionPerfResult.Add($j.Name, ($j.PSEndTime - $j.PSBeginTime).TotalMinutes)
                        
                        $j | Remove-Job
                        Invoke-GarbageCollector
                        if ($j -in $jobArray)
                        {
                            Trace-Progress -Message "$functionName : Removing job [$($j.Name)] from job array"
                            $jobArray.Remove($j)
                        }
                    }
                }

                while(@(Get-Job -State Running).Count -ge $maxJobLimit) {
                    Trace-Progress -Message "$functionName : Running $maxJobLimit jobs already, waiting before starting next job"
                    Start-Sleep 10
                }

                # Background job that collects logs for each role
                $jobStatic = Start-Job -Scriptblock {
                    param($argumentsObject)
                    Trace-Progress -Message "$using:functionName : invoking script variables - using:PSScriptRoot = [$using:PSScriptRoot]"
                    Set-Location $using:PSScriptRoot
                    Trace-Progress -Message "$using:functionName : after set pwd, job pwd = [$pwd]"
                    $transcriptPath = "$using:OutputPath\RoleOutput\Get-Roles_Output_$using:role.log"
                    Start-Transcript -Path $transcriptPath -Verbose
                    Get-RoleLogs -argumentsObject $argumentsObject -role $using:role
                    Stop-Transcript
                } -Name $role -ArgumentList $argumentsObject `
                -InitializationScript $initblock

                $jobArray.Add($jobStatic)
                Trace-Progress -Message "$functionName : Started Get-RoleLogs for role $role"

            } #foreach ($role in $roleNames)
        }
        catch {
            Trace-Progress -Message "$functionName : Failed to kick off jobs"
        }
        Trace-Progress -Message "$functionName : Background jobs for all roles and resource providers kicked off in parallel"

        while($jobArray.Count -gt 0)
        {
            $completedJob = $jobArray | Wait-Job -Any -Timeout 30
            $jobToBeRemoved = $null
            if ($null -ne $completedJob)
            {
                # $completedJob will have exactly one job that completed.
                $jobToBeRemoved = $completedJob
            } else {
                # No job finished Continue to wait
                Trace-Progress -Message "$functionName : Waiting for $($jobArray.Count) jobs to finish.."

                # Check any job exceeded time
                foreach($j in $jobArray)
                {
                    #Check if any of the job has exceeded the timeout
                    if (($jobTime = ((Get-date) - $j.PSBeginTime).Totalseconds) -gt $maxJobTimeInSec )
                    {
                        #Time to terminate the job
                        Trace-Progress -Message "$functionName : job [$($j.Name)] exceeded maximum time for individual job [$jobTime] seconds - Terminating Job forcefully...." -Error
                        #TerminateJobAndCopyTempFilesToOutputPath -JobToTerminate $j -TempFolderPath $destPath -OutputPath $OutputPath -SharePath $DestinationSharePath -SasUri $OutputSasUri
                        $jobToBeRemoved = $j
                        break;
                    }
                }
            }

            if ($jobToBeRemoved)
            {
                $jobToBeRemoved | Stop-Job
                $jobToBeRemoved | Receive-Job
                Trace-Progress -Message "$functionName : job $($jobToBeRemoved.Name) completed with state = $($jobToBeRemoved.State)"
                if ($jobToBeRemoved.State -ne 'Completed') {
                    $errorMessage = $jobToBeRemoved.ChildJobs.JobStateInfo.Reason.Message
                    if($errorMessage) {
                        Trace-Progress -message "$functionName : child job errors = $errorMessage"
                    }
                }

                # Trace the time took by each job
                $jobToBeRemoved |ForEach-Object {Add-Content -Path $roleTimeLog -Value "$($_.Name), $($_.PSBeginTime), $($_.PSEndTime), $(($_.PSEndTime - $_.PSBeginTime).TotalMinutes)"}
                $logCollectionPerfResult.Add($jobToBeRemoved.Name, ($jobToBeRemoved.PSEndTime - $jobToBeRemoved.PSBeginTime).TotalMinutes)
                
                $jobToBeRemoved | Remove-Job
                Invoke-GarbageCollector
                if ($jobToBeRemoved -in $jobArray)
                {
                    Trace-Progress -Message "$functionName : Removing job [$($jobToBeRemoved.Name)] from job array"
                    $jobArray.Remove($jobToBeRemoved)           
                }
            }
        } #while($jobArray.Count -gt 0)

        Write-Output "`r"
        Trace-Progress -Message "$functionName : Logs placed at : $OutputPath on $env:ComputerName"
    }
    finally
    {
        $logCollectionCleanUpStartDate = Get-Date

        if($jobArray.Count -gt 0) {
            Trace-Progress -Message "$functionName : Termination event triggered - job array has $($jobArray.Count) jobs in progress"
            $jobArray | Stop-job 
            foreach($j in $jobArray) {
                Trace-Progress -Message "$functionName : processing $($j.Id) , $($j.Name) , $($j.State)"
            }
            Trace-Progress -Message "$functionName : terminated all jobs"
            Trace-Progress -Message "$functionName : Copying in progress files if any..."
        }

        $logCollectionPerfResult.Add("CleanUpTime", ((Get-Date) - $logCollectionCleanUpStartDate).TotalMinutes)
        $logCollectionPerfSortedResult = $logCollectionPerfResult.GetEnumerator() | Select-Object -Property Key,Value | Sort-Object -Property value -Descending
        $logCollectionPerfSortedResult | ConvertTo-Json | Set-Content "$OutputPath\Get-AzureStackLog_Performance.json"

        $LogCollectionUploadNumberOfFiles = ($telInventory | Measure-Object).Count
        $LogCollectionUploadFileSizeInMb = $telOutputSizeMb

        # dump current process metrics, we can compare at the end
        # Trace-InvokingProcessStats -Role "Main_End"
        if ($roleTimeLog -ne $null)
        {
            Show-RoleTime -roleTimesCsvFilePath $roleTimeLog
        }
        else
        {
            Trace-Progress "RoleTime CSV FilePath is null. Cannot show graph of time to collect logs for each role." 
        }
        
        Write-ErrorsIfExist -Role "MainLogCollection"        
        $logCollectionDuration = ($ToDate - $FromDate).Totalhours.ToString("0.0##")
        $logCollectionTime = ((Get-Date) - $logCollectionStartDate).TotalMinutes.ToString("0.0##")

        # Mandatory trace statements as output file is parsed by StampTools.psm1 in SupportBridge repo
        Trace-Progress -Message "$functionName : LogCollectionUploadFileSizeInMb : $LogCollectionUploadFileSizeInMb"
        Trace-Progress -Message "$functionName : LogCollectionUploadNumberOfFiles : $LogCollectionUploadNumberOfFiles"
        Trace-Progress -Message "$functionName : LogCollectionUploadDirectory : $OutputFolderName"
        Trace-Progress -Message "$functionName : logCollectionTime : $logCollectionTime"
        Trace-Progress -Message "$functionName : logCollectionDuration : $logCollectionDuration"

        $collectionDetails.logCollectionUploadFileSizeInMb = $LogCollectionUploadFileSizeInMb
        $collectionDetails.logCollectionUploadNumberOfFiles = $LogCollectionUploadNumberOfFiles
        $collectionDetails.outputFolderName = $OutputFolderName
        $collectionDetails.logCollectionTime = $logCollectionTime
        $collectionDetails.logCollectionDuration = $logCollectionDuration

        # This has to be the last line before the transcipt ends, other wise LogCollection BVT validation would fail.
        Trace-Progress "$functionName : Completed collecting information for all roles - Get-AzureStackLog_Output for [$logCollectionDuration] hours took [$logCollectionTime] minutes, followed up by copying out to assigned destination."

        # Transcript needs tobe stopped as move-item would fail moving get-azurestacklog.
        Stop-Transcript
        $totalTime = ((Get-Date) - $logCollectionStartDate).TotalMinutes.ToString("0.0##")
        Trace-Progress "$functionName : Log collection completed duration [$totalTime] minutes"
    }
}

Export-ModuleMember -Function Invoke-AzureStackLogCollection
# SIG # Begin signature block
# MIInkwYJKoZIhvcNAQcCoIInhDCCJ4ACAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDX3U++05rIxIAx
# Kjjv7NY64BaNDZUsjm5PSwtxJ7HLf6CCDXYwggX0MIID3KADAgECAhMzAAADTrU8
# 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
# /Xmfwb1tbWrJUnMTDXpQzTGCGXMwghlvAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIJ4PhuB7O9DcAIRPVn9RWP99
# N11Cm46ZbPbxvdwHSdu8MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAsggNmu2Vire75mVnIJ1CYL0EcFDKJBdQT7DsbmK5dVlw7IqUbnX9ArvP
# cF68kdNFQwtyx7OHgD6smCAvByBWht2cLcVD5lZ/rhxpF0mwWd7EwxPkA4mv8pjr
# HcyIpYh89hZczmchzK9XbRO1WuRiz5K65ylZBRi67ppn1vkqzVWVMw7qFFiazXiB
# RibHPGjO2DUSuai6DwXkP086km0of10Bz2MoNaQdT4yFyWAJfRkCdLkuN9x+XeiR
# BjeEFEmA0M6N4yhVLLJzdlmcAT0RzW+K2ukfK5JpZr2k7yj0V0RO5mVMrh1d164K
# pMaLyuPhGVTYNdPAZlMdAbR99PudO6GCFv0wghb5BgorBgEEAYI3AwMBMYIW6TCC
# FuUGCSqGSIb3DQEHAqCCFtYwghbSAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsq
# hkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDB0uUBoYrHM2LzxDj39Xw+ixDOsJCFzit+wt1WwzroOgIGZMl2ok/J
# GBMyMDIzMDgwMzA4MjIyNy4xODNaMASAAgH0oIHQpIHNMIHKMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l
# cmljYSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpERDhDLUUz
# MzctMkZBRTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCC
# EVQwggcMMIIE9KADAgECAhMzAAABxQPNzSGh9O85AAEAAAHFMA0GCSqGSIb3DQEB
# CwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTIyMTEwNDE5MDEz
# MloXDTI0MDIwMjE5MDEzMlowgcoxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo
# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y
# cG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMx
# JjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkREOEMtRTMzNy0yRkFFMSUwIwYDVQQD
# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF
# AAOCAg8AMIICCgKCAgEAq0hds70eX23J7pappaKXRhz+TT7JJ3OvVf3+N8fNpxRs
# 5jY4hEv3BV/w5EWXbZdO4m3xj01lTI/xDkq+ytjuiPe8xGXsZxDntv7L1EzMd5jI
# SqJ+eYu8kgV056mqs8dBo55xZPPPcxf5u19zn04aMQF5PXV/C4ZLSjFa9IFNcrib
# dOm3lGW1rQRFa2jUsup6gv634q5UwH09WGGu0z89RbtbyM55vmBgWV8ed6bZCZrc
# oYIjML8FRTvGlznqm6HtwZdXMwKHT3a/kLUSPiGAsrIgEzz7NpBpeOsgs9TrwyWT
# ZBNbBwyIACmQ34j+uR4et2hZk+NH49KhEJyYD2+dOIaDGB2EUNFSYcy1MkgtZt1e
# RqBB0m+YPYz7HjocPykKYNQZ7Tv+zglOffCiax1jOb0u6IYC5X1Jr8AwTcsaDyu3
# qAhx8cFQN9DDgiVZw+URFZ8oyoDk6sIV1nx5zZLy+hNtakePX9S7Y8n1qWfAjoXP
# E6K0/dbTw87EOJL/BlJGcKoFTytr0zPg/MNJSb6f2a/wDkXoGCGWJiQrGTxjOP+R
# 96/nIIG05eE1Lpky2FOdYMPB4DhW7tBdZautepTTuShmgn+GKER8AoA1gSSk1EC5
# ZX4cppVngJpblMBu8r/tChfHVdXviY6hDShHwQCmZqZebgSYHnHl4urE+4K6ZC8C
# AwEAAaOCATYwggEyMB0GA1UdDgQWBBRU6rs4v1mxNYG/rtpLwrVwek0FazAfBgNV
# HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o
# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU
# aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG
# CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz
# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV
# HRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IC
# AQCMqN58frMHOScciK+Cdnr6dK8fTsgQDeZ9bvQjCuxNIJZJ92+xpeKRCf3Xq47q
# dRykkKUnZC6dHhLwt1fhwyiy/LfdVQ9yf1hYZ/RpTS+z0hnaoK+P/IDAiUNm32NX
# LhDBu0P4Sb/uCV4jOuNUcmJhppBQgQVhFx/57JYk1LCdjIee//GrcfbkQtiYob9O
# a93DSjbsD1jqaicEnkclUN/mEm9ZsnCnA1+/OQDp/8Q4cPfH94LM4J6X0NtNBeVy
# wvWH0wuMaOJzHgDLCeJUkFE9HE8sBDVedmj6zPJAI+7ozLjYqw7i4RFbiStfWZSG
# jwt+lLJQZRWUCcT3aHYvTo1YWDZskohWg77w9fF2QbiO9DfnqoZ7QozHi7RiPpbj
# gkJMAhrhpeTf/at2e9+HYkKObUmgPArH1Wjivwm1d7PYWsarL7u5qZuk36Gb1mET
# S1oA2XX3+C3rgtzRohP89qZVf79lVvjmg34NtICK/pMk99SButghtipFSMQdbXUn
# S2oeLt9cKuv1MJu+gJ83qXTNkQ2QqhxtNRvbE9QqmqJQw5VW/4SZze1pPXxyOTO5
# yDq+iRIUubqeQzmUcCkiyNuCLHWh8OLCI5mIOC1iLtVDf2lw9eWropwu5SDJtT/Z
# wqIU1qb2U+NjkNcj1hbODBRELaTTWd91RJiUI9ncJkGg/jCCB3EwggVZoAMCAQIC
# EzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT
# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS
# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoX
# DTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0
# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh
# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC
# 0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VG
# Iwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP
# 2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/P
# XfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361
# VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwB
# Sru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9
# X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269e
# wvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDw
# wvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr
# 9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+e
# FnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAj
# BgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+n
# FV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEw
# PwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9j
# cy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3
# FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAf
# BgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBH
# hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNS
# b29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF
# BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0Nl
# ckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4Swf
# ZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTC
# j/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu
# 2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/
# GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3D
# YXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbO
# xnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqO
# Cb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I
# 6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0
# zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaM
# mdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNT
# TY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggLLMIICNAIBATCB+KGB0KSBzTCByjEL
# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWlj
# cm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBF
# U046REQ4Qy1FMzM3LTJGQUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w
# IFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVACEAGvYXZJK7cUo62+LvEYQEx7/noIGD
# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV
# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG
# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEF
# BQACBQDodUZdMCIYDzIwMjMwODAzMDUxNzE3WhgPMjAyMzA4MDQwNTE3MTdaMHQw
# OgYKKwYBBAGEWQoEATEsMCowCgIFAOh1Rl0CAQAwBwIBAAICEzUwBwIBAAICE0ww
# CgIFAOh2l90CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgC
# AQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQBKTscFwACZWmhx
# t/vYDBceSq7MGhGPlP93LNpL/4Tvu7aFhaLb4oq56JjAs+m5gprDZp5rsR7I2c/V
# Nifee8FGl4ZTQxNaUOniFHvDRlZcileUJ+wlrI+IDYMMJ+ntyO89gDDlDoYrD4xt
# pxgPuAq7dulCZbNcu4sGIDzf+BIn9TGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYT
# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU
# aW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABxQPNzSGh9O85AAEAAAHFMA0GCWCGSAFl
# AwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcN
# AQkEMSIEIGKMROq/S4PHrFTFeunXz0XxQVe14H9Mn18+uRXOMiT2MIH6BgsqhkiG
# 9w0BCRACLzGB6jCB5zCB5DCBvQQgGQGxkfYkd0wK+V09wO0sO+sm8gAMyj5EuKPq
# vNQ/fLEwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv
# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0
# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA
# AcUDzc0hofTvOQABAAABxTAiBCApuwtd51yvRC9/vbBHEwcTytISpRzdl8rlW0gA
# TXXDVTANBgkqhkiG9w0BAQsFAASCAgA7SjqAaNXwbA7Qf9+bkIAAset8PohBGdHR
# k39ufjVQYtdruh0Uy2dum2elyQki+YWQHYdKNBdbFN7bUOyl/Qy0yBRwdx+ptH5p
# bLRdl60wXuorB/LgVwFRFe8lw40Lex6Qqz9UMQwDj7Ni2k8lIacJj03VYe53mWa8
# d6gxfK1LuoNdJXY8o/9IZcK3uCRiC5xTTieTdAUsVUyBtuxPCVhjoLv/it1pbTf6
# J7pY0wRLvlmqhK0w+iz90Q411oaMrX5FkkjOrBmRhsmFFU517z4xpqV9oY4Ea12I
# XxPklfCdZr2JyTWQiR1jxvsgA38eWhFKem1hzdl3Z5k2zZXvSfluVc4RRcsrgH3B
# 2uhOoRHhAcQj46UVgU9QaIoBJKudoN1K5UGGcZSsU6b7hswoAABfktkHkU8FQ7uZ
# iZiUzhXrluAR7G26oDiTKqwvX7/J1RwSoWLDh3ZfhrHQQ8EhDlqDdXcnkpqH+COu
# /HYJ0UY73wiPXtzxH8faSRVNwgywByYSZleCAplaQrTo2+NHwKQbq8r8sTR9lLi1
# PWjlosBnwapFG3Alk7akMXBLNe3Cc7pnyDfDpTPtJQso0JYEqTpoV4Ve2Y1k7vxa
# jQ7Vyp5UdflqlDVaxYRcNfTPVC9kCCx2UU0Cvphjnrmb/+1MRtQUgzt2RWxy5h1H
# VucjGs9xyw==
# SIG # End signature block