Release Management/ESR Landing Process

From MozillaWiki
Jump to: navigation, search


We'd like to have a lightweight process that prevents "surprise" ESR landings at the 11th hour and makes sure ESR patches are created very soon after their related mainline patches.


The ESR38 repo: The ESR38 repo:

More info about the ESR

What should land on mozilla-esr38/mozilla-esr38

Security and some major stability fixes when they're landed/merged onto mozilla-beta, or fixes for regressions specific to the ESR. In the first few cycles of ESR we may be more flexible on these criteria. As the versions progress we should limit this to the most critical security fixes.

Exception: If patches only make changes to tests, test harnesses or anything else that does not affect the shipped builds, they may land with self approval (use a=testonly, a=npotb etc).

The associated flags

approval-mozilla-esr38: ?, +, -

approval-mozilla-esr38: ?, +, -

tracking-esr38: ?, -, 42+, 43+, 44+, ...

tracking-esr38: ?, -, 42+, 43+, 44+, ...

status-esr38: ?, unaffected, wontfix, affected, checkin-pending, fixed, verified

status-esr38: ?, unaffected, wontfix, affected, checkin-pending, fixed, verified

The process

1) When an engineer believes that a stability bug needs to be addressed for the ESR, or a security fix that's landed on a branch affects the ESR:

  • Set tracking-esr38 (and if we're in the middle of supporting 2 versions, then also tracking-esr38 to ?
  • Set tracking-esr38 (and if we're in the middle of supporting 2 versions, then also tracking-esr38 to affected if an ESR patch is still being worked on
  • Set approval-mozilla-esr38 (and if we're in the middle of support 2 versions, then also approval-mozilla-esr38 to ? and status-esr38/38 checkin-pending if a patch is ready to land on mozilla-esr38/38

2) Members of both Security and Release Management teams will triage tracking-esr38/38=?, and if agreement is that it's needed for the ESR, the tracking flag will be set to the first version of mainline Firefox that the patch is present in and the approval-mozilla-esr38/38 flag will be set to +.

  • In the case of an ESR-specific regression, we'll track for the next ESR release (e.g.: 45).
  • Why are we using mainline versions to track the ESR? According to the ESR proposal, a chemspill uses a minor version number, thus throwing off our tracking flags. Additionally, engineers shouldn't have to know what version of the ESR we're on.

3) Once the mozilla-beta version matches the tracking-esr38/38 version(s), Security and Release Management teams will triage those bugs and make sure affected/checkin-pending fixes are landed at least 1 week prior to release so that we can go-to-build.

  • Approval is required, so add "a={whoever set the approval-mozilla-esr10 flag to +}" to the commit message.
  • After landing the patch, set status-esr38/38 to "fixed".
  • Our beta period for the ESR will be to push this build to FTP a week early for qualification by enterprises.

ESR Triage Queries


ESR_PREVIOUS (click to edit): 31

ESR_CURRENT (click to edit): 38

ESR_CURRENT_DOT (click to edit): .3.0

ESR_NEXT (click to edit): 38

ESR_NEXT_DOT (click to edit): .4.0




Note: not useful until Firefox 38 is on Aurora or later


NOTE: Post-merge, we'll likely need to create new static links for 20+ b2g bugs (still landing to v1.1, along with 21+ bugs)


ESR Timeline and Activities


Review ESR queries

  • for potential ESR uplifts
  • to review uplift requests
  • to follow up on approved uplifts that have not landed
  • Note: if you don't have security bug access, please ask another release manager to check the sec-critical bugs to nominate them and cc you.

Week 4

Tue: Send smoke test e-mail to enterprise list

Week 5


  1. Kick off RC build in ship-it
  2. Send go to build e-mail for ESR candidate to release-drivers. (This happens automatically if you fill in the form in ship-it)
  3. Create release notes in Nucleus

Release Week

Monday: ESR sign off on esr-localtest channel should have been received, so now email release-drivers list to request the push to esr-cdntest (more on these channels in Releases/Update_Channels.

Release Day

All happens after mainline release goes live (usually 8am Pacific time)

  1. You must have received sign off for esr-cdntest updates from QA
  2. Send push release to esr channel e-mail request for releng to r-d
  3. Mark release notes as public in Nucleus
  4. Update product details in SVN (instructions, remember to push the big red button)
  5. Add release to historical releases page
  6. Post release announcement to enterprise mailing list
  7. Update as needed the wiki template values - Release_Management/ESR_Landing_Process#CURRENT_TEMPLATE_VALUES - at the very least you are bumping the dot version of the current ESR

Sample E-mails

Smoke Test Request

Subject: Request: Smoke Test Firefox {{ESR_NEXT}}esr

As we approach the ESR {{ESR_NEXT}} release date of {{FIREFOX_SHIP_DATE}}, we'd like your help in smoke testing the latest pre-release builds. Our request is not for full qualification of the builds but rather exploratory testing of internal websites and applications for which our QA team does not have access.

Please file bugs for any critical regressions that you find in Bugzilla and make sure to set the need-info? flag on release-mgmt at <mailto:release-mgmt at> in order to alert the release management team to the issues. Alternatively, you can directly email release-mgmt at <mailto:release-mgmt at> or this list.

Thank you for your continued support in ensuring high quality ESR releases.

Firefox Release Manager

*NOTE*: Do not deploy any of the pre-release builds listed below. These pre-release builds will not update correctly and will not be supported by Mozilla.

ESR {{ESR_NEXT}} Windows:


ESR {{ESR_NEXT}} Linux 32 bits:

ESR {{ESR_NEXT}} Linux 64 bits:

Request to push release to esr channel

Subject: Please push Firefox 24.5.0esr build #1 to the ESR channel


QA has signed off on the desktop release. Please push ESR to the esr release channel. 


Release Announcement

Subject: Firefox 24.6.0esr released

I'm pleased to announce the release of Firefox ESR 24.6.0. This release includes security fixes in line with Firefox 30.

You can find installers for Windows / Mac OS X / GNU/Linux here:

And the release notes are available here:

Firefox Release Manager

Branching Logistics

When we have the overlapping ESR (and the first build of a major version number for the - 10, 17, 24, 31, etc) we do build a separate build with its own branding from the newly minted branch. See for how to kick off the builds and for an example of the custom configs needed for that first build's partials that has to land before kicking off the build in ship-it.