---
title: Software Updates
slug: bhdo/software-updates
createdAt: 2022-06-03T18:52:05.000Z
---

You can upload new version updates and upgrades to Belden Horizon Data Operations. Your Belden Horizon Data Operations devices can be upgraded from previous versions by using UPD files. Get the latest UPD files from your Belden account executive.&#x20;

The upgrade process preserves your data and existing configurations. After the Belden Horizon Data Operations software has been installed on a device, this upgrade process can be used throughout the lifetime of the device.

# Important

- You can't downgrade a lower version.&#x20;
- If needed, you can upgrade to the same version you're currently on.
- An upgrade to an internal pre-release version is possible, but contains a warning. Pre-release versions are not upgradeable.
- You cannot skip any version between upgrades.
- Creating a backup prior to upgrading is recommended.&#x20;
- You cannot upgrade if your controller is IDE. You must have a SATA controller to upgrade.
- Software upgrades haven’t been validated yet on VirtualBox 6.1.x. An upgrade attempt running on VirtualBox 6.1.x may result in a corrupted and unrecoverable Belden Horizon Data Operations instance.
- If  you want the same edge device configuration and setup on a fresh installation or with an update, you can use a template. See [Templates](https://docs.litmus.io/edgemanager/lem-user-ui/product-features/templates) for more information.&#x20;

:::hint{type="warning"}
**Caution**: Software upgrades haven’t been validated yet on VirtualBox 6.1.x. An upgrade attempt running on VirtualBox 6.1.x may result in a corrupted and unrecoverable Belden Horizon Data Operations instance.
:::

# Before You Begin

- Get the latest software file (.upd) from your Belden account executive..
- Verify the current software version running on Belden Horizon Data Operations in **System** > **Info** under the *General&#x20;*&#x73;ection.

## Backup Checklist

For backup purposes, you can complete the following tasks before doing a software upgrade.&#x20;

:::hint{type="info"}
**Note**: All configurations and settings are maintained and carried over after upgrading to a new version.&#x20;
:::

- [ ] Download all tags in a CSV file from **DeviceHub&#x20;**> **Tags**. See [Manage Tags](https://public-docs.litmus.io/bhdo/manage-tags#download-tags-as-a-csv-file).
- [ ] Download flows files from **Flows Manager**. See [Manage a Flows Manager](https://public-docs.litmus.io/bhdo/manage-a-flows-manager) for more information.
- [ ] Export all flows from your **Analytics&#xA0;**&#x67;roups. See [Manage Processors and Analytics Flows](https://public-docs.litmus.io/bhdo/manage-processors-and-analytics-flows) for more information.
- [ ] Export the OPC UA hierarchy configuration JSON file from the **OPC&#x20;**> **Hierarchy&#x20;**&#x70;ane. See [Manage Nodes](https://public-docs.litmus.io/bhdo/manage-nodes) for more information.
- [ ] Create a Template from the **Template&#x20;**&#x74;ab in **System&#x20;**> **Backup / Restore**. See the *Download a Template* section in [Manage Templates](https://public-docs.litmus.io/bhdo/manage-templates).
- [ ] Create a support bundle from the **Support&#x20;**&#x73;ection in **System&#x20;**> **Support**. See [Support](https://public-docs.litmus.io/bhdo/support).
- [ ] Make a backup of your system from the **Backup / Restore Configuration** section in **Settings&#x20;**> **Backup / Restore**. See [Back Up a Device](https://public-docs.litmus.io/bhdo/back-up-a-device).

# Upgrade Belden Horizon Data Operations

You have three options for upgrading Belden Horizon Data Operations.&#x20;

## Option 1: Upload Local File

This is the recommended upgrade method.&#x20;

### Before You Begin

- Get the latest software file (.upd) from your Belden account executive..
- Verify the current software version running on Belden Horizon Data Operations in **System** > **Info** under the *General&#x20;*&#x73;ection.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/aEIl1UkUhRrnQlWiGP66X_software-version.png" size="80" width="1041" height="529" caption="Current software version" position="center" showCaption="true"}

### Upload a New Version of Belden Horizon Data Operations Software

Once you have the .upd file that has the new version of Belden Horizon Data Operations, complete the following steps to upload it to your Belden Horizon Data Operations instance.&#x20;

**To upload a new version of Belden Horizon Data Operations:**

1. In Belden Horizon Data Operations, navigate to **System&#x20;**> **Device Management**.
   The *Device Management* pane appears.
2. From the *Manage&#x20;*&#x73;ection, click **Upload File**.&#x20;

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BUkLGmBML3q1kgV0eLDQT_upload-file.png" size="80" width="1131" height="760" position="center" showCaption="false"}
3. Select the upd. file you want to use, and then click **Open**.
   A pop-up warns you of the device reboot and prompts you to confirm the upload.
4. Click **Ok**.
   The software loads and installs, and then the system reboots.
5. Once the system has restarted, close your browser and open the browser again.&#x20;
6. Clear your browser cache.&#x20;
7. Log in to Belden Horizon Data Operations and navigate to **System > Info**. Verify the software version is the updated version.&#x20;

## Option 2: Upgrade Through Belden Horizon Data Manager

If you have access to Belden Horizon Data Manager, see the following for upgrading remotely:

- [Software](https://public-docs.litmus.io/bhdm/software)
- [Add New Software Job](https://public-docs.litmus.io/bhdm/add-new-software-job)

## Option 3: Download Upgrade File

If the two options above are not available, then you can download the upgrade file in Belden Horizon Data Operations.&#x20;

### Before You Begin

Follow up with your Belden account executive to get the required download URL and Checksum value that will be used to access the upgrade file.&#x20;

### Download the Upgrade File in Belden Horizon Data Operations

**To download the upgrade file in Belden Horizon Data Operations:**

1. In Belden Horizon Data Operations, navigate to **System&#x20;**> **Device Management**.
   The *Device Management* pane appears.
2. In the *Update Files* section, click **Download from URL**.&#x20;
   The *Download Software Update&#x20;*&#x64;ialog box appears.&#x20;

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ACjtK7byOjnG7NmWrdaau_download-from-urlbhdo.png" size="80" width="1197" height="709" caption="Download from URL option" position="center" showCaption="true"}
3. Enter or paste the *Download URL* and *Checksum&#x20;*&#x76;alue in the required fields. Then, click **Start download**. When the download successfully completes, the file displays in the *Update Files* section.&#x20;
4. For the downloaded file, click **Update**.&#x20;



