Deploy ControlUp for Apps

Prev Next
First-time setup wizard

The first time you open ControlUp for Apps, a setup wizard walks you through the deployment steps. Follow the instructions in the setup wizard. You can refer to this article for additional information.

ControlUp for Apps requires you to deploy two components, which you can deploy directly from ControlUp:

  • ControlUp for Apps module: An add-on for the ControlUp for Desktops Agent.
  • ControlUp for Apps browser extension: Required for capturing web application metrics.

Prerequisites

Read ControlUp for Apps Overview for prerequisites.

Deployment instructions

To access deployment settings, go to Settings > Applications.
AccessApplicationsSettings.png

Step 1 - Deploy the ControlUp for Apps module

Under the Deployment tab, define which version of the module you want to deploy, and which devices should receive it. The selected version is installed on devices in your selected groups or with one of the selected tags.

Recommendation: To install the module on all your devices and automatically keep it updated, select Latest GA version and target All device groups / All device tags.

Step 2 - Deploy the ControlUp for Apps browser extension

Under the Extensions tab, configure how the browser extension is deployed. Note that the extension is installed only on devices that already have the ControlUp for Apps module installed. You can configure:

  • Browser extension deployment: Choose to deploy the extension either from our CDN or from the official Chrome and Edge web stores. If you want to handle deployment through GPO, select Do not install, and read below to learn how to configure your GPO.
    • Deployment from the web store requires ControlUp for Apps module version 1.3 or higher. Devices running an older version always use ControlUp's CDN for extension deployment, regardless of how you configure this setting. Read the module deployment section above to learn how to ensure you are running the latest module version.
    • The browser extension is unlisted on the web stores. It can't be found via manual search. It can be deployed only through the ControlUp UI or GPO.
  • Device group and tag targets: The selected deployment option is applied to all devices in your selected groups or with one of the selected tags.
  • Browsers: Select which browsers to install the extension on.

Extension UI
The extension is an optional feature that allows end users to view their own page load metrics by clicking the extension icon. Choose to allow this for all devices, certain devices (in specific groups or with specific tags), or do not allow.
Browser extension UI displaying page load metrics.

Version compatibility warning

Extension deployment settings require ControlUp for Desktops version 2.17.7+ AND ControlUp for Apps module version 1.2.x+.
If devices are running older versions:

  • The top-most rule always applies regardless of targeting scope.
  • The extension will be installed on all browsers regardless of your selection.

Advanced deployment options

When configuring module and extension deployment, you can add deployment rules for more granular control. For example, you can use this to pilot a new version to a test group of devices, or install the extension on different browsers for different groups of devices.

How deployment rules are evaluated

Rules are evaluated from top to bottom:

  • The first rule a device matches is the only rule applied to that device.
  • Rules do not stack.
  • Best practice: Place specific, limited-scope rules at the top (such as a beta testing group), and a "catch-all" rule at the bottom (All devices - Latest GA version)

Manually deploy extensions with GPO

If you prefer to manage extensions using a group policy instead of allowing ControlUp to handle the deployment, set the extension deployment settings in ControlUp to Do not install to prevent ControlUp from interfering with your group policy.

To install the extension from ControlUp's CDN, use the following extension ID and update URL:

  • Microsoft Edge: jmnkfnngldhhdkggfgemlkckmphhnojp;https://downloads.sip.controlup.com/appdx/latest/appdx_edge.xml
  • Google Chrome: fbmmpaeakganhhofacjdciocgnbclbcl;https://downloads.sip.controlup.com/appdx/latest/appdx_chrome.xml

To install the extension directly from the Chrome/Edge web stores, use the following extension ID and update URL:

  • Microsoft Edge: dhinjceeijmmnbppipomdhbcpcjndlip;https://edge.microsoft.com/extensionwebstorebase/v1/crx
  • Google Chrome: inoojfkadjhokmpdpednfbokjdangaep;https://clients2.google.com/service/update2/crx

Read Microsoft's documentation or Google's documentation to learn how to force install extensions using a group policy.

Troubleshooting

  • To verify the connection between the browser extension and the ControlUp for Applications module installed on the device, open the extension UI from your browser toolbar. Online indicates a successful connection.
    Extension UI connected