Upgrade from Focal to Jammy on IBM VPC¶

General Advice¶

Once you have decided to upgrade your system, the next question is how? There are two options depending on whether your system is setup/deployed with automation or whether it requires manual configuration.

For fully automated system deployments it is recommended to redeploy with new Jammy instances instead of upgrading from Focal.

For systems that cannot be easily created or destroyed and require manual configuration, running do-release-upgrade is a good option. However this option requires some manual intervention as explained below.

Manual intervention steps¶

While upgrading from Focal to Jammy, manual decision making will be needed for the following options that are presented.

Additional SSH daemon¶

When upgrading in a session over SSH there is an inherent risk of losing access if something goes wrong with the SSH daemon. To mitigate this risk an additional SSH daemon is started on a different port as a backup.

The prompt notifies you that an additional SSH daemon will be started and you can either continue or cancel the upgrade.

../../_images/0_additional_ssh_daemon.png

Update sources.list¶

Since the IBM VPC Focal image is configured to use internal mirrors by default, the sources.list entries will likely need to be updated from ‘focal’ to ‘jammy’. Confirm ‘Y’ on the prompt to automatically update the sources.list entries.

Start upgrade¶

A final prompt is provided before starting the upgrade. It gives information about the number of changes and the estimated time to complete because once started, the upgrade process cannot be cancelled. At this stage you can continue, cancel or see additional details.

Restart services automatically¶

During the upgrade of certain libraries, some services have to be restarted. You have the option of allowing the services to be restarted automatically during the upgrade. If you select ‘no’ here, you’ll be asked about the services that you want to restart after each library upgrade.

SSHD configuration modified¶

Canonical makes changes to /etc/ssh/sshd_config for IBM VPC images. As a result, during upgrade you’ll see a prompt notifying you about the availability of a newer version of the sshd_config file. You’ll be asked if you want to keep the existing modified version, use the default one from the new upgrade or take some other action.

../../_images/4_sshd_modified_config.png

Restart to finish upgrade¶

Finally, a restart will be necessary for some parts of the upgrade to be applied. If you select no, you can use /var/run/reboot-required.pkgs to check for the packages that need a reboot.