StableReleaseUpdates

Differences between revisions 1 and 405 (spanning 404 versions)
Revision 1 as of 2006-09-11 22:08:06
Size: 1080
Editor: studiocity-motorola-bsr1-70-36-194-85
Comment: start drafting
Revision 405 as of 2026-03-24 09:33:35
Size: 13923
Editor: sally-makin
Comment: Update redirecting links to new destinations
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Once an Ubuntu release has been completed and published, updates for it are only released under certain circumstances, and must follow a special procedure. ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||

{{{#!wiki warning
SRU documentation has moved to https://documentation.ubuntu.com/project/SRU/stable-release-updates/index.html

See the announcement: https://lists.ubuntu.com/archives/ubuntu-devel/2024-August/043090.html
}}}
Line 5: Line 11:
In contrast to pre-release versions, official releases of Ubuntu are subject to much wider use, and by a different demographic of user. During development, changes to the distribution primarily affect developers, early adopters and other advanced users, all of whom have elected to use pre-release software at their own risk.

Users of the official release, in contrast, expect a high degree of stability. They use their Ubuntu system for their day-to-day work, and problems they experience with it can be extremely disruptive. Many of them are less experienced with Ubuntu and with Linux, and expect a reliable system which does not require their intervention.

Therefore, when changes are necessary, both a strong rationale and a low risk of regressions must be provided in order to avoid exposing users to inappropriate risks.
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/explanation/principles/ and https://documentation.ubuntu.com/project/SRU/explanation/requirements/
}}}
Line 13: Line 17:
guidelines/criteria

== How ==

update procedure
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/requirements/#what-is-acceptable-to-sru
}}}

=== High-impact bugs ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#what-is-acceptable-to-sru

=== Other safe cases ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#other-safe-cases

=== New upstream microreleases ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#new-upstream-microreleases

=== Staging low priority uploads ===

See: https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#explanation-staged-uploads

=== ESM Uploads ===

See: https://documentation.ubuntu.com/project/SRU/reference/special/

<<Anchor(GeneralRequirements)>>
== General Requirements ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/requirements/#general-requirements-for-all-srus
}}}

=== Development Release Fixed First ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#general-requirements-for-all-srus

=== Newer Releases ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#general-requirements-for-all-srus

== Procedure ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/howto/standard/
}}}

=== SRU Bug Template ===

See: https://documentation.ubuntu.com/project/SRU/reference/bug-template/

=== Bug references in changelogs ===

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#bug-references-in-changelogs

=== Staging an upload ===

See: https://documentation.ubuntu.com/project/SRU/howto/special/#stage-an-upload

==== Landing an upload blocked by staging ====

See: https://documentation.ubuntu.com/project/SRU/howto/special/#land-an-upload-blocked-by-staging

==== Responsibility for SRU verification and cancellation of incomplete verification ====

See: https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#explanation-staged-uploads

== Publishing ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/howto/release/
}}}

== Phasing ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/explanation/standard-processes/#phasing
}}}

=== Investigation of Halted Phased Updates ===

See: https://documentation.ubuntu.com/project/SRU/howto/phasing/

=== SRU team documentation ===

See: https://documentation.ubuntu.com/project/SRU/internal/#override-phasing

== Verification ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/howto/standard/ and https://documentation.ubuntu.com/project/SRU/howto/regression/#howto-report-regression
}}}

=== Autopkgtest Regressions ===

See: https://documentation.ubuntu.com/project/SRU/howto/autopkgtest-failure/

==== Expected resolution for reported autopkgtest failures ====

See: https://documentation.ubuntu.com/project/SRU/howto/autopkgtest-failure/

== Removal of updates ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#removal-of-languishing-updates
}}}

== Regressions ==
<<Anchor(regressions)>>

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/howto/regression/#howto-report-regression
}}}

=== Testing for Regressions ===

(defunct section removed)

<<Anchor(Special)>>
== Documentation for Special Cases ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/

See the announcement: https://lists.ubuntu.com/archives/ubuntu-devel/2025-June/043391.html
}}}

=== Kernel ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#kernel
}}}

=== Landscape ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#landscape
}}}

=== Snapd ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#snapd
}}}

=== Snapcraft ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#snapcraft
}}}

=== Ubuntu-image ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#ubuntu-image
}}}

=== Docker.io group ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#docker-io-group
}}}

=== gce-compute-image-packages ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#gce-compute-image-packages
}}}

=== google-compute-engine ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#google-compute-engine
}}}

=== google-compute-engine-oslogin ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#google-compute-engine-oslogin
}}}


=== google-guest-agent ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#google-guest-agent
}}}

=== google-osconfig-agent ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#google-osconfig-agent
}}}

=== curtin ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#curtin
}}}


=== walinuxagent ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#walinuxagent
}}}

=== GNOME ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#gnome
}}}


=== OpenStack ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#openstack
}}}

=== Certbot ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#certbot
}}}

=== cloud-init ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#cloud-init
}}}


=== DPDK ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#dpdk
}}}

=== ubuntu-release-upgrader and python-apt ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#ubuntu-release-upgrader-and-python-apt
}}}

=== apt and python-apt ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#apt-and-python-apt
}}}

=== rax-nova-agent ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#rax-nova-agent
}}}

=== livecd-rootfs ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#livecd-rootfs
}}}

=== fwupd and fwupdate ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#fwupd-and-fwupdate
}}}

=== snapd-glib ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#snapd-glib
}}}

=== netplan.io ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#netplan-io
}}}

=== ec2-hibinit-agent ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#ec2-hibinit-agent
}}}

=== NVIDIA driver ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#nvidia-driver
}}}

=== wslu ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#wslu
}}}

=== openjdk-N ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#openjdk-n
}}}

=== Postfix ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#postfix
}}}

=== sosreport/sos ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#sosreport-sos
}}}

=== oem-*-meta ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#oem-meta
}}}

=== ubuntu-dev-tools ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#ubuntu-dev-tools
}}}

=== OpenLDAP ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#openldap
}}}

=== HAProxy ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#haproxy
}}}

=== autopkgtest ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#autopkgtest
}}}

=== squid ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#squid
}}}

=== bind9 ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#bind9
}}}

=== virtualbox ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#virtualbox
}}}

=== ubuntu-advantage-tools ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#ubuntu-advantage-tools
}}}

=== open-vm-tools ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#open-vm-tools
}}}

=== postgresql ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#postgresql
}}}

=== GRUB ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#grub
}}}

=== OpenVPN ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#openvpn
}}}

=== Language Packs (language-pack-*) ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#language-packs-language-pack
}}}

=== cd-boot-images-<arch> ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#cd-boot-images-arch
}}}

<<Anchor(Security)>>
== Data Packages Kept in Sync with Security ==
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#data-packages-kept-in-sync-with-security
}}}

=== tzdata ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#tzdata
}}}

=== distro-info-data ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#distro-info-data
}}}

=== linux-firmware ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#linux-firmware
}}}

=== wireless-regdb ===
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#wireless-regdb
}}}

== Toolchain Updates ==
{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/package-specific/#toolchain-updates
}}}

== Examples ==

As a reference, see [[https://launchpad.net/bugs/173082|bug #173082]] for an idea of how the SRU process works for a main package, or [[https://launchpad.net/bugs/208666|bug #208666]] for an SRU in universe.

== Package Removals ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#explanation-removals
}}}

== Links ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/reference/status/
}}}

== Reviewing procedure and tools ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/internal/#reviewing-procedure-and-tools
}}}

== Contacting the SRU team ==

{{{#!wiki warning
This section has moved to https://documentation.ubuntu.com/project/SRU/howto/contact/
}}}
----
CategoryProcess

Why

When

High-impact bugs

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#what-is-acceptable-to-sru

Other safe cases

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#other-safe-cases

New upstream microreleases

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#new-upstream-microreleases

Staging low priority uploads

See: https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#explanation-staged-uploads

ESM Uploads

See: https://documentation.ubuntu.com/project/SRU/reference/special/

General Requirements

Development Release Fixed First

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#general-requirements-for-all-srus

Newer Releases

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#general-requirements-for-all-srus

Procedure

SRU Bug Template

See: https://documentation.ubuntu.com/project/SRU/reference/bug-template/

Bug references in changelogs

See: https://documentation.ubuntu.com/project/SRU/reference/requirements/#bug-references-in-changelogs

Staging an upload

See: https://documentation.ubuntu.com/project/SRU/howto/special/#stage-an-upload

Landing an upload blocked by staging

See: https://documentation.ubuntu.com/project/SRU/howto/special/#land-an-upload-blocked-by-staging

Responsibility for SRU verification and cancellation of incomplete verification

See: https://documentation.ubuntu.com/project/SRU/explanation/non-standard-processes/#explanation-staged-uploads

Publishing

Phasing

Investigation of Halted Phased Updates

See: https://documentation.ubuntu.com/project/SRU/howto/phasing/

SRU team documentation

See: https://documentation.ubuntu.com/project/SRU/internal/#override-phasing

Verification

Autopkgtest Regressions

See: https://documentation.ubuntu.com/project/SRU/howto/autopkgtest-failure/

Expected resolution for reported autopkgtest failures

See: https://documentation.ubuntu.com/project/SRU/howto/autopkgtest-failure/

Removal of updates

Regressions

Testing for Regressions

(defunct section removed)

Documentation for Special Cases

Kernel

Landscape

Snapd

Snapcraft

Ubuntu-image

Docker.io group

gce-compute-image-packages

google-compute-engine

google-compute-engine-oslogin

google-guest-agent

google-osconfig-agent

curtin

walinuxagent

GNOME

OpenStack

Certbot

cloud-init

DPDK

ubuntu-release-upgrader and python-apt

apt and python-apt

rax-nova-agent

livecd-rootfs

fwupd and fwupdate

snapd-glib

netplan.io

ec2-hibinit-agent

NVIDIA driver

wslu

openjdk-N

Postfix

sosreport/sos

oem-*-meta

ubuntu-dev-tools

OpenLDAP

HAProxy

autopkgtest

squid

bind9

virtualbox

ubuntu-advantage-tools

open-vm-tools

postgresql

GRUB

OpenVPN

Language Packs (language-pack-*)

cd-boot-images-<arch>

Data Packages Kept in Sync with Security

tzdata

distro-info-data

linux-firmware

wireless-regdb

Toolchain Updates

Examples

As a reference, see bug #173082 for an idea of how the SRU process works for a main package, or bug #208666 for an SRU in universe.

Package Removals

Reviewing procedure and tools

Contacting the SRU team


CategoryProcess

StableReleaseUpdates (last edited 2026-03-24 09:33:35 by sally-makin)