Skip Ribbon Commands
Skip to main content

Install the Device Management Agent on terminal servers

Last Update: 7/21/2017 11:35 AM
This article has been moved to our new Help Center. Please update your bookmarks.

​​​​This guide shows you how to install and configure the Device Management Agent​ (DMA) on a terminal server. After you complete the steps in this guide, the Agent will run at startup for all users of the terminal server and you can use it for additional services like DeploymentPro and HealthCheck for Office 365.

Contents of this guide:


 

Prerequisites

Complete these steps before you get started:

  1. Create th​e customer in MSPComplete. Read the Add customers topic for more information.
  2. Add the source and destination endpoints. Read the Add endpoints topic for more information.
  3. Download the customer's DMA setup file​. Read the Add users by deploying DMA topic for more information.

 

Install DMA on the terminal server

The first step is to copy the DMA setup file to the terminal server and then install it using the Install Application on Remote Desktop Server utility located in the Control Panel. Read the Learn How To Install Applications on an RD Session Host Server TechNet article for more information.

 

Add a DMA shortcut to the all users startup folder

Add a DMA shortcut to the all users startup folder for the terminal server, to ensure that the Agent runs at startup for all users.

Complete these steps:

  1. Open a File Explorer window and go to where the agent is installed on the terminal server, which should be C:\Program Files (x86)\BitTitan\DeviceManagementAgent
  2. In a separate File Explorer window, go to the all users startup folder, which should be C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
  3. Find the BitTitanDMAExecutor.exe file in the Agent install folder, and then hold the Shift+CTRL keys while you click and drag the file to the all users startup folder window.

 

Give all users access to the DMA installation folder

Give all users of the terminal server access to the DMA installation folder to ensure they are not blocked from running the Agent at startup.

Complete these steps:

  1. Open a File Explorer window and go to C:\Program Files (x86)
  2. Right-click the BitTitan folder, and then select Properties.
  3. Click the Security tab, and then click Edit.
  4. Click Add.
  5. Type Domain Users in the Object Name field, and click Check Names. The entry should resolve to Domain users (underlined).
  6. Click OK.
  7. Select Domain Users (Domain\Domain Users) in the Group list, and then add a checkmark under Allow and next to Full Control. This allows all users of the system to have full control of the BitTitan folder and its contents.
  8. Click OK to finish.

    dma_termserver_perms.png
    Important: You may need to allow UNC path access in your user lockdown Group Policy Object (GPO). You can allow UNC path access to users by disabling the “Remove Run menu from Start Menu” GPO. Read the Remove Run menu from Start Menu article from Microsoft for more information.

Next steps