--- title: "Upgrade Guide for Hybrid Cloud" slug: "upgrade-guide-for-hybrid-cloud" description: "This article walks you through the update of our Hybrid Cloud release to version 8.8" tags: ["Update"] updated: 2026-03-19T10:12:20Z published: 2026-03-19T10:12:20Z canonical: "support.controlup.com/upgrade-guide-for-hybrid-cloud" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.controlup.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrade Guide for Hybrid Cloud To keep your ControlUp Hybrid Cloud environment performing at its peak, it’s essential to follow a structured upgrade path. To update your environment, you must upgrade the following components: - ControlUp Monitors - Data Collectors - ControlUp for VDI Agent When a new ControlUp version or build is released, you must first upgrade your Monitors and data collectors to maintain core functionality. While you can upgrade Agents at your own pace, we recommend completing in a timely manner. Staying on a unified version is the best way to avoid compatibility issues and ensure your Monitors stay in sync with your Agents. ## Prerequisites - .NET Framework 4.8 See the [ControlUp Hybrid Cloud Implementation Requirements](/tim-reorg/docs/controlup-hybrid-cloud-implementation-requirements) guide and make sure you meet all prerequisites. ## Preparation before upgrading 1. Download the latest version of the Real-Time DX Console from our [Download Center](https://www.controlup.com/download-center/). 2. Back up the ControlUp folder which holds the configuration of your ControlUp Real-Time environment. This is in case something unexpected happens and we need to recover your data. **To back up the folder:** a. Press **CTRL + X** and type **%appdata%.** Click **OK.** This opens the Roaming folder for your logged-in user. ![Windows Run window with %appdata%.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%2812%29.png) b. Select the ControlUp folder and copy it to a secure location. !['ControlUp' folder in AppData > Roaming.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%289%29.png) 3. Ensure that all data collectors are up to date and compatible with the console/monitor version. For more information, see [Data Collector Compatibility](/docs/upgrade-guide-for-hybrid-cloud#data-collector-compatibility). ### Upgrade Procedure Before you start to upgrade your Hybrid Cloud environment, close all open ControlUp Real-Time DX Consoles that are running on your machine and launch the file for the new version of the Console. If required, [log in with your credentials](/v1/docs/sign-in-to-the-real-time-console) to your existing organization. #### Upgrade ControlUp Monitors If your Real-Time DX Console machine or any of the monitors are part of a workgroup, and not domain-joined, you must upgrade using the [**Invoke-CUMonitorUpdate**](/v1/docs/90-powershell-cmdlets#invokecumonitorupdate) PowerShell cmdlet on each monitor machine. If your console machine or any of the monitors are domain-joined, we recommend you upgrade using the console: 1. From the ControlUp Management Console screen, click the **Settings** ribbon and click **Monitors**. The **Manage ControlUp Monitors** screen appears. 2. In the **Monitors** tab, you can see under **Details** that there is a version mismatch: !['Manage ControlUp Monitors' screen in the ControlUp Console. The monitors display 'version mismatch'.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/UpGMontiorsMis.png) 3. Right-click on the monitor(s) and select **Upgrade.** The upgrade process starts for the selected monitor. After the upgrade, the version matches: !['Manage ControlUp Monitors' screen in the ControlUp Console. The details column no longer displays a message about version mismatch.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/UpGMontiorsMatch.png) #### Upgrade ControlUp Data Collectors To perform the upgrade on data collectors from the Real-Time DX Console, we recommend to first stop the data collectors. 1. Locate the machines that are configured as [data collectors](/tim-reorg/docs/controlup-data-collector) in the organization tree. Right-click each machine you want to upgrade and select **Agent Control** > **Stop Remote Agent**. 2. After each agent stops, right-click on the machine and select **Agent Control** > **Upgrade/Install Remote Agent.** The deployment of the agent starts on the selected machine.![Right-click action menu showing the action 'Upgrade/Install Remote Agent'.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%288%29.png) #### Upgrade ControlUp Agents We recommend that you upgrade your ControlUp for VDI Agents to the same version as the other components so you can benefit from the latest fixes, features, and enhancements. Note that .NET Framework 4.8 is required to upgrade Agents to the highest versions. Before you upgrade, we recommend to first stop the Agents. To perform the upgrade on Agents using the **Invoke-CUAgentUpdate** PowerShell cmdlet, see [here](/v1/docs/invoke-cuagentupdate-upgrade-an-agent). If you use Citrix PVS, MCS, or Omnissa (formerly VMware) Full Clones, Linked Clones, or Instant Clones images in your organization, you can download the ControlUp Agent MSI [here](https://www.controlup.com/products/controlup/agent) and deploy it on the image itself. Upgrade/Uninstall MSI-installed Agents You can upgrade and uninstall agents that were installed with the MSI installer from the Real-Time DX Console. On the Console machine, add the following registry settings: Registry Key: `HKLM\SOFTWARE\Smart-X\ControlUp\Console` Value Name: `EnableAgentManagement` Value Type: `REG_DWORD` Value Data: `1` To perform the upgrade on Agents from the Real-Time DX Console: 1. Right-click the folder name containing the Agents you want to upgrade and select **Agent Control** > **Stop Remote Agent**. Repeat for each folder as needed. 2. After all agents have stopped, right-click the organization name and select **Agent Control** > **Upgrade/Install Remote Agent**. - ControlUp supports backward compatibility for the agents, allowing you to run the monitor with a higher version than the agents, as far backward as two versions lower than the monitor. This means it's not mandatory to upgrade the agents right away. For Controlup for VDI version details, see [here](/v1/docs/controlup-version-lifecycle). - ControlUp also supports forward compatibility for the agents configured for [outbound communication](/v1/docs/agent-outbound-communication). This allows you to run the monitor with a lower version than the outbound agents, but **not** with a lower version than the inbound agents. Note that forward compatibility is **not** supported for the console. ## Data Collector Compatibility As mentioned above, it is crucial to ensure the compatibility of the data collectors. It is best practice to have dedicated machines that serve as data collectors. However, by default, the Real-Time Console and the ControlUp Monitor fill this role. To find out which settings the data collector role holds, perform the following steps: 1. From the directory tree, right-click your hypervisor connection, XenDesktop site, or NetScaler appliance and click **Connection Settings**. The **Edit Connection** tab appears. 2. Click the arrow to open the data collectors dropdown: ![Hypervisor Connection window with no machines available.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%2811%29.png) If a machine shows after you click the arrow, then this machine acts as a data collector. The agent on that machine must be updated. If no machine shows after you click the arrow, then you don't currently use a data collector in your ControlUp environment. ![Hypervisor Connection window with machine available.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%2813%29.png) 3. Search for the data collectors in the directory tree: ![ControlUp Console directory tree search bar.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image%2814%29.png) If a data collector isn't up to date, the machine appears with an ![](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/360008724378mceclip5.png) icon. 4. To update a data collector, right-click the data collector in the organization tree and select **Agent Control** > **Upgrade Remote Agent.** ## Login To login to your existing ControlUp organization, see [here](/v1/docs/sign-in-to-the-real-time-console).