Apache Cassandra > Index > HowToRelease
Added by Johan Oskarsson, last edited by Johan Oskarsson on Apr 08, 2009  (view change)

Preparation

  1. Bulk update Jira to unassign from this release all issues that are open non-blockers and send follow-up notification to the developer list that this was done.

Branching

Skip this section if this is NOT the first release in a series (i.e. release X.Y.0).

  1. Notify developers on the #cassandra IRC channel that you are about to branch a release.
  2. Regenerate the documentation.
  3. Commit these changes to trunk.
  4. Create a branch for the release series:
    svn copy https://svn.apache.org/repos/asf/incubator/cassandra/trunk \
    https://svn.apache.org/repos/asf/incubator/cassandra/branches/branch-X.Y -m "Branching for X.Y releases"
    
  5. Update the default version in build.xml on trunk to X.Y+1.0-dev.
  6. Commit these changes to trunk.
    svn commit -m "Preparing for X.Y+1.0 development"
    

Updating Release Branch

These operations take place in the release branch.

  1. Check out the branch with:
    svn co https://svn.apache.org/repos/asf/incubator/cassandra/branches/branch-X.Y
    
  2. Regenerate the documentation.
    ant docs
    
  3. Update
    docs/releasenotes.html
    with release notes for this release.
  4. Update the version number in build.xml
  5. Commit these changes.
    svn commit -m "Preparing for release X.Y.Z"
    
  6. Tag the release candidate (R is the release candidate number):
    svn copy https://svn.apache.org/repos/asf/incubator/cassandra/branches/branch-X.Y \
    https://svn.apache.org/repos/asf/incubator/cassandra/tags/release-X.Y.Z-rcR -m "Cassandra X.Y.Z-rcR release."
    

Building

  1. Build the release & run unit tests.
    ant -Dversion=X.Y.Z test tar *targetdoesntexistyet*
    
  2. Check that release file looks ok - e.g. install it and run examples from tutorial.
  3. Generate the MD5 checksum of the release file.
    md5sum cassandra-X.Y.Z.tar.gz > cassandra-X.Y.Z.tar.gz.md5
    
  4. Sign the release (see Step-By-Step Guide to Mirroring Releases for more information).
    gpg --armor --output cassandra-X.Y.Z.tar.gz.asc --detach-sig cassandra-X.Y.Z.tar.gz
    
  5. Copy release files to a public place.
    ssh people.apache.org mkdir public_html/cassandra-X.Y.Z-candidate-0
    scp -p cassandra-X.Y.Z.tar.gz* people.apache.org:public_html/cassandra-X.Y.Z-candidate-0
    
  6. Call a release vote on cassandra-dev at incubator.apache.org.

Publishing

Leaving this empty for now.

See Also