For the complete documentation index, see llms.txt. This page is also available as Markdown.
Support

Device status

This section discusses the available device status in VHQ.

Keywords

Also called: device state, status values. Search terms: active, inactive, pending registration, pending hierarchy assignment, deleted, blacklisted.

What are device statuses?

You can manually change a device's status from the Device Search screen or Device Profile. Select the checkbox for the device serial number, then, on the Actions window, select the status to assign. You can view a device's status in the Device Status column of the Device Search screen, and filter by it.

Status values

  • Pending Registration: The device is not registered with the server. Pre-boarded devices default to this status. It can't be changed manually — you can only delete or blacklist the device.

  • Pending Hierarchy Assignment: The device was not successfully assigned to a hierarchy after registration — for example, if the hierarchy doesn't match or wasn't assigned during the key exchange process, though the device may still be in Active status. You can manually change active devices to Inactive or Pending Hierarchy Assignment status, or delete or blacklist them.

  • Active: The device is successfully registered, assigned to a hierarchy, and in use. It reaches Active status once the key exchange succeeds. You can manually change it to Inactive, Pending Registration, Delete, or Blacklist.

  • Inactive: The device is disabled — physically present in the system but not in active mode. You can manually change it to Active, Pending Registration, Delete, or Blacklist.

  • Deleted: The device has been deleted. You can manually undelete it, which restores its previous status.

  • Blacklisted: The device is blacklisted. This status cannot be changed.

A device in VHQ must be in the Active or Pending Hierarchy Assignment state to perform device operations, such as downloading a package from the VHQ server to the device or uploading diagnostic information from the device to the VHQ server.

Was this helpful?