Scope
This article applies to any platform running the Ubuntu Server 20.04 LTS operating system.
Description
This article demonstrates the upgrade process for anyone who is using a Telos supplied server (eg: a Telos Infinity VIP Server or a Telos Alliance AP-3000) or is using a COTS server imaged with Ubuntu Server 20.04 LTS and is not familiar with the Ubuntu Server upgrade procedure, but has familiarity with a CLI (command line interface).
Prerequisites
A platform running Ubuntu Server 20.04 LTS
Internet access to AWS S3 and Canonical repositories
[Optional] Physical access to the platform
IMPORTANT NOTES
PLEASE READ BEFORE PROCEEDING WITH THIS UPDATE!
During this update, services running on the platform will be offline for several minutes. Be sure to have a backup plan ready, or perform the update at a time when the services can be off air.
Procedure
Run the command below to update the configuration of the /etc/default/grub file, to update it to our latest best practices:
curl -sSf https://telos-public.s3.amazonaws.com/devops/low-latency-kernel/install-low-latency-kernel.sh | bashRun the command below to verify that the /etc/default/grub file has been updated correctly:
cat /etc/default/grub | grep "GRUB_DEFAULT"
Run the command below to upgrade all packages to the latest version:
sudo apt update && sudo apt -y upgradeRun the command below to start the 22.04 LTS upgrade process. It is NOT recommended to do it via SSH, therefore if you have access to the machine via other means (physical, IPMI), we recommend proceeding that way.
During the upgrade process you will be prompted multiple times, please refer to steps 5-11.
Prompts that are not listed here pertain to modifications not done by Telos Alliance tools or existing doc, therefore refer to your IT department or to the official Canonical documentation.
sudo do-release-upgradeIf you are connected via SSH, you will be prompted to open a temporary ssh server and add the relevant iptables rule. Consult with your IT department if it is safe to do so in your environment. At the end of the upgrade process, the temporary ssh server and the iptables rule will be automatically removed.
You will be presented with the list of package changes. Enter d for more details, or enter y to proceed with the upgrade.
You will be prompted to restart various services during the upgrade process. If you are NOT connected via SSH, it is safe to choose Yes. If you are connected via SSH, choose No and evaluate each service carefully.
You will be prompted to keep or update the /etc/sysctl.conf file. Choose N.
You will be prompted to keep or update the /etc/default/grub file. Choose the default option Keep the local version currently installed:
You will be prompted to remove packages that are now unused. The number of packages may vary. Choose y.
Once the upgrade is complete, you will be prompted to reboot. Choose y.
Once the system comes back online, run the command below to verify you are running 22.04. At the time of writing, the latest version is 22.04.5, but newer versions are to be expected in the future.
lsb_release -d
Once the system returns online, run the command below to verify you are running the correct kernel. At the time of writing, the latest version is 5.15.0-124-lowlatency, but newer versions are to be expected in the future.
uname -r
Run the command below to verify no more updates are available:
sudo apt update && sudo apt -y upgrade
If unused packages or kernels are still present, run the command below to remove them:
sudo apt autoremove
Let us know how we can help
If you encountered issue, have further questions on this topic or have ideas about improving this document, please contact us at support@telosalliance.com