Author: buildbot
Date: Thu Feb  5 06:06:07 2015
New Revision: 939049

Log:
Staging update by buildbot for nifi

Added:
    websites/staging/nifi/trunk/content/development/licensing-guide.html
Modified:
    websites/staging/nifi/trunk/content/   (props changed)

Propchange: websites/staging/nifi/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Feb  5 06:06:07 2015
@@ -1 +1 @@
-1657479
+1657480

Added: websites/staging/nifi/trunk/content/development/licensing-guide.html
==============================================================================
--- websites/staging/nifi/trunk/content/development/licensing-guide.html (added)
+++ websites/staging/nifi/trunk/content/development/licensing-guide.html Thu 
Feb  5 06:06:07 2015
@@ -0,0 +1,431 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+  <head>
+    <title>NiFi Release Guidelines</title>
+
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+    <meta property="og:image" 
content="http://www.apache.org/images/asf_logo.gif"; />
+
+    <link href="/css/bootstrap.css" rel="stylesheet">
+    <link href="/css/bootstrap-theme.css" rel="stylesheet">
+    <link href="/css/site.css" rel="stylesheet">
+
+    <script 
src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js";></script>
+    <script src="/js/bootstrap.min.js"></script>
+<script>
+  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new 
Date();a=s.createElement(o),
+  
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+  ga('create', 'UA-57264262-1', 'auto');
+  ga('send', 'pageview');
+
+</script>
+
+    
+    <!-- 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 
&quot;License&quot;); 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 &quot;AS IS&quot; 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. -->
+  </head>
+
+  <body>
+    <div class="container">
+
+      <!-- Static navbar -->
+<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#navbar" aria-expanded="false" 
aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav">
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" 
role="button" aria-expanded="false">Project<span class="caret"></span></a>
+                    <ul class="dropdown-menu" role="menu">
+                        <li><a href="/index.html">Home</a></li>
+                                               <li><a 
href="https://blogs.apache.org/nifi/";>Apache NiFi Blog</a></li>
+                        <li><a href="/docs/roadmap.html">Roadmap</a></li>
+                        <li><a 
href="http://www.apache.org/licenses/LICENSE-2.0";><span class="glyphicon 
glyphicon-link" aria-hidden="true"></span> License</a></li>
+                    </ul>
+                </li>
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" 
role="button" aria-expanded="false">Documentation<span class="caret"></span></a>
+                    <ul class="dropdown-menu" role="menu">
+                        <li><a href="/docs/faq.html">FAQ</a></li>
+                                               <li><a 
href="/docs/nifi-docs/overview.html">NiFi Overview</a></li>
+                                               <li><a 
href="/docs/nifi-docs/user-guide.html">User Guide</a></li>
+                                               <li><a 
href="/docs/nifi-docs/developer-guide.html">Developer Guide</a></li>
+                    </ul>
+                </li>
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" 
role="button" aria-expanded="false">Download<span class="caret"></span></a>
+                    <ul class="dropdown-menu" role="menu">
+                        <li><a href="/downloads/">Download NiFi</a></li>
+                    </ul>
+                </li>
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" 
role="button" aria-expanded="false">Community<span class="caret"></span></a>
+                    <ul class="dropdown-menu" role="menu">
+                        <li><a href="/mailing_lists.html">Mailing 
Lists</a></li>
+                        <li><a href="/people.html">People</a></li>
+                    </ul>
+                </li>
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" 
role="button" aria-expanded="false">Development<span class="caret"></span></a>
+                    <ul class="dropdown-menu" role="menu">
+                        <li><a 
href="/development/quickstart.html">Quickstart</a></li>
+                                               <li><a 
href="/development/release-guide.html">Release Guide</a></li>
+                                               <li><a 
href="/development/licensing-guide.html">Licensing Guide</a></li>
+                                               <li><a 
href="/docs/nifi-docs/developer-guide.html">Developer Guide</a></li>
+
+                        <li><a 
href="https://git-wip-us.apache.org/repos/asf/incubator-nifi.git";><span 
class="glyphicon glyphicon-link" aria-hidden="true"></span> Source</a></li>
+                        <li class="divider"></li>
+                        <li class="dropdown-header">Tools</li>
+                        <li><a 
href="https://issues.apache.org/jira/browse/NIFI";><span class="glyphicon 
glyphicon-link" aria-hidden="true"></span> Issues</a></li>
+                    </ul>
+                </li>
+                <li class="dropdown">
+                    <a class="dropdown-toggle" data-toggle="dropdown" 
href="#">ASF Links <span class="caret"></span></a>
+                    <ul class="dropdown-menu">
+                        <li><a href="http://www.apache.org";><span 
class="glyphicon glyphicon-link" aria-hidden="true"></span> Apache Software 
Foundation</a></li>
+                        <li><a 
href="http://www.apache.org/foundation/sponsorship.html";><span class="glyphicon 
glyphicon-link" aria-hidden="true"></span> Sponsorship</a></li>
+                        <li><a href="http://www.apache.org/security/";><span 
class="glyphicon glyphicon-link" aria-hidden="true"></span> Security</a></li>
+                        <li><a 
href="http://www.apache.org/foundation/thanks.html";><span class="glyphicon 
glyphicon-link" aria-hidden="true"></span> Thanks</a></li>
+                    </ul>
+                </li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div>
+</nav>
+
+
+      <!--<div class="jumbotron">-->
+        <div id="content">
+          <h1 id="wzxhzdk5-apache-nifi-release-guide"><img alt="NiFi logo" 
style="float: right" src="/images/niFi-logo-horizontal.png" /> Apache NiFi 
Release Guide</h1>
+<p>The purpose of this document is to capture and describe the steps involved 
in producing 
+an official release of Apache NiFi.  It is written specifically to someone 
acting in the
+capacity of a <a 
href="http://www.apache.org/dev/release-publishing.html#release_manager";>Release
 Manager</a> (RM).  </p>
+<h2 id="background-material">Background Material</h2>
+<ul>
+<li>
+<p>These documents are necessary for all committers to be familiar with</p>
+<ul>
+<li><a href="http://apache.org/licenses/LICENSE-2.0";>Apache License 
V2.0</a></li>
+<li><a href="http://www.apache.org/legal/resolved.html";>Apache Legal 
License/Resolved</a></li>
+<li><a href="http://www.apache.org/dev/apply-license.html";>Apache How-to Apply 
License</a></li>
+<li><a href="http://incubator.apache.org/guides/branding.html";>Apache 
Incubator Branding Guidelines</a></li>
+</ul>
+</li>
+<li>
+<p>These documents are necessary for someone acting as the RM</p>
+<ul>
+<li><a href="http://www.apache.org/licenses/exports/";>Apache Encryption 
Software / ECCN Info</a></li>
+<li><a href="http://www.apache.org/dev/release.html";>Apache Release 
Policy</a></li>
+<li><a href="http://www.apache.org/dev/release-publishing";>Apache Release 
Guide</a></li>
+<li><a href="http://incubator.apache.org/guides/releasemanagement.html";>Apache 
Incubator Release Guide</a></li>
+<li><a href="http://incubator.apache.org/guides/release.html";>another Apache 
Incubator Release Guide</a></li>
+<li><a 
href="http://incubator.apache.org/incubation/Incubation_Policy.html";>Apache 
Incubator Policy</a></li>
+</ul>
+</li>
+<li>
+<p>These documents are helpful for general environmental setup to perform 
releases</p>
+<ul>
+<li><a href="http://www.apache.org/dev/openpgp.html";>Apache PGP Info</a></li>
+<li><a href="http://www.apache.org/dev/release-signing.html";>Apache Release 
Signing</a></li>
+<li><a href="http://www.apache.org/dev/publishing-maven-artifacts.html";>Apache 
Guide to publish Maven Artifacts</a></li>
+</ul>
+</li>
+</ul>
+<h2 id="the-objective">The objective</h2>
+<p>Our aim is to produce and official Apache release.<br />
+The following is a list of the sorts of things that will be validated and are 
the basics to check
+when evaluating a release for a vote.</p>
+<h2 id="what-to-validate-and-how-to-validate-a-release">What to validate and 
how to Validate a release</h2>
+<p>There are two lists here: one of specific incubator requirements, and 
another of general Apache requirements.</p>
+<h3 id="incubator">Incubator:</h3>
+<ul>
+<li>Do the resulting artifacts have 'incubating' in the name?</li>
+<li>Is there a DISCLAIMER file in the source root that meets the requirements 
of the Incubator branding guidelines?</li>
+</ul>
+<h3 id="general-apache-release-requirements">General Apache Release 
Requirements:</h3>
+<ul>
+<li>Are LICENSE and NOTICE file present in the source root and complete?<ul>
+<li>Specifically look in the *-sources.zip artifact and ensure these items are 
present at the root of the archive.</li>
+</ul>
+</li>
+<li>Evaluate the sources and dependencies.  Does the overall LICENSE and 
NOTICE appear correct?  Do all licenses fit within the ASF approved 
licenses?<ul>
+<li>Here is an example path to a sources artifact:  </li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip</code></li>
+</ul>
+</li>
+<li>Is there a README available that explains how to build the application and 
to execute it?<ul>
+<li>Look in the *-sources.zip artifact root for the readme.</li>
+</ul>
+</li>
+<li>Are the signatures and hashes correct for the source release?<ul>
+<li>Validate the hashes of the sources artifact do in fact match:</li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip.md5</code></li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip.sha1</code></li>
+<li>Validate the signatures of the sources artifact and of each of the hashes. 
 Here are example paths:</li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip.asc</code></li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip.asc.md5</code></li>
+<li><code>https://repository.apache.org/service/local/repositories/orgapachenifi-1011/content/org/apache/nifi/nifi/0.0.1-incubating/nifi-0.0.1-incubating-source-release.zip.asc.sha1</code></li>
+<li>Need a quick reminder on how to <a 
href="http://www.apache.org/dev/release-signing.html#verifying-signature";>verify
 a signature</a>?</li>
+</ul>
+</li>
+<li>Do all sources have necessary headers?<ul>
+<li>Unzip the sources file into a directory and execute <code>mvn install 
-Pcheck-licenses</code></li>
+</ul>
+</li>
+<li>Are there no unexpected binary files in the release?<ul>
+<li>The only thing we'd expect would be potentially test resources files.</li>
+</ul>
+</li>
+<li>Does the app (if appropriate) execute and function as expected?</li>
+</ul>
+<h2 id="the-flow-of-a-release-an-outline">The flow of a release (an 
outline)</h2>
+<ul>
+<li>The community is contributing to a series of JIRA tickets assigned to the 
next release</li>
+<li>The number of tickets open/remaining for that next release approaches 
zero</li>
+<li>A member of the community suggests a release and initiates a 
discussion</li>
+<li>Someone volunteers to be an RM for the release (can be a committer but 
apache guides indicate preference is a PPMC member)</li>
+<li>A release candidate is put together and a vote sent to the team.</li>
+<li>If the team rejects the vote the issues noted are resolved and another RC 
is generated</li>
+<li>Once a vote is accepted within the NiFi PPMC for a release candidate then 
the vote is sent to the IPMC</li>
+<li>If the IPMC rejects the vote then the issues are resolved and a new RC 
prepared and voted upon within the PPMC</li>
+<li>If the IPMC accepts the vote then the release is 'releasable' and can be 
placed into the appropriate 'dist' location, maven artifacts released from 
staging.</li>
+</ul>
+<h2 id="the-mechanics-of-the-release">The mechanics of the release</h2>
+<h3 id="prepare-your-environment">Prepare your environment</h3>
+<p>Follow the steps outlined in the <a 
href="http://nifi.incubator.apache.org/development/quickstart.html";>Quickstart 
Guide</a></p>
+<div class="codehilite"><pre><span class="n">At</span> <span 
class="n">this</span> <span class="n">point</span> <span 
class="n">you</span><span class="o">&#39;</span><span class="n">re</span> <span 
class="n">on</span> <span class="n">the</span> <span class="n">latest</span> 
<span class="s">&#39;develop&#39;</span> <span class="n">branch</span> <span 
class="n">and</span> <span class="n">are</span> <span class="n">able</span> 
<span class="n">to</span> <span class="n">build</span> <span 
class="n">the</span> <span class="n">entire</span> <span 
class="n">application</span>
+</pre></div>
+
+
+<p>Create a JIRA ticket for the release tasks and use that ticket number for 
the commit messages.  For example we'll consider NIFI-270 as our ticket.  Also
+have in mind the release version you are planning for.  For example we'll 
consider '0.0.1-incubating'.</p>
+<p>Create the next version in JIRA if necessary so develop work can continue 
towards that release.</p>
+<p>Create new branch off develop named after the JIRA ticket or just use the 
develop branch itself.  Here we'll use a branch off of develop with
+<code>git checkout -b NIFI-270-RC1</code></p>
+<p>Change directory into that of the project you wish to release.  For example 
either <code>cd nifi</code></p>
+<p>Verify that Maven has sufficient heap space to perform the build tasks.  
Some plugins and parts of the build 
+consumes a surprisingly large amount of space.  These settings have been shown 
to 
+work <code>MAVEN_OPTS="-Xms1024m -Xmx3076m -XX:MaxPermSize=256m"</code></p>
+<p>Ensure your settings.xml has been updated as shown below.  There are other 
ways to ensure your PGP key is available for signing as well</p>
+<blockquote>
+<div class="codehilite"><pre>     ...
+     <span class="nt">&lt;profile&gt;</span>
+        <span class="nt">&lt;id&gt;</span>signed_release<span 
class="nt">&lt;/id&gt;</span>
+        <span class="nt">&lt;properties&gt;</span>
+            <span class="nt">&lt;mavenExecutorId&gt;</span>forked-path<span 
class="nt">&lt;/mavenExecutorId&gt;</span>
+            <span class="nt">&lt;gpg.keyname&gt;</span>YOUR GPG KEY ID 
HERE<span class="nt">&lt;/gpg.keyname&gt;</span>
+            <span class="nt">&lt;gpg.passphrase&gt;</span>YOUR GPG PASSPHRASE 
HERE<span class="nt">&lt;/gpg.passphrase&gt;</span>
+        <span class="nt">&lt;/properties&gt;</span>
+    <span class="nt">&lt;/profile&gt;</span>
+    ...
+    <span class="nt">&lt;servers&gt;</span>
+       <span class="nt">&lt;server&gt;</span>
+           <span class="nt">&lt;id&gt;</span>repository.apache.org<span 
class="nt">&lt;/id&gt;</span>
+           <span class="nt">&lt;username&gt;</span>YOUR USER NAME HERE<span 
class="nt">&lt;/username&gt;</span>
+           <span class="nt">&lt;password&gt;</span>YOUR MAVEN ENCRYPTED 
PASSWORD HERE<span class="nt">&lt;/password&gt;</span>
+       <span class="nt">&lt;/server&gt;</span>
+    <span class="nt">&lt;/servers&gt;</span>
+    ...
+</pre></div>
+
+
+</blockquote>
+<p>Ensure the the full application build and tests all work by executing
+<code>mvn -T 2.5C clean install</code> for a parallel build.  Once that 
completes you can
+startup and test the application by <code>cd nifi-assembly/target</code> then 
run <code>bin/nifi.sh start</code> in the nifi build.
+The application should be up and running in a few seconds at 
<code>http://localhost:8080/nifi</code></p>
+<p>Evaluate and ensure the appropriate license headers are present on all 
source files.  Ensure LICENSE and NOTICE files are complete and accurate.<br />
+Developers should always be keeping these up to date as they go along adding 
source and modifying dependencies to keep this burden manageable.<br />
+This command <code>mvn install -Pcheck-licenses</code> should be run as well 
to help validate.  If that doesn't complete cleanly it must be addressed.</p>
+<p>Now its time to have maven prepare the release so execute <code>mvn 
release:prepare -Psigned_release -DscmCommentPrefix="NIFI-270-RC1 " 
-Darguments="-DskipTests"</code>.
+Maven will ask:</p>
+<p><code>What is the release version for "Apache NiFi"? (org.apache.nifi:nifi) 
0.0.1-incubating: :</code></p>
+<p>Just hit enter to accept the default.</p>
+<p>Maven will then ask:</p>
+<p><code>What is SCM release tag or label for "Apache NiFi"? 
(org.apache.nifi:nifi) nifi-0.0.1-incubating: :</code></p>
+<p>Enter <code>nifi-0.0.1-incubating-RC1</code> or whatever the appropriate 
release candidate (RC) number is.
+Maven will then ask:</p>
+<p><code>What is the new development version for "Apache NiFi"? 
(org.apache.nifi:nifi) 0.0.2-incubating-SNAPSHOT: :</code></p>
+<p>Just hit enter to accept the default.</p>
+<p>Now that preparation went perfectly it is time to perform the release and 
deploy artifacts to staging.  To do that execute</p>
+<p><code>mvn release:perform -Psigned_release -DscmCommentPrefix="NIFI-270-RC1 
" -Darguments="-DskipTests"</code></p>
+<p>That will complete successfully and this means the artifacts have been 
released to the Apache Nexus staging repository.  You will see something 
like</p>
+<p><code>[INFO]  * Closing staging repository with ID 
"orgapachenifi-1011".</code></p>
+<p>So if you browse to 
<code>https://repository.apache.org/#stagingRepositories</code> login with your 
Apache committer credentials and you should see 
<code>orgapachenifi-1011</code>.  If you click on that you can inspect the 
various staged artifacts.</p>
+<p>Validate that all the various aspects of the staged artifacts appear 
correct</p>
+<ul>
+<li>Download the sources.  Do they compile cleanly?  If the result is a build 
does it execute?</li>
+<li>Validate the hashes match.</li>
+<li>Validate that the sources contain no unexpected binaries.</li>
+<li>Validate the signature for the build and hashes.</li>
+<li>Validate the LICENSE/NOTICE/DISCLAIMER/Headers.  </li>
+<li>Validate that the README is present and provides sufficient information to 
build and if necessary execute.</li>
+</ul>
+<p>If all looks good then push the branch to origin <code>git push origin 
NIFI-270</code></p>
+<p>If anything isn't correct about the staged artifacts you can drop the 
staged repo from repository.apache.org and delete the
+local tag in git.  If you also delete the local branch and clear your local 
maven repository under org/apache/nifi then it is
+as if the release never happened.  Before doing that though try to figure out 
what went wrong.  So as described here you see
+that you can pretty easily test the release process until you get it right.  
The <code>mvn versions:set</code> and <code>mvn versions:commit</code>
+commands can come in handy to help do this so you can set versions to 
something clearly release test related.</p>
+<p>Now it's time to initiate a vote within the PPMC.  Send the vote request to 
<code>d...@nifi.incubator.apache.org</code>
+with a subject of <code>[VOTE] Release Apache NiFi 0.0.1-incubating</code>. 
The following template can be used:</p>
+<blockquote>
+<div class="codehilite"><pre><span class="n">Hello</span>
+<span class="n">I</span> <span class="n">am</span> <span 
class="n">pleased</span> <span class="n">to</span> <span class="n">be</span> 
<span class="n">calling</span> <span class="n">this</span> <span 
class="n">vote</span> <span class="k">for</span> <span class="n">the</span> 
<span class="n">source</span> <span class="n">release</span> <span 
class="n">of</span> <span class="n">Apache</span> <span class="n">NiFi</span>
+<span class="n">nifi</span><span class="o">-</span>0<span 
class="p">.</span>0<span class="p">.</span>1<span class="o">-</span><span 
class="n">incubating</span><span class="p">.</span>
+
+<span class="n">The</span> <span class="n">source</span> <span 
class="n">zip</span><span class="p">,</span> <span class="n">including</span> 
<span class="n">signatures</span><span class="p">,</span> <span 
class="n">digests</span><span class="p">,</span> <span 
class="n">etc</span><span class="p">.</span> <span class="n">can</span> <span 
class="n">be</span> <span class="n">found</span> <span class="n">at</span><span 
class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">repository</span><span 
class="p">.</span><span class="n">apache</span><span class="p">.</span><span 
class="n">org</span><span class="o">/</span><span class="n">content</span><span 
class="o">/</span><span class="n">repositories</span><span 
class="o">/</span><span class="n">orgapachenifi</span><span 
class="o">-</span>1011
+
+<span class="n">The</span> <span class="n">Git</span> <span 
class="n">tag</span> <span class="n">is</span> <span class="n">nifi</span><span 
class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>1<span 
class="o">-</span><span class="n">incubating</span><span 
class="o">-</span><span class="n">RC1</span>
+<span class="n">The</span> <span class="n">Git</span> <span 
class="n">commit</span> <span class="n">ID</span> <span class="n">is</span> 
72<span class="n">abf18c2e045e9ef404050e2bffc9cef67d2558</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">git</span><span class="o">-</span><span 
class="n">wip</span><span class="o">-</span><span class="n">us</span><span 
class="p">.</span><span class="n">apache</span><span class="p">.</span><span 
class="n">org</span><span class="o">/</span><span class="n">repos</span><span 
class="o">/</span><span class="n">asf</span>?<span class="n">p</span><span 
class="p">=</span><span class="n">incubator</span><span class="o">-</span><span 
class="n">nifi</span><span class="p">.</span><span class="n">git</span><span 
class="p">;</span><span class="n">a</span><span class="p">=</span><span 
class="n">commit</span><span class="p">;</span><span class="n">h</span><span 
class="p">=</span>72<span 
class="n">abf18c2e045e9ef404050e2bffc9cef67d2558</span>
+
+<span class="n">Checksums</span> <span class="n">of</span> <span 
class="n">nifi</span><span class="o">-</span>0<span class="p">.</span>0<span 
class="p">.</span>1<span class="o">-</span><span 
class="n">incubating</span><span class="o">-</span><span 
class="n">source</span><span class="o">-</span><span 
class="n">release</span><span class="p">.</span><span class="n">zip</span><span 
class="p">:</span>
+<span class="n">MD5</span><span class="p">:</span> 5<span 
class="n">a580756a17b0573efa3070c70585698</span>
+<span class="n">SHA1</span><span class="p">:</span> <span 
class="n">a79ff8fd0d2f81523b675e4c69a7656160ff1214</span>
+
+<span class="n">Release</span> <span class="n">artifacts</span> <span 
class="n">are</span> <span class="n">signed</span> <span class="n">with</span> 
<span class="n">the</span> <span class="n">following</span> <span 
class="n">key</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">people</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">keys</span><span class="o">/</span><span 
class="n">committer</span><span class="o">/</span><span 
class="n">joewitt</span><span class="p">.</span><span class="n">asc</span>
+
+<span class="n">KEYS</span> <span class="n">file</span> <span 
class="n">available</span> <span class="n">here</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">dist</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">repos</span><span class="o">/</span><span 
class="n">dist</span><span class="o">/</span><span 
class="n">release</span><span class="o">/</span><span 
class="n">incubator</span><span class="o">/</span><span 
class="n">nifi</span><span class="o">/</span><span class="n">KEYS</span>
+
+8 <span class="n">issues</span> <span class="n">were</span> <span 
class="n">closed</span><span class="o">/</span><span class="n">resolved</span> 
<span class="k">for</span> <span class="n">this</span> <span 
class="n">release</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">issues</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">jira</span><span class="o">/</span><span 
class="n">secure</span><span class="o">/</span><span 
class="n">ReleaseNote</span><span class="p">.</span><span 
class="n">jspa</span>?<span class="n">projectId</span><span 
class="p">=</span>12316020<span class="o">&amp;</span><span 
class="n">version</span><span class="p">=</span>12329307
+
+<span class="n">The</span> <span class="n">vote</span> <span 
class="n">will</span> <span class="n">be</span> <span class="n">open</span> 
<span class="k">for</span> 72 <span class="n">hours</span><span 
class="p">.</span> 
+<span class="n">Please</span> <span class="n">download</span> <span 
class="n">the</span> <span class="n">release</span> <span 
class="n">candidate</span> <span class="n">and</span> <span 
class="n">evaluate</span> <span class="n">the</span> <span 
class="n">necessary</span> <span class="n">items</span> <span 
class="n">including</span> <span class="n">checking</span> <span 
class="n">hashes</span><span class="p">,</span> <span 
class="n">signatures</span><span class="p">,</span> <span 
class="n">build</span> <span class="n">from</span> <span 
class="n">source</span><span class="p">,</span> <span class="n">and</span> 
<span class="n">test</span><span class="p">.</span>  <span class="n">The</span> 
<span class="n">please</span> <span class="n">vote</span><span 
class="p">:</span>
+
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>1 
<span class="n">Release</span> <span class="n">this</span> <span 
class="n">package</span> <span class="n">as</span> <span 
class="n">nifi</span><span class="o">-</span>0<span class="p">.</span>0<span 
class="p">.</span>1<span class="o">-</span><span class="n">incubating</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>0 
<span class="n">no</span> <span class="n">opinion</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">-</span>1 
<span class="n">Do</span> <span class="n">not</span> <span 
class="n">release</span> <span class="n">this</span> <span 
class="n">package</span> <span class="n">because</span> <span 
class="n">because</span><span class="p">...</span>
+</pre></div>
+
+
+</blockquote>
+<p>A release vote is majority rule.  So wait 72 hours and see if there are at 
least 3 binding (in the PPMC sense of binding) +1 votes and no more negative 
votes than positive.
+If so forward the vote to the IPMC.  Send the vote request to 
<code>gene...@incubator.apache.org</code> with a subject of
+<code>[VOTE] Release Apache NiFi 0.0.1-incubating</code>.  The following 
template can be used:</p>
+<blockquote>
+<div class="codehilite"><pre><span class="n">Hello</span>
+
+<span class="n">The</span> <span class="n">Apache</span> <span 
class="n">NiFi</span> <span class="n">PPMC</span> <span class="n">has</span> 
<span class="n">voted</span> <span class="n">to</span> <span 
class="n">release</span> <span class="n">Apache</span> <span 
class="n">NiFi</span> 0<span class="p">.</span>0<span class="p">.</span>1<span 
class="o">-</span><span class="n">incubating</span><span class="p">.</span>
+<span class="n">The</span> <span class="n">vote</span> <span 
class="n">was</span> <span class="n">based</span> <span class="n">on</span> 
<span class="n">the</span> <span class="n">release</span> <span 
class="n">candidate</span> <span class="n">and</span> <span 
class="n">thread</span> <span class="n">described</span> <span 
class="n">below</span><span class="p">.</span>
+<span class="n">We</span> <span class="n">now</span> <span 
class="n">request</span> <span class="n">the</span> <span class="n">IPMC</span> 
<span class="n">to</span> <span class="n">vote</span> <span class="n">on</span> 
<span class="n">this</span> <span class="n">release</span><span 
class="p">.</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span 
class="n">the</span> <span class="n">PPMC</span> <span class="n">voting</span> 
<span class="n">result</span><span class="p">:</span>
+<span class="n">X</span> <span class="o">+</span>1 <span 
class="p">(</span><span class="n">binding</span><span class="p">)</span>
+<span class="n">Y</span> <span class="o">-</span>1 <span 
class="p">(</span><span class="n">binding</span><span class="p">)</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span 
class="n">the</span> <span class="n">PPMC</span> <span class="n">vote</span> 
<span class="n">thread</span><span class="p">:</span> <span 
class="p">[</span><span class="n">URL</span> <span class="n">TO</span> <span 
class="n">PPMC</span> <span class="n">Vote</span> <span 
class="n">Thread</span><span class="p">]</span>
+
+<span class="n">The</span> <span class="n">source</span> <span 
class="n">zip</span><span class="p">,</span> <span class="n">including</span> 
<span class="n">signatures</span><span class="p">,</span> <span 
class="n">digests</span><span class="p">,</span> <span 
class="n">etc</span><span class="p">.</span> <span class="n">can</span> <span 
class="n">be</span> <span class="n">found</span> <span class="n">at</span><span 
class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">repository</span><span 
class="p">.</span><span class="n">apache</span><span class="p">.</span><span 
class="n">org</span><span class="o">/</span><span class="n">content</span><span 
class="o">/</span><span class="n">repositories</span><span 
class="o">/</span><span class="n">orgapachenifi</span><span 
class="o">-</span>1011
+
+<span class="n">The</span> <span class="n">Git</span> <span 
class="n">tag</span> <span class="n">is</span> <span class="n">nifi</span><span 
class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>1<span 
class="o">-</span><span class="n">incubating</span><span 
class="o">-</span><span class="n">RC1</span>
+<span class="n">The</span> <span class="n">Git</span> <span 
class="n">commit</span> <span class="n">ID</span> <span class="n">is</span> 
72<span class="n">abf18c2e045e9ef404050e2bffc9cef67d2558</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">git</span><span class="o">-</span><span 
class="n">wip</span><span class="o">-</span><span class="n">us</span><span 
class="p">.</span><span class="n">apache</span><span class="p">.</span><span 
class="n">org</span><span class="o">/</span><span class="n">repos</span><span 
class="o">/</span><span class="n">asf</span>?<span class="n">p</span><span 
class="p">=</span><span class="n">incubator</span><span class="o">-</span><span 
class="n">nifi</span><span class="p">.</span><span class="n">git</span><span 
class="p">;</span><span class="n">a</span><span class="p">=</span><span 
class="n">commit</span><span class="p">;</span><span class="n">h</span><span 
class="p">=</span>72<span 
class="n">abf18c2e045e9ef404050e2bffc9cef67d2558</span>
+
+<span class="n">Checksums</span> <span class="n">of</span> <span 
class="n">nifi</span><span class="o">-</span>0<span class="p">.</span>0<span 
class="p">.</span>1<span class="o">-</span><span 
class="n">incubating</span><span class="o">-</span><span 
class="n">source</span><span class="o">-</span><span 
class="n">release</span><span class="p">.</span><span class="n">zip</span><span 
class="p">:</span>
+<span class="n">MD5</span><span class="p">:</span> 5<span 
class="n">a580756a17b0573efa3070c70585698</span>
+<span class="n">SHA1</span><span class="p">:</span> <span 
class="n">a79ff8fd0d2f81523b675e4c69a7656160ff1214</span>
+
+<span class="n">Release</span> <span class="n">artifacts</span> <span 
class="n">are</span> <span class="n">signed</span> <span class="n">with</span> 
<span class="n">the</span> <span class="n">following</span> <span 
class="n">key</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">people</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">keys</span><span class="o">/</span><span 
class="n">committer</span><span class="o">/</span><span 
class="n">joewitt</span><span class="p">.</span><span class="n">asc</span>
+
+<span class="n">KEYS</span> <span class="n">file</span> <span 
class="n">available</span> <span class="n">here</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">dist</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">repos</span><span class="o">/</span><span 
class="n">dist</span><span class="o">/</span><span 
class="n">release</span><span class="o">/</span><span 
class="n">incubator</span><span class="o">/</span><span 
class="n">nifi</span><span class="o">/</span><span class="n">KEYS</span>
+
+8 <span class="n">issues</span> <span class="n">were</span> <span 
class="n">closed</span><span class="o">/</span><span class="n">resolved</span> 
<span class="k">for</span> <span class="n">this</span> <span 
class="n">release</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span 
class="o">//</span><span class="n">issues</span><span class="p">.</span><span 
class="n">apache</span><span class="p">.</span><span class="n">org</span><span 
class="o">/</span><span class="n">jira</span><span class="o">/</span><span 
class="n">secure</span><span class="o">/</span><span 
class="n">ReleaseNote</span><span class="p">.</span><span 
class="n">jspa</span>?<span class="n">projectId</span><span 
class="p">=</span>12316020<span class="o">&amp;</span><span 
class="n">version</span><span class="p">=</span>12329307
+
+<span class="n">The</span> <span class="n">vote</span> <span 
class="n">will</span> <span class="n">be</span> <span class="n">open</span> 
<span class="k">for</span> 72 <span class="n">hours</span><span 
class="p">.</span> 
+<span class="n">Please</span> <span class="n">download</span> <span 
class="n">the</span> <span class="n">release</span> <span 
class="n">candidate</span> <span class="n">and</span> <span 
class="n">evaluate</span> <span class="n">the</span> <span 
class="n">necessary</span> <span class="n">items</span> <span 
class="n">including</span> <span class="n">checking</span> <span 
class="n">hashes</span><span class="p">,</span> <span 
class="n">signatures</span><span class="p">,</span> <span 
class="n">build</span> <span class="n">from</span> <span 
class="n">source</span><span class="p">,</span> <span class="n">and</span> 
<span class="n">test</span><span class="p">.</span>  <span class="n">The</span> 
<span class="n">please</span> <span class="n">vote</span><span 
class="p">:</span>
+
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>1 
<span class="n">Release</span> <span class="n">this</span> <span 
class="n">package</span> <span class="n">as</span> <span 
class="n">nifi</span><span class="o">-</span>0<span class="p">.</span>0<span 
class="p">.</span>1<span class="o">-</span><span class="n">incubating</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>0 
<span class="n">no</span> <span class="n">opinion</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">-</span>1 
<span class="n">Do</span> <span class="n">not</span> <span 
class="n">release</span> <span class="n">this</span> <span 
class="n">package</span> <span class="n">because</span> <span 
class="n">because</span><span class="p">...</span>
+</pre></div>
+
+
+</blockquote>
+<p>Wait 72 hours.  If the vote passes then send a vote result email.  Send the 
email to <code>gene...@incubator.apache.org, 
d...@nifi.incubator.apache.org</code>
+with a subject of <code>[RESULT][VOTE] Release Apache NiFi 
0.0.1-incubating</code>.  Use a template such as:</p>
+<blockquote>
+<div class="codehilite"><pre><span class="n">Hello</span>
+
+<span class="n">The</span> <span class="n">release</span> <span 
class="n">passes</span> <span class="n">with</span>
+
+<span class="n">X</span> <span class="o">+</span>1 <span 
class="p">(</span><span class="n">binding</span><span class="p">)</span> <span 
class="n">votes</span>
+<span class="n">Y</span> <span class="o">-</span>1 <span 
class="p">(</span><span class="n">binding</span><span class="p">)</span> <span 
class="n">votes</span>
+
+<span class="n">Thanks</span> <span class="n">to</span> <span 
class="n">all</span> <span class="n">who</span> <span class="n">helped</span> 
<span class="n">make</span> <span class="n">this</span> <span 
class="n">release</span> <span class="n">possible</span><span class="p">.</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span 
class="n">the</span> <span class="n">IPMC</span> <span class="n">vote</span> 
<span class="n">thread</span><span class="p">:</span> <span 
class="p">[</span><span class="n">INSERT</span> <span class="n">URL</span> 
<span class="n">OF</span> <span class="n">IPMC</span> <span 
class="n">Vote</span> <span class="n">Thread</span><span class="p">]</span>
+</pre></div>
+
+
+</blockquote>
+<p>Now all the voting is done and the release is good to go.</p>
+<p>Here are the steps of the release once the release is approved:</p>
+<ol>
+<li>
+<p>Upload source-release artifacts to dist.  If the release version is 
0.0.1-incubating then upload them (zip, asc, md5, sha1) to
+<code>https://dist.apache.org/repos/dist/release/incubator/nifi/0.0.1-incubating</code></p>
+</li>
+<li>
+<p>To produce binary convenience release build the application from the raw 
source in staging.  For each binary convenience artifact:  </p>
+<ul>
+<li>Generate ascii armored detached signature by running <code>gpg -a -b 
nifi-0.0.1-incubating-bin.tar.gz</code></li>
+<li>Generate md5 hash summary by running <code>md5sum 
nifi-0.0.1-incubating-bin.tar.gz | awk '{ printf substr($0,0,32)}' &gt;  
nifi-0.0.1-incubating-bin.tar.gz.md5</code></li>
+<li>Generate sha1 hash summary by running <code>sha1sum 
nifi-0.0.1-incubating-bin.tar.gz | awk '{ printf substr($0,0,40)}' &gt;  
nifi-0.0.1-incubating-bin.tar.gz.sha1</code></li>
+<li>Upload the bin, asc, sha1, md5 for each binary convenience build to the 
same location as the source release</li>
+</ul>
+</li>
+<li>
+<p>In repository.apache.org go to the staging repository and select 
<code>release</code> and follow instructions on the site.</p>
+</li>
+<li>
+<p>Merge the release branch into master</p>
+</li>
+<li>
+<p>Merge the release branch into develop</p>
+</li>
+<li>
+<p>Update the NiFi website to point to the new download(s)</p>
+</li>
+<li>
+<p>Update the NiFi incubator status page to indicate NEWS of the release</p>
+</li>
+<li>
+<p>In Jira mark the release version as 'Released' and 'Archived' through 
'version' management in the 'administration' console.</p>
+</li>
+</ol>
+        </div>
+      <!--</div>-->
+        <div id="footer">
+          <a alt="Apache Software Foundation" href="http://www.apache.org";>
+           <img id="asf-logo" alt="Apache Software Foundation" 
src="/images/feather-small.gif">
+          </a>
+          <a alt="Apache Incubator Logo" href="http://incubator.apache.org/";>
+           <img id="incubator-logo" alt="Apache Incubator" 
src="/images/egg-logo.png" >
+          </a>
+          <div id="copyright">
+            <p>Copyright &#169; 2014 The Apache Software Foundation, Licensed 
under the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache License, 
Version 2.0</a>.<br/>Apache, the Apache feather logo, and the Apache Incubator 
project logo are trademarks of The Apache Software Foundation.</p>
+          </div>
+        </div>
+      </div>
+
+
+  </body>
+</html>


Reply via email to