Hardware Admin Manual

Document: 271.01F — Qmatic

Copyright Notice

The information in this document is subject to change without prior notice and does not represent a commitment on the part of Q-MATIC AB. All efforts have been made to ensure the accuracy of this manual, but Q-MATIC AB cannot assume any responsibility for any errors and their consequences. This manual is copyrighted and all rights are reserved. Reproduction is not allowed without written permission from Q-MATIC AB.

COPYRIGHT © Q-MATIC AB, 2025. Feedback and questions: documentation@qmatic.com.

1. What’s New

2. Introduction

2.1 About Hardware Admin

Hardware Admin is an application for monitoring the status of hardware devices and remotely accessing logs from Qmatic Certified Hardware apps.

Main Features

• View all devices in a branch and see their status (connected/disconnected), update time, app version, and device IP.
• Access logs from Qmatic Display and Qmatic Kiosk devices.

2.2 System Requirements

• For on-premises systems: Orchestra 7 or later.

2.3 Installation

1. Copy certifiedHardwareAdmin.war to <Orchestra_install_dir>\system\custdeploy.
2. Copy certifiedHardwareAdminMessages.properties to <Orchestra_install_dir>\system\conf\lang.
3. Add the following lines to applicationMessages.properties:

   application.certifiedHardwareAdmin = Hardware Admin
   application.certifiedHardwareAdmin.description = Get logs from Certified Hardware applications and see the connectivity of hardware devices.
   module.certifiedHardwareAdmin = Hardware Admin

4. Execute the following queries against the qp_central database:

   PostgreSQL:

   INSERT INTO applications
     (id,branch_app,is_distributed,enabled,icon_url,url,version,view_index)
     VALUES ('certifiedHardwareAdmin', true, false, 1, NULL, 'certifiedHardwareAdmin', 1, 101);
   
   INSERT INTO application_modules
     (id,is_distributed,enabled,icon_url,privilege_level,url,view_index,application_id)
     VALUES ('certifiedHardwareAdmin', 0, 0, NULL, 20, NULL, 0, 'certifiedHardwareAdmin');

   MS SQL:

   INSERT INTO applications
     (id, branch_app, is_distributed, enabled, icon_url, url, version, view_index)
     VALUES ('certifiedHardwareAdmin', 1, 0, 1, NULL, 'certifiedHardwareAdmin', 1, 101);
   
   INSERT INTO application_modules
     (id, is_distributed, enabled, icon_url, privilege_level, url, view_index, application_id)
     VALUES ('certifiedHardwareAdmin', 0, 0, NULL, 20, NULL, 0, 'certifiedHardwareAdmin');

   Oracle:

   INSERT INTO applications
     (id, branch_app, is_distributed, enabled, icon_url, url, version, view_index)
     VALUES('certifiedHardwareAdmin', 1, 0, 1, NULL, 'certifiedHardwareAdmin', 1, 101);
   
   INSERT INTO application_modules
     (id, is_distributed, enabled, icon_url, privilege_level, url, view_index, application_id)
     VALUES ('certifiedHardwareAdmin', 0, 0, NULL, 20, NULL, 0, 'certifiedHardwareAdmin');

5. Restart Orchestra Central.
6. Set up roles and access rights (see section 2.4).
7. Add the Hardware Admin unit type to the required operation profiles.

2.4 Access Rights

Users of Hardware Admin must be assigned to a role with the following access modules:

• Hardware Admin
• Connector Administration
• Connector EntryPoint

3. Using Hardware Admin

3.1 Overview

Click the Hardware Admin icon on the Orchestra home page to open the application. You are directed to the Certified Hardware tab, which lists Certified Hardware devices. Select a branch from the dropdown (type to filter by name), then click Show to load the device list.

The device list is based on the unit types added in Business Configuration. By default, the list shows entry point devices. Click Displays to switch to the display device list. The following information is shown per device:

3.2 Monitor Status of Qmatic Hardware

Go to the Qmatic Hardware tab to monitor the connectivity status of Intro kiosks (printers), Hubs, and Device Controllers. Select a branch from the dropdown and click Show. The list is based on unit types added in Business Configuration and updates every 60 seconds from the stat database. Columns shown:

3.3 Retrieve Logs

View and export logs from Certified Hardware devices:

1. In Certified Hardware Admin, find the device in the device list.
2. In the Action column, click Open menu and select View logs.
3. To download a log file, click Export. The log is exported as a .txt file.

3.4 Prevent Users from Opening Device Settings

To prevent users from accessing the Settings page on devices, disable the device navigation bar.

1. In Certified Hardware Admin, locate the device in the device list.
2. In the Action column, click Open menu and select Settings.
3. Turn off Enable device navigation bar and let users access settings.

Q-MATIC AB, Box 198, SE-431 23 Mölndal, Sweden. Phone: +46 31 756 46 00. Email: info@qmatic.com. Web: www.qmatic.com