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=jessie
   8 pusuite=proposed-updates
   9 oldrev=8.1
  10 newrev=8.2
  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 skip="squid3 icedove php5"
  29 if [ -n "${skip}" ]; then
  30   mv ${pusuite}.list ${pusuite}.list.ori
  31   grep -vFf <(dak ls -f heidi -S -s ${pusuite} ${skip}) ${pusuite}.list.ori > ${pusuite}.list
  32 fi
  33 dak make-changelog -s ${pusuite} -b ${suite} | cat - ${ftpdir}/dists/${suite}/ChangeLog | sponge ${ftpdir}/dists/${suite}/ChangeLog
  34 if [ -n "${skip}" ]; then
  35   $EDITOR ${ftpdir}/dists/${suite}/ChangeLog
  36 fi
  37
  38 dak control-suite --add ${suite} < ${pusuite}.list
  39 dak control-suite --remove ${pusuite} < ${pusuite}.list
  40
  41 - clean up *.changes from proposed-updates:
  42 # Be careful if uploads were not included in the point release.
  43 pumorguedir="${base}/morgue/queues/$(date +%Y/%m)"
  44 mkdir -p "${pumorguedir}"
  45 cd ${ftpdir}/dists/${pusuite}
  46 mv -t "${pumorguedir}" -n -- *.changes
  47
  48 - -r0 additions?
  49   For example new d-i. If so:
  50 cd ~/${suite}_${newrev}
  51 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/${suitename}-r0-additions.cs .
  52 dak control-suite --add ${suitename}-r0 < ${suitename}-r0-additions.cs
  53
  54 - sync with stable RM if there is any propup needed. do it, if so:
  55 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.unstable .
  56 dak control-suite --force --add unstable <propups.unstable
  57 cp /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/propups.testing .
  58 dak control-suite --force --add testing <propups.testing
  59
  60 - ask rms if they have RMs to do.
  61 - and then check if they have a d-i update. if so, bash:
  62 # set dioldver to "empty" if there is no old to remove
  63 diver=20150422+deb8u2
  64 dak copy-installer -s ${pusuite} -d ${suite} ${diver}
  65 dioldver=20150422+deb8u1
  66 if [ "${dioldver}" != "empty" ]; then
  67     cd $ftpdir/dists/${suite}/main
  68     for iarch in $(dak admin s-a list-arch ${suite}); do
  69         if [ -d "installer-${iarch}/${dioldver}" ]; then
  70             echo "Moving installer-${iarch}/${dioldver} to morgue"
  71             mkdir -p "${base}/morgue/d-i/installer-${iarch}/"
  72             mv "installer-${iarch}/${dioldver}" "${base}/morgue/d-i/installer-${iarch}/"
  73         fi
  74     done
  75
  76     # Remove old version also from proposed-updates
  77     cd $ftpdir/dists/${pusuite}/main
  78     for iarch in $(dak admin s-a list-arch ${suite}); do
  79         rm -rf -- "installer-${iarch}/${dioldver}"
  80     done
  81 fi
  82 cd $ftpdir/dists/${suite}
  83
  84 - Updates for win32-loader?
  85 cd ${ftpdir}/tools/win32-loader
  86 if [ -d ${suitename}-proposed-updates ]; then
  87     rm -r ${suite}
  88     mv ${suitename}-proposed-updates ${suite}
  89 fi
  90 cd ${ftpdir}
  91
  92 - Update version number in README, README.html and dists/README,
  93   Clean up dists/stable/ChangeLog (add header, basically). bash:
  94
  95 cd ${ftpdir}/dists/${suite}
  96
  97 date_long=$(date "+%A, %-dth %B %Y" | sed 's/1th/1st/; s/2th/2nd/; s/3th/3rd/')
  98 date_iso=$(date "+%Y-%m-%d")
  99 date_short=$(date "+%a, %d %b %Y")
 100 sed -e "1i======================================\n${date_short} - Debian ${newrev} released\n======================================" -i ChangeLog
 101 sed -e "/^${suite}/ s/Debian ${oldrev}/Debian ${newrev}/" -i ../README
 102 sed -e "s/Debian ${oldrev}/Debian ${newrev}/g; /Debian ${newrev}/ s/released .*\\./released ${date_long}./" -i ../../README
 103 sed -e "s/Debian ${oldrev}/Debian ${newrev}/g; /Debian ${newrew}/ s/released .*\\./released ${date_long}./; /meta name=\"Modified\"/ s/content=\".*\"/content=\"${date_iso}\"/" -i ../../README.html
 104
 105 # Inspect changes. Regular expressions might be a bit fragile.
 106 $EDITOR ChangeLog ../README ../../README ../../README.html
 107 rm -f -- ./*~ ../*~ ../../*~
 108
 109 - Update the 'Debian<n>.<n>r<n>' symlink in dists/
 110 cd $ftpdir/dists/
 111 rm -f Debian${oldrev}
 112 ln -s ${suitename} Debian${newrev}
 113
 114 - Update fields in suite table in postgresql.
 115   bash:
 116
 117 mdate=$(date +"%d %B %Y")
 118 psql projectb <<EOF
 119 begin;
 120 update suite set version = '${newrev}' where suite_name = '${suite}';
 121 update suite set description = 'Debian ${newrev} Released ${mdate}' where suite_name = '${suite}';
 122 commit;
 123 EOF
 124
 125 - prepare for gps. bash:
 126 dak dominate --force -s ${suite}
 127 - check output from cruft report:
 128 dak cruft-report -s ${suite}
 129 - if cruft was removed: go back to run dominate again
 130
 131 - Let SRM see if all is ok
 132
 133 - then:
 134 dak generate-packages-sources2 --force -s ${suite} && dak contents generate -f -s ${suite} -a ftp-master
 135
 136 - For wheezy: update main/i18n/Index
 137 if [[ ${suitename} == wheezy ]]; then
 138   ${scriptsdir}/generate-i18n-Index "${ftpdir}/dists/${suite}"
 139 fi
 140
 141 - Generate Releases:
 142 dak generate-releases -f -s ${suite} ${pusuite}
 143 # Remove InRelease: Release can be signed by both ftpmaster & stable release keys
 144 rm ${ftpdir}/dists/${suite}/InRelease
 145
 146 - have the SRMs sign it and put the signature in.
 147 cd ${ftpdir}/dists/${suite}
 148 cat /srv/release.debian.org/www/${suitename}/${newrev%%.*}/${newrev}/Release.gpg >> Release.gpg
 149 gpg --no-default-keyring --keyring /usr/share/keyrings/debian-archive-keyring.gpg --trust-model=always --verify Release.gpg Release
 150
 151 - Check if a mirror push is needed or next dinstall is enough. for a push
 152 o if so, bash:
 153
 154 TRACEFILE="${ftpdir}/project/trace/ftp-master.debian.org"
 155 DATE_SERIAL=$(date +"%Y%m%d01")
 156 FILESOAPLUS1=$(awk '/serial/ { print $3+1 }' ${TRACEFILE} )
 157 if [ "$DATE_SERIAL" -gt "$FILESOAPLUS1" ]; then
 158     SERIAL="$DATE_SERIAL"
 159 else
 160     SERIAL="$FILESOAPLUS1"
 161 fi
 162 date -u > ${TRACEFILE}
 163 echo "Using dak v1" >> ${TRACEFILE}
 164 echo "Running on host: $(hostname -f)" >> ${TRACEFILE}
 165 echo "Archive serial: ${SERIAL}" >> ${TRACEFILE}
 166 cd ${mirrordir}
 167 rsync -aH --link-dest ${ftpdir} --delete --delete-after --ignore-errors ${ftpdir}/. .
 168 date -u > /srv/ftp.debian.org/web/mirrorstart
 169 echo "Using dak v1" >> /srv/ftp.debian.org/web/mirrorstart
 170 echo "Running on host $(hostname -f)" >> /srv/ftp.debian.org/web/mirrorstart
 171 sudo -H -u archvsync /home/archvsync/runmirrors > ~dak/runmirrors.log 2>&1 &
 172