Upgrading OneController

After the initial installation (see Installing and Setting Up OneController), you can upgrade OneController with updated images available at https://extranet.extremenetworks.com/downloads/ Pages/OneController.aspx on the Software tab.

The upgrade images have the following extensions:

  • OneC-V Controller image extension: jse
  • OneC-A-600 Controller image extension: ice

The configuration directories that are copied during a backup (see Backing Up and Restoring Configurations and Logs) are copied before an upgrade starts. The platform configuration is restored upon completion of the upgrade.

Caution

Caution

The OneController configuration directories are restored to /usr/opendaylight/preserved when an upgrade finishes. Because OneController is based on the OpenDaylight controller, whose development is not controlled by Extreme Networks, the compatibility of your current configuration files with new OneController image cannot be assured. After the upgrade is complete, use a file compare utility to examine differences between your old backup configuration files in the preserved directory with the new configuration files in/usr/opendaylight/configuration/ that were installed by the upgrade. Make changes to the new configuration files as needed.

To upgrade the OneController software:

  1. On the left navigation bar, click System Configuration, and then, on the menu bar, click Maintenance. The Maintenance System screen appears (see the following figure).
    expand icon
    Maintenance—System Screen
    Graphics/OneC_Maintenance_System.png
  2. Click Upgrade. The Upgrade screen appears (see the following figure).
    expand icon
    Maintenance—Upgrade Screen
    Graphics/OneC_Maintenance_Upgrade.png
    Any software upgrade images that are available locally (on the hardware that is running OneController) appear in the Available Upgrades table.
  3. If the image that you want to upgrade to is not local, copy it locally:
    1. Click Download an Upgrade Image. The Download Upgrade Image dialog box appears (see the following figure).
      expand icon
      Download Upgrade Image Dialog Box
      Graphics/OneC_Download_Upgrade_Image.png
    2. For transmitting the file, select the protocol in the Protocol list:
      • ftp
      • scp
      • http
    3. Enter the IP address or host name for the server that you are copying the image file from in the Server box.
    4. Enter your logon credentials for the server you are copying from in the User ID and Password boxes. Re-enter your password in the Confirm box.
    5. Enter the upgrade image location where you are downloading from in the Directory box (in the form "\\top level folder name\folder name" for example). If the file is in the root directory, you can leave this blank.
    6. Enter the name of the upgrade file in the File Name box.
    7. Click Submit.
    8. Click Refresh. The upgrade image appears in the Available Upgrades table.
  4. To upgrade at a later date:
    1. For the desired upgrade image, click Schedule Upgrade. The Schedule Upgrade dialog box appears (see the following figure).
      expand icon
      Schedule Upgrade Dialog Box
      Graphics/OneC_Schedule_Upgrade.png
    2. In the Backup Method list, select where the current OneController image should be backed up to:
      • none—no backup is performed
      • local—on the same hardware that hosts OneController
      • usb—on a removable USB flash drive connected the hardware that hosts OneController
    3. Select the upgrade date in Start Date by typing a date or by clicking Graphics/OneC_Calendar_Icon.png.
    4. In Start Time, select the upgrade time: Graphics/OneC_Upgrade_Time.png
    5. Click Submit.
  5. To upgrade immediately:
    1. For the desired upgrade image, click Upgrade Now. The Upgrade Now dialog box appears (see the following figure).
      expand icon
      Upgrade Now Dialog Box
      Graphics/OneC_Upgrade_Now.png
    2. In the Backup Method list, select where the current OneController image should be backed up to:
      • none—no backup is performed
      • local—on the same hardware that hosts OneController
      • usb—on a removable USB flash drive connected the hardware that hosts OneController
    3. Click Submit.
    OneController upgrades the software and reboots.
You can verify that the upgrade was successfully performed by checking the software version shown in the Manufacturing Information report (see Viewing OneController Reports).