Upgrade Guide for Hybrid Cloud
    • Dark
      Light
    • PDF

    Upgrade Guide for Hybrid Cloud

    • Dark
      Light
    • PDF

    Article summary

    For Hybrid Cloud version 8.7 or higher

    The following article explains the required steps to upgrade your ControlUp Real-Time Hybrid Cloud infrastructure to version 9.0.5 from version 8.7 or higher. If you use 8.6.5 or lower, see how to upgrade here.

    Prerequisites

    • ControlUp Real-Time DX Console Version 8.7 or higher
    • .NET Framework 4.8

    See the ControlUp Hybrid Cloud Implementation Requirements guide and make sure you meet all prerequisites.

    Preparation before upgrading

    1. Download the latest ControlUp version here.

    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.
      image.png

      b. Select the ControlUp folder and copy it to a secure location.
      image.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.

    Upgrade Procedure

    Before you start to upgrade your Hybrid Cloud environment, close all open ControlUp Real-Time Consoles that are running on your machine and launch the file for the new version of the Real-Time Console. If required, log in with your credentials to your existing organization.

    Upgrade ControlUp Monitors

    If your console machine or any of the monitors are part of a workgroup, and not domain-joined, you must upgrade using the Invoke-CUMonitorUpdate 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.
      image.png

    2. In the Monitors tab, you can see under Details that there is a version mismatch:
      UpGMontiorsMis

    3. Right-click on the monitor(s) and select Upgrade. The upgrade process starts for the selected monitor. After the upgrade, the version matches:
      UpGMontiorsMatch

    Upgrade ControlUp Data Collectors

    To perform the upgrade on data collectors from the Real-Time Console, we recommend to first stop the data collectors.

    1. Locate the machines that are configured as data collectors 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.
      image.png

    Upgrade ControlUp Agents

    We recommend that you upgrade the agents as well as to use 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 version 9.0 and higher.
    To perform the upgrade on all agents from the Real-Time Console, we recommend to first stop the agents.

    1. Right-click the organization name and select Agent Control > Stop Remote Agent.
    2. After all agents have stopped, right-click the organization name and select Agent Control > Upgrade/Install Remote Agent:
      4405485535121UpgradeAgentAllMachines.gif
    • If you use Citrix PVS, MCS, or VMware Linked Clones images in your organization, you can download the ControlUp Agent MSI here and deploy it on the image itself.

      Upgrade/Uninstall MSI-installed Agents

      From version 8.8, you can upgrade and uninstall agents that were installed with the MSI installer from the console. On the agent machine you want to manage from the console, under HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUp\Console\EnableAgentManagement set the value to 1.
      From version 9.0, you can set the value on the console machine.

    • ControlUp supports backward compatibility for the agents, allowing you to run the monitor with a higher version than the agents. This means it's not mandatory to upgrade the agents right away.

    • From version 9.0, ControlUp also supports forward compatibility for the agents configured for 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:
      image.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.
      image.png

    3. Search for the data collectors in the directory tree:
      image.png

      If a data collector isn't up to date, the machine appears with an 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.


    Was this article helpful?