Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Build the release (binary and source versions) after running unit tests. Note that this will generate MD5 checksum files automatically. {{{
    ant test tar binary
    Code Block
    
     # Verify that the MD5 checksums are valid: 
    % md5sum -c hive-0.6.0
    No Format
    
    % ant -Dversion=X.Y.Z clean test tar binary
    
  2. Verify that the MD5 checksums are valid:
    No Format
    
    % md5sum -c hive-X.Y.Z.tar.gz.md5

     
    hive-X.Y.Z.tar.gz: OK
    
    
    % md5sum -c hive-

...

  1. X.

...

  1. Y.

...

  1. Z-bin.tar.gz.md5

...

  1.  
    hive-X.Y.Z-bin.tar.gz: OK
    

...

  1. Check

...

  1. that

...

  1. release

...

  1. file

...

  1. looks

...

  1. ok

...

  1. -

...

  1. e.g.

...

  1. install

...

  1. it

...

  1. and

...

  1. run

...

  1. examples

...

  1. from

...

  1. tutorial.

...

  1. Sign

...

  1. the

...

  1. release

...

  1. (see

...

  1. Step-By-Step

...

  1. Guide

...

  1. to

...

  1. Mirroring

...

  1. Releases

...

  1. for

...

  1. more

...

  1. information).
    No Format
    
    % 

...

  1. gpg --armor --output hive-X.Y.Z.tar.gz.asc --detach-sig hive-X.Y.Z.tar.gz

...

  1. 
    % gpg --armor --output hive-X.Y.Z-bin.tar.gz.asc --detach-sig hive-X.Y.Z-bin.tar.gz
    

...

  1. Copy

...

  1. release

...

  1. files

...

  1. to

...

  1. a

...

  1. public

...

  1. place.
    No Format
    
    % 

...

  1. ssh people.apache.org mkdir public_html/hive-X.Y.Z-candidate-0

...

  1. 
    % scp -p hive-X.Y.Z*.tar.gz* people.apache.org:public_html/hive-X.Y.Z-candidate-0

...

  1. 
    
  2. Call a release vote on dev at hive.apache.org.

...

Publishing

Once three PMC members have voted for a release, it may be published.

  1. Tag the release:
    No Format
    
    svn move 

...

  1. https://svn.apache.org/repos/asf/hive/tags/release-X.Y.Z-rcR

...

  1.  \
    https://svn.apache.org/repos/asf/hive/tags/release-X.Y.Z

...

  1.  -m "HiveX.Y.Z release."

...

Code Block

 # Copy release files to the distribution directory and make them writable by the hive group. 

...

  1. 
    
  2. Copy release files to the distribution directory and make them writable by the hive group.
    No Format
    
    ssh people.apache.org

...

  1. 
    cp -pR public_html/hive-X.Y.Z-candidate-0/ /www/www.apache.org/dist/hive/hive-X.Y.Z

...

  1. 
    cd /www/www.apache.org/dist/hive

...

  1. 
    chgrp -R hive hive-X.Y.Z

...

  1. 
    chmod -R g+w hive-X.Y.Z

...

Code Block

 # The release directory usually contains just two releases, the most recent from two branches, with a link named 'stable' to the most recent recommended version. 

...

  1. 
    
  2. The release directory usually contains just two releases, the most recent from two branches, with a link named 'stable' to the most recent recommended version.
    No Format
    
    ssh people.apache.org

...

  1. 
    cd /www/www.apache.org/dist/hive

...

  1. 
    rm -rf hive-A.B.C; rm stable

...

  1. 
    ln -s hive-A.B.D stable

...

Code Block

 # Wait 24 hours for release to propagate to mirrors.
 ## Prepare to edit the website. 

...

  1. 
    
  2. Wait 24 hours for release to propagate to mirrors.
    1. Prepare to edit the website.
      No Format
      
      svn co https://svn.apache.org/repos/asf/hive/site

...

    1. 
      
  1. Update the documentation links in
  1. author/src/documentation/content/xdocs/site.xml

...

  1. .
  2. Update the release news in author/src/documentation/content/xdocs/releases.xml

...

  1. .
  2. Regenerate the site,

...

  1. review

...

  1. it,

...

  1. then

...

  1. commit

...

  1. it.

...

  1. Code Block
    
    ant -Dforrest.home=/usr/local/forrest -Djava5.home=/usr/local/jdk1.5

...

  1. 
    firefox publish/index.html

...

  1. 
    svn commit -m "Updated site for release X.Y.Z."
    

...

  1. Deploy

...

  1. your

...

  1. site

...

  1. changes.

...

  1. Code Block
    
    ssh people.apache.org

...

  1. 
    cd /www/hive.apache.org

...

  1. 
    svn up

...

  1. 
    
  2. Copy the new release docs to
  1. people.apache.org:/www/hive.apache.org/docs/rX.Y.Z

...

  1. and

...

  1. update

...

  1. the

...

  1. docs/current

...

  1. link,

...

  1. by

...

  1. doing

...

  1. the

...

  1. following

...

  1. in

...

  1. your

...

  1. home

...

  1. directory

...

  1. on

...

  1. people.apache.org:

...

  1. Code Block
    
    ssh people.apache.org

...

  1. 
    tar xvf /www/www.apache.org/dist/hive/hive-X.Y.Z/hive-X.Y.Z.tar.gz '*/docs'

...

  1. 
    chmod -R ug=rwX,o=rX hive-X.Y.Z

...

  1. 
    chgrp -R hive hive-X.Y.Z

...

  1. 
    cp -rp hive-X.Y.Z/docs /www/hive.apache.org/docs/rX.Y.Z

...

  1. 
    rm -r hive-X.Y.Z

...

  1. 
    cd /www/hive.apache.org/docs/

...

  1. 
    ln -s rX.Y.Z current

...

  1. 
    
  2. Send announcements to the user and developer lists once the site changes are visible.
    1. In JIRA, ensure that only issues in the "Fixed" state have a "Fix Version" set to release X.Y.Z.
    2. In JIRA, "release" the version. Visit the "Administer Project" page, then the "Manage versions" page. You need to have the "Admin" role in Hive's Jira for this step and the next.
    3. In JIRA, close issues resolved in the release. Disable mail notifications for this bulk change.

...