Updating the Roving Edge Infrastructure Device Software while Disconnected
Describes how to updating the Roving Edge Infrastructure device software while the device is not connected to the internet.
You can update your Roving Edge Infrastructure device's system software while in a disconnected or offline state. Request a system update through your device's Roving Edge Infrastructure Node resource in the Oracle Cloud Infrastructure Cloud. After the update bundle is copied to the destination bucket, download it to a local device such as a laptop computer. Upload the system update bundle to your Roving Edge Infrastructure device using object storage.
You must have the required permissions to perform a software update on a disconnected Roving Edge Infrastructure device. See Enabling Disconnected Upgrade Bundle Delivery.
Upgrading your Roving Edge Infrastructure device's system software while in a disconnected state is only available for individual device nodes.
-
Access the Device Console for the device node you are configuring for a system update.
-
Click the System Status icon (
) in the upper right corner of the Device Console. The System Upgrades dialog box appears, indicating any available software updates. It also displays your current software version and version number of the software update.
-
Record the current system software version. You will use it later in the update.
-
Log into the Oracle Cloud Infrastructure Cloud Console.
-
Open the navigation menu and click Hybrid. Under Roving Edge Infrastructure, click Nodes. The Nodes page appears.
-
Select the Compartment from the list. All nodes in that compartment are listed in tabular form.
-
Select Active under State. Your device must be in the Customer Received or Customer Deployed as listed in the state details to request a system update bundle.
-
Click the device node that you want to configure for disconnected system update. The Node Details page appears.
-
Click System Upgrades under Resources. The System Upgrade Bundle Request list appears. All the system update requests are listed in tabular form. The upgrade bundles only remain listed for 48 hours. Previously-completed bundle transfers remain in object storage indefinitely until you remove them.
-
Click Request System Upgrade Bundle. The Request Node Upgrade Bundle dialog box appears.
-
Take the current system software version of the device that you recorded at the beginning of these steps, and enter it in the Current Software Version box and click Get Next Upgrade Version. The version number you enter is compared with the available update bundles to see which is the appropriate match. The best match is displayed in the Compatible Upgrade Version box. In some cases, you might need to perform an interim system software update before you can perform the update you want. The Compatible Upgrade Version box ensures you follow the required update order.
-
Select a bucket from the Destination Bucket list. The bucket you select receives the system bundle you are requesting. Click Change Compartment if you want to select a destination bucket residing in a different compartment.
-
Click Request System Upgrade Bundle. The System Upgrade Bundle Requests list shows the transfer progress for the bundle to the specified destination bucket. Click View Details from the Action menu to show more information in the system update bundle request.
As an alternative to using the Oracle Cloud Infrastructure Cloud Console to perform device software update tasks, you can use the following command line interface tools:
-
Getting 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]
-
Listing the 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]
-
Requesting 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]
-
Viewing 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]
-
-
After your upgrade bundle request has completed transferring, access it from the destination bucket on Oracle Cloud Infrastructure object storage. Download the upgrade bundle to the local computer or laptop from which you are accessing OCI. See Downloading an object.
Note
System update bundles can be very large. They can take a long time to download. Plan accordingly.
-
Copy the downloaded bundle to a laptop or computer that you can connect to the same network as the Roving Edge Infrastructure device.
-
Upload the system update bundle from the storage device to your Roving Edge Infrastructure device. See Uploading an Object for Roving Edge Infrastructure. Copy the bundle to the "rover-system-upgrade-staging" bucket in object storage.
-
Review how to set up and use the CLI as described in Using the Command Line Interface. After the bundle is uploaded to the bucket, open a command line window and run the oci rover device system-upgrade upload-bundle command:
oci rover device system-upgrade upload-bundle --endpoint object_storage_endpoint --file bundle_file_path
You can then view all import tasks by running the oci rover device system-upgrade get-import-history command:
oci rover device system-upgrade get-import-history --endpoint upgrade_endpoint
To 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
To start the upgrade, 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 object/release bundle. For example:2.5.3.20230808163434.rover_disconnected_release.tar
.After the import status indicates "COMPLETED", you can proceed with the normal system software update using the Device Console.
-
Click the System Status icon (
) in the upper right corner of the Device Console. The System Upgrades dialog box displays the time stamp and name of the system update bundle, as well as the status of the various stages during the upload process. When the upload is complete, the dialog box displays the device's current system software version and the new version installed from the system update bundle.
-
Open the navigation menu and select Node Management > Nodes. The Nodes page appears. All of the device nodes are listed in tabular format.
-
Click Upgrade next to the device node you want to update. Confirm the update request. The software version you selected is downloaded onto your Roving Edge Infrastructure device. The System Upgrades dialog box indicates when the installation is complete.
The device is automatically rebooted at the end of the update process. You must unlock the rebooted device using the Serial Console. See Unlock the Device.