]> git.decadent.org.uk Git - dak.git/blob - docs/README.stable-point-release
Merge branch 'master' of ftp-master.debian.org:/srv/ftp.debian.org/git/dak
[dak.git] / docs / README.stable-point-release
1 Rough Guide to doing Stable Point Releases in Debian
2 ----------------------------------------------------
3
4 o Dump projectb for backup purposes.
5 o get everything listed, dak control-suite -l proposed-updates > p-u.list
6 o generate the changelog using dak make-changelog -s proposed-updates -b stable | cat - ${ftpdir}/dists/stable/ChangeLog | sponge ${ftpdir}/dists/stable/ChangeLog
7 o add everything to stable:  cat p-u.list |dak control-suite --add stable
8 o remove everything from proposed-updates, dak control-suite -r proposed-updates < p-u.list
9 o sync with stable RM if there is any propup needed. do it, if so.
10 o ask rms if they have RMs to do.
11 o If you installed a debian-installer upload; migrate the relevant
12   installer-*/$release directory from proposed-updates to stable.
13   (Including potentially removing older versions)
14   dak copy-installer helps
15 o Update version number in README, README.html and dists/README
16 o Update the 'Debian<n>.<n>r<n>' symlink in dists/
17 o Clean up dists/stable/ChangeLog (add header, basically)
18 o Update fields in suite table in postgresql (see below)
19
20 o dak dominate --force -s stable
21 o dak generate-filelist -s stable
22 o Let SRM see if all is ok
23 o cd $configdir ; apt-ftparchive generate apt.conf.stable
24 o dak generate-releases --force-touch --apt-conf apt.conf.stable stable
25 o Check if a mirror push is needed or next dinstall is enough. for a push
26 o if so:
27    TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org"
28    DATE_SERIAL=$(date +"%Y%m%d01")
29    FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} )
30    if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then
31        SERIAL="$DATE_SERIAL"
32    else
33        SERIAL="$FILESOAPLUS1"
34    fi
35    date -u > ${TRACEFILE}
36    echo "Using dak v1" >> ${TRACEFILE}
37    echo "Running on host: $(hostname -f)" >> ${TRACEFILE}
38    echo "Archive serial: ${SERIAL}" >> ${TRACEFILE}
39    cd ${mirrordir}
40    rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. .
41
42    date -u > /srv/ftp.debian.org/web/mirrorstart
43    echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart
44    echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart
45    sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 &
46
47
48 begin;
49 update suite set version = '6.0.1' where suite_name = 'stable';
50 update suite set description = 'Debian 6.0.1 Released 19 March 2011' where suite_name = 'stable';
51
52 ------------------------------------------------------------------------
53 Old doc:
54
55
56 o run 'dak clean-proposed-updates' to get rid of obsolete .changes
57   from p-u ['dak clean-proposed-updates *.changes' from within p-u]
58 o [also check for obsolete .changes caused by 'dak rm'-ing from p-u]
59 o Update dak.conf (at least the section for Reject-Proposed-Updates,
60   before using 'dak reject-proposed-updates')
61 o Install, reject and remove packages as directed by the SRM using
62   'dak process-accepted' (installs), 'dak reject-proposed-updates'
63   (rejects) and 'dak rm' (removals)
64
65   NB: removing packages are not logged to the stable ChangeLog; you
66       need to do that byhand.
67
68
69 o Decruft stable in coordination with SRMs
70
71 o Do anything in proposed-updates/TODO
72 o Close any applicable stable bugs
73   (hint: http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=ftp.debian.org&include=etch)
74 o Update version number in README, README.html and dists/README
75 o Update the 'Debian<n>.<n>r<n>' symlink in dists/
76 o Clean up dists/stable/ChangeLog (add header, basically)
77 o Update version fields in dak.conf
78 o Update fields in suite table in postgresql (see below)
79
80 o Run 'dak make-suite-file-list --force -s stable'
81 o Run apt-ftparchive generate apt.conf.stable
82 o Run 'dak generate-releases --force-touch --apt-conf apt.conf.stable stable'
83
84 [Yes, this sucks and more of it should be automated. c.f. ~ajt/pointupdate]
85
86 #######################################################
87
88 update suite set version = '4.0r3' where suite_name = 'stable';
89 update suite set description = 'Debian 4.0r3 Released 16th February 2008' where suite_name = 'stable';
90
91 Rough Guide to doing Old-Stable Point Releases in Debian
92 --------------------------------------------------------
93
94 Pretty much as above, except that process-accepted doesn't know about
95 oldstable, so you have to do some surgery on it first to make it
96 support that.  Probably want to disable cron.daily whilst doing so.
97 Also watch out for the installing_to_stable detection which doesn't
98 work well with the current layout of oldstable-proposed-updates (as a
99 symlink to $distro-proposed-updates).  clean-proposed-updates,
100 cruft-report and most everything else support a -s/--suite so they
101 sould be fine to use.