Diff for "FrontPage/Axis2C/releases/steps"

Create a Key Pair

If you do not have one, create a key pair. Please do not create keys for each and every release.

# gpg --gen-key

the keys will be genrated in the ~/.gnupg

Export the Keys

gpg --armor --export <your id here> > KEYS

update KEYS

cd ~/release1
cat KEYS >> /www/www.apache.org/dist/ws/axis2-c/KEYS

Cut the relase

1. tag the SVN
   • do a svn cp to the tags location of the project. (

     (eg : svn copy https://svn.apache.org/repos/asf/webservices/axis2/trunk/c \

     • https://svn.apache.org/repos/asf/webservices/axis2/tags/c/1.2.0-rc1 \ -m "Tagging the 1.2.0 release of the 'axis2c' project for RC1 for the first time")

2. Take a new checkout and from the tag

   • (eg : svn checkout http://svn.apache.org/repos/asf/webservices/axis2/tags/c/1.2.0-rc2-4 ./1_2_0)

cd 1_2_0
remove Werror flag from configure.ac, neethi/configure.ac and util/configure.ac
To create binary and source distributions
sh dist1.sh > info 2> errors
By using source zip file created, create a windows binary named axis2c-bin-1.2.0-win32.zip and put it to ~/projects/release/axis2c-1.2.0
To create checksums, sign and verify
sh dist2.sh > info 2> errors
To upload
sh copy.sh

See appendix for the contents of the scripts build.sh(used inside dist1.sh) dist1.sh and dist2.sh and copy.sh

1. Upload release to your home dir at apache
2. Copy the release from your home to /www/www.apache.org/dist/ws/axis2-c/
3. Move earlier releases to archive.apache.org (/www/archive.apache.org/dist/ws/axis2/c/)

4. Update the site at https://svn.apache.org/repos/asf/webservices/axis2/site/c/

5. svn update the site at /www/ws.apache.org/axis2/c
6. Test Main Site Downloads (wait until mirros pickup the distributables, before sending the release note.)

Places to Change Version Numbers

• axutil_version.h
• axis2c.pc.in

• configure.ac & Makefile.am

  • util
  • util/include
  • guththila
  • axiom
  • neethi
  • samples
  • tools/tcpmon
  • tools/md5
• INSTALL file
• project.properties
• download.html
• index.html
• doxygenconf file
• build/win32/makefile
• library version numbers

Web Site

1. Update the website
2. Test the Web Site

Documentation

1. update index.html and download.html
2. update INSTALL file
3. project.propeties file
4. Reveiw project.xml
5. Include the web site docs in source and bin distributions in a 'docs' folder
6. Review README file
7. Update NEWS file, to contain a summary of what's new in release

8. Update the ChangeLog

9. Include doxygen generated API docs on 'docs/api' folder in both bin and src releases

Releasing

1. Create Announcements
2. Update JIRA
3. Send the Announcements

Useful Links

1. http://www.apache.org/dev/release.html#what

2. http://incubator.apache.org/guides/releasemanagement.html

3. http://httpd.apache.org/dev/release.html

4. http://jakarta.apache.org/commons/releases/index.html

5. http://www.apache.org/dev/

6. http://www.apache.org/foundation/voting.html

Appendix

Contents of build.sh

set -e
sh autogen.sh

AXIS2C_HOME=`pwd`/deploy
export AXIS2C_HOME
echo "AXIS2C_HOME = ${AXIS2C_HOME}"

sh configure --prefix=`pwd`/deploy --enable-tests=yes --with-apache2=/usr/local/apache2/include --enable-tcp=yes --with-archive=/usr/include
make -j 10
make install

cd samples
sh autogen.sh
sh configure --prefix=`pwd`/../deploy --with-axis2=`pwd`/../deploy/include/axis2-1.2
make -j 10
make install
cd ..

Contents of dist1.sh

sh clean.sh
rm -rf /axis2c/deploy

AXIS2C_HOME=`pwd`/deploy
export AXIS2C_HOME

echo "If you do not need to build Axis2/C %sh dam_dist1.sh nobuild"
BIN_DIR=axis2c-bin-1.2.0-linux
SRC_DIR=axis2c-src-1.2.0
TAR_GZ=$BIN_DIR.tar.gz
WIN_ZIP=axis2c-bin-1.2.0-win32.zip
SRC_TAR_GZ=$SRC_DIR.tar.gz
SRC_ZIP=$SRC_DIR.zip
MD5=$TAR_GZ.md5
ASC=$TAR_GZ.asc
SRC_TAR_GZ_MD5=$SRC_TAR_GZ.md5
SRC_ZIP_MD5=$SRC_ZIP.md5
SRC_TAR_GZ_ASC=$SRC_TAR_GZ.asc
SRC_ZIP_ASC=$SRC_ZIP.asc
WIN_MD5=$WIN_ZIP.md5
WIN_ASC=$WIN_ZIP.asc
PWDIR=$PWD

echo "Deleting $BIN_DIR, $TAR_GZ, $MD5 etc if any"
rm -rf $BIN_DIR
rm -f $TAR_GZ
rm -f $MD5
rm -rf $SRC_DIR
rm -f $SRC_TAR_GZ
rm -f $SRC_ZIP
rm -f $SRC_TAR_GZ_MD5
rm -f $SRC_ZIP_MD5
rm -f $WIN_MD5
rm -f $ASC
rm -f $SRC_ZIP_ASC
rm -f $SRC_TAR_GZ_ASC
rm -f $WIN_ASC

if [ $# -ne 1 ]
then
    sh build.sh
fi

echo "Making source distribution"
make dist

echo "Making binary distribution"
make bindist

Contents of dist2.sh

BIN_DIR=axis2c-bin-1.2.0-linux
SRC_DIR=axis2c-src-1.2.0
TAR_GZ=$BIN_DIR.tar.gz
WIN_ZIP=axis2c-bin-1.2.0-win32.zip
SRC_TAR_GZ=$SRC_DIR.tar.gz
SRC_ZIP=$SRC_DIR.zip
MD5=$TAR_GZ.md5
ASC=$TAR_GZ.asc
SRC_TAR_GZ_MD5=$SRC_TAR_GZ.md5
SRC_ZIP_MD5=$SRC_ZIP.md5
SRC_TAR_GZ_ASC=$SRC_TAR_GZ.asc
SRC_ZIP_ASC=$SRC_ZIP.asc
WIN_MD5=$WIN_ZIP.md5
WIN_ASC=$WIN_ZIP.asc
PWDIR=$PWD

echo "Deleting windows binary zip, $MD5 $ASC etc if any"
rm -f $WIN_ZIP
rm -f $MD5
rm -f $SRC_TAR_GZ_MD5
rm -f $SRC_ZIP_MD5
rm -f $WIN_MD5
rm -f $ASC
rm -f $SRC_ZIP_ASC
rm -f $SRC_TAR_GZ_ASC
rm -f $WIN_ASC

tar -zxf axis2c-src-1.2.0.tar.gz
zip -rq axis2c-src-1.2.0.zip axis2c-src-1.2.0
cp -f ../axis2c-bin-1.2.0-win32.zip ./
echo "Creating MD5"
openssl md5 < $TAR_GZ > $MD5
openssl md5 < $SRC_TAR_GZ > $SRC_TAR_GZ_MD5
openssl md5 < $WIN_ZIP > $WIN_MD5
openssl md5 < $SRC_ZIP > $SRC_ZIP_MD5

echo "To sign please enter password for the private key"
gpg --armor --output $TAR_GZ.asc --detach-sig $TAR_GZ
gpg --armor --output $SRC_TAR_GZ.asc --detach-sig $SRC_TAR_GZ
gpg --armor --output $WIN_ZIP.asc --detach-sig $WIN_ZIP
gpg --armor --output $SRC_ZIP.asc --detach-sig $SRC_ZIP

echo "DONE"

Content of copy.sh

rm -rf 1.2.0
rm -f 1.2.0.tar.gz
mkdir 1.2.0
cp -f ../KEYS 1.2.0
cp -f axis2c-* 1.2.0
tar zcf axis2c_1.2.0.tar.gz 1.2.0
scp axis2c_1.2.0.tar.gz damitha@people.apache.org:~/

Building Windows Binary

• ENABLE_GUTHTHILA = 1
• CRUNTIME = /MT
• EMBED_MANIFEST = 0
• DEBUG = 0