Your 128T router or conductor must have internet access to download the latest software packages; for deployments where the 128T router does not have internet access, you can use the 128T conductor as a repository (or proxy) to retrieve software images. As with any upgrade activity, it is always prudent to create a backup of your current software configuration before initiating any upgrade activity.
There are three standard ways of upgrading routers:
- Using the conductor's PCLI to initiate the upgrade
- Using the conductor's GUI to initiate the upgrade
- Manually upgrading a router by invoking the
install128tapplication from the Linux shell
The router upgrade process using the PCLI and the GUI is done in two stages: first, the software is downloaded, then it is installed. Using the
install128t application steps through both of these processes.
Stopping the 128T Routing Software
Before upgrading the 128T Routing Software, use the following procedure to stop the the software.
- Launch a Linux shell window.
- Execute the commandsudo systemctl stop 128T
- Verify that the software has stopped by executing the commandResult: The software is listed as inactive (dead).sudo systemct1 status 128T
- Close the Linux shell.
Upgrading using the Conductor's PCLI
For routers managed by a 128T Conductor, upgrades can be initiated via the 128T conductor's PCLI. This upgrade process is completed in two stages: download followed by upgrade.
As an administrator-level user, log into the conductor's PCLI.
Use the command
show assetsto list the devices managed by this conductor, and the software revision each asset is currently running.
For a given asset, use the command
show asset [asset ID]or
show asset software router [router name]to view the available software upgrades for that asset. The list will be in the section labeled "Available for Download" at the end of the output.
If there are software releases absent from the list that you are confident should appear, use the command
send command yum-cache-refresh router [router name]to refresh the software list.
send command download router [your router name] [software version]. You can monitor the progress by using the
show asset [asset ID]command, which will indicate Automated Provisioner status (e.g., downloading).
Once the download is complete, use the command
send command upgrade router [your router name]to initiate the upgrade process.
The conductor's automated provisioner will upgrade both nodes in a high availability router in series to minimize/avoid downtime. Despite this, it is still recommended to perform upgrade activity during periods of low traffic or maintenance windows.
Upgrading using the Conductor's GUI
Similar to the process for upgrading using the PCLI, the GUI upgrade process using the GUI is done in two stages: download and upgrade.
- Navigate to the Router page in the Conductor's UI. Routers that have available upgrades will indicate as such using a blue upgrade badge in the router list.
- Click on the Upgrade 128T icon (the arrow within a circle) next to your router. Result: a list of upgrade and download options appears. This list is filterable if the list of available options grows large.
- Click on the target release in the Available Downloads section of the list. You will be asked to confirm the operation.
Result: the 128T will begin downloading the software. Click on the router in the router list to monitor its progress.
- Once complete, click the Upgrade 128T icon again, and select the target software release from the Available Upgrades list. You will again be asked to confirm this operation.
Result: the router will now begin the upgrade process.
The Automated Provisioner will upgrade both nodes in a high availability router in series to minimize/avoid downtime. Despite this, it is still recommended to perform upgrade activity during periods of low traffic or maintenance windows.
Upgrading using the Interactive Installer
Launch a Linux command prompt window on the node you wish to upgrade.
Enter the command to launch the installer.sudo install128t
Result: The 128T splash screen appears.
install128tapplication will check to see if it has an update available, and will ask that you upgrade if it detects a newer version is available.
Press the enter key to select Begin and start the installation wizard.
When prompted, select Upgrade.
Result: The application queries 128 Technology's software repository for new software.
Select the desired software version from the list of available options.
Once the upgrade is complete, press the enter key to select Yes to start your software.
Your output may vary based upon the nature of the upgrade, occasion, various packages, and dependencies that 128T requires as part of the 128T Routing Software upgrade.
Routers with Restricted Internet Access
The standard upgrade workflow is for individual instances of 128T software to download software upgrades directly from mirror servers hosted and managed by 128 Technology on the public internet. Occasionally, 128T routers are deployed in locations with restricted or no access to the internet. In this case, you can configure the routers to retrieve software from conductor.
Within a given router's configuration, at
router > system > software-update > repository, you can configure the
source-type setting to one of three values:
conductor-only: the router will retrieve software versions only from (or through) the conductor
prefer-conductor: the router will retrieve software versions from the conductor, and fall back to using the internet
internet-only(default): the router will use 128 Technology's publicly hosted repositories for retrieving sofwtare images
Because this is a router setting, your collection of routers can each use different preferences. E.g., a router in on the internet can use 128 Technology's repository, but another router managed by the same conductor sitting in an isolated environment can use the conductor.
For routers that have no access to the internet, at
router > system > software-update > repository > offline-mode to
true. This overrides the
import iso command can be used to import packages contained within a 128T ISO onto a local yum repository, thereby allowing that 128T to be upgraded without contacting to 128 Technology servers.
import iso command allows user to specify the exact
filepath to the ISO or specify
hunt which will look everywhere on disk for a file that matches the pattern
128T*.iso except for the following directories
This feature works on either Conductor or Routers. It can be combined with Conductor Hosted Repos feature where the ISO is imported on the Conductor and then Routers use the Conductor as the yum repository to download 128T packeges from.
Once the local software repository has been updated to the software from the ISO, the upgrade can proceed using your preferred method.