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
    Trace-Progress "UtcDateTime format before format conversion is $($UtcdateTime.ToString())"
    $formattedDateTime = $UtcdateTime.ToString("yyyy/MM/dd HH:mm:ss")
    Trace-Progress "UtcDateTime format after format conversion is $formattedDateTime"

    return [System.TimeZoneInfo]::ConvertTimeFromUtc($formattedDateTime, (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','Script')]
        [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 savings logs to an output path / share path
        [Parameter(Mandatory=$false)]
        [bool]
        $SaveToPathSelected = $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 = "DiagLogs-" + ((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

    Trace-Progress "Fromdate in UTC is $FromDate and ToDate in UTC is $ToDate"
    Trace-Progress "The local time zone is $(Get-Timezone)"

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

    Trace-Progress "After conversion to the local timezone, FromDate is $FromDate and ToDate is $ToDate"

    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 ((Get-ItemProperty -Path "HKLM:\Software\Microsoft\ArcA\" -ErrorAction SilentlyContinue).IsArcAEnv) {
        $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 "saveToPathSelected" -Value $SaveToPathSelected

    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', 'Script')

            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
# MIIoQwYJKoZIhvcNAQcCoIIoNDCCKDACAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAVSe/NNxNH9tQW
# uNsd0QFYuMjNqY87Dc+MDl2WZp4ENKCCDXYwggX0MIID3KADAgECAhMzAAADrzBA
# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA
# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG
# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN
# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL
# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB
# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd
# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ
# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY
# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp
# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn
# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT
# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG
# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O
# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk
# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx
# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt
# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# 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
# /Xmfwb1tbWrJUnMTDXpQzTGCGiMwghofAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIAQaCpajxIL1TYg9yKGzf9oj
# DfylmBeyGlcdccXwm9R/MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAVB4DfbgSoQOX396+r72maGkq4yx14LUtu96WD4eLnd290GWTfgrX97XB
# U2f48rmDPkAfcrr9UpWOBGtj3Soz3X4vKAorYlXchA/J9XQRcN9u+ad+lNZcwRiM
# hFNMht6UraahBXToFre86MRC1YW7Jz1KhwD3ZFuK5E3Pk1/t0TVA+QXsELL8iA60
# 43ClhUmfKIayxG8iQEzXo4g/oMbELi1H7Pk6EGJRf3DlJVEhg0N7lVyTOEzr1VBW
# ekfm7Uak6AUhGXUygUeGduO/odzU/yTg9TqfVlwd1gbZMPH9DpWT/GBpRxH/nZ3S
# qMuSpmb2WUYVS+57TUb5tPIgBZDq1aGCF60wghepBgorBgEEAYI3AwMBMYIXmTCC
# F5UGCSqGSIb3DQEHAqCCF4YwgheCAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsq
# hkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCAA9IXTTp9PAqCfi0p48Xx915NRXnsc59moNz18AjB0egIGZut2j7hj
# GBMyMDI0MTAwOTAxMTIzNi43ODJaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT
# Tjo2NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
# U2VydmljZaCCEfswggcoMIIFEKADAgECAhMzAAAB9ZkJlLzxxlCMAAEAAAH1MA0G
# CSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u
# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp
# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI0
# MDcyNTE4MzEwMVoXDTI1MTAyMjE4MzEwMVowgdMxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9w
# ZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjY1MUEt
# MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAzO90cFQTWd/WP84IT7JM
# IW1fQL61sdfgmhlfT0nvYEb2kvkNF073ZwjveuSWot387LjE0TCiG93e6I0HzIFQ
# BnbxGP/WPBUirFq7WE5RAsuhNfYUL+PIb9jJq3CwWxICfw5t/pTyIOHjKvo1lQOT
# WZypir/psZwEE7y2uWAPbZJTFrKen5R73x2Hbxy4eW1DcmXjym2wFWv10sBH40aj
# Jfe+OkwcTdoYrY3KkpN/RQSjeycK0bhjo0CGYIYa+ZMAao0SNR/R1J1Y6sLkiCJO
# 3aQrbS1Sz7l+/qJgy8fyEZMND5Ms7C0sEaOvoBHiWSpTM4vc0xDLCmc6PGv03CtW
# u2KiyqrL8BAB1EYyOShI3IT79arDIDrL+de91FfjmSbBY5j+HvS0l3dXkjP3Hon8
# b74lWwikF0rzErF0n3khVAusx7Sm1oGG+06hz9XAy3Wou+T6Se6oa5LDiQgPTfWR
# /j9FNk8Ju06oSfTh6c03V0ulla0Iwy+HzUl+WmYxFLU0PiaXsmgudNwVqn51zr+B
# i3XPJ85wWuy6GGT7nBDmXNzTNkzK98DBQjTOabQXUZ884Yb9DFNcigmeVTYkyUXZ
# 6hscd8Nyq45A3D3bk+nXnsogK1Z7zZj6XbGft7xgOYvveU6p0+frthbF7MXv+i5q
# cD9HfFmOq4VYHevVesYb6P0CAwEAAaOCAUkwggFFMB0GA1UdDgQWBBRV4Hxb9Uo0
# oHDwJZJe22ixe2B1ATAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBf
# BgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
# L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmww
# bAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29m
# dC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El
# MjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF
# BwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAcwxmVPaA9xHf
# fuom0TOSp2hspuf1G0cHW/KXHAuhnpW8/Svlq5j9aKI/8/G6fGIQMr0zlpau8jy8
# 3I4zclGdJjl5S02SxDlUKawtWvgf7ida06PgjeQM1eX4Lut4bbPfT0FEp77G76hh
# ysXxTJNHv5y+fwThUeiiclihZwqcZMpa46m+oV6igTU6I0EnneotMqFs0Q3zHgVV
# r4WXjnG2Bcnkip42edyg/9iXczqTBrEkvTz0UlltpFGaQnLzq+No8VEgq0UG7W1E
# LZGhmmxFmHABwTT6sPJFV68DfLoC0iB9Qbb9VZ8mvbTV5JtISBklTuVAlEkzXi9L
# IjNmx+kndBfKP8dxG/xbRXptQDQDaCsS6ogLkwLgH6zSs+ul9WmzI0F8zImbhnZh
# UziIHheFo4H+ZoojPYcgTK6/3bkSbOabmQFf95B8B6e5WqXbS5s9OdMdUlW1gTI1
# r5u+WAwH2KG7dxneoTbf/jYl3TUtP7AHpyck2c0nun/Q0Cycpa9QUH/Dy01k6tQo
# mNXGjivg2/BGcgZJ0Hw8C6KVelEJ31xLoE21m9+NEgSKCRoFE1Lkma31SyIaynbd
# YEb8sOlZynMdm8yPldDwuF54vJiEArjrcDNXe6BobZUiTWSKvv1DJadR1SUCO/Od
# 21GgU+hZqu+dKgjKAYdeTIvi9R2rtLYwggdxMIIFWaADAgECAhMzAAAAFcXna54C
# m0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE
# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z
# b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp
# Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMy
# MjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0B
# AQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51
# yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY
# 6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9
# cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN
# 7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDua
# Rr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74
# kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2
# K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5
# TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZk
# i1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q
# BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3Pmri
# Lq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUC
# BBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJl
# pxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIB
# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9y
# eS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUA
# YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU
# 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny
# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw
# MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w
# Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/yp
# b+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulm
# ZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM
# 9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECW
# OKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4
# FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3Uw
# xTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPX
# fx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVX
# VAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGC
# onsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU
# 5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG
# ahC0HVUzWLOhcGbyoYIDVjCCAj4CAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT
# Tjo2NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
# U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAJsAKu48NbR5YRg3WSBQCyjzdkvaggYMw
# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD
# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsF
# AAIFAOqwUeQwIhgPMjAyNDEwMDkwMDUwNDRaGA8yMDI0MTAxMDAwNTA0NFowdDA6
# BgorBgEEAYRZCgQBMSwwKjAKAgUA6rBR5AIBADAHAgEAAgIOhTAHAgEAAgITwTAK
# AgUA6rGjZAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB
# AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQAJCtpQok5gNhr/
# 3BretEVozs+JqvKrhe90FGNFDi7Yowz/28j90UbKDW0Ki+Vj96fIsxaYRN/EfYhv
# wU98O/ZmqzmEjEHvtrFsWrhGvVClAi9wEdBFSBXPO+hjA/vcU1h2Bndj24avVPka
# j0FnRlumQ+EX0ocSZk4pT/eR7WSSCrYgR3HTqIuK6mtmFmCCJaRP+EM1FBGEYlca
# eE+GFW59EtgpYiERC8M7QlFGS6spyNDN3aGyEcjflJvntSZZwXJ0dR57wYXayEfU
# hW69VdFFZZ/tTOIs/XdEPAcKlK/7kqRMyDodozqAQ+Vc7n9viCXjeBurCZpabISD
# dP5fGgRZMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh
# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD
# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw
# MTACEzMAAAH1mQmUvPHGUIwAAQAAAfUwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG
# SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgtRUA9iwrnEwI
# zCDl6iMhlJNNymm5Sgsf9jEUPVTAHVEwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk
# MIG9BCDB1vLSFwh09ISu4kdEv4/tg9eR1Yk8w5x7j5GThqaPNTCBmDCBgKR+MHwx
# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt
# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB9ZkJlLzxxlCMAAEAAAH1
# MCIEIKf/5A9AaYqlqP/XkrB9l4SDMDQm6iu5RDMTRsTa9Tt6MA0GCSqGSIb3DQEB
# CwUABIICAIWI+9OK/DgJplvuRIk0iupDR4/j+DcfOEPq/gGDHSFcNEcyoaGQJLvf
# 9A/szbRCSeJi2Qyr67MIglYEudfbgRMWv3+yvAW3qHhzMjixy8HnWovDTXS7rGpf
# hZDyJ9PFsViNU+0n9vAiphxoauDT5sbacptA7pokgo28oY+MAbyY0oSQcyVI7ZEL
# Fsf/hHLfFX6beFDbC5t96ZP+vMclsb+mO5bn9F7ydGDLEQ7RF2w0fUziEdPtNxHb
# KVs6y0UX/nnIOSpzhtyv6Hcj0uzFO0uKO+oSHjQmpKxJJbVk6M3TlCNX1yZkDC3F
# 78xqzT3AkuhokdtFHe7hTKZLbnb+41pxYjsB/mRTk9SNmyqpA2ZDs9+UqxlQDsW5
# Wzx9dbHYTYmVJZL32a0ePNN3CuUkw50h8xPnBw8aascpotcEDcIfWWUfzHkgurmd
# qGXGmRqogPc1BExyM/IRjPo1gXPf2liYi40qr+IxePZyCstU3pY28BfBLjbsDSwH
# 2Zk3N3C73vXU3a7Urm3kbzN75EAC9lBff/UW+FxCbJi9PpiOcfOwSUZMiYba7AwU
# sY54z0XM9kH/2KrBmnoP5/5mHqpU9KoP4F0ObKD2kXWGAAqRi2mFKaL+S8QtFY68
# IJisv63+S886n70k9qMOA1c005ehooQ0zijUhAX2ya/piZ9gaJ7h
# SIG # End signature block