Re: [Hadoop Wiki] Update of "HowToRelease" by DougCutting

[Nigel Daley <nd...@yahoo-inc.com>]

Doug, does "jdiff.stable" also need to be edited in the build.xml or  
set on cmd line?

Nige

On Sep 25, 2008, at 4:10 PM, Apache Wiki wrote:

> Dear Wiki user,
>
> You have subscribed to a wiki page or wiki category on "Hadoop Wiki"  
> for change notification.
>
> The following page has been changed by DougCutting:
> http://wiki.apache.org/hadoop/HowToRelease
>
> The comment on the change is:
> updated for addition of jdiff
>
> ------------------------------------------------------------------------------
>  svn commit -m "Merge -r R1:R2 from trunk to X.Y branch. Fixes:  
> HADOOP-A, HADOOP-B."
>  }}}
>
> + = Build Requirements =
> +
> + To build an official release, you must:
> +
> +   1. Use a 64-bit Linux system, so that we can build both 32- and  
> 64-bit native code.
> +
> +   1. Have a recent version of Eclipse installed, so that the  
> eclipse plugin will build.
> +
> +   1. Have Owen's patched version of JDiff installed, attached to [https://issues.apache.org/jira/browse/HADOOP-3532 
>  HADOOP-3532].
> +
>  = Building =
>
> - 	1. Build the release & run unit tests.  Note that releases are  
> normally built on 64-bit Linux, so that they include the native code  
> for that platform.  Also, folks who build releases should install  
> eclipse, so that the eclipse plugin can be included in releases, pre- 
> compiled. {{{
> + 	1. Build the release & run unit tests. {{{
>  export JAVA_HOME=/path/to/32bit/jdk
>  export CFLAGS=-m32
>  export CXXFLAGS=-m32
> - ant -Dversion=X.Y.Z -Dcompile.native=true -Dcompile.c++=true - 
> Dlibhdfs=1 -Declipse.home=/usr/lib/eclipse clean package-libhdfs tar  
> test test-libhdfs
> + ant -Dversion=X.Y.Z -Dcompile.native=true -Dcompile.c++=true - 
> Dlibhdfs=1 -Declipse.home=/usr/lib/eclipse -Djdiff.home=/usr/local/ 
> jdiff clean package-libhdfs api-report tar test test-libhdfs
>  export JAVA_HOME=/path/to/64bit/jdk
>  export CFLAGS=-m64
>  export CXXFLAGS=-m64
> @@ -126, +136 @@
>
>  cp -rp hadoop-X.Y.Z/docs/api /www/hadoop.apache.org/core/docs/rX.Y.Z
>  rm -r hadoop-X.Y.Z
>  }}}
> +
> +         1. Generate the jdiff API data for the new release by, in  
> the branch directory, running {{{
> + ant -Dversion=X.Y.Z -Djdiff.home=/usr/local/jdiff api-xml
> + }}} then commit the XML file generated in docs/jdiff to both trunk  
> and to the branch.
> +
>  	1. 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.
>          1. In Jira, "release" the version.  Visit the "Administer  
> Project" page, then the "Manage versions" page.   You need to have  
> the "Admin" role in Hadoop Core's Jira for this step and the next.

Re: [Hadoop Wiki] Update of "HowToRelease" by DougCutting

[Doug Cutting <cu...@apache.org>]

Nigel Daley wrote:
> Doug, just getting back to this.  Does this look right?
> 
> http://wiki.apache.org/hadoop/HowToRelease?action=diff

Looks good to me.  Thanks!

Doug

Re: [Hadoop Wiki] Update of "HowToRelease" by DougCutting

[Nigel Daley <nd...@yahoo-inc.com>]

On Sep 26, 2008, at 10:56 AM, Doug Cutting wrote:

> Nigel Daley wrote:
>> Doug, does "jdiff.stable" also need to be edited in the build.xml  
>> or set on cmd line?
>
> Good point.  It should be updated in trunk after we've made a  
> release, but not merged to branches, so branches always point to a  
> prior branches release.  (It can't be updated until the "stable"  
> release is published, since we refer to the published javadoc.)
>
> If we make a release from other than the most-recent branch then we  
> probably want to update it in more recent branches to point to the  
> new version of the prior branch.
>
> Does that sound right?  If so, would you like to update the wiki, or  
> should I?

Doug, just getting back to this.  Does this look right?

http://wiki.apache.org/hadoop/HowToRelease?action=diff

Thx,
Nige

Re: [Hadoop Wiki] Update of "HowToRelease" by DougCutting

[Doug Cutting <cu...@apache.org>]

Nigel Daley wrote:
> Doug, does "jdiff.stable" also need to be edited in the build.xml or set 
> on cmd line?

Good point.  It should be updated in trunk after we've made a release, 
but not merged to branches, so branches always point to a prior branches 
release.  (It can't be updated until the "stable" release is published, 
since we refer to the published javadoc.)

If we make a release from other than the most-recent branch then we 
probably want to update it in more recent branches to point to the new 
version of the prior branch.

Does that sound right?  If so, would you like to update the wiki, or 
should I?

Doug