Upgrading the USS Gateway from 20.04 LTS to 22.04 LTS.
Upgrade the USS Gateway from 20.04 to 22.04
This KB will take you through the process of upgrading the USS Gateway from Ubuntu 20.04 to 22.04
Pre-Upgrade steps
- Important! Follow the first part of the article, Migrating the SSL Intercept certificate to a new server and store the
.pem
somewhere safe. - If your USS Gateway is running on virtual infrastructure, ensure you take a snapshot in case you need to roll back.
- Backup Your Data:
- Use tools like
rsync
orDeja Dup
to back up important files. - Backup critical system configurations if you have customised the system.
- Use tools like
- Ensure Disk Space:
- The upgrade process requires sufficient disk space (usually 1–2 GB additional for the upgrade files).
- Log in to the Command Line, then
sudo su
to switch to the root account. - Check the current version of Ubuntu by typing
cat /etc/issue
- you should see version 20.04 - Run these commands to ensure your system is fully updated before upgrading:
sudo apt-get update && apt-get upgrade
SelectY
if prompted. This will determine previous updates that need installing and install them.sudo apt dist-upgrade
SelectY
if prompted.sudo apt autoremove
SelectY
if prompted.
- Upgrade to the latest version of the 20.04 USS Gateway. At the time of writing, this is 2.0.71 (see Download)
dpkg -l | grep ussgateway
. This will confirm the current version of the USS Gateway software- If your version is not the latest, download the latest USS Gateway package by typing this command.
wget https://downloads.clouduss.com/gateway/packages/ussgateway_20.04_<VERSION>_amd64.deb
replacing the<VERSION>
with the latest release, e.g. 2.0.71 (see Download) - Update packages:
sudo apt update
And press Enter - Install new Gateway package:
sudo apt -f install ./ussgateway_20.04_<VERSION>_amd64.deb
replacing the<VERSION>
with the latest release, e.g. 2.0.71 (see Download) - Press
Y
when prompted to install the new packages - Follow any further prompts and accept any defaults if asked
Perform the Upgrade
- Install the update manager:
sudo apt install update-manager-core
and select Y if prompted.
- Edit the Update Manager file:
- Type to view the current default setting
cat /etc/update-manager/release-upgrades
- Type
nano /etc/update-manager/release-upgrades
this will allow the file to be edited. Use the arrow keys to move down to changePrompt=never
toPrompt=lts
- Press
control x, then Y to Save
- Select
enter
, and then you will return to the command prompt.
- Begin the upgrade process.
- Type
sudo do-release-upgrade
When prompted, press[ENTER]
to continue. This will check what packages are available. - Press
Y
to Continue. This will start the process of downloading files from Ubuntu.
- At this screen, select
Yes
.
- At this screen, select
Y
to keep the current version.
- At this screen, select
Y
to keep the current version.
- At this screen, select
Y
to keep the current version.
- At this screen, select
OK
to keep the current version.
- At this screen, select
Y
to remove the obsolete packages.
- At this screen, select
Y
to Restart the USS Gateway and load the new version of Ubuntu. - Log in to the Command Line, then
sudo su
to switch to the root account. - Install the latest version of the 22.04 USS Gateway by running these commands. At the time of writing this is 2.0.71 (see Download)
- Download the latest USS Gateway package by typing this command.
wget https://downloads.clouduss.com/gateway/packages/ussgateway_22.04_<VERSION>_amd64.deb
replacing the<VERSION>
with the latest release, e.g. 2.0.71 (see Download) - Update packages:
sudo apt update
And press Enter - Install new Gateway package:
sudo apt -f install ./ussgateway_22.04_<VERSION>_amd64.deb
replacing the<VERSION>
with the latest release, e.g. 2.0.71 (see Download) - Press
Y
when prompted to install the new packages - Follow any further prompts and accept any defaults if asked
- Check if the USS Gateway is now running the latest version. Type
dpkg -l | grep ussgateway
- Log in to the Gateway User Interface to check the status of the system
- If the proxy service does not show as started, install the newest
libltdl7
.
- Type
apt-get install libltdl7
Then selectY
- Once installed type:
systemctl start uss-squid5
to start the proxy service.
Post-Upgrade steps.
Once the USS Gateway has upgraded, complete the steps below.
- Check the version of Ubuntu by typing.
cat /etc/issue
- it should now show 22.04
- Check the Update Manager file.
- Type to view the current default setting
cat /etc/update-manager/release-upgrades,
if it still shows thePrompt=lts
then follow the steps below. - Type
nano /etc/update-manager/release-upgrades
this will allow the file to be edited. Use the arrow keys to move down to changePrompt=lts
toPrompt=never
- Press
control x, then Y to Save,
- Select
enter
, and then you will return to the command prompt.
- Type,
cat /etc/update-manager/release-upgrades
to confirm the save has been completed and the Prompt=never
The USS Gateway has now completed the upgraded process to Ubunti 22.04 LTS.