|
|
| Line 2: |
Line 2: |
| {{Release Engineering How To|Generate_partial_updates}} | | {{Release Engineering How To|Generate_partial_updates}} |
|
| |
|
| <h1> Intro </h1>
| | = Intro = |
| <p>This document is about generating partial updates from older releases, eg N-2 to N, on request from Release Management. We generate N-1 to N updates in the release automation, but more than that is a manual process until <span class="fck_mw_template">{{bug|575317}}</span> makes some progress.
| | This document is about generating partial updates from older releases, eg N-2 to N, on request from Release Management. We generate N-1 to N updates in the release automation, but more than that is a manual process until {{bug|575317}} makes some progress. |
| </p><p>Assumptions:
| |
| </p>
| |
| <ul><li> the automated updates builder has already run, and you're re-using the slave for the copy of the utilities and scripts you need
| |
| </li><li> the request is for the release channel
| |
| </li><li> all locales are being generated, possibly only some of the platforms
| |
| </li></ul>
| |
| <p>For the purposes of this doc we'll say the update will be between $OLDV and $NEWV build$BUILD. The bug is $XXX<a href="http://www.freepornpump.com">XXX</a>
| |
| </p>
| |
|
| |
|
| <h1> Create config files </h1>
| | Assumptions: |
| <h2> Patcher config </h2>
| | * the automated updates builder has already run, and you're re-using the slave for the copy of the utilities and scripts you need |
| <p>To get setup
| | * the request is for the release channel |
| </p>
| | * all locales are being generated, possibly only some of the platforms |
| <ul><li> grab a copy of the release config, mozRelease-branch-patcher2.cfg, from your own CVS checkout or from <a href="http://mxr.mozilla.org/mozilla/source/tools/patcher-configs/mozRelease-branch-patcher2.cfg?raw=1">mxr</a>
| | |
| </li><li> verify that the file is up to date by checking the values of <tt>from</tt> and <tt>to</tt> in <tt><current-update></tt>, and the right buildN in the <tt>completemarurl</tt> of the <tt><releases></tt> block for the release being created
| | For the purposes of this doc we'll say the update will be between $OLDV and $NEWV build$BUILD. The bug is $XXXXXX |
| </li><li> rename it to mozRelease-branch-patcher2-$XXXXXX.cfg
| | |
| </li></ul>
| | = Create config files = |
| <p>To modify the config
| | == Patcher config == |
| </p>
| | To get setup |
| <ul><li> in the <tt><current-update></tt> block
| | * grab a copy of the release config, mozRelease-branch-patcher2.cfg, from your own CVS checkout or from [http://mxr.mozilla.org/mozilla/source/tools/patcher-configs/mozRelease-branch-patcher2.cfg?raw=1 mxr] |
| <ul><li> change the <tt>from</tt> version to $OLDV
| | * verify that the file is up to date by checking the values of <tt>from</tt> and <tt>to</tt> in <tt><current-update></tt>, and the right buildN in the <tt>completemarurl</tt> of the <tt><releases></tt> block for the release being created |
| </li><li> in the <tt><partial></tt> block change the from version in the paths to $OLDV
| | * rename it to mozRelease-branch-patcher2-$XXXXXX.cfg |
| </li></ul>
| | |
| </li><li> remove all the past-update lines just below <tt><current-update></tt> block
| | To modify the config |
| </li><li> remove the unneeded blocks from <tt><release></tt> (keep only $OLDV and $NEWV, for brevity)
| | * in the <tt><current-update></tt> block |
| </li><li> if only some platforms are needed (eg windows), remove the other platforms from the <tt><platforms></tt> and <tt><exceptions</tt> blocks
| | ** change the <tt>from</tt> version to $OLDV |
| </li></ul>
| | ** in the <tt><partial></tt> block change the from version in the paths to $OLDV |
| <p>Attach the file to the bug, request review. You'll download it again later using $YYYYYY for the attachment id. <a href="https://bug768576.bugzilla.mozilla.org/attachment.cgi?id=637051">Example config</a>.
| | * remove all the past-update lines just below <tt><current-update></tt> block |
| </p>
| | * remove the unneeded blocks from <tt><release></tt> (keep only $OLDV and $NEWV, for brevity) |
| <h2> Update verify configs </h2>
| | * if only some platforms are needed (eg windows), remove the other platforms from the <tt><platforms></tt> and <tt><exceptions</tt> blocks |
| <p>To get setup
| | |
| </p>
| | Attach the file to the bug, request review. You'll download it again later using $YYYYYY for the attachment id. [https://bug768576.bugzilla.mozilla.org/attachment.cgi?id=637051 Example config]. |
| <ul><li> grab a copy of the configs, either from your tools checkout or directly from hg.m.o (<a href="http://hg.mozilla.org/build/tools/raw-file/default/release/updates/mozRelease-firefox-win32.cfg">windows</a>, <a href="http://hg.mozilla.org/build/tools/raw-file/default/release/updates/mozRelease-firefox-mac64.cfg">mac</a>)
| | |
| </li><li> verify the configs are up to date by checking the current release is referenced in the 2nd line, and that the to definition there refers to the right buildN path
| | == Update verify configs == |
| </li><li> rename to mozRelease-firefox-win32-$XXXXXX.cfg
| | To get setup |
| </li></ul>
| | * grab a copy of the configs, either from your tools checkout or directly from hg.m.o ([http://hg.mozilla.org/build/tools/raw-file/default/release/updates/mozRelease-firefox-win32.cfg windows], [http://hg.mozilla.org/build/tools/raw-file/default/release/updates/mozRelease-firefox-mac64.cfg mac]) |
| <p>To modify the configs:
| | * verify the configs are up to date by checking the current release is referenced in the 2nd line, and that the to definition there refers to the right buildN path |
| </p>
| | * rename to mozRelease-firefox-win32-$XXXXXX.cfg |
| <ul><li> remove all the lines that aren't for $OLDV and the current shipped release
| | |
| </li><li> in $OLDV's full check line
| | To modify the configs: |
| <ul><li> add the locales from $OLDV's quick check line
| | * remove all the lines that aren't for $OLDV and the current shipped release |
| </li><li> add the patch_types, aus_server, ftp_server, and to definitions from the current release
| | * in $OLDV's full check line |
| </li></ul>
| | ** add the locales from $OLDV's quick check line |
| </li><li> remove the $OLDV quick check comment and config line
| | ** add the patch_types, aus_server, ftp_server, and to definitions from the current release |
| </li><li> remove current release lines
| | * remove the $OLDV quick check comment and config line |
| </li><li> repeat for each platform
| | * remove current release lines |
| </li></ul>
| | * repeat for each platform |
| <p>Attach the files to the bug as a patch (eg via mq), request review. You'll download it again later using $ZZZZZZ as the attachment id. <a href="https://bug768576.bugzilla.mozilla.org/attachment.cgi?id=637065">Example config</a>.
| | |
| </p>
| | Attach the files to the bug as a patch (eg via mq), request review. You'll download it again later using $ZZZZZZ as the attachment id. [https://bug768576.bugzilla.mozilla.org/attachment.cgi?id=637065 Example config]. |
|
| |
|
| = Generate the partials = | | = Generate the partials = |