Moving a Branch Tag

The CGIs are built onto hgwbeta every-other Monday night. The QA team tests the new CGIs on hgwbeta. If problems are found, the developer is contacted for a fix to the offending file. It may be necessary to either roll back to a previous version of a file, or to include the developer's new fix in this release of the CGIs. To do either of these, we move the branch tag for the branch release of the CGIs on hgwbeta.

Where?

The two directories that are important are:

- the directory where the build is:

  hgwbeta:/data/tmp/releaseBuild/vXYZ_branch

- the directory where the scripts are:

  hgwbeta:/cluster/bin/build/scripts

How? ("Who" in parenthesis)

1. (QA): Find an error in the binaries, determine if it needs to be patched, and alert the Developer.
2. (Developer): Fix the error (and get a second opinion on your fix from another developer).
3. (QA): Verify the developer's fix on hgwdev and notify Developer if it's fixed or not.
4. (Developer): Send email to Build-meister (cc'ing browser-qa) with revision number of the fix and patch request (including an explanation of the problem and the fix and the name of the QA person who will test the fix on hgwbeta).
5. (Build-Meister): Check the CVS log to make sure that you are only picking up only one change (between the last branch and the developer's change).
6. (Build-Meister): Tell the program which file and version you want to change to. hgwbeta:/cluster/bin/build/scripts> vi MoveBranchTagFiles.conf Edit this file to include the file name and new version number like so: hg/$CGI/fileName.c 1.234
7. (Build-Meister): Do a test run and verify that everything is set up correctly: hgwbeta:/cluster/bin/build/scripts/moveBranchTag.csh
8. (Build-Meister): If it is correct, run it for real: hgwbeta:/cluster/bin/build/scripts/moveBranchTag.csh real
9. (Build-Meister): Determine which CGIs are affected by this file change: hgwbeta:/usr/local/apache/cgi-bin> dependencies fileName.c
10. (Build-Meister): Go to the current build: hgwbeta> cd $BUILDDIR
11. (Build-Meister): Determine the current branch number. It will be the most recent directory that looks like "v---_branch". hgwbeta:/data/tmp/releaseBuild> ls -ltr
12. (Build-Meister): Do a 'make' in the library directory, if necessary. If the file change was a lib file, then do a make in the corresponding lib directory: hgwbeta:/data/tmp/releaseBuild/vXYZ_branch/kent/src/hg/lib> make -or- hgwbeta:/data/tmp/releaseBuild/vXYZ_branch/kent/src/lib> make
13. (Build-Meister): Do a 'make alpha' in the CGI directories that are impacted by the change: hgwbeta:/data/tmp/releaseBuild/vXYZ_branch/kent/src/hg/hgTracks> make alpha
14. (Build-Meister): Reply to the email to the Developer and browser-qa that the tag has been moved and binaries made on hgwbeta.
15. (QA): Test the change on hgwbeta.
16. (QA): Reply to the email about the efficacy of the change.