pop-upgrade

Utility for upgrading Pop!_OS and its recovery partition to new releases. This tool will be used as a replacement for Ubuntu's do-release-upgrade script. The goal is to be less error-prone, ensuring that critical packages are retained on upgrade, and better integration with Pop!_OS.

Dbus API

When launched in daemon mode (requires root), a new Dbus service will be registered, with the following details:

Interface: com.system76.PopUpgrade
Name: com.system76.PopUpgrade
Path: /com/system76/PopUpgrade

DBus Methods

FetchUpdates (additional_strings: as, download_only: b) -> (updates_available: b, completed: s, total: s)
- Creates a task which will fetch all available updates, including the additional packages.
- If an update task is already in progress, completed and total will have non-zero values.
- If updates_available returns false, then there are no packages to fetch.
- Unless download_only is specified as true, the packages will also be installed.
RecoveryUpgradeByFile (path: s) -> (result: y)
- Creates a task which will upgrade the recovery partition via a file ath the path.
RecoveryUpgradeByRelease (version: s, arch: s, flags: q) -> (result: y)
- Creates a task which will upgrade the recovery partition via the release API, using the defined details.
- If package updates are available, a FetchUpdates task will execute beforehand.
- how defines how the recovery partition should be upgraded.
  - Possible options are file and release.
- version defines the suite to fetch from (ie: 20.04)
- arch defines which variant of that version to fetch (ie: nvidia)
- flags sets additional configuration parameters for the task
RefreshOS () -> (result: y)
ReleaseCheck () -> (current: s, next: s, build: n)
- Quickly checks the current release, determines the next release, and states whether an update is available or not.
ReleaseUpgrade (how: q, from: s, to: s)
- Creates a task to initiate a distribution release upgrade.
- The from defines which suite to upgrade from.
- The to defines the suite to upgrade to.
- The upgrade method performed is determined by the how.
  - 1 will use systemd to perform an offline upgrade.
  - 2 will use the recovery partition to perform an offline upgrade.
  - Any other value will result in an error.
ReleaseRepair ()
- Performs automatic repairs of any issues found which may impact system operation
  - The /etc/fstab file will be corrected if certain mounts are missing or are mounting by the wrong ID
  - Source lists will also be parsed and corrected if they are missing any critical repositories
Status () -> (status: q, sub_status: q)
- Reports the current status of the daemon, where zero indicates inactivity.
- If that status has a sub_status, it will be set to a non-zero value.
- The available statuses for the main status are:
  - 0: Inactive,
  - 1: Fetching Packages,
  - 2: Recovery Upgrade,
  - 3: Release Upgrade,
  - 4: Package Upgrade
UpgradePackages ()
- Upgrades packages for the current release, similar to performing a non-interactive upgrade normally.

DBus Signals

PackageFetchResult (status: q)
- Indicates that a FetchUpdates task completed
- A status of 0 indicate success, whereas 1 indicates failure
PackageFetched (package: s, completed: u, total: u)
- An event that is triggered when a FetchUpdates task has fetched a package.
- package refers to the name of the package that was fetched.
- completed and total can be used to track the progress of the task.
PackageFetching (package: s)
- An event that is triggered when a FetchUpdates task has begun fetching a new package.
- package refers to the name of the package that was fetched
PackageUpgrade (event: a{ss})
- The ADT is represented as a map of field-value pairs.
RecoveryDownloadProgress (progress: t, total: t)
- Tracks the progress of the recovery files being fetched
RecoveryUpgradeEvent (event: q)
- Notifies the client of a recovery upgrade event that has occurred
RecoveryUpgradeResult (result: y)
- Indicates the final result of the recovery upgrade process
ReleaseUpgradeEvent (event: q)
- Notifies the client of a release upgrade event that has occurred
ReleaseUpgradeResult (result: y)
- Indicates the final result of the recovery upgrade process

Recovery Upgrade Event

Fetching (1): fetching recovery files
Syncing (2): syncing recovery files with recovery partition
Verifying (3): verifying checksums of fetched files
Complete (4): recovery partition upgrade completed
Failed (5): recovery partition upgrade failed

Release Upgrade Event

UpdatingPackageLists (1): updating package lists for the current release
FetchingPackages (2): fetching updated packages for the current release
UpgradingPackages (3): upgrading packages for the current release
InstallingPackages (4): ensuring that system-critical packages are isntalled
UpdatingSourceLists (5): updating the source lists to the new release
FetchingPackagesForNewRelease (6): fetching packages for the new release
AttemptingLiveUpgrade (7): attempting live upgrade to the new release
AttemptingSystemdUnit (8): creating a systemd unit for installing the new release
AttemptingRecovery (9): setting up the recovery partition to install the new release
Success (10): new release is ready to install
SuccessLive (11): new release was successfully installed
Failure (12): an error occurred while setting up the upgrade

License

Licensed under the GNU General Public License, Version 3.0, (LICENSE or https://www.gnu.org/licenses/gpl-3.0.en.html)

Contribution

Any contribution intentionally submitted for inclusion in the work by you, shall be licensed under the GNU GPLv3.

isms/upgrade