ControlUp On-Premises Upgrade Guide
    • Dark
      Light
    • PDF

    ControlUp On-Premises Upgrade Guide

    • Dark
      Light
    • PDF

    Article Summary

    Each of our new ControlUp On-Premises (COP) versions provides bug fixes or adds new features. We recommend to regularly upgrading your on-premises environment as it is important to the security and stabilty of your ControlUp environment.

    Contact us at support@controlup.com to receive the latest installation files for all on-premises components.

    When to Use This Guide?

    This upgrade manual is relevant only if you currently have ControlUp Server version 8.1.5.20 or later installed.

    You must complete the on-premises upgrade preparation within 14 days (by default, unless changed) before the date that you complete the following tasks to upgrade your ControlUp environment to the latest version.

    Earlier Versions

    If you upgrade COP Server version 8.5 to 8.8, it fails. You must first upgrade from version 8.5 to 8.7, and then only after to 8.8.

    If you run ControlUp Server version 8.1.5.19 or earlier, contact our support team at support@controlup.com.

    Prerequisites

    Complete the following prerequisites before you begin the upgrade:

    Back Up Your ControlUp Server and Monitors

    Take a snapshot of all your COP Server(s) and Monitors for fast recovery, if needed.

    Back Up Your ControlUp Database (Optional)

    It is best practice to back up the ControlUp database in case the COP installation fails.

    To create a database backup in SSMS:

    1. Connect to the instance where the ControlUp Database is stored on the SQL Server Management Studio.
    2. Right-click the database > Tasks > Back Up...
      image.png
    3. In the Back Up Database dialog box, keep the backup type Full. In the Destination section, specify if you want to back up to Disk or Tape.
      BackUpDB
    4. Under the Media Options tab, select the checkboxes Overwrite all existing backup sets and Verify backup when finished.
      VerifyBackupDB
    5. Save the backup file to safe location.

    Sanity Test Before Upgrade

    1. Verify that Monitoring Status is green and take a screenshot.
    2. Click Monitoring Status, verify that all monitors are green and take a screenshot.
    3. Verify that the monitors are connected to the Data Sources.
    4. Login to IOP:
      1. Verify that data is displayed in the Top Insights reports and take a screenshot.
      2. Verify that the Session Count report works properly and take a screenshot.
    5. Login to SOP:
      1. Verify that every widget displays data and take a screenshot.
      2. If Custom Dashboards exist, verify that they display data and take a screenshot.

    COP Server Backups

    Stop All Running ControlUp Monitors

    To stop all running monitor services from the console:

    1. Open the Console and click Monitoring Status.
    2. Right-click the root folder and stop the Universal Forwarder (Splunk) application on the monitors.
      select Stop.
    3. Right-click the root folder and select Stop.
      COPUpgrade_StopMonitors
    4. Wait until the status of all monitors changes to Stopped.
    5. Stop the SOP Server.
    Note

    After you stop the monitors, no activity files will be created.

    ControlUp Server Configuration Backup

    1. Make a copy of the ControlUp Server folder and copy to a safe location, as you might need to use it after the upgrade:
      • If you upgrade from version 8.6 or later, you can find it under C:\Program Files\ControlUp Inc\
      • If you upgrade from an earlier version, you can find it under C:\Program Files\Smart-X\
    2. In the console, click File > Save Configuration. If successfully saved, the following popup appears:
      COPconfigSuccess
    3. Backup the roaming configuration folder which contains encrypted COP configuration:
      • Explore to %Appdata%
      • Make a copy of the ControlUp folder and save it in a safe place as you might need to use it after the upgrade.

    COP Server Upgrade

    Perform the following COP Server upgrade instructions according to your COP Server High Availability

    To check your ControlUp Server Installation Mode:

    1. Login to your ControlUp Server
    2. Open Program and Features (appwiz.cpl).
    3. Click the ControlUp Server.
    4. Click Change (or Modify).
    5. Click Alternate Server Configuration.
    6. Your failover Server Mode option appears.

    ControlUp Server in Light Mode

    Important

    You can't upgrade your ControlUp Server if you're using your ControlUp Database in Light Mode. In this case, you must first Uninstall the ControlUp Server and then Install it from scratch. When you uninstall, all objects (machines, hypervisors, folder structure) are removed from the ControlUp LDS. After you reinstall, you must manually redefine all the objects.

    1. After you Uninstall the ControlUp Server, uninstall all the programs that start with SQL Express and all other SQL Programs (if any exist) from Control Panel > Programs and Features.
    2. Install the latest COP version as an administrator and follow the installation instructions in ControlUp On-Premises Server Installation.
    Important

    Light Mode isn’t recommended for Production Mode.

    Upgrade Instructions for Production Mode (Standalone Server)

    Note

    The following steps aren’t relevant if you run the ControlUp Server in Failover Mode.

    1. Run the installation file of the new ControlUp Server version as an administrator.
      COPServerInstall

    2. Click Upgrade and wait until the installation is complete and the Upgraded Successfully message appears.
      4405471898897UpgradeSuccessful.png

      Important

      If the upgrade failed, contact our support team at support@controlup.com and provide log files as described in ControlUp On-Premises Installation: Log Files .

    Upgrade Instructions for ControlUp Server in Production Mode with a Failover Feature

    1. Secondary Server-2:
      1. In Control Panel > Programs and Features, uninstall the ControlUp Server, as shown below:
        COPUninstall
      2. Uninstall AD LDS Instance ControlUp-LDS (if it exists).
      3. In Server Manager > Add Roles and Features, uninstall Server Role Active Directory Lightweight Directory Services.
        ServerRoles
    2. Main Server-1, upgrade according to the Production Mode (Standalone Server) steps above.
    3. Secondary Server-2, follow the steps in COP Server High Availability.

    ControlUp Real-Time Consoles Upgrade

    Note

    Before you upgrade the Real-Time Consoles, make sure to successfully complete the ControlUp Server upgrade.

    1. Open Program and Features (appwiz.cpl) and uninstall the current Real-Time Consoles.
    2. Install the new versions following the steps in ControlUp On-Premises Real-Time Console Installation.

    ControlUp Monitors Upgrade

    1. In the console, click Monitoring Status to see all monitors configured in your ControlUp organization.
    2. Start all the monitors and wait several minutes until all are in Running status. A version mismatch will appear on each monitor. This is expected until after you complete the monitors upgrade.
    3. Right-click a monitor or site > Upgrade. Repeat this step for all monitors so that no monitor appears with a version mismatch.
    4. After the upgrade is complete, check that the monitors started successfully and the Version column shows the updated version.
      image.png
    5. Verify that the monitors are connected to the Data Sources.

    IOP Forwarder Upgrade

    1. Login to each monitor server machine:
      1. Open Program and Features (appwiz.cpl).
      2. Uninstall the Insights On-Premises (IOP) Forwarder and Universal Forwarder (Splunk) applications. Verify that these applications are removed from the programs list.
      3. Install the new IOP Forwarder.
    2. Repeat the above steps for each monitor.
    3. Update Script-based Actions (SBA)s and Automated Actions and Automated Actions (Virtual Expert). For more details, see How to Update SBAs and AA-VE in On-Premises Environments.

    Change Backup Settings for On-Prem Monitor Activity (Optional)

    Optionally, if you want to change the Activity Files retention default value of 14 days:
    1. Login to the console.
    2. Open Monitoring Status > Monitors Settings > On-Prem Monitor Backup.
    3. In the Minimum days before deleting the backed up zipped files field, replace the default value of 14 with a new value.
    image.png

    Upgrade Additional ControlUp Agents

    After you complete the upgrade of the ControlUp Server, Consoles and Monitors, upgrade a few additional Agents to verify that all components can be upgraded.

    If you are using MSI, use the provided file. Otherwise, perform the following steps:

    1. Right-click the machine and select Agent Control > Upgrade/Install Remote Agent. To upgrade the agent on multiple machines simultaneously, select machines as needed, right-click them and select Agent Control > Upgrade/Install Remote Agent.
      AgentUpgrade.gif

      MSI Package

      If you installed the agent with an MSI package, use this method.

    2. Verify that a version mismatch doesn’t appear for the upgraded agents.

    Sanity Test After Upgrade

    1. Verify that the Monitoring Status is green and take a screenshot.
    2. Click Monitoring Status, verify that all monitors are green and take a screenshot.
    3. Verify that the monitors are connected to the Data Sources.

    Insights On-Premises Upgrade: OVA-based deployment

    1. Make sure you have completed the On-Premises Upgrade: Preparation Guide.
    2. Take a screenshot of your current IOP Licenses page.
    3. Shutdown the current IOP Server(s):
      1. Login as admin (cuadmin, prior to IOP 8.8).
      2. Shut down the machine by running shutdown -P 0
    4. Only if you didn't copy disk 2 as part of the preparation steps: move disk 2 from the current IOP VM folder to the new OVA VM folder.
    5. Power on the new IOP Server(s).
    6. Use the admin user to login to IOP.
    7. Open Licenses, and make sure that all your IOP licenses are installed by comparing to the state before you switched the IOP.
    8. To reset the default Audit Log size to prevent your OS disk from exceeding maximum capacity (500GB), perform the following steps:
      1. Open Insights as a Manager (port 8000) .
      2. Select Indexes.

    IOPIndexes

    1. In the _audit row, click Edit.

    IOPAudit

    1. Set Max Size of Entire Index to 35GB and click Save.

    IOPMaxIndexSize

    1. To restore the data from the time you copied disk 2 until the time you powered on the new IOP, perform the Activity Files restore on every monitor:
      1. To find where the Activity Files are stored:
        1. Login to the COP Server.
        2. Open Program and Features (appwiz.cpl).
        3. Select ControlUp Server and click Change.
        4. In the ControlUp On-Premises Server window, click Insights On-Premises (IOP) Configuration.
        5. Note the Activity Files Folder and Backup Files Location, and click Back.
        6. Click X to close the ControlUp On-Premises Server window and click Yes to confirm in the pop-up.
        7. Close Program and Features.
      2. To restore the Activity Files:
        1. Login to the monitor.
        2. Verify (if needed, create) a folder named Restore under the Activity Files Folder you noted in the previous step.
        3. Copy all the relevant Activity Files from the Backup Files Location you noted in the previous step to the Restore folder.
    Important!

    You must perform these steps on every monitor machine.

    Insights On-Premises Upgrade: Linux-based deployment

    The steps above cover IOP upgrade instructions for an OVA-based deployment only. For IOP Linux-based deployment upgrade instructions, see Insights On-Premises Upgrade for Linux.

    Solve On-Premises Upgrade

    1. Make sure you have completed the On-Premises Upgrade: Preparation Guide.
    2. Shutdown the current SOP Server.
    3. Power on the new machines created from the OVA of the preparation section.
    4. Reload the JSON Web Token (JWT) file to the COP Server Settings. For more details about importing JWT to COP, see COP Security enhancement for Monitor/SOP communication.
    5. From the Console, click Monitoring Status > Monitors, select Start all Monitors.

    Sanity Test After SOP Upgrade

    1. Verify that Monitoring Status is green and take a screenshot.
    2. Click Monitoring Status, verify that all monitors are green and take a screenshot.
    3. Verify that the monitors are connected to the Data Sources.
    4. Login to IOP and verify that the Session Count report works properly. Note that the Top Insights reports run once daily at 4:00AM, and are therefore available only on the following day.
    5. Login to SOP:
      1. Verify that every widget displays data.
      2. If Custom Dashboards exist, verify that they display data.

    Upgrade All Remaining ControlUp Agents (can perform at a later stage)

    We recommend that you upgrade all ControlUp Agents to avoid version mismatches.

    1. Right-click a machine and select Agent Control > Upgrade/Install Remote Agent. To upgrade the agent on multiple machines simultaneously, select machines as needed, right-click them and select Agent Control > Upgrade/Install Remote Agent.
    MSI Package

    If you installed the agent with an MSI package, use this method.

    1. Verify that a version mismatch doesn’t appear for the upgraded agents.

    Was this article helpful?