Agent Installation Overview

To monitor physical devices, you need to install the Edge DX Agent onto the devices.

Network Requirements

Devices with the Edge DX Agent installed need to have TCP 443 / SSL outbound connectivity to:

• https://[tenant-name].sip.controlup.com
• https://downloads.sip.controlup.com

You can find your tenant name by going to Settings > Downloads

Agent Whitelisting

Whitelist the following directory in your antivirus software - C:\Program Files\Avacee\sip_agent\

If you use SSL inspection, then you must disable SSL inspection for your Edge DX tenant URL https://[tenant-name].sip.controlup.com. The Edge DX Agent is not able to communicate with your tenant if SSL inspection is enabled.

Download and Install the Edge DX Agent

To download the Edge DX Agent for your OS, go to the Agent Downloads page.

If you access Edge DX using ControlUp's DEX management platform (app.controlup.com), click on the Device icon and go to Configuration > Downloads.

If you access Edge DX using Solve (solve.controlup.com) or by direct tenant URL (<tenant-name>.sip.controlup.com), go to Configuration > Downloads.

Click the links below for detailed installation instructions for:

• Windows
• macOS
• Linux
• IGEL OS
• HP ThinPro
• Stratodesk NoTouch

Agent Manager and Version Control

For Windows and macOS devices, you can install the Agent Manager which installs the Agent and keeps it up-to-date. By default, the Agent Manager installs the latest GA version of the Agent. For details, visit Agent Version Control.

Agent Distribution

To distribute the Edge DX Agent to end-user devices, use any of the following methods:

1. Distribute the Edge DX Agent, tenant name, and device registration code through an internal file share solution or by email.
2. Distribute the Edge DX Agent as an application, using a management solution such as Microsoft Intune or Microsoft Endpoint Configuration Manager.
3. Copy the Edge DX Agent into a master image that is used to provision new devices for users.

Agent Connection Troubleshooting

If you have a proxy, firewall, or use antivirus software, make sure that you perform the necessary whitelisting described above.

Use the following troubleshooting methods to help you identify if something is interfering with your network connection. For example, your company's security team might use a transparent proxy that you aren't aware of.

Method 1 - Send a Post Request to Your Tenant

Run the following command from the machine you are installing the Agent on. Replace [tenant-name] with your own tenant name.

curl - v https://[tenant-name].sip.controlup.com/api/hello

The command sends a POST request to your tenant. If you don't receive a successful response, then something is intercepting the network connection to your tenant.

Method 2 - Check Your Tenant's SSL Certificate

From the machine you are installing the Agent on:

1. Open Edge DX in your browser.
2. Click the Lock icon next to the URL.

   

3. View the details of the SSL certificate. This procedure is slightly different depending on your browser. In Google Chrome for example, go to Connection is secure > Certificate is valid.
4. Check the issuer of the certificate.

   

ControlUp always uses DigiCert for the SSL certificate. If you see any issuer other than DigiCert, then something is intercepting the network connection to your tenant.