Installation

Target Host Requirements

QMS Desktop Utility requirements include the following.

  • .NET 4.8 (Full Installation)

Installing the Desktop Utility Locally

To install the QMS Desktop Utility, complete the following steps.

  1. Find and run the QMS DesktopUtilitySetup.exe program.

  2. The Welcome page will display. Click Next to proceed with installation or Cancel to exit.

  3. The End-User License Agreement page will display. If you accept the terms, check the I accept the terms in the License Agreement checkbox and click Next to proceed with installation or Cancel to exit.

  4. The Configure Data Service Host Address page will display. Enter the Hostname or the IP Address of the QMS Data Service. If the QMS Server has been configured to use Windows Authentication for user credentials, check the Use Windows Authentication checkbox. If the QMS Server has been configured to use SSL for the QMS Client website, check the Use SSL checkbox. If the QMS Server has been configured to use SSL for the Reat-time Updates (Agent State Service), check the Use SSL on AgentStateService checkbox. Click Next to proceed with installation or Cancel to exit.

  5. The Destination Folder view will display. Accept the default installation folder, manually type in a different folder, or click the Change… button to select a different folder. Click Next to proceed with installation or Cancel to exit.

  6. The Ready to install Enghouse Interactive QMS Desktop Utility page will display. Click Install to complete the installation or Cancel to exit.

  7. The Installing Enghouse Interactive QMS Desktop Utility page will display. A status bar will indicate the progress of the installation.

  8. When the installation completes, the Completed… page will display. Click Finish to close the installer.

Installing the Desktop Utility Remotely

It is recommended that the customer have a software deployment system or strategy in place to avoid having to manually install the QMS Desktop Utiity on each desktop. Installation can also be scripted using msiexec.exe as long as the target computers already have the necessary prerequisites installed (.NET 4.8 Full). The command for scripting is as follows:

msiexec.exe /i QMSDesktopUtilitySetup.msi REBOOT=ReallySuppress /qn SERVER=<server> ENABLENTLM=<ntlm> ENABLESSL=<ssl> ENABLESSLONASSERV=<sslonasserv>

Where <server> must be replaced by the address of the QMS Data Service.

Where <ntlm> is 1 if enabling Windows Authentication or 0 otherwise

Where <ssl> is 1 if enabling SSL or 0 otherwise

Where <sslonasserv> is 1 if enabling SSL on the AgentStateService or 0 otherwise

Licensing QMS Users for the Desktop Utility

On the QMS Server, complete the following steps:

  1. Log into the QMS web client as a user that has Edit User privileges.

  2. Click the Administration tab.

  3. Click the Users link.

  4. Select a user that will need Desktop Utility access and click the Edit icon.

  5. Under Licenses, check the box for Desktop Utility.

  6. Click Save.

  7. Repeat steps 4-6 for any additional users that need Desktop Utility access.

If more than one user needs access to the Desktop Utility, it is possible to select multiple users and click the Multi-User Edit button to add a Desktop Utility license to all selected users.