How to Upgrade to Niagara 4.6


#1

With the release of Niagara 4.6 on the Dell Gateway, there are a few paths to upgrading an existing 4.2 installation. Here is an excerpt from the installation guide on upgrading. The full doc can be found here. The installation guide is also included as part of the installer download.

There are multiple scenarios for upgrading depending on which version you are moving to and what version you are moving from. This section attempts to document the known scenarios and walk you through this process.

All scenarios described below will decommission the Niagara installations current state. Commissioning will be required after upgrading with these methods.

Scenario 1:

An instance of Niagara on your gateway was installed from Niagara_4.2.36.34_Kodaro_UC16_EDGE_Installer_1.8

This means you service is named Niagara_4.2.36.34. All newer versions after this have the version removed in favor of simplifying updates. You can verify this by running the command on the gateway:
sudo docker ps -a

At this point, we have two options:

Option 1: Rename and Use New Installer

If you are planning on upgrading to 4.6 or any other version other than 4.2, this is the option you will need.

  1. Rename the service by running the command:

sudo docker rename Niagara_4.2.36.34 Niagara

Before Rename:
image
2. Confirm the rename command was successful:

sudo docker ps -a
image

  1. Download the newer installer you are planning on upgrading from here

  2. Go back to the section “Prepare to Install on Ubuntu Core” and follow the steps with your new installer. Starting at Niagara_4.2.36.34_Kodaro_UC16_EDGE_Installer_1.9 and above will now be able to upgrade the older versioned service name without issue.

Option 2: Keep Same Name and Installer

If you do not wish to go through the steps of getting the latest installer, you can upgrade to the latest version within the installer version as it relates to the Niagara version (4.2,4.6 etc). This means if you wanted to just update from 1.8 to 1.9, all you would need to do is to re-run the installer and select 1.9 from the manual version selection. This would also mean that you would keep the version in the service name so upgrading to Niagara 4.6 would still require additional work. See Scenario 2 in this section of the document.
image

After completing the above new installation by defining the version, you can verify the new version is using the latest image by running:

sudo docker ps -a

Note we now have a 1.9 image installed for the a ctive Niagara service and the old 1.8 is defined as the backup.

Scenario 2:
An instance of Niagara on your gateway was installed from Niagara_4.2.36.34_Kodaro_UC16_EDGE_Installer_1.8 and you upgraded it to another version using Scenario 1 Option 2 and are now ready to upgrade to a newer version than a 4.2 release.

Rename and Use New Installer

If you are planning on upgrading to 4.6 or any other version other than 4.2, this is the option you will need.

  1. Rename the service by running the command:

sudo docker rename Niagara_4.2.36.34 Niagara

Before Rename:
image

  1. Confirm the rename command was successful:

sudo docker ps -a

image
3. Download the newer installer you are planning on upgrading from www.kodaro.com
4. Go back to the section “Prepare to Install on Ubuntu Core” and follow the steps with your new installer. Starting at Niagara_4.2.36.34_Kodaro_UC16_EDGE_Installer_1.9 and above will now be able to upgrade the older versioned service name without issue.


Upgrading Dell Edge Gateway to Latest Versions of Niagara