9.1. System Queue

The System queue provides a status of all tasks run on device and the System log lists all the tasks run internally. These tasks are performed by a multi-thread task queue and the task status can be viewed to monitor progress.

The System queue is processed by a number of workers and the number of workers available will depend on the number of CPUs on your PxM Virtual Appliance.

When a worker is processing a task, if a task fails to acquire a task lock it is sent to the back of the queue. This happens when there is already another task for that device which is being processed on another queue.

By default, queues are restarted periodically to ensure they are never stuck.

The System queue is prioritised into the following queue prioritise:

  • High queue only deals with High priority tasks. The worker only pulls high priority task from the queue and ignores the others.
  • Medium/High queue deals with medium as well as high priority tasks. The worker pulls the next medium or high task from the queue and ignores the others.
  • Low/Medium/High queue deals with low, medium as well as high priority tasks. The worker pulls the next low, medium or high task from the queue.
  • Long queue only deals with Password refresh tasks. The worker will only pull tasks that are PasswordRefresh tasks and ignores the others.

To view the System queue page, click System queue in the left-hand menu.

WebUI System queue table

The following information is presented in the System queue:

Heading Description
Expansion icon Indicates a task description is available. Click the arrow to reveal the description.
Status

Status of the run task:

Success

Failed

Timestamp Is the Date and Time the task was executed.
Name Name of the task that was run.
Priority

In indicates the priority level set for the task to run.

The System Queue is a multi-threaded task queue and prioritises all tasks as High, Medium or Low.

Actioned by Indicates the user that initiated the task.
User Name of the user the task was run against, if applicable.
Device Name of the device the task was run on, if applicable.
Device template Name of the device template that was used to run the task, if applicable.
Profile Name of the profile the task belongs to, if applicable.

Note

Additional columns can be viewed by right-clicking on a table heading and selecting Columns from the context menu.

9.1.1. Quick queue

The quick queue gives you quick access to the system queue beneath any page on the Web Management Interface.

To enable the quick queue:

  1. On the left-hand menu, to the right of System queue, click the Quick queue iconToggle quick queue icon.

    The system queue table will now appear at the bottom of any page viewed.

    WebUI Quick queue table

  2. For the quick queue to automatically update every 10 seconds, ensure that the Quick queue auto-refresh checkbox is selected.

    Note

    Alternatively, press CTRL+ALT+Q to refresh the quick queue table at any time.

  3. To close the quick queue, click the Quick queue iconTogge quick queue icon again.

9.1.2. System log

The System log button at the top of the System queue page provides a rolling report of the system task log.

9.1.2.1. Task descriptions

Click the blue arrow Expansion icon at the start of the row to see a brief explanation of the task or the reason for failed tasks. Not all tasks in the System queue will have a description available.

WebUI System queue expanded record

9.1.3. Log files

Log files are available for each individual user task to help troubleshoot failed tasks. To view the log file of a task, right-click an individual task and select View log. The log file for the task opens.

WebUI Log viewer window

  • To filter the log file, click the Level drop-down and select the information you want displayed.
  • To save the log file, either:
    • Press CTRL+C to copy the information displayed on the log file, or
    • Click the Download button.