Title:    Apache Hadoop Development Tools
Notice:    Licensed to the Apache Software Foundation (ASF) under one
           or more contributor license agreements.  See the NOTICE file
           distributed with this work for additional information
           regarding copyright ownership.  The ASF licenses this file
           to you under the Apache License, Version 2.0 (the
           "License"); you may not use this file except in compliance
           with the License.  You may obtain a copy of the License at
           .
             http://www.apache.org/licenses/LICENSE-2.0
           .
           Unless required by applicable law or agreed to in writing,
           software distributed under the License is distributed on an
           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
           KIND, either express or implied.  See the License for the
           specific language governing permissions and limitations
           under the License.

#Making A Release

The project follows [GitFlow](https://github.com/nvie/gitflow). Thus start the release using :

    git flow release start <RELEASE-VERSION>

This will create a release branch and switch to that.

Bump up to the release version using :  

    mvn tycho-versions:set-version -DnewVersion=<RELEASE-VERSION>

Make a complete build :

    mvn clean install

Make the required changes/bug fixes. Then commit all the changes back to release branch.

sign the release using :

    mvn verify gpg:sign install:install deploy:deploy

Create MD5 and SHA1 checksums for the source distribution:

    md5sum -b hdt-<RELEASE-VERSION>-hdt-assembly-src.tar.gz > hdt-<RELEASE-VERSION>-hdt-assembly-src.tar.gz.md5
    
    md5sum -b hdt-<RELEASE-VERSION>-hdt-assembly-bin.tar.gz > hdt-<RELEASE-VERSION>-hdt-assembly-bin.tar.gz.md5
    
    sha1sum -b hdt-<RELEASE-VERSION>-hdt-assembly-src.tar.gz > hdt-<RELEASE-VERSION>-hdt-assembly-src.tar.gz.sha1
    
    sha1sum -b hdt-<RELEASE-VERSION>-hdt-assembly-bin.tar.gz > hdt-<RELEASE-VERSION>-hdt-assembly-bin.tar.gz.sha1

Copy Binary and Source Release Artifacts, signature and checksum from *dist/target/* to *people.apache.org:~/public_html*/

Finish the release to merge back the changes to development and master :

    git flow release finish <VERSION>


Now go back on development branch and bump up to the next development version using  :

    mvn tycho-versions:set-version -DnewVersion=<NEXT-VERSION>

Now make a complete build to check all changes :

    mvn clean install
    
Then commit all the changes back to development

#Run the Vote. 

Send a "VOTE" to the [developer mailing list](mailto:dev@hdt.incubator.apache.org) including links to release artifacts. A VOTE always contains two parts. Send an email to the developer mailing list with the subject line:

    [VOTE] Release HDT version x.xx.xx

After the vote is over, send a "RESULT" email to the list with the subject line:

    [RESULT][VOTE] Release HDT version x.xx.xx

After the PPMC vote passes initiate a vote on the [general mailing list](mailto:general@incubator.apache.org)

Votes on whether a package is ready to be released use majority approval -- i.e., at least three PPMC(*for dev mailing list*)/ IPMC(*for general*) members must vote affirmatively for release, and there must be more positive than negative votes.


# Distribute and announce

If VOTE passes : Upload the release to https://dist.apache.org/repos/dist/release/incubator/hdt/

Send an announcement to the mailing list. Email announcements should have the subject line: 

    [ANNOUNCE] Released HDT version x.xx.xx