• Welcome to Edge DX

    Contents

    What Is Edge DX

    Welcome to Edge DX by ControlUp. With Edge DX, you can manage physical endpoints – located anywhere – without requiring VPNs or cloud gateways.
    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.

    Edge DX integrates with Solve, ControlUp’s hosted web application for real-time monitoring and analysis for virtual desktops.

    How to Get Edge DX

    If you are a Solve subscriber, go to the Solve dashboard, and hover over the top NEW icon in the left side navigation and click on Physical endpoints. Then click Start Trial for a free 21 day trial for 100 desktops.

    If you are not a Solve customer, ask your ControlUp representative for an Edge DX tenant and the 21 day free trial for 100 desktops.

    Edge DX Installation

    To learn how to install Edge DX, see the Edge DX Deployment and Installation article. 

    User Permissions

    Edge DX Administrators and Users can access the following features:

    Edge DX Feature Administrators Users
    Dashboard
    Device metrics
    Reports
    System events  
    Run actions  
    Change scripts  
    Control user permissions  

     

    To learn how to add a new user, see the configuration section.

    Edge DX User Interface

    The user interface guide has four main sections: Configuration, Dashboard, Devices, and Reports.

    Configuration

    Click the controls icon in the top right corner to open the Configuration dropdown menu:

    CPE_configuration_dropdown_menu.png

    You’ll find the following configuration pages:

    System Events

    Track IT admin events such as administrator logons, device registration, errors, and more.

    Alerts

    Set alerts to let you know about important events in your physical device network. For example, set an alert for high CPU load. Alerts are always cross-device. Alert notifications include all devices that triggered it. Generally, alerts are triggered every 60 seconds.

    Scripts

    Using Edge DX’s powerful and extensible scripting engine, you can distribute and run scripts on Windows, Linux, and Mac devices, to perform IT administration tasks and to collect results and data.
    Supported scripting languages include PowerShell, Python, Bash, Swift, and Shell Script. Windows-specific scripts include VBScript, JScript, and cmd.exe. Scripts can be configured per platform (Linux, MacOS, and Windows).
    Script Examples:

    • Get CPU temperature
    • Get expiring X.509 certificates expiring in the next 30 days and return them as an event.
    • Perform a forced group policy update
    • Restart Windows Print Spooler Service

    For more information about scripts, see the Edge DX Scripting Guide.

    Data

    This page displays the raw data collected from agents, processed, and displayed in the Dashboard and in the Reports.

    Downloads

    This page contains Agent downloads and installation instructions per device type. For details, Edge DX Agent Deployment and Installation.

    Agent Settings

    This page provides agent version information and a range of agent performance settings:

    • Production Agent Versions: This section currently displays the Windows agent manager version. This software is installed on client devices and manages the installed agent version by upgrading or downgrading to the production version.
    • Intervals:
      • Action Check Interval: allows an extra, more frequent check for actions and script updates. It increases load on the database and can affect system performance. Each Device Update also checks for actions and script updates so to disable this additional check, set the interval to be greater than the Device Update Interval.
      • Device Update Interval: controls how frequently the agent sends info including performance stats, current active processes, remote IP address, services and agent version to the service. It also checks for actions and script updates. Gathering this information on the device can have a performance impact so avoid reducing this interval below 60 seconds, unless actively troubleshooting.
      • Configuration Update Interval: Controls how frequently the agent checks for new settings and scripts. During setup it is common for this interval to be short, however during production this can be longer.
      • Trigger Interval: Short Trigger Interval and Long Trigger Interval control how often you run a script (Scripts > Add Script). For more information see the scripting guide.
    • Agent Feature Settings: Includes configurations for MS Windows Event Log. 
    • Custom Agent Settings: An open field that accepts JSON-formatted data input that can be used to send configurations to the agent that are not available in the user interface. Examples include settings such as new data or filter data, or to disable a feature. After entering your data input, click Save Custom Settings. All agents will pick up the new settings at the next configuration refresh.

    Tenant Users

    Manage Solve single sign-on (SSO) and control user access to Edge DX and configure Solve single sign-on.

    CPE_configuration_tenant_users.png

     

    With Solve Single Sign-On (SSO) enabled, Solve users will have Edge DX viewer permissions, and Solve managers will have Edge DX administrator permissions.
    To add an Edge DX new user:

    1. Click Add User.
    2. Enter the user name (UPN) and click Add.
    3. You’ll receive a success message: “New user was created!”. Click OK.
    4. Under Tenant Users, locate and click on the new user to grant Solve SSO and Edge DX administrator or viewer access rights.
      Note that only Edge DX Administrators can add and grant access rights to other administrators and viewers.

    Dashboard

    Dashboard widgets display aggregate device data and metrics. Click to drill down to the device view. An interactive map shows device locations. Click the pins to zoom in and see device data and performance metrics.

    CPE_dashboard_main.png

    Devices

    The Devices view features a wide range of sortable columns. One set of columns displays device identification and agent data, such as device group, and location, and agent version. These columns are either sortable or feature filtering capabilities. To filter results, simply click the desired column funnel icon to open the filter builder.

    CPE_click_filter_builder_with_filter_builder_in_corner.png

    The other columns show key performance metrics: Wi-Fi signal, network latency, CPU usage, memory available, logon times, and input delay. Data is displayed using colored threshold indicators that can be clicked to drill down and view further device data.

    CPE_devices_thresholds_drill_down.png

    Devices Drill Down
    In the Devices view, click a device to drill down and see further data.

    CPE_Devices.png

    At the top of the device drill down page are five tabs:

    CPE_device_drill_down_5_top_tabs.png

    Performance includes an interactive map and device hardware, software, and networking specifications. Chart widgets display key performance metrics including CPU usage, CPU queue length, memory usage, network usage, hourly network usage, network latency, and active sessions. For each metric, click the bell icon to create an alert, to be triggered when a certain threshold is reached.

    Active Processes displays all active processes for the chosen device.

    Installed Applications lists all the applications installed on the chosen device.

    Missing Patches indicates which Windows updates should be applied.

    Device Events shows all events related to your devices. You can sort device events in the Type column. Event types include Alerts, Action, Device, Security, System. You can also filter events using the title, description or local ID columns.

    CPE_device_device_events.png

    Reports

    CPE_reports.png

    Edge DX includes four types of reports:
    All Devices: These cross-platform reports are related to hardware and operating system information. Examples include:

    • Hardware & Operating Systems
    • Installed Applications

    Windows Apps & Processes: A list of reports focusing on processes and applications. Examples include: 

    • Top Processes by CPU Time
    • Top Users by Application

    Windows Performance & Security:

    • Examples include Local Administrators, Missing Patches, Windows Event Log.

    Custom Reports: Here you can add your own report:

    1. Click Configuration > Data and click the index you are interested in.
    2. On the left side, select the columns (metrics) that you want to include.
    3. Define the sort order by clicking the relevant column heading.
    4. Click the Create Custom Report button. Name your report, add a description, and check Public if you want this report to be viewable by other users in your organization. 

     

     

  • 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.