Return-Path: <commits-return-1407-archive-asf-public=cust-asf.ponee.io@giraph.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id 8AD5C200BC3
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Fri, 18 Nov 2016 20:19:26 +0100 (CET)
Received: by cust-asf.ponee.io (Postfix)
	id 89713160B04; Fri, 18 Nov 2016 19:19:26 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id ABFDB160B03
	for <archive-asf-public@cust-asf.ponee.io>; Fri, 18 Nov 2016 20:19:25 +0100 (CET)
Received: (qmail 32205 invoked by uid 500); 18 Nov 2016 19:19:24 -0000
Mailing-List: contact commits-help@giraph.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@giraph.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@giraph.apache.org>
List-Post: <mailto:commits@giraph.apache.org>
List-Id: <commits.giraph.apache.org>
Reply-To: dev@giraph.apache.org
Delivered-To: mailing list commits@giraph.apache.org
Received: (qmail 32196 invoked by uid 99); 18 Nov 2016 19:19:24 -0000
Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 18 Nov 2016 19:19:24 +0000
Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33)
	id B3163E0230; Fri, 18 Nov 2016 19:19:24 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: edunov@apache.org
To: commits@giraph.apache.org
Message-Id: <df24fde68e5d4b6db66b25eefd5b5260@git.apache.org>
X-Mailer: ASF-Git Admin Mailer
Subject: git commit: updated refs/heads/trunk to 8a40ce0
Date: Fri, 18 Nov 2016 19:19:24 +0000 (UTC)
archived-at: Fri, 18 Nov 2016 19:19:26 -0000

Repository: giraph
Updated Branches:
  refs/heads/trunk f89234214 -> 8a40ce0aa


GIRAPH-1124 - Create documentation on how to make Giraph release

Test Plan: mvn clean site

Reviewers: rvs, dionysis.logothetis

Reviewed By: dionysis.logothetis

Differential Revision: https://reviews.facebook.net/D65313


Project: http://git-wip-us.apache.org/repos/asf/giraph/repo
Commit: http://git-wip-us.apache.org/repos/asf/giraph/commit/8a40ce0a
Tree: http://git-wip-us.apache.org/repos/asf/giraph/tree/8a40ce0a
Diff: http://git-wip-us.apache.org/repos/asf/giraph/diff/8a40ce0a

Branch: refs/heads/trunk
Commit: 8a40ce0aad03838cbc3be7bf158f81e508ecde6f
Parents: f892342
Author: Sergey Edunov <edunov@fb.com>
Authored: Fri Nov 18 11:19:16 2016 -0800
Committer: Sergey Edunov <edunov@fb.com>
Committed: Fri Nov 18 11:19:16 2016 -0800

----------------------------------------------------------------------
 src/site/site.xml                  |  1 +
 src/site/xdoc/releasing_giraph.xml | 90 +++++++++++++++++++++++++++++++++
 2 files changed, 91 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/giraph/blob/8a40ce0a/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 96520c3..69b5cc9 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -101,6 +101,7 @@
     	<item name="Rexster I/O" href="rexster.html"/>
       </item>
       <item name="How to generate patches?" href="generating_patches.html" />
+      <item name="How to release giraph?" href="releasing_giraph.html" />
       <item name="How to build this site?" href="build_site.html" />
     </menu>
   </body>

http://git-wip-us.apache.org/repos/asf/giraph/blob/8a40ce0a/src/site/xdoc/releasing_giraph.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/releasing_giraph.xml b/src/site/xdoc/releasing_giraph.xml
new file mode 100644
index 0000000..ca8e349
--- /dev/null
+++ b/src/site/xdoc/releasing_giraph.xml
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+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.
+-->
+
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+  <properties>
+    <title>Generating Patches</title>
+  </properties>
+
+  <body>
+  <section name="Generating patches" id="Generatingpatches">
+    <p>Releasing new version of Apache Giraph may take 2 weeks or more. Please, plan accordingly.</p>
+    <p>Follow these steps to release new version of Apache Giraph.</p>
+    <ul>
+      <li>Check out the Giraph source from the <a href="http://git-wip-us.apache.org/repos/asf/giraph.git">git repository</a>.</li>
+      <li>Make a release branch <tt>git checkout -b release-1.2; git push origin release-1.2</tt></li>
+      <li>Once you have a release branch, setup continuous integration in Jenkins. <a href="https://builds.apache.org/job/Giraph-1.2/">See for example a setup for Giraph 1.2 release</a></li>
+      <li>Fix test cases and build errors until you have a clean build for both hadoop_1 and hadoop_2 profiles</li>
+      <li>Check JIRA tickets associated with this release and make sure you don't have any open</li>
+      <li>When you have everything ready for the release, create a tag <tt>git tag -a rel/1.2.0-RC1 -m "Preparing release 1.2.0"</tt></li>
+      <li>Do the license check: <tt>mvn apache-rat:check -Phadoop_1</tt>  and make sure you don't have any issues <tt>grep '!?????' target/rat.txt</tt>
+      </li>
+      <li>When all of above are clean, you can do the build: <tt>mvn clean install -Phadoop_1 -Prelease</tt>
+      If this command fails generating signatures <a href="http://www.apache.org/dev/release-signing.html">check this page for more information</a></li>
+      <li>You can now get the prepared binaries, source files and signatures in <tt>giraph-dist/target/</tt></li>
+      <li>To generate remaining md5 and sha1 hashes, wou can use the following set of commands:
+        <source>
+md5 -r * |grep -v asc | while read k f; do
+  echo $k > "$f.md5"
+done
+
+shasum * |grep -v asc |grep -v md5 | while read k f; do
+  echo $k > "$f.sha1"
+done
+        </source>
+      </li>
+      <li>Now you need to build release for hadoop_2. First, change version in all pom.xml files:
+          <source>
+mvn versions:set -DnewVersion=1.2.0-hadoop2
+grep -R 'version.*1.2.0' . | grep pom.xml | grep -v hadoop2
+          </source>
+      Make sure the output of the second command is empty. Modify missed pom.xml manually otherwise.
+      </li>
+      <li>Repeat steps for hadoop_2 profile:
+          <source>
+mvn apache-rat:check -Phadoop_2
+grep '!?????' target/rat.txt
+
+mvn clean install -Phadoop_2
+
+          </source>
+          Get release files from <tt>~/.m2/repository/org/apache/giraph/giraph-dist/1.2.0-hadoop2</tt> and sign them.
+
+      </li>
+      <li>Finally make files available in dist SVN:
+          <tt>svn checkout https://dist.apache.org/repos/dist/dev/giraph/</tt>
+          Make sure that the content there looks ok (try to build and run Giraph just from those tarballs).
+      </li>
+      <li>
+      Configure your .m2/settings.xml as described <a href="http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env">here</a>. And deploy released artifacts to the maven repository:
+          <source>
+mvn -Prelease -Phadoop_1 deploy
+mvn -Prelease -Phadoop_2 deploy
+          </source>
+      </li>
+
+    </ul>
+
+  </section>
+  </body>
+</document>