Edge DX Agent Deployment and Installation

Contents

About Edge DX

Edge DX is a systems and device management SaaS for desktop, Mac, IGEL and other devices, with features for monitoring, troubleshooting, and gathering intelligence across remote devices.

Edge DX is available to ControlUp Real-time Console users through the Solve interface, and also as a standalone product if you have not yet installed ControlUp. 

For more information about the Edge DX user interface and capabilities, see Welcome to Edge DX.

Agent Deployment

To deploy Edge DX, administrators and users in your organization will require:

CPE_configuration_downloads.png

Alternatively, use one of these methods to distribute the Edge DX agent to end user devices:

  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 Installation

To download and install agents from the Edge DX Download page:

Windows Agent Manager

Supported OS Versions: Windows 7 SP1+ (x64), Windows 10 Version 1607+ (x64), Windows Server 2012 R2+ (x64).

To download and install Windows Agent Manager:

  1. Double click the download icon download_button.pngto download and run the appropriate version of the agent.
  2. Install and start it.
  3. The Agent Manager will also update the agent when new versions are available and selected.

Command Line Installation:

The Agent Manager can also be installed from the command line, using your device registration code and tenant name. For example:

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

Note that the device registration code and tenant name are not checked and will be stored as-is. Agents will fail to connect if they are not correct.

To prepare a Windows image for cloning with Citrix PVS/MCS (or similar), use the ONLYSTARTONBOOT=1 option to make the Agent Manager download and install the correct version of the Edge DX agent, but not 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. Here's an example of the command line you would use:

msiexec /i agentmanagersetup.msi /qn DEVREGCODE=fccbd8540ab7ea23a9cda5795b81dfc8b3855d0a TENANT=acme.sip.controlup.com ONLYSTARTONBOOT=1 ALLUSERS=1

Linux Agent

Supported OS Versions: See .NET Core 3.1 supported OS list on github.

Download and Installation

  1. You can download the agent directly, but the easiest and most recommended way to install and update the Linux agent is as a system daemon with the script below.
  2. After downloading the script, remember to chmod +x it and run it with sudo:
sudo ./sip-install.sh <tenant name> <device registration code>

3. Once installed, you can update the agent from a Custom Action in the Devices drill down view. If the Custom Action script is not already in your tenant, contact support@controlup.com and we'll show you how to add it.

CPE_devices_drill_down_actions_custom_actions.png

Command Line Installation

To run Linux Agent directly using command line:

  1. Download the agent and give it execution rights with chmod +x.
  2. The agent needs to run with root privilege (sudo) and needs the tenant name and device registration code as parameters. For example:
sudo ./avaceesipagent-linux tenant=acme.sip.controlup.com devregcode=fccbd8540ab7ea23a9cda5795b81dfc8b3855d0a

MacOS BETA Agent

Supported OS Versions: macOS 10.13+ (x64).

A dmg Mac installer is coming soon, but for now you will need to install it from the command line in a Terminal window.

The easiest and recommended way to install and update the Mac agent is as a launchctl service with this script.

After downloading the script, remember to chmod +x it and run it with sudo:

sudo ./mac-sip-install.sh <tenant name> <device registration code>

If you want to run the agent directly from a command line, then download it and give it execution rights with chmod +x.

The agent needs to run with sudo root privileges and requires the tenant name and device registration code as parameters. For example:

sudo ./avaceesipagent-macos tenant=acme.sip.controlup.com devregcode=fccbd8540ab7ea23a9cda5795b81dfc8b3855d0a

IGEL OS BETA Agent

Supported OS Versions: 10.05.500+

To install the IGEL agent, follow these steps:

  1. Create the custom partition: In the IGEL Universal Management Suite, go to:
    Setup > System > Firmware Customization > Custom Partition > Partition
  2. Enable the custom partition. Give it a size of at least 100MB and make note of the mount point (e.g. /custom).
  3. Once the custom partition is enabled, add the ControlUp agent as a downloaded package:
    Setup > System > Firmware Customization > Custom Partition > Download
  4. When adding the package, use the following information:
 /custom/controlup-cpe-agent/start.sh <tenant name> <device registration code>
  • Automatic Update: Enable this if you want the agent be updated as new versions are released.

* If you changed the custom partition mount point when enabling it, adjust the Initial Action command with the appropriate mount point.

 

Device Registration

To connect, the following information is required:

  • Tenant name: e.g. acme.sip.controlup.com
  • Device registration code: Unique to each tenant
    • The tenant name and device registration code are stored in:
      • Windows Registry at HKLM\Software\Avacee\SIP
      • For Mac and Linux in settings.json at /usr/local/avacee/sip_agent
  • A Unique Identifier (UID) that is automatically generated by the tenant name the first time you connect. The UID is stored in the file system.
1-on-1 Demo
Schedule now
Price Quote
Get it now
Need a Script?
Get it here
Powered by Zendesk