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 email@example.com 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 (Obsolete, placeholder for future replacement).
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 (Obsolete, placeholder for future replacement).
- Re-enable the Soyuz publisher cron job for a single publisher run.
- Ask #webops to run "ANALYZE binarypackagepublishinghistory;" on launchpad_prod.
- Re-enable the Soyuz publisher cron job for a second publisher run.
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.
Modify various reports on snakefruit (at least britney) to point to the new distroseries.
Notify Colin Watson to set up merge-o-matic to point to the new distroseries.
Update global.conf in lp:~ubuntu-transition-trackers/ubuntu-transition-tracker/configs
- Notify toolchain developers to upload new toolchain. Iterate uploads as necessary until this has successfully built on all architectures.
- Make sure that proposed-migration is configured properly for the new series.
Check that https://people.canonical.com/~ubuntu-archive/proposed-migration/<NEWSERIES>/results.cache exists, as required by bileto.
- Remove the "block-all source" hint from proposed-migration.
Notify a Launchpad admin to set the status of the new distroseries to DEVELOPMENT.
Check with a webops that branch-distro has completed (Obsolete, placeholder for future replacement).
- 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 (Obsolete, placeholder for future replacement).
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.
- Copy everything from PREVIOUS-proposed to DEVEL-proposed, and delete the ones from PREVIOUS-proposed that aren't SRUs.
- Inform the SRU team that the bulk copy has been done, so that they know to sort out PREVIOUS-proposed vs. DEVEL-proposed for any new SRUs they accept.
Drop the --dry-run flag from the auto-sync job in ubuntu-archive@snakefruit's crontab.
Create new live filesystem configurations for the new distroseries, using branch-livefses in lp:ubuntu-archive-tools. This currently needs to be done for OWNER where OWNER is:
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, and configure ~cdimage/.isotracker.conf
- Notify stgraber, vorlon, or bdmurray to follow README.series on db@limequat.
- 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 Brian Murray or a real ~ubuntu-archive member to create an Apport retracer apt configuration (example for 17.04) for the new release and roll it out to porter-i386:/home/ubuntu-archive/config
Check http://ddebs.ubuntu.com for the new release. (In principle that should happen by itself, but in practice it may crash/hang on archive.ubuntu.com not yet having indexes, or run into time outs on the gigantic first import after opening/copying the new release). This is running on germanium.canonical.com → sudo -u ddebs -i; This has a checkout of lp:ddeb-retriever and is cron driven.
Notify Iain Lane or someone with access to the user update config.json to add the new release to the list in git lp:~ubuntu-desktop/+git/appstream-cloud (*make sure the json is valid*), and then as prod-ue-appstream-back@wendigo run juju set appstream-generator config="$(cat config.json)" after pulling. See 9163c1a2bc5fb3c2c2ba1c27df8f7573a54b4045.
- 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 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 David Britton (or anybody in ~canonical-server) to update lp:ubuntu-manpage-repository
Notify Iain Lane (Laney) to https://git.launchpad.net/~ubuntu-release/autopkgtest-cloud/tree/tools/seed-new-release for the new release (run this on wendigo.canonical.com's prod-ues-proposed-migration environment)
- Notify 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 the retracer charm owned by the daisy-pluckers team to include the new release of Ubuntu.
- 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.
Ensure that postgresql-common is updated for new release
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 (firstname.lastname@example.org) 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.