Using the Desktop Session Manager
The APA Desktop Session Manager (DSM) enables the Real-Time Client to use the keyboard and mouse emulators even when a VMWare/Remote Desktop Session is disconnected. This allows unattended robotic automation workflows to continue to execute keystrokes and mouse clicks.
The Desktop Session Manager moves the session to the console session (also known as session 0) and can only be used for single sessions running on Windows Desktop (32- or 64-bit) and not on Windows Server. Citrix deployments are not supported.
You cannot log out of Windows while the Desktop Session Manager is running locally.
You can pause or exit the Desktop Session Manager using the right-click options on the Desktop Session Manager icon in the Windows system tray.
When using the Desktop Session Manager on a remote session, you need to reconnect to the console session.
To use the desktop session manager:
| 1. | On the Remote Desktop Session, run DSM.exe. |
| 2. | The application runs and appears in the Windows system tray. |
| 3. | To pause the Desktop Session Manager, right-click the icon in the system tray and click Pause. |
| 4. | To exit the Desktop Session Manager, right-click the icon and click Pause. |
Logging In to a Remote Session Running DSM
To reconnect to a remote machine running Desktop Session Manager, you must have admin privileges and must connect to the console session on the machine.
To log in to the remote session:
Run the mstsc/admin command.
Viewing the Desktop Session Manager Logs
The Desktop Session Manager has its own log file, which is cleaned out when you restart the Desktop Session Manager. The process ID is recorded in the log.
To view the logs:
| 1. | On the Remote Desktop Session, navigate to %appdata%\Nice_Systems\DSM. |
| 2. | Open the DSM.log file. |
2018-08-02 14:01:14,197 INFO DSM Started!
2018-08-02 14:01:14,210 INFO Session state notify, new state: Connected
2018-08-02 14:01:14,211 INFO DSM is running elevated
2018-08-02 14:01:14,219 INFO DSM Init - OK, Pid: 11320, isX64: True
2018-08-02 14:26:32,671 INFO DSM Paused!
2018-08-02 14:26:39,816 INFO Session state notify, new state: Locked
2018-08-02 14:27:21,684 INFO Session state notify, new state: Connected
Troubleshooting Desktop Session Manager
To reconnect to a machine running Desktop Session Manager, you must have admin privileges and must connect to the console session on the machine.
