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=oldstable
   7 suitename=lenny
   8 pusuite=oldstable-proposed-updates
   9 oldrev=5.0.8
  10 newrev=5.0.9
  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 cat ${pusuite}.list | dak control-suite --add ${suite}
  30 dak control-suite --remove ${pusuite} < ${pusuite}.list
  31
  32 - sync with stable RM if there is any propup needed. do it, if so.
  33 - ask rms if they have RMs to do.
  34 - and then check if they have a d-i update. if so, bash:
  35 # set dioldver to "empty" if there is no old to remove
  36 diver=20090123lenny9
  37 dioldver=20090123lenny8
  38 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
  39 cd $ftpdir/dists/${suite}/main
  40 if [ "${dioldver}" != "empty" ]; then
  41     for iarch in $(dak admin s-a list-arch ${suite}); do
  42         if [ -d "installer-${iarch}/${dioldver}" ]; then
  43             echo "Moving installer-${iarch}/${dioldver} to morgue"
  44             mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
  45             mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
  46         fi
  47     done
  48 fi
  49 cd $ftpdir/dists/${suite}
  50
  51 - Update version number in README, README.html and dists/README,
  52   Clean up dists/stable/ChangeLog (add header, basically). bash:
  53   $EDITOR ChangeLog ../README ../../README*
  54   rm -f *~ ../*~ ../../*~
  55
  56 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
  57 cd $ftpdir/dists/
  58 rm -f Debian${oldrev}
  59 ln -s ${suitename} Debian${newrev}
  60
  61 - Update fields in suite table in postgresql.
  62   bash:
  63
  64 mdate=$(date +"%d %B %Y")
  65 psql projectb <<EOF
  66 begin;
  67 update suite set version = '${newrev}' where suite_name = '${suite}';
  68 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
  69 commit;
  70 EOF
  71
  72 - prepare for gps. bash:
  73 dak dominate --force -s ${suite}
  74 dak generate-filelist -s ${suite}
  75
  76 - Let SRM see if all is ok
  77
  78 - then:
  79 dak generate-packages-sources -s ${suite} ; dak contents generate -f -s ${suite}
  80 dak generate-releases -f -s ${suite}
  81
  82 - have the SRMs sign it and put the signature in.
  83 - Check if a mirror push is needed or next dinstall is enough. for a push
  84 o if so, bash:
  85
  86 TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org"
  87 DATE_SERIAL=$(date +"%Y%m%d01")
  88 FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} )
  89 if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then
  90     SERIAL="$DATE_SERIAL"
  91 else
  92     SERIAL="$FILESOAPLUS1"
  93 fi
  94 date -u > ${TRACEFILE}
  95 echo "Using dak v1" >> ${TRACEFILE}
  96 echo "Running on host: $(hostname -f)" >> ${TRACEFILE}
  97 echo "Archive serial: ${SERIAL}" >> ${TRACEFILE}
  98 cd ${mirrordir}
  99 rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. .
 100 date -u > /srv/ftp.debian.org/web/mirrorstart
 101 echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart
 102 echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart
 103 sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 &
 104