Install Desktop Agent Manually
Follow the steps below to install the UXM Desktop Agent, software can be downloaded from here: Download Agent Software.
If using MSI installer: Please note that old EXE installer have to be uninstalled first, there is no migration path from EXE to MSI installer, the MSI installer is mainly used for new customers that haven't deployed the EXE installer via SCCM.
Prerequisities
Installing the Desktop Agent
- Launch the installer
Agent Key: Enter agent key provided, can also be found under Administration -> "Configure UXM" in the UXM app.
Collector: Enter the IP or DNS of the UXM collector, a valid HTTPs certificate is required on the collector if you want to use HTTPs.
For SaaS solutions use https://customername.uxmapp.comVerify HTTPs certificate: Can be de-selected if server is running On-Premise with invalid HTTPs certificate, custom ca-certificates.crt file might need to be deployed to support custom On-Premise certificates.
Proxy settings: Proxy settings is by default automatically detected from the local users IE settings, you can choose to force a proxy server by entering the details manually if the automatic detection fails.
- Select plugins to activate
The Desktop Agent can monitor different types of applications via plugins, select the ones you want to use:
- Desktop UI monitoring:
Desktop client programs like Outlook, Word, Excel can be monitored via Windows Automation UI, please note that this requires XML Profiles to be created with information about events that starts/stops the measurements.
- Chrome / Firefox:
A browser plugin is installed that injects the Web agent javascript into selected websites that you want to monitor, is used for monitoring SaaS websites like ServiceNow and Timelog where the Web agent can't be installed because you don't own the server.
Please note that users will get a warning and have to accept the plugins the first time they start Chrome or Firefox.
- Desktop UI monitoring:
- Browser extension/addon activation
Select "Force browser extension/addon activation" to avoid that users is asked if they wan't to activate the browser extension/addon.
You can skip this if you activate the extension/addon via Group Policies:
Distribute UXM Web Chrome extension to nodes
Distribute UXM Web Firefox addon to nodes
- Enter destination where agent should be installed.
- Click install and you are done, a new service is created called “UXM Desktop Agent”.
This service monitors PC resources, communicates with the UXM Controller and launches a process called PCAgentUI.exe for each user session on the PC. (For monitoring clicks and events inside monitored programs)
Troubleshooting issues
Log files are stored under %PROGRAMDATA%\MCG\UXM PC Agent\Logs, we will need these if there are any issues with the agent.
It can also be nessesary to enable debug logging, this is done by editing the files C:\Program Files\MCG\UXM Desktop Agent\PCAgent.properties and C:\Program Files\MCG\UXM Desktop Agent\PCAgentUI.properties and setting the level to debug, a restart of the UXM Desktop Agent services is needed afterwards.
