]> git.donarmstrong.com Git - dak.git/blob - docs/README.stable-point-release
e395adf9ccb028373936743b890e0fabfde599fd
[dak.git] / docs / README.stable-point-release
1 Rough Guide to doing Stable Point Releases in Debian
2 ----------------------------------------------------
3
4 - sudo to dak
5 - bash:
6 suite=stable
7 suitename=wheezy
8 pusuite=proposed-updates
9 oldrev=7.6
10 newrev=7.7
11 export SCRIPTVARS=/srv/ftp-master.debian.org/dak/config/debian/vars
12 . $SCRIPTVARS
13 . "${configdir}/common"
14 . "${configdir}/dinstall.functions"
15 umask 022
16 export LANG=C
17 export LC_ALL=C
18 pg_timestamp pre_${suite}_${newrev}
19 cd ~
20 mkdir -p ${suite}_${newrev}
21 cd ${suite}_${newrev}
22 dak control-suite -l ${pusuite} > ${pusuite}.list
23 dak control-suite -l ${suite} > ${suite}.list
24
25 - ask SRMs if there is anything to be skipped from this release. If so
26   edit ${pusuite}.list (and later the Changelog too)
27 - bash:
28 dak make-changelog -s ${pusuite} -b ${suite} | cat - ${ftpdir}/dists/${suite}/ChangeLog | sponge ${ftpdir}/dists/${suite}/ChangeLog
29 dak control-suite --add ${suite} < ${pusuite}.list
30 dak control-suite --remove ${pusuite} < ${pusuite}.list
31
32 - clean up *.changes from proposed-updates:
33 # Be careful if uploads were not included in the point release.
34 pumorguedir="${base}/morgue/queues/$(date +%Y/%m)"
35 mkdir -p "${pumorguedir}"
36 cd ${ftpdir}/dists/${pusuite}
37 mv -t "${pumorguedir}" -n -- *.changes
38
39 - -r0 additions?
40   For example new d-i. If so:
41 cd ~/${suite}_${newrev}
42 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs .
43 dak control-suite --add ${suitename}-r0 < ${suitename}-r0-additions.cs
44
45 - sync with stable RM if there is any propup needed. do it, if so:
46 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable .
47 dak control-suite --force --add unstable <propups.unstable
48 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.testing .
49 dak control-suite --force --add testing <propups.testing
50
51 - ask rms if they have RMs to do.
52 - and then check if they have a d-i update. if so, bash:
53 # set dioldver to "empty" if there is no old to remove
54 diver=20130613+deb7u2+b3
55 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
56 dioldver=20130613+deb7u2+b1
57 cd $ftpdir/dists/${suite}/main
58 if [ "${dioldver}" != "empty" ]; then
59     for iarch in $(dak admin s-a list-arch ${suite}); do
60         if [ -d "installer-${iarch}/${dioldver}" ]; then
61             echo "Moving installer-${iarch}/${dioldver} to morgue"
62             mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
63             mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
64         fi
65     done
66 fi
67 cd $ftpdir/dists/${suite}
68
69 - Updates for win32-loader?
70 cd ${ftpdir}/tools/win32-loader
71 if [ -d ${suite}-proposed-updates ]; then
72     rm -r ${suite}
73     mv ${suite}-proposed-updates ${suite}
74 fi
75 cd ${ftpdir}
76
77 - Update version number in README, README.html and dists/README,
78   Clean up dists/stable/ChangeLog (add header, basically). bash:
79   $EDITOR ChangeLog ../README ../../README*
80   rm -f *~ ../*~ ../../*~
81
82 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
83 cd $ftpdir/dists/
84 rm -f Debian${oldrev}
85 ln -s ${suitename} Debian${newrev}
86
87 - Update fields in suite table in postgresql.
88   bash:
89
90 mdate=$(date +"%d %B %Y")
91 psql projectb <<EOF
92 begin;
93 update suite set version = '${newrev}' where suite_name = '${suite}';
94 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
95 commit;
96 EOF
97
98 - prepare for gps. bash:
99 dak dominate --force -s ${suite}
100 - check output from cruft report:
101 dak cruft-report -s ${suite}
102
103 dak generate-filelist -s ${suite}
104
105 - Let SRM see if all is ok
106
107 - then:
108 if [ "${suitename}" = "squeeze" ]; then
109   dak generate-packages-sources -s ${suite} && dak contents generate -f -s ${suite} -a ftp-master
110 else
111   dak generate-packages-sources2 --force -s ${suite} && dak contents generate -f -s ${suite} -a ftp-master
112 fi
113
114 - For squeeze: merge Contents
115 if [ "${suitename}" = "squeeze" ]; then
116   cd $ftpdir/dists/${suite}
117   for carch in $(dak admin s-a list-arch ${suite}); do
118     echo doing ${carch}
119     cp $base/dak/templates/contents Contents-${carch}.new;
120     zcat {main,contrib,non-free}/Contents-${carch}.gz | ~joerg/mergecontents.pl | sort >> Contents-${carch}.new;
121     gzip -9v Contents-${carch}.new;
122     mv Contents-${carch}.new.gz Contents-${carch}.gz;
123   done
124   rm {main,contrib,non-free}/Contents-*
125 fi
126
127 - For wheezy: update main/i18n/Index
128 if [ "${suitename}" = "wheezy" ]; then
129   ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}"
130 fi
131
132 - Generate Releases:
133 dak generate-releases -f -s ${suite}
134 rm ${ftpdir}/dists/${suite}/InRelease
135
136 - have the SRMs sign it and put the signature in.
137 cd ${ftpdir}/dists/${suite}
138 cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release.gpg >> Release.gpg
139 gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release
140
141 - Check if a mirror push is needed or next dinstall is enough. for a push
142 o if so, bash:
143
144 TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org"
145 DATE_SERIAL=$(date +"%Y%m%d01")
146 FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} )
147 if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then
148     SERIAL="$DATE_SERIAL"
149 else
150     SERIAL="$FILESOAPLUS1"
151 fi
152 date -u > ${TRACEFILE}
153 echo "Using dak v1" >> ${TRACEFILE}
154 echo "Running on host: $(hostname -f)" >> ${TRACEFILE}
155 echo "Archive serial: ${SERIAL}" >> ${TRACEFILE}
156 cd ${mirrordir}
157 rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. .
158 date -u > /srv/ftp.debian.org/web/mirrorstart
159 echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart
160 echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart
161 sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 &
162