You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@oozie.apache.org by ka...@apache.org on 2011/09/20 03:59:57 UTC
svn commit: r1172947 - in /incubator/oozie/site/publish: documentation.html
downloads.html howtorelease.html index.html mailing_list.html
quick-start.html who_we_are.html
Author: kamrul
Date: Tue Sep 20 01:59:56 2011
New Revision: 1172947
URL: http://svn.apache.org/viewvc?rev=1172947&view=rev
Log:
adding site html
Added:
incubator/oozie/site/publish/howtorelease.html
Modified:
incubator/oozie/site/publish/documentation.html
incubator/oozie/site/publish/downloads.html
incubator/oozie/site/publish/index.html
incubator/oozie/site/publish/mailing_list.html
incubator/oozie/site/publish/quick-start.html
incubator/oozie/site/publish/who_we_are.html
Modified: incubator/oozie/site/publish/documentation.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/documentation.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/documentation.html (original)
+++ incubator/oozie/site/publish/documentation.html Tue Sep 20 01:59:56 2011
@@ -42,7 +42,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
<a href="index.html">Apache Oozie</a>
</div>
@@ -102,6 +102,10 @@
<li class="none">
<strong>Documentation</strong>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
Modified: incubator/oozie/site/publish/downloads.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/downloads.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/downloads.html (original)
+++ incubator/oozie/site/publish/downloads.html Tue Sep 20 01:59:56 2011
@@ -42,7 +42,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
<a href="index.html">Apache Oozie</a>
</div>
@@ -102,6 +102,10 @@
<li class="none">
<a href="documentation.html">Documentation</a>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
Added: incubator/oozie/site/publish/howtorelease.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/howtorelease.html?rev=1172947&view=auto
==============================================================================
--- incubator/oozie/site/publish/howtorelease.html (added)
+++ incubator/oozie/site/publish/howtorelease.html Tue Sep 20 01:59:56 2011
@@ -0,0 +1,311 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Oozie - How to Release</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <span id="bannerLeft">
+
+ Â
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 2011-09-19
+ |
+ <a href="index.html">Apache Oozie</a>
+ </div>
+ <div class="xright"> <a href="../index.html">OTHER RELEASES</a>
+ |
+ <a href="http://www.apache.org/" class="externalLink">ASF</a>
+
+
+
+
+
+
+
+
+ Version: 3.1.0-SNAPSHOT
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+
+ <h5>Apache Oozie</h5>
+ <ul>
+
+ <li class="none">
+ <a href="index.html">Home</a>
+ </li>
+
+ <li class="none">
+ <a href="who_we_are.html">Who we are</a>
+ </li>
+ </ul>
+ <h5>Getting Started</h5>
+ <ul>
+
+ <li class="none">
+ <a href="quick-start.html">Quick start</a>
+ </li>
+
+ <li class="none">
+ <a href="mailing_list.html">Mailing List</a>
+ </li>
+
+ <li class="none">
+ <a href="downloads.html">Downloads</a>
+ </li>
+
+ <li class="none">
+ <a href="documentation.html">Documentation</a>
+ </li>
+
+ <li class="none">
+ <strong>How to Release</strong>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2>How to Release</h2>
+<p>This page is to document the release procedure for Oozie. Oozie is currently a Apache incubator project. Its release process is <tt>work in progress</tt>. </p>
+<div class="section"><h3>Preparation</h3>
+<ol type="1"><li>Define issue management process like assigning/removing issues from the release.</li>
+<li>TBD. []</li>
+</ol>
+</div>
+<div class="section"><h3>Creating Release Branch</h3>
+<p>A new release branch is created only for for major (X.0.0) and minor(X.Y.0) releases but not for patches (X.Y.Z). Patch is an update to an existing branch created for X.Y.0. Although the patch release could be tagged.</p>
+<ol type="1"><li>Send email to oozie-dev@incubator.apache.org to notify that <ol type="A"><li>A new branch is about to be created based from the trunk. </li>
+<li>Request to hold off any commits until further email.</li>
+</ol>
+</li>
+<li>Update and committ the pom.xml of different sub-projects (such as core, client, webapp etc.) of Oozie with appropriate version (i.e. x.y.0)</li>
+<li>Create a branch for the release:<div class="source"><pre>svn copy https://svn.apache.org/repos/asf/incubator/oozie/trunk \
+https://svn.apache.org/repos/asf/incubator/oozie/branches/branch-X.Y -m "Branching for X.Y releases"</pre>
+</div>
+</li>
+</ol>
+</div>
+<div class="section"><h3>Updating Release Branch</h3>
+<p>These steps are required for all the releases (such as major, minor, and patches).</p>
+<ol type="1"><li>Check out the branch with:<div class="source"><pre> svn co https://svn.apache.org/repos/asf/incubator/oozie/branches/branch-X.Y</pre>
+</div>
+</li>
+<li>Create <i>rat</i> report to verify all files have apache license aggreement. The generated report will be used later. TBD: How to combine rat report generated for each sub-projects?<div class="source"><pre> mvn apache-rat:check</pre>
+</div>
+</li>
+<li>Tag the release candidate, where R is the iteration number for this release candidate, starting with 0:<div class="source"><pre> svn copy https://svn.apache.org/repos/asf/incubator/oozie/branches/branch-X.Y \
+ https://svn.apache.org/repos/asf/incubator/oozie/tags/release-X.Y.Z-rcR -m "Oozie X.Y.Z-rcR release."</pre>
+</div>
+</li>
+</ol>
+</div>
+<div class="section"><h3>Building</h3>
+<ol type="1"><li>Build with all unit tests:<div class="source"><pre> umask 0022
+ mvn clean package assembly:single
+ OR
+ bin/mkdistro.sh</pre>
+</div>
+</li>
+<li>Generate the MD5 checksum of the release file:<div class="source"><pre> cd distro/target
+ md5sum Oozie-X.Y.Z-incubating.tar.gz > Oozie-X.Y.Z-incubating.tar.gz.md5</pre>
+</div>
+</li>
+<li>If you do not have a gpg key pair, do the following steps:<ol type="A"><li>Generating key pair using the following command. You can simply accept all default settings and give your name, email and Passphase.<div class="source"><pre> gpg --gen-key</pre>
+</div>
+</li>
+<li>Export the public key.<div class="source"><pre> gpg --armor --output pubkey.txt --export 'Your Name'</pre>
+</div>
+</li>
+<li>Open pubkey.txt, copy the full text and append it to the following files by pasting, then commit these changes:<div class="source"><pre> https://svn.apache.org/repos/asf/incubator/oozie/branches/branch-X.Y.Z/KEYS
+ https://svn.apache.org/repos/asf/incubator/oozie/trunk/KEYS</pre>
+</div>
+</li>
+<li>Upload updated KEYS to Apache.<div class="source"><pre> scp KEYS people.apache.org:/www/www.apache.org/dist/incubator/oozie/KEYS</pre>
+</div>
+</li>
+<li>Export your private key, keep it with you.<div class="source"><pre> gpg --export-secret-key -a "Your Name" > private.key</pre>
+</div>
+</li>
+</ol>
+</li>
+<li>Sign the release (see Step-By-Step Guide to Mirroring Releases for more information).<div class="source"><pre> gpg --armor --output oozie-X.Y.Z-incubating.tar.gz.asc --detach-sig oozie-X.Y.Z-incubating.tar.gz</pre>
+</div>
+</li>
+<li>Verify gpg signature.<div class="source"><pre> gpg --import KEYS (if necessarily)
+ gpg --verify oozie-X.Y.Z-incubating.tar.gz.asc oozie-X.Y.Z-incubating.tar.gz</pre>
+</div>
+</li>
+<li>Copy release files to a public place (usually into public_html in your home directory):<div class="source"><pre> ssh people.apache.org mkdir public_html/oozie-X.Y.Z-incubating-candidate-0
+ scp -p oozie-X.Y.Z-incubating.tar.gz* people.apache.org:public_html/oozie-X.Y.Z-incubating-candidate-0
+ cd ..
+ scp release_log.txt people.apache.org:public_html/oozie-X.Y.Z-incubating-candidate-0
+ scp rat_report people.apache.org:public_html/oozie-X.Y.Z-incubating-candidate-0
+ NOTE: The rat_report is the report generated in the Updating Release Branch section above.</pre>
+</div>
+</li>
+<li>Call a release vote for the Podling PMC (PPMC). This vote must receive a minimum of 3 PPMC members +1s, and more +1s than -1s. The email should be sent to oozie-user@incubator.apache.org. The mail should:<ol type="A"><li>Have a subject line "[VOTE] Release Oozie X.Y.Z-incubating (candidate a)" where X.Y.Z is the version number and a is the candidate number for this release.</li>
+<li>State what are new in this release.</li>
+<li>Tell where the keys used to sign the release can be found.</li>
+<li>State where the release, md5 signature, gpg signature, and rat report can be found.</li>
+<li>Request that users and developers download it, test it, and vote.</li>
+<li>State when the vote closes. The vote must remain open for at least 72 hours. It can be longer at your discretion (e.g. around major holidays).<br />
+Here is a sample email:<div class="source"><pre> Subject: [VOTE] Release Oozie X.Y.Z-incubating (candidate 0)
+
+ Hi,
+
+ I have created a candidate build for Oozie X.Y.Z-incubating. This is the first release of Oozie from Apache Incuabtion.
+
+ Keys used to sign the release are available at http://svn.apache.org/viewvc/incubator/oozie/trunk/KEYS?view=markup.
+
+ Please download, test, and try it out:
+
+ http://people.apache.org/~you/oozie-X.Y.Z-incubating-candidate-0
+
+ The release, md5 signature, gpg signature, and rat report can all be found at the above address.
+
+ Should we release this? Vote closes on <DATE>.
+
+ Me</pre>
+</div>
+</li>
+</ol>
+</li>
+<li>If the PPMC approves the release, call an Incubator PMC (IPMC) vote. This vote must receive a minimum of 3 IPMC member +1s, and more +1s than -1s. The email sent should look similar to PPMC.</li>
+</ol>
+</div>
+<div class="section"><h3>Publish</h3>
+<p>If both votes pass, the release needs to be published.</p>
+<ol type="1"><li>Tag the release:<div class="source"><pre> svn move https://svn.apache.org/repos/asf/incubator-oozie/tags/release-X.Y.Z-rcR \
+ https://svn.apache.org/repos/asf/incubator-oozie/tags/release-X.Y.Z -m "Oozie X.Y.Z release."</pre>
+</div>
+</li>
+<li>Copy the release files to the distribution directory and make them writable by the oozie group.<div class="source"><pre> ssh people.apache.org
+ cp -pr public_html/oozie-X.Y.Z-incubating-candidate-0 /www/www.apache.org/dist/incubator/oozie/oozie-X.Y.Z-incubating
+ cd /www/www.apache.org/dist/incubator/oozie
+ chgrp -R incubator oozie-X.Y.Z-incubating
+ chmod -R g+w oozie-X.Y.Z-incubating</pre>
+</div>
+</li>
+<li>Wait 24 hours for release to propagate to mirrors.</li>
+<li>Edit the website. Details: TBD<div class="source"><pre> svn co https://svn.apache.org/repos/asf/incubator/oozie/site</pre>
+</div>
+</li>
+<li>Wait until you see your changes reflected on the Apache web site.</li>
+<li>Send announcements to the user and developer lists as well as (announce@haoop.apache.org) once the site changes are visible.<div class="source"><pre> The Oozie team is happy to announce the release of Oozie X.Y.Z.
+
+ Apache Oozie provides a workflow management and scheduling for Hadoop jobs.
+ More details about Oozie can be found at http://incubator.apache.org/oozie.
+
+ The highlights of this release are ... The details of the release can be found at http://incubator.apache.org/oozie/releases.html.</pre>
+</div>
+</li>
+</ol>
+<ol type="1"><li>In JIRA, mark the release as released.<ol type="A"><li>Goto JIRA and click on Administration tab.</li>
+<li>Select the Oozie project.</li>
+<li>Select Manage versions.</li>
+<li>Select Release for the version you have released.</li>
+<li>If a description has not yet been added for the version you are releasing, select Edit Details and give a brief description of the release.</li>
+<li>If the next version does not exist (that is, if you are releasing version X.Y, if version X.Y+1 does not yet exist) create it using the Add Version box at the top of the page.</li>
+</ol>
+</li>
+<li>In JIRA, mark the issues resolved in this release as closed.<ol type="A"><li>Goto JIRA and click on the "Search for Issues" on "Issues" menu.</li>
+<li>In the left hand Edit section, set Project to Oozie.</li>
+<li>In Status select "Resolved"</li>
+<li>In Resolutions select "Fixed"</li>
+<li>Click "Search" button</li>
+<li>In the next screen, further select fix For select the version you are releasing.</li>
+<li>Click on the "Search" button</li>
+<li>Select "Tools->Bulk change all XX issues" (near the top right)</li>
+<li>Select all the issues and click on "Next"</li>
+<li>Select "Transition Issues" radio button and click on "Next"</li>
+<li>Select "Close Issue" radio button and click on "Next"</li>
+<li>Uncheck the box near the bottom at says "Send mail for this update" lest you spam every Oozie developer with a message for every bug resolved in this release. Click "Next".</li>
+<li>Click "Confirm". Don't worry if it gives you a HTTP 500 error, it still does the transitions. []</li>
+</ol>
+</li>
+</ol>
+</div>
+</div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2011
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a></div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Modified: incubator/oozie/site/publish/index.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/index.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/index.html (original)
+++ incubator/oozie/site/publish/index.html Tue Sep 20 01:59:56 2011
@@ -43,7 +43,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
Apache Oozie
</div>
@@ -103,6 +103,10 @@
<li class="none">
<a href="documentation.html">Documentation</a>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
Modified: incubator/oozie/site/publish/mailing_list.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/mailing_list.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/mailing_list.html (original)
+++ incubator/oozie/site/publish/mailing_list.html Tue Sep 20 01:59:56 2011
@@ -42,7 +42,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
<a href="index.html">Apache Oozie</a>
</div>
@@ -102,6 +102,10 @@
<li class="none">
<a href="documentation.html">Documentation</a>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
Modified: incubator/oozie/site/publish/quick-start.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/quick-start.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/quick-start.html (original)
+++ incubator/oozie/site/publish/quick-start.html Tue Sep 20 01:59:56 2011
@@ -42,7 +42,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
<a href="index.html">Apache Oozie</a>
</div>
@@ -102,6 +102,10 @@
<li class="none">
<a href="documentation.html">Documentation</a>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
Modified: incubator/oozie/site/publish/who_we_are.html
URL: http://svn.apache.org/viewvc/incubator/oozie/site/publish/who_we_are.html?rev=1172947&r1=1172946&r2=1172947&view=diff
==============================================================================
--- incubator/oozie/site/publish/who_we_are.html (original)
+++ incubator/oozie/site/publish/who_we_are.html Tue Sep 20 01:59:56 2011
@@ -42,7 +42,7 @@
<div class="xleft">
- Last Published: 2011-09-07
+ Last Published: 2011-09-19
|
<a href="index.html">Apache Oozie</a>
</div>
@@ -102,6 +102,10 @@
<li class="none">
<a href="documentation.html">Documentation</a>
</li>
+
+ <li class="none">
+ <a href="howtorelease.html">How to Release</a>
+ </li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>