To be carried out by: Ubuntu Release Team
- Unblock development process for new release as quickly as possible.
- Prepare for first milestone CD release.
Bugs related to this process are tagged with new-release-cycle-process. If you discover new glitches or things that can be automated, please file a bug with that tag.
Previous release minus 1 month
- Contact Soyuz development/production teams to ensure there are no known outstanding issues that will prevent on-time opening of the new distroseries.
If there is a release scheduled to End of Life, start off EndOfLifeProcess for it.
- Remind toolchain developers to begin preparing the new toolchain.
- Confirm final schedule for the new release and communicate key release dates
- Create codenameReleaseSchedule page
- Update Fridge calendar?
- Canonical calendars
Previous release minus 2 weeks
- Double-check with Soyuz development/production teams.
Ask for the maillist distroseries-changes to be set up by sending email to firstname.lastname@example.org to file an RT ticket.
- Subscribe gmane to distroseries-changes mailing list, once it's available.
Previous release plus 1 day
Create new seed branches based on those for the previous release, and push them to the appropriate subdirectories of bzr+ssh://bazaar.launchpad.net/~ubuntu-core-dev/ubuntu-seeds/. The branch-seeds script in lp:ubuntu-archive-tools can do the hard work here.
- Notify Colin Watson to set up seed mirrors and germinate output for the new distroseries.
- Disable the Soyuz publisher cron jobs.
- Ensure that the Bazaar package importer on jubany is stopped.
Notify a Launchpad admin to create new distroseries with status FROZEN.
- Create milestones in the new series:
ubuntu-$version-month-1 etc., set at monthly intervals after the previous release until feature freeze
ubuntu-$version-feature-freeze at feature freeze
ubuntu-$version-beta or ubuntu-$version-beta-1 etc. as required
ubuntu-$version at the next release date
Check that the new distroseries exists with status FROZEN, and that the previous distroseries has status CURRENT.
Visit http://launchpad.net/ubuntu/<series> and click "Initialize Series" in the top right menu. Select which Debian parents you want for this series (it defaults to the existing ones), which architectures you want, ensure "Copy Source And Binaries" is selected and click the "Initialize Series" button.
Notify a webops to run branch-distro to initialize branches for the new series.
- Re-enable the Soyuz publisher cron jobs and wait for the first run to complete.
As ubuntu-archive@snakefruit, use compare-archives to compare dists trees under ~/mirror/ubuntu/ for previous and current distroseries and sign off on any differences; the only differences should be the distroseries name, that custom uploads (installer-*, dist-upgrader-all, and i18n) are missing from dists/DSN/main, that Release.gpg does not yet exist (this will be created when the full publisher cron job next runs), and that Contents-*.gz do not yet exist (these will be created when generate-contents next runs).
Verify that the partner repository has been created on archive.canonical.com as a result of this process; if not, notify the Soyuz developers to fix it and check that this happens.
Grant ~ubuntu-sru queue admin access to the previous distroseries (for pocket in proposed updates; do edit-acl -p ubuntu-sru -S PREVIOUS --pocket $pocket -t admin add; done) and remove ~ubuntu-release's queue admin access (for pocket in release proposed; do edit-acl -p ubuntu-release -S PREVIOUS --pocket $pocket -t admin delete; done).
Check that the process of initialising the new distroseries granted queue admin access to ~ubuntu-release to the new distroseries (edit-acl -p ubuntu-release -S NEW -t admin query).
- Move the bootstrap archive on snakefruit to use the new series, so the new chroots can reference it.
- Notify Adam Conrad to upload new buildd chroots (which can be copied from the previous distroseries), and to upload fresh tarballs for the just-released distroseries as well for efficiency.
Add a request to Launchpad devs and admins to open Launchpad translations for the new distroseries.
Notify Colin Watson to modify various reports (at least britney) to point to the new distroseries.
Notify Colin Watson to set up merge-o-matic to point to the new distroseries.
- Notify toolchain developers to upload new toolchain. Iterate uploads as necessary until this has successfully built on all architectures.
Create an empty lp:~ubuntu-sru/britney/hints-ubuntu-PREVIOUS branch.
- Make sure that proposed-migration is configured properly for the new series.
- Remove the "block-all source" hint from proposed-migration.
Create new live filesystem configurations for the new distroseries, using branch-livefses in lp:ubuntu-archive-tools.
Notify a Launchpad admin to set the status of the new distroseries to DEVELOPMENT.
Check with a webops that branch-distro has completed.
- Notify #launchpad-ops (or someone with access to jubany) to add the new series name in the lp:udd code, pull that change onto the package importer, and restart package-import.
Inform #ubuntu-devel and ubuntu-devel-announce that the new release is now open for uploads, pointing to merge-o-matic output.
- Check whether there are any uploads in the previous release's -updates pocket not in the new release, and copy them over if so.
Uncomment the auto-sync job in ubuntu-archive@snakefruit's crontab.
Create data/RELEASE, tools/RELEASE, and tools/boot/RELEASE directories in debian-cd based on corresponding directories for the previous release. Set OFFICIAL to "Alpha" in CONF.sh for the new release. Adjust cdimage code to be aware of the new release.
- Notify Michael Vogt to update the default release in popcon.ubuntu.com and update the component list
- Target issues from the previous release's release notes to be fixed in the new release.
- Notify Michael Vogt or Serge Hallyn to update vm-builder so that it can build VMs for the new release
- Notify Martin Pitt or Sebastian Bacher to create an Apport retracer apt configuration for the new release.
Notify Martin Pitt to set up http://ddebs.ubuntu.com for the new release.
Notify Iain Lane or someone with access to the user to run juju service set appstream-dep11 releases="<space separated list of supported releases ≥ xenial>" as prod-ue-appstream-back@wendigo
- Open an RT to ask IS to create chroots on the porter boxes.
- Notify William Grant to update the ftbfs on qa.ubuntuwire.com.
- Notify Evan Broder to update lintian.ubuntuwire.com.
- Notify Gerfried Fuchs (Rhonda) to update packages.ubuntu.com.
- Notify Iain Lane (Laney) to update people.c.c/~ubuntu-archive/transitions and udd.debian.org
- Notify Dimitri Ledkov / Dustin Kirkland (or anybody with ~ubuntu-core-dev) to update lp:ubuntu-manpage-repository
Notify Martin Pitt (pitti) or Iain Lane (Laney) to initialize autopkgtest results for the new release (run this on wendigo.canonical.com's prod-ues-proposed-migration environment)
- Notify Martin Pitt (pitti) or Iain Lane (Laney) to create containers/images/configuration for autopkgtest for the new release.
- Notify Brian Murray to update whoopsie-update-daily-users cronjob in canonical-is-puppet to include the new release of Ubuntu.
- Notify MPT to select new color for errors.ubuntu.com.
- Notify Brian Murray to update errors.ubuntu.com to display the new release of Ubuntu.
First weeks, after toolchain complete
- Notify 'ubuntu-devel' and 'ubuntu-devel-announce' that the release is now open and where to subscribe to the release'-changes' maillist.
Review the people listed in '!regression-alert' (StableReleaseUpdates#Regressions) as needed. '!regression-alert' is handled by ubotto and flagged in #ubuntu-devel. Changes can be made and tested in #ubuntu-ops. The people listed should be the tech leads for foundations, desktop, server, security, and QA, along with the release manager and key community members.
Merge base-files if necessary and change /etc/issue, /etc/issue.net, /etc/lsb-release, and /etc/os-release to refer to the new release.
Merge debootstrap if necessary and create a bootstrap script for the new release as a copy of the previous one (currently, we can just make the new one a symlink to gutsy, as it hasn't changed since then).
Merge lintian, vim, emacs-goodies-el and clang if necessary and update lists of Ubuntu release names to include the new release name.
- Do a no change rebuild of devscripts to pick up the new development release from distro-info.
Update /usr/share/python-apt/templates/Ubuntu.info in python-apt to include the new release name.
Update meta-release, ubuntu-release-upgrader, and syslinux-themes-ubuntu to handle the new release.
Merge cdrom-detect, choose-mirror, and iso-scan if necessary and update cdrom/suite and mirror/suite debconf templates to include a choice for the new release and update any previous default.
Merge the rest of the installer in dependency order, ending with debian-installer once all other installer components have built successfully on all architectures.
Notify ubiquity maintainer(s) to run debian/rules update, adjust as necessary to account for changes, and upload.
Update the version number in unity-greeter & unity-control-center logos to refer to the new release.
- Ensure that the ISO tracker has a daily-build "milestone" for the new release
Create ~ubuntu-archive/wubi/RELEASE/ and symlink ~ubuntu-archive/wubi/RELEASE-1/stable to ~ubuntu-archive/wubi/RELEASE/stable
Edit default_milestone in ~cdimage/.isotracker.conf to match the new milestone name in the ISO tracker
Notify canonical-platform-qa (email@example.com) to set up Utah jobs for Ubuntu desktop and server.
Add new series to production/current-triggers on nusakan.
- Turn live filesystem and cdimage cron jobs back on.
Add the date of the previous release to calendar.ubuntu in bsdmainutils
Defect Analysts (or team lead for those teams without Defect Analysts) will triage the +nominations bugs list, declining non-SRU candidate nominations and re-target bugs. The release team will evaluate the remaining list, accepting good SRU candidates
Notify web team to reset http://www.ubuntu.com/testing to indicate no testing in progress, and reference new release.
- Check to make sure the future+1 and future+2 series is available on launchpad to assign bugs to, if not present, then ask webops on #launchpad-ops to add letter-series, with status Future.
Update https://wiki.ubuntu.com/ReleaseTeam/FeatureStatus to new release, and all linked pages.
Two weeks after new release starts, finish EndofLifeProcess for any old releases scheduled now that we've had some migration overlap.
- Update ubuntu-release-notes project to know about the new series.
Ask firefox maintainer to update start page for the new release.
Continue on MilestoneProcess.