System Diagnostics

From Userful Support
< Docs(Redirected from Manuals/System Diagnostics)
Jump to navigationJump to search

Copyright © 2021 Userful Corporation. All rights reserved.
(Updated 2021.02.10)

To return to the main documentation page, Click Here.

Note: This page has been updated in our new Support Portal - try it here!


System Diagnostics is a great way to check the system performance. This tool reports CPU and memory performance on all displays and helps administrators to identify and analyze the problem in the event of system malfunction. If there is any problem you will see one or more notifications on the top right corner of Control Center. You can either close these notifications, learn more about the issue or take an action to resolve the issue.

This document highlights various diagnostics checks performed on the system running Userful™ software appliance.


Licensing notification provides the status of system licensing. It specifies the licensing information including the number of licensed displays. For more information about licensing, visit Licensing page.

Maintenance and Support Status

This notification provides status of Maintenance and Support Contract for your Userful server. For more information please contact your Userful Sales Representative, or visit Maintenance and Support Renewal FAQs.

Reboot Recommended

For optimal performance, it is recommended to reboot the Userful server after updating it. Clicking on the "Resolve" link will bring up a confirmation dialog and once confirmed system will reboot.

Userful Host Hardware

Userful™ software appliance installs checks if the Userful server's hardware is adequate for optimal performance and better user experience. The system runs various tests on the Userful server including:

Host CPU

For optimal performance, minimum 4 CPU cores are required. This is to provide enough CPU power to render the content.

Host GPU

For optimal performance, an Intel 4th generation (or better) GPU is required. This is to render and decode the content. BIOS of the Userful server must be configured to enable Intel® Integrated GPU.
Under the system BIOS go to Advanced > Built-in Device Options > VGA Boot Device, and select Intel VGA Controller (Integrated) from the available options.
Please note that HP EliteDesk system is considered as an example to quote these settings.

If there is no Intel GPU in the system:

  • Onboard display will not be visual
  • Session Acceleration through Intel GPU will not be possible
  • Intel GPU will not be accessible for offloading
Host RAM

A minimum of 8 GB RAM is recommended for the Userful server.

Hard Disk Space

Minimum of 5 GB disk space is recommended for installing the OS and sample content. However, for large media files, large disk space is recommended.

Secure Boot

This notification shows an error if Secure Boot is enabled in the BIOS of Userful Server. This will disrupt the normal functioning of the Userful server.
For further instructions on disabling Secure Boot please visit How to change BIOS settings.


Display Network

This check ensures all the receiver devices are running at full speed i.e. 1000Mbps.

Network Latency

This notification ensures that the Userful server is connected to a gigabit ethernet connection to make sure that network doesn’t become bottleneck while pushing the content to the displays.

Network DHCP Status

By default, all receiver devices and the Userful server gets the IP address from DHCP server. If there are more than one DHCP servers in the network there might a conflict and this notification appears. If you see the Duplicate DHCP server error; ensure that there is only one active DHCP server in the network.

Network IP Conflicts

If there are two receiver devices with same IP Address, the system will show "Duplicate IP Address Detected" notification. If you are using DHCP server to assign an IP address to the receiver device, restarting the device should fix the problem. If you have assigned the IP address manually, assign the correct IP Address from Control Center > Displays.

Network Bandwidth

This check ensures that the network bandwidth usage is below the threshold value for better system performance, this notification will appear if it goes beyond the threshold value.

Isolated Network

This check notifies the users to disconnect any devices other then receiver devices if any detected in the Isolated Network.

Userful TURN Server

This notification shows an error if Userful TURN server ( port number 3478 is blocked. This may cause issues while uploading files and accessing webcams via Userful Cloud.

Zero Client Health

To fix this error notification, simply power cycle the faulty receiver device.

Software Update Congruency

This notification ensures that the ISO includes all the latest packages and is synced with the Userful live server. Please contact your Userful Sales Representative if you see this notification on the top right corner of Control Center.

Unsupported Devices

USB Hubs/Devices

When a receiver device has an unsupported device (e.g., devices with built-in USB hubs i.e. multimedia keyboards, monitors, etc.) attached to it, this notification shows an "Unsupported Device Attached" error. Remove the offending device(s) connected to the receiver device until the error message disappears.

Extra Signage Player Codecs

Userful software requires some codecs to support a wide range of video and image formats to play signage content. This check will notify users if respective codecs are not installed. Clicking on the "Resolve" link will download the required codecs.
Please refer to Control Center > Settings > System Updates and Extra Packages for more details.

Userful Cloud

Userful Cloud Registration Status

This notification provides registration status for Userful server. Clicking on the "Resolve" link will give you a claim code that can be used to proceed with the registration process.

Userful Cloud Subscription Status

This notification provides cloud subscription status for Userful server, if the subscription contract has expired or about to expire.

Blackmagic Capture Card Firmware Status

This notification checks if the Blackmagic Capture Card firmware is up-to-date or not. For more details on how to update the firmware please visit Configure Blackmagic Firmware Updater or FAQ to update the Blackmagic capture card firmware.

Note: The Virtual Machines (VDI) related diagnostics mentioned below will only appear on Userful v9.7 or the prior versions of Userful software

Virtual Machines (VDI)

These notifications ensure that preliminary requirements for using Virtual Machine (VDI) source are fulfilled.

Hardware Virtualization

For creating Virtual Machine (VDI) source, BIOS of the Userful host must be configured to enable Hardware Virtualization CPU setting.
Under the system BIOS go to Advanced > System Options tab, check the Virtualization Technology(VTx) check box and save the settings. (Please note that HP EliteDesk system is considered as an example to quote these settings).

VDI Setup

This notification ensures that VirtualBox Extension Pack (VDI) is installed through Control Center > Settings > Check for Available Packages for using Virtual Machine (VDI) source.

Related Links