Upgrading the Roving Edge Device Software while Disconnected

Learn how to upgrade the Roving Edge device software while the device isn't connected to your Oracle Cloud Infrastructure (OCI) tenancy.

Note

The ability to upgrade device software while the device is disconnected was introduced in Roving Edge software version 2.6. If your device is running an earlier version (2.5 or earlier), you must update the device software while connected. To find your device software version, see Identifying the Device Software Version.

The disconnected upgrade process consists of several tasks:

  1. Get the device's current software version.
  2. In OCI, request a system upgrade bundle.
  3. Transfer the upgrade bundle to a bucket on the Roving Edge device.
  4. On the device, import the upgrade bundle.
  5. Upgrade the device.

The steps for each task are described in this section.

You must have the required permissions to perform a software upgrade on a disconnected Roving Edge Infrastructure device. See Enabling Disconnected Upgrade Bundle Delivery.

Note

System upgrade bundles can be very large. They can take a long time to download and upload. Plan accordingly.

After the upgrade, the device reboots, and you must use the Serial Console to unlock the device. To prepare to use the Serial Console, see Operating the Serial Console.

  • Task 1 – Get the Device's Current Software Version
    1. Sign in to the Device Console of the Roving Edge device you plan to upgrade.

    2. Click the System Status icon (System Status Icon) in the upper right corner of the Device Console.

      System Upgrades displays your current software version.

    3. Record the current system software version. You use it later in the upgrade process.

    Task 2 – Request a System Upgrade Bundle
    1. Sign in to the OCI Cloud Console.

    2. Open the navigation menu and click Hybrid. Under Roving Edge Infrastructure, click Nodes. The Nodes page is displayed.

    3. Select the Compartment that contains the device node you plan to upgrade.

    4. Click the device node that you plan to upgrade.

      The Node Details page is displayed.

      The device node must be in the Customer Received or Customer Deployed state to request a system upgrade bundle.

    5. Under Resources, click System Upgrades.

    6. Click Request System Upgrade Bundle.

      The Request Node Upgrade Bundle dialog box is displayed.

    7. Enter the required information:

      • Enter the device node's current software version in the Current Software Version box and click Get Next Upgrade Version.

        The version number you enter is compared with the available upgrade bundles to see which is the appropriate match. The best match is displayed in the Compatible Upgrade Version box. Sometimes, you might need to perform an interim system software upgrade before you can perform the upgrade you want. The Compatible Upgrade Version box ensures you follow the required upgrade order.

      • Select a bucket from the Destination Bucket list. The bucket you select receives the system bundle you're requesting. Click Change Compartment to select a destination bucket residing in a different compartment.

    8. Click Request System Upgrade Bundle.

      The System Upgrade Bundle Requests list shows the transfer progress for the bundle to the specified destination bucket.

      After the transfer is complete, the upgrade bundle file is stored in the Object Storage bucket, and remains there until you delete it.

    9. (Optional) In the Actions menu (An image of the three dot icon.), click View Details to show more information in the system upgrade bundle request.

      Upgrade bundle request work requests remain listed for 48 hours.
    Task 3 – Transfer the Upgrade Bundle to the Device.
    1. (While still signed in to OCI) After the upgrade bundle transfer is complete, click the Destination bucket name to view the file in the Object Storage bucket.
    2. Next to the upgrade bundle file, click the Actions menu (Actions menu (An image of the three dot icon.)), and select Download.

      The Download Object dialog box is displayed while the object is downloading, and shows the download status.

    3. Copy the downloaded bundle to a computer that you can connect to the same network as the Roving Edge Infrastructure device.

    4. Upload the upgrade bundle to the rover-system-upgrade-staging bucket in Roving Edge Object Storage. See Uploading an Object to an Object Storage Bucket on a Device.

    Task 4 – On the Device, Import the Upgrade Bundle
    1. Sign in to the Device Console of the Roving Edge device you plan to upgrade.

    2. In the navigation menu, click Node Management, then click Offline System Upgrades.

      Previous upgrade bundles are listed. If this is the first upgrade bundle request, the list is empty.

    3. Click Import Bundle.

      The Import Bundle Requests panel is displayed.

    4. Under Object Name, select the upgrade bundle from the drop-down menu.

    5. Click Import Bundle.

      The upgrade bundle is imported to the device and placed in an Object Storage bucket named rover-system-upgrade-staging. When the import is finished, the imported bundle state changes to Imported, and you can proceed to upgrade the device.

    Task 5 – Upgrade the Device
    1. (While still signed in to the Device Console) Ensure that the upgrade bundle import is finished. Click the System Status icon (System Status Icon) in the upper right corner of the Device Console.

      The System Upgrades dialog box displays the status of the various stages of the import process. When the import is complete, the dialog box displays the device's current system software version and the new imported version.

    2. In the navigation menu, select Node Management > Nodes.

    3. On the device node line, click the Actions menu (An image of the three dot icon.), and select Upgrade.

    4. Confirm the upgrade request.

      The System Upgrades dialog box indicates when the upgrade is complete.

      The device is automatically rebooted at the end of the upgrade process. You must unlock the rebooted device using the Serial Console. See Operating the Serial Console.

  • You can use the CLI to perform upgrade preparation tasks, but you can't use the CLI to perform the upgrade. Use the Device Console to upgrade the device.

    Upgrade Preparation CLI Commands

    Note

    The following commands are run on your OCI tenancy. Ensure that you use a CLI profile configured to reach the OCI tenancy.

    • Get the compatible upgrade version: Run the oci rover node rover-bundle-version get command and required parameters to get the compatible upgrade version for a Roving Edge Infrastructure device:

      oci rover node rover-bundle-version get --current-rover-bundle-version current_rover_bundle_version --rover-node-id rover_node_ocid [OPTIONS]
    • Request a system upgrade bundle: Run the oci rover node rover-bundle copy-to-customer command and required parameters to request a system upgrade bundle for a Roving Edge Infrastructure device.

      oci rover node rover-bundle copy-to-customer --bundle-version bundle_version \
      --destination-bucket-name destination_bucket_name --destination-compartment-id destination_compartment_ocid \
      --rover-node-id rover_node_ocid [OPTIONS]
    • List upgrade bundle requests: Run the oci rover node rover-bundle-request list command and required parameters to list the upgrade bundle requests for a Roving Edge Infrastructure device:

      oci rover node rover-bundle-request list --rover-node-id rover_node_ocid [OPTIONS]
                              
    • View the transfer progress for an upgrade request: Run the oci rover node rover-bundle get-status command and required parameters to view the transfer progress for an upgrade request for a Roving Edge Infrastructure device:

      oci rover node rover-bundle get-status --rover-node-id rover_node_ocid --work-request-id work_request_ocid [OPTIONS]
                              
    Note

    The following commands are run on the Roving Edge Device. Ensure that you use a CLI profile configured to reach the device (not your OCI tenancy).

    • Upload the system bundle to the device on an Object Storage bucket named rover-system-upgrade-staging: Run the oci rover device system-upgrade upload-bundle command and required parameters.

      oci rover device system-upgrade upload-bundle --endpoint device_object_storage_endpoint --file bundle_file_path
    • Import the upgrade bundle to an Object Storage bucket on the device: Run the oci rover device system-upgrade import-bundle command.

      oci rover device system-upgrade import-bundle --object-name object_name

      where object_name is the name of the upgrade bundle object. For example: 2.5.3.20230808163434.rover_disconnected_release.tar.

    • View all import tasks: Run the oci rover device system-upgrade get-import-history command.

      oci rover device system-upgrade get-import-history --endpoint upgrade_endpoint
    • View a specific task: Run the oci rover device system-upgrade get-import-status command.

      oci rover device system-upgrade get-import-status --endpoint upgrade_endpoint --task-id task_ocid --wait true|false

    After the import status indicates COMPLETED, you can proceed with the normal system software upgrade using the Device Console.

  • This task can't be performed using the API.