Releasing

NOTES ON RELEASING NEW VERSION OF NAGIOSPLUG

NB: A copy of this document is located at:
http://nagiosplugins.org/node/96

*** Pre-release
git pull
. tools/devmode, if feeling adventurous
check compilation, check tinderbox screens

*** Prepare and commit files
Update BUGS, NEWS file
Update AUTHORS if new members
Update configure.in, package.def and NP-VERSION-GEN with version
Run git2cl (get from http://josefsson.org/git2cl/):
git2cl >Changelog
commit BUGS NEWS configure.in package.def ChangeLog NP-VERSION-GEN

*** Create new tag and push to SF
git tag -a -m release-1.4.15 release-1.4.15
git push --tags

*** Checkout new version
rm -fr /tmp/nagioslug
# If you need to checkout the tag, don't forget to "checkout master" later to
# get back to your development branch:
git checkout tags/release-1.4.14
# Beware: the trailing slash of --prefix is REQUIRED
git checkout-index --prefix=/tmp/nagiosplugins/ -a

*** Build the tarball
cd /tmp/nagiosplugins
tools/setup
./configure
make dist

*** Upload generated tarball to sourceforge
** These steps have changed due to SF procedural changes - need revising
Setup account on SF to allow SSH access:
ssh -t USER,nagiosplug@shell.sourceforge.net create

Goto filesystem UI: https://sourceforge.net/project/admin/explorer.php?group_id=29880
Create a subdirectory under nagiosplug for the release version

Upload file to new release directory, eg:
scp nagios-plugins-1.4.14.tar.gz USER,nagiosplug@frs.sourceforge.net:/home/frs/project/n/na/nagiosplug/nagiosplug/1.4.14

SF -> Develop -> News -> Submit

Add news item to http://nagiosplugins.org/nagiosplugins-{release}
"Proud to announce...."
Summary about release
List all people on team involved.
Add acknowledgement to contributors
Link to download at https://sourceforge.net/projects/nagiosplug/files/
Include contents of NEWS for this release. Use this perl script to convert NEWS to wiki format:


perl -pe 'BEGIN { $in_release=0} if(/^[\d\.]+/ && $in_release) { exit} if($in_release) { s/^\t//; s/^/ * / unless (/^[A-Z]*$/) } if(/^[\d\.]+/ && $in_release==0) { $in_release=1 }' NEWS


Publish to front page.

SF -> Submit News about release. Make sure it is called "Nagios Plugins" (with those caps)
Link to plugins site news article

*** Announce new release
Send email to nagiosplug-help, nagios-announce with the summary and link to nagiosplugins.org
Send email to Ethan directly to update nagios.org site.