Edge DX Agent Distribution and Installation for Windows
  • Dark
    Light
  • PDF

Edge DX Agent Distribution and Installation for Windows

  • Dark
    Light
  • PDF

See Edge DX Agent Distribution and Installation for general information regarding Edge DX Agent distribution and installation.

Click the arrow image.png to the right of Windows Agent Manager on the Downloads page to display information about the installation options for Windows.

Windows expand for additional details.png

Supported versions of Windows OS for Edge DX Agent Installation

The following versions of the Windows operating system are supported for installation of the Edge DX Agent:

  • Windows 7 SP1+ (x64)
  • Windows 10 Version 1607+ (x64)
  • Windows 11
  • Windows Server 2012 R2+ (x64)

Manual Installation of Edge DX Agent for Windows

To download and install the Edge DX Agent Manager and Agent on your Windows device:

  1. Click image.png Download for the Windows Agent Manager.

Click Download for Windows.png The Agent Manager Setup MSI file downloads.

Windows agent msi file.png

  1. Click the MSI file to run it on your device. The Agent Manager Setup wizard opens.

Edge DX Agent Manager Setup Wizard.png

Alternatively, you can distribute the MSI file to end-user devices, or automate installation as detailed in Edge DX Agent Distribution.

  1. Click Next.

Set up the Agent Manager by providing the Device Registration Code and the Tenant Name appearing on the Downloads page. The Device Registration Code along with the Tenant Name identify your device as belonging to the specified ControlUp Tenant.

  1. Enter the Tenant Name in the Agent Manager Setup wizard. Type the part of the Tenant Name which precedes .sip.controlup.com. In the example screenshot shown, that text is acme. Then click Test to test the Tenant connection.

acme Edge DX Agent Manager Setup Wizard.png

If the Tenant connection is successful, the next screen of the Agent Manager Setup wizard displays the confirmation- Successful Tenant connection!- and prompts you to enter your Device Registration Code.

  1. Click Copy to the right of the Device Registration Code on the Downloads page and paste the Device Registration Code in its field in the Agent Manager Setup wizard. Then click Check.

check device reg code Edge DX Agent Manager Setup Wizard.png

If the Device Registration Code check passes, the next screen of the Agent Manager Setup wizard displays the confirmation - Device Registration Code check passed! - and prompts you to click OK to continue and store the input values.

check passed device reg code Edge DX Agent Manager Setup.png

  1. Click OK.

The next screen of the Agent Manager Setup wizard displays the message – Installation Complete - and prompts you to click Close to exit.

installation complete Edge DX Agent Manager.png

  1. Click Close.

Command Line Installation of Edge DX Agent for Windows

The Agent Manager can be installed from the command line, using your Device Registration Code and Tenant Name from the Downloads page, as described in Edge DX Agent Distribution and Installation.

For example:

msiexec /i agentmanagersetup.msi /qn DEVREGCODE=<device registration code> TENANT=<tenant name> ALLUSERS=1

You can also specify PROXY= and GROUP= on the msiexec command to set a web proxy address and port number like 10.0.0.1:8080 and the Device Group.

In the command line installation, the device registration code and tenant name are not checked as they are in the manual installation, (see Manual Installation of Edge DX Agent for Windows) and will be stored as-is. Agents fail to connect if the registration code and tenant name are not correct.

Windows Image Cloning Installation of Edge DX Agent

Click the arrow image.png to the right of Windows Agent Manager on the Downloads page to display information about the Windows image cloning installation option for Windows.

To prepare a Windows image for cloning with Citrix PVS/MCS (or similar), use the ONLYSTARTONBOOT=1 option to cause the Agent Manager to download and install the correct version of the Edge DX Agent, but not to start it.

The Edge DX Agent will be set to "Automatic'' so that the service starts and registers on the first boot of the cloned image. The following is an example of the command line to use:

msiexec /i agentmanagersetup.msi /qn DEVREGCODE=<device registration code> TENANT=<tenant name>.sip.controlup.com ONLYSTARTONBOOT=1 ALLUSERS=1

Scripted Uninstall of Edge DX Agent for Windows

You can perform a scripted uninstall of the Edge DX agent for:

To perform a scripted uninstall of the Edge DX agent for Windows, use the PowerShell script below.

$Command = "c:\Windows\System32\msiexec.exe"

### to fully uninstall Agent Manager ###
$Params = "/x {2AE0BDC4-26B3-4352-81EA-F4811B5B9B60} /norestart /qn"
$ParamsArray = $Params.Split(" ")
& "$Command" $ParamsArray

### to fully uninstall SIP Agent ###
$Params = "/x {0EE8541E-2D9F-4382-820F-DE7B93F7ED53} /norestart /qn"
$ParamsArray = $Params.Split(" ")
& "$Command" $ParamsArray

Scripted Uninstall of the Edge DX Agent from All Windows Devices in Your Organization

To uninstall the Edge DX from all Windows devices in your organization, perform the following steps:

  1. Under Configuration > Scripts click Add Script. See the Edge DX Scripting Guide for more information.
  2. Schedule when the script should run. For example, you can select the System - Once Per Day trigger to run the script on each device in the next few minutes. See the Edge DX Scripting Guide - Script Triggers for more information.

Scripted Uninstall of the Edge DX Agent from One or More Specific Windows Devices in Your Organization

To uninstall the Edge DX from one or more specific Windows devices in your organization, run the script provided above as a Custom Action. See the Edge DX Scripting Guide - Custom Actions for more information.


Was this article helpful?