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.5
  10 newrev=7.6
  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 like, cat /srv/release.debian.org/www/squeeze/6.0/6.0.4/propup.unstable | dak control-suite --add unstable
  47 Note: unstable first, then testing
  48 - ask rms if they have RMs to do.
  49 - and then check if they have a d-i update. if so, bash:
  50 # set dioldver to "empty" if there is no old to remove
  51 diver=20130613+deb7u2+b1
  52 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
  53 dioldver=20130613+deb7u1+b2
  54 cd $ftpdir/dists/${suite}/main
  55 if [ "${dioldver}" != "empty" ]; then
  56     for iarch in $(dak admin s-a list-arch ${suite}); do
  57         if [ -d "installer-${iarch}/${dioldver}" ]; then
  58             echo "Moving installer-${iarch}/${dioldver} to morgue"
  59             mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
  60             mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
  61         fi
  62     done
  63 fi
  64 cd $ftpdir/dists/${suite}
  65
  66 - Updates for win32-loader?
  67 cd ${ftpdir}/tools/win32-loader
  68 if [ -d ${suite}-proposed-updates ]; then
  69     rm -r ${suite}
  70     mv ${suite}-proposed-updates ${suite}
  71 fi
  72 cd ${ftpdir}
  73
  74 - Update version number in README, README.html and dists/README,
  75   Clean up dists/stable/ChangeLog (add header, basically). bash:
  76   $EDITOR ChangeLog ../README ../../README*
  77   rm -f *~ ../*~ ../../*~
  78
  79 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
  80 cd $ftpdir/dists/
  81 rm -f Debian${oldrev}
  82 ln -s ${suitename} Debian${newrev}
  83
  84 - Update fields in suite table in postgresql.
  85   bash:
  86
  87 mdate=$(date +"%d %B %Y")
  88 psql projectb <<EOF
  89 begin;
  90 update suite set version = '${newrev}' where suite_name = '${suite}';
  91 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
  92 commit;
  93 EOF
  94
  95 - prepare for gps. bash:
  96 dak dominate --force -s ${suite}
  97 - check output from cruft report:
  98 dak cruft-report -s ${suite}
  99
 100 dak generate-filelist -s ${suite}
 101
 102 - Let SRM see if all is ok
 103
 104 - then:
 105 if [ "${suitename}" = "squeeze" ]; then
 106   dak generate-packages-sources -s ${suite} && dak contents generate -f -s ${suite} -a ftp-master
 107 else
 108   dak generate-packages-sources2 --force -s ${suite} && dak contents generate -f -s ${suite} -a ftp-master
 109 fi
 110
 111 - For squeeze: merge Contents
 112 if [ "${suitename}" = "squeeze" ]; then
 113   cd $ftpdir/dists/${suite}
 114   for carch in $(dak admin s-a list-arch ${suite}); do
 115     echo doing ${carch}
 116     cp $base/dak/templates/contents Contents-${carch}.new;
 117     zcat {main,contrib,non-free}/Contents-${carch}.gz | ~joerg/mergecontents.pl | sort >> Contents-${carch}.new;
 118     gzip -9v Contents-${carch}.new;
 119     mv Contents-${carch}.new.gz Contents-${carch}.gz;
 120   done
 121   rm {main,contrib,non-free}/Contents-*
 122 fi
 123
 124 - For wheezy: update main/i18n/Index
 125 if [ "${suitename}" = "wheezy" ]; then
 126   ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}"
 127 fi
 128
 129 - Generate Releases:
 130 dak generate-releases -f -s ${suite}
 131 rm ${ftpdir}/dists/${suite}/InRelease
 132
 133 - have the SRMs sign it and put the signature in.
 134 cd ${ftpdir}/dists/${suite}
 135 cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release.gpg >> Release.gpg
 136 gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release
 137
 138 - Check if a mirror push is needed or next dinstall is enough. for a push
 139 o if so, bash:
 140
 141 TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org"
 142 DATE_SERIAL=$(date +"%Y%m%d01")
 143 FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} )
 144 if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then
 145     SERIAL="$DATE_SERIAL"
 146 else
 147     SERIAL="$FILESOAPLUS1"
 148 fi
 149 date -u > ${TRACEFILE}
 150 echo "Using dak v1" >> ${TRACEFILE}
 151 echo "Running on host: $(hostname -f)" >> ${TRACEFILE}
 152 echo "Archive serial: ${SERIAL}" >> ${TRACEFILE}
 153 cd ${mirrordir}
 154 rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. .
 155 date -u > /srv/ftp.debian.org/web/mirrorstart
 156 echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart
 157 echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart
 158 sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 &
 159