You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by am...@apache.org on 2015/11/25 10:48:45 UTC

svn commit: r1716343 - /jackrabbit/site/live/jcr/creating-releases.html

Author: amitj
Date: Wed Nov 25 09:48:45 2015
New Revision: 1716343

URL: http://svn.apache.org/viewvc?rev=1716343&view=rev
Log:
@trivial: Site checkin for project Apache Jackrabbit Site-1.0-SNAPSHOT

Modified:
    jackrabbit/site/live/jcr/creating-releases.html

Modified: jackrabbit/site/live/jcr/creating-releases.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/creating-releases.html?rev=1716343&r1=1716342&r2=1716343&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/creating-releases.html (original)
+++ jackrabbit/site/live/jcr/creating-releases.html Wed Nov 25 09:48:45 2015
@@ -1,651 +1,651 @@
-<!DOCTYPE html>
-<!--
- | Generated by Apache Maven Doxia at 2015-11-24 
- | Rendered using Apache Maven Fluido Skin 1.3.1
--->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20151124" />
-    <meta http-equiv="Content-Language" content="en" />
-    <title>Apache Jackrabbit - Creating Releases</title>
-    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
-    <link rel="stylesheet" href="./css/site.css" />
-    <link rel="stylesheet" href="./css/print.css" media="print" />
-
-      
-    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
-
-    
-                  </head>
-        <body class="topBarEnabled">
-          
-    
-    
-            
-    
-    
-    <a href="http://github.com/apache/jackrabbit">
-      <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
-        src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
-        alt="Fork me on GitHub">
-    </a>
-  
-                
-                    
-                
-
-    <div id="topbar" class="navbar navbar-fixed-top ">
-      <div class="navbar-inner">
-                <div class="container-fluid">
-        <a data-target=".nav-collapse" data-toggle="collapse" class="btn btn-navbar">
-          <span class="icon-bar"></span>
-          <span class="icon-bar"></span>
-          <span class="icon-bar"></span>
-        </a>
-                
-                                                                                <a class="brand" href="index.html"  title="Apache Jackrabbit">
-
-                                
-                                                                                                                    <img src="images/logos/jlogo.gif" alt="Apache Jackrabbit" />
-                
-                </a>
-                    
-                                <ul class="nav">
-                          <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="index.html"  title="Welcome">Welcome</a>
-</li>
-                  
-                      <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
-</li>
-                  
-                      <li>      <a href="articles.html"  title="Articles">Articles</a>
-</li>
-                  
-                      <li>      <a href="frequently-asked-questions.html"  title="FAQ">FAQ</a>
-</li>
-                  
-                      <li>      <a href="http://wiki.apache.org/jackrabbit/FrontPage"  title="Jackrabbit Wiki">Jackrabbit Wiki</a>
-</li>
-                  
-                      <li>      <a href="jackrabbit-history.html"  title="Jackrabbit History">Jackrabbit History</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="getting-started-with-apache-jackrabbit.html"  title="Getting Started">Getting Started</a>
-</li>
-                  
-                      <li>      <a href="standalone-server.html"  title="Standalone Server">Standalone Server</a>
-</li>
-                  
-                      <li>      <a href="jackrabbit-components.html"  title="Jackrabbit Components">Jackrabbit Components</a>
-</li>
-                  
-                      <li>      <a href="first-hops.html"  title="First Hops">First Hops</a>
-</li>
-                  
-                      <li>      <a href="jcr-api.html"  title="JCR & API">JCR & API</a>
-</li>
-                  
-                      <li>      <a href="jackrabbit-architecture.html"  title="Jackrabbit Architecture">Jackrabbit Architecture</a>
-</li>
-                  
-                      <li>      <a href="deployment-models.html"  title="Deployment Models">Deployment Models</a>
-</li>
-                  
-                      <li>      <a href="jackrabbit-configuration.html"  title="Jackrabbit Configuration">Jackrabbit Configuration</a>
-</li>
-                  
-                      <li>      <a href="node-types.html"  title="Node Types">Node Types</a>
-</li>
-                  
-                      <li>      <a href="object-content-mapping.html"  title="Object Content Mapping">Object Content Mapping</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="jackrabbit-team.html"  title="Jackrabbit Team">Jackrabbit Team</a>
-</li>
-                  
-                      <li>      <a href="jackrabbit-roadmap.html"  title="Jackrabbit Roadmap">Jackrabbit Roadmap</a>
-</li>
-                  
-                      <li>      <a href="building-jackrabbit.html"  title="Building Jackrabbit">Building Jackrabbit</a>
-</li>
-                  
-                      <li>      <a href="mailing-lists.html"  title="Mailing Lists">Mailing Lists</a>
-</li>
-                  
-                      <li>      <a href="issue-tracker.html"  title="Issue Tracker">Issue Tracker</a>
-</li>
-                  
-                      <li>      <a href="source-repository.html"  title="Source Repository">Source Repository</a>
-</li>
-                  
-                      <li>      <a href="continuous-integration.html"  title="Continuous Integration">Continuous Integration</a>
-</li>
-                  
-                      <li>      <a href="website.html"  title="Website">Website</a>
-</li>
-                  
-                      <li>      <a href="creating-releases.html"  title="Creating Releases">Creating Releases</a>
-</li>
-                  
-                      <li>      <a href="supporting-software-attribution.html"  title="Attribution">Attribution</a>
-</li>
-                  
-                      <li>      <a href="privacy-policy.html"  title="Privacy">Privacy</a>
-</li>
-                          </ul>
-      </li>
-                <li class="dropdown">
-        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
-        <ul class="dropdown-menu">
-        
-                      <li>      <a href="http://www.apache.org/foundation/how-it-works.html"  title="Introduction">Introduction</a>
-</li>
-                  
-                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Sponsorship">Sponsorship</a>
-</li>
-                  
-                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Current Sponsors">Current Sponsors</a>
-</li>
-                          </ul>
-      </li>
-                  </ul>
-          
-          
-          
-                   
-                      </div>
-          
-        </div>
-      </div>
-    </div>
-    
-        <div class="container-fluid">
-          <div id="banner">
-        <div class="pull-left">
-                                <div id="bannerLeft">
-                <h2>Apache Jackrabbit Site</h2>
-                </div>
-                      </div>
-        <div class="pull-right">  </div>
-        <div class="clear"><hr/></div>
-      </div>
-
-      <div id="breadcrumbs">
-        <ul class="breadcrumb">
-                
-                    
-                  <li id="publishDate">Last Published: 2015-11-24
-                   </li>
-                      
-                
-                    
-      
-                            </ul>
-      </div>
-
-            
-      <div class="row-fluid">
-        <div id="leftColumn" class="span3">
-          <div class="well sidebar-nav">
-                
-                    
-                <ul class="nav nav-list">
-                    <li class="nav-header">Apache Jackrabbit</li>
-                              
-      <li>
-  
-                          <a href="index.html" title="Welcome">
-          <i class="none"></i>
-        Welcome</a>
-            </li>
-                
-      <li>
-  
-                          <a href="downloads.html" title="Downloads">
-          <i class="none"></i>
-        Downloads</a>
-            </li>
-                
-      <li>
-  
-                          <a href="articles.html" title="Articles">
-          <i class="none"></i>
-        Articles</a>
-            </li>
-                
-      <li>
-  
-                          <a href="frequently-asked-questions.html" title="FAQ">
-          <i class="none"></i>
-        FAQ</a>
-            </li>
-                
-      <li>
-  
-                          <a href="http://wiki.apache.org/jackrabbit/FrontPage" class="externalLink" title="Jackrabbit Wiki">
-          <i class="none"></i>
-        Jackrabbit Wiki</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jackrabbit-history.html" title="Jackrabbit History">
-          <i class="none"></i>
-        Jackrabbit History</a>
-            </li>
-                              <li class="nav-header">Documentation</li>
-                              
-      <li>
-  
-                          <a href="getting-started-with-apache-jackrabbit.html" title="Getting Started">
-          <i class="none"></i>
-        Getting Started</a>
-            </li>
-                
-      <li>
-  
-                          <a href="standalone-server.html" title="Standalone Server">
-          <i class="none"></i>
-        Standalone Server</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jackrabbit-components.html" title="Jackrabbit Components">
-          <i class="none"></i>
-        Jackrabbit Components</a>
-            </li>
-                
-      <li>
-  
-                          <a href="first-hops.html" title="First Hops">
-          <i class="none"></i>
-        First Hops</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jcr-api.html" title="JCR & API">
-          <i class="none"></i>
-        JCR & API</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jackrabbit-architecture.html" title="Jackrabbit Architecture">
-          <i class="none"></i>
-        Jackrabbit Architecture</a>
-            </li>
-                
-      <li>
-  
-                          <a href="deployment-models.html" title="Deployment Models">
-          <i class="none"></i>
-        Deployment Models</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jackrabbit-configuration.html" title="Jackrabbit Configuration">
-          <i class="none"></i>
-        Jackrabbit Configuration</a>
-            </li>
-                
-      <li>
-  
-                          <a href="node-types.html" title="Node Types">
-          <i class="none"></i>
-        Node Types</a>
-            </li>
-                
-      <li>
-  
-                          <a href="object-content-mapping.html" title="Object Content Mapping">
-          <i class="none"></i>
-        Object Content Mapping</a>
-            </li>
-                              <li class="nav-header">Development</li>
-                              
-      <li>
-  
-                          <a href="jackrabbit-team.html" title="Jackrabbit Team">
-          <i class="none"></i>
-        Jackrabbit Team</a>
-            </li>
-                
-      <li>
-  
-                          <a href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">
-          <i class="none"></i>
-        Jackrabbit Roadmap</a>
-            </li>
-                
-      <li>
-  
-                          <a href="building-jackrabbit.html" title="Building Jackrabbit">
-          <i class="none"></i>
-        Building Jackrabbit</a>
-            </li>
-                
-      <li>
-  
-                          <a href="mailing-lists.html" title="Mailing Lists">
-          <i class="none"></i>
-        Mailing Lists</a>
-            </li>
-                
-      <li>
-  
-                          <a href="issue-tracker.html" title="Issue Tracker">
-          <i class="none"></i>
-        Issue Tracker</a>
-            </li>
-                
-      <li>
-  
-                          <a href="source-repository.html" title="Source Repository">
-          <i class="none"></i>
-        Source Repository</a>
-            </li>
-                
-      <li>
-  
-                          <a href="continuous-integration.html" title="Continuous Integration">
-          <i class="none"></i>
-        Continuous Integration</a>
-            </li>
-                
-      <li>
-  
-                          <a href="website.html" title="Website">
-          <i class="none"></i>
-        Website</a>
-            </li>
-                
-      <li class="active">
-  
-            <a href="#"><i class="none"></i>Creating Releases</a>
-          </li>
-                
-      <li>
-  
-                          <a href="supporting-software-attribution.html" title="Attribution">
-          <i class="none"></i>
-        Attribution</a>
-            </li>
-                
-      <li>
-  
-                          <a href="privacy-policy.html" title="Privacy">
-          <i class="none"></i>
-        Privacy</a>
-            </li>
-                              <li class="nav-header">Apache Software Foundation</li>
-                              
-      <li>
-  
-                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction">
-          <i class="none"></i>
-        Introduction</a>
-            </li>
-                
-      <li>
-  
-                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
-          <i class="none"></i>
-        Sponsorship</a>
-            </li>
-                
-      <li>
-  
-                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors">
-          <i class="none"></i>
-        Current Sponsors</a>
-            </li>
-            </ul>
-                
-                    
-                
-          <hr />
-
-           <div id="poweredBy">
-                   
-    <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
-
-    
-    <div class="g-plusone" data-href="http://www.apache.org/jackrabbit-site/" data-size="tall" ></div>
-
-                   <div class="clear"></div>
-                            <div class="clear"></div>
-                            <div class="clear"></div>
-                            <div class="clear"></div>
-                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
-        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
-      </a>
-                  </div>
-          </div>
-        </div>
-        
-                
-        <div id="bodyColumn"  class="span9" >
-                                  
-            <!-- 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. --><h1>Creating Releases</h1>
-<p>This is a how to document for creating Apache Jackrabbit releases. It documents the current release process and needs to be updated as we move forward.</p>
-<div class="section">
-<h2>Release planning<a name="Release_planning"></a></h2>
-<p>Jackrabbit releases are created based on user demand and the availability of fixes and other requested changes. Any committer can declare their plan to cut a release by sending a &#x201c;Apache Jackrabbit x.y.z release plan&#x201d; message to the dev@ list. The plan should refer to Jira for the list of fixes to be included in the release and give a rough estimate of the release schedule. It&#x2019;s OK to revise the plan if needed.</p>
-<p>If you&#x2019;re not a committer, you can send a message to the mailing list asking for a new release to be made. Including the list of specific fixes you need and a short rationale of why you need the release.</p></div>
-<div class="section">
-<h2>Prerequisites for release managers<a name="Prerequisites_for_release_managers"></a></h2>
-<p>You need to be a Jackrabbit committer to prepare and perform a release, but anyone is welcome to help test the release candidates and comment on the release plans.</p>
-<p>You should have a code signing key that is included in the Jackrabbit KEYS file. See Appendix A at the end of this page for more details.</p>
-<p>You also need to tell Maven your Subversion credentials needed for deploying artifacts to the Nexus server at <a class="externalLink" href="https://repository.apache.org/">https://repository.apache.org/</a>. See Appendix B for the required settings.</p></div>
-<div class="section">
-<h2>Release management tasks<a name="Release_management_tasks"></a></h2>
-
-<ol style="list-style-type: decimal">
-  
-<li>Make sure that an appropriate version for the release is entered in Jira and that all the related issues have been resolved. This is also a good time to create a new version in JIRA for the next release.</li>
-  
-<li>Create a <tt>RELEASE-NOTES.txt</tt> file in the root folder of the project to be released. If such a file already exists, update it for the release. See a previous release notes for examples of what to include. The release note report in Jira is a useful source of required information: Open the <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK">Jira Oak</a> page, click on the release, then on the &#x201c;Release Notes&#x201d; button on the top right. When done, commit the file.</li>
-  
-<li>Build and deploy the release artifacts with Maven. See below for the exact steps.</li>
-  
-<li>Close the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> on repository.apache.org.</li>
-  
-<li>
-<p>Upload the artifacts to <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/jackrabbit/">https://dist.apache.org/repos/dist/dev/jackrabbit/</a> (instructions at the end of the build)</p>
-  
-<div class="source">
-<pre>cd /path/to/jackrabbit-dev
-scp -r /path/to/jackrabbit/target/checkout/target/$version $version
-svn add $version
-svn commit -m &quot;Apache Jackrabbit $version release candidate&quot; $version
-</pre></div></li>
-  
-<li>
-<p>Start the vote thread, wait 72 hours. See the vote template generated by the Maven build.</p></li>
-  
-<li>If the vote fails (easy case first) remove the tag from svn and drop the staged repository - done</li>
-  
-<li>
-<p>If the vote is successful</p>
-  
-<ol style="list-style-type: decimal">
-    
-<li>close the vote by publishing the results</li>
-    
-<li>copy the release candidate from dev/jackrabbit to release/jackrabbit in <a class="externalLink" href="https://dist.apache.org/repos/dist/">https://dist.apache.org/repos/dist/</a>, and delete any older releases from the same branch (they&#x2019;re automatically archived),</li>
-  </ol>
-  
-<div class="source">
-<pre>svn move -m &quot;Apache Jackrabbit $version&quot; \
-https://dist.apache.org/repos/dist/dev/jackrabbit/$version \
-https://dist.apache.org/repos/dist/release/jackrabbit/$version
-</pre></div>
-  
-<ol style="list-style-type: decimal">
-    
-<li>release the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> for synchronization to Maven central.</li>
-    
-<li>mark the version as released in Jira: <a class="externalLink" href="https://issues.apache.org/jira/browse/JCR">Jira Project Home</a> -&gt; Project Summary -&gt; Administer Project. Under Versions, click &lt;More&gt;. You&#x2019;ll see all the defined project versions. From the settings menu, choose &#x2018;Release&#x2019; on the version.</li>
-    
-<li>close all the issues included in the release: Jira Project Home -&gt; Change Log -&gt; Choose the released version. From the issue list you have the option to bulk update all of the included issues. Just &#x2018;Transition Issues&#x2019; from &#x2018;Resolved&#x2019; to &#x2018;Closed&#x2019; and you are done!</li>
-  </ol></li>
-  
-<li>
-<p>Update the Jackrabbit web site to point to the new release.</p>
-  
-<ol style="list-style-type: decimal">
-    
-<li>index.md</li>
-    
-<li>downloads.md</li>
-  </ol></li>
-  
-<li>Send the release announcement once the web site and download mirrors have been synced. Please note the announce mails needs to be sent from an @apache.org address.</li>
-</ol></div>
-<div class="section">
-<h2>Steps to build the release artifacts<a name="Steps_to_build_the_release_artifacts"></a></h2>
-<p>The release is built using the Maven release plugin. See the <a class="externalLink" href="http://maven.apache.org/developers/release/releasing.html">Releasing a Maven project</a> guide for more details. Make sure you have added the pgp key information in you maven settings file, especially if you have more than one key installed locally. See <a href="#b">Appendix B</a> for the details.</p>
-<p>In case you don&#x2019;t feel comfortable to keep the passwords in the file <tt>~/.m2/settings.xml</tt> forever, you need to set it now temporarily.</p>
-<p>There have been some problems with certain combinations of Java and Maven versions. A known combinations where releasing was successful is Java 7 with Maven 3.2.2. In case you get an exception &#x201c;Proxy Error&#x201d; in the <tt>release:perform</tt>, see the <a class="externalLink" href="http://status.apache.org/">Apache Services Status Page</a>, however it has been reported that the status page is not always accurate.</p>
-
-<ol style="list-style-type: decimal">
-  
-<li>Execute mvn <tt>release:prepare</tt>. This will update the POM files and tag the release in svn.</li>
-  
-<li>Execute mvn <tt>release:perform</tt>. This will build the tagged release and deploy the artifacts to a staging repository on repository.apache.org. The non-Maven release artifacts are automatically deployed to your home directory on people.apache.org. You only need to add the keyname if you have multiple keys and the code signing keys is not your default key.</li>
-</ol>
-<p>After this is done, you can remove the passwords from the file <tt>~/.m2/settings.xml</tt> if you don&#x2019;t want to keep it there.</p></div>
-<div class="section">
-<h2>Related Links<a name="Related_Links"></a></h2>
-
-<ul>
-  
-<li><a class="externalLink" href="http://www.apache.org/dev/release.html">http://www.apache.org/dev/release.html</a></li>
-  
-<li><a class="externalLink" href="http://www.apache.org/dev/release-signing.html">http://www.apache.org/dev/release-signing.html</a></li>
-  
-<li><a class="externalLink" href="http://wiki.apache.org/incubator/SigningReleases">http://wiki.apache.org/incubator/SigningReleases</a></li>
-  
-<li><a class="externalLink" href="http://www.apache.org/dev/repository-faq.html">http://www.apache.org/dev/repository-faq.html</a></li>
-</ul></div>
-<div class="section">
-<h2>Appendix A: Create and add your key to the Jackrabbit KEYS file<a name="Appendix_A:_Create_and_add_your_key_to_the_Jackrabbit_KEYS_file"></a></h2>
-<p>Follow these instructions to generate your code signing key and to add it to the Jackrabbit KEYS file.</p>
-
-<ol style="list-style-type: decimal">
-  
-<li><a class="externalLink" href="http://www.apache.org/dev/release-signing.html#generate">Generate a code signing key</a> using your @apache.org address as the email and &#x201c;CODE SIGNING KEY&#x201d; as the comment.</li>
-  
-<li>
-<p>The Jackrabbit KEYS file is managed in <a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS">https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS</a>. To modify the file, first checkout the dist directory:</p>
-  
-<div class="source">
-<pre>svn checkout https://svn.apache.org/repos/asf/jackrabbit/dist
-</pre></div></li>
-  
-<li>
-<p>See <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#keys-policy">instructions on how to append your key to the file</a> (or, as an alternative, the beginning of the KEYS file).</p></li>
-  
-<li>
-<p>Commit the change using:</p>
-  
-<div class="source">
-<pre>svn commit -m &quot;Add code signing key&quot; KEYS
-</pre></div></li>
-  
-<li>
-<p>See the changes on <a class="externalLink" href="http://www.apache.org/dist/jackrabbit/KEYS">http://www.apache.org/dist/jackrabbit/KEYS</a> (you may need to wait a few minutes).</p></li>
-</ol>
-<p>You can (but don&#x2019;t need to) get your key <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#apache-wot">linked to the Apache web of trust</a>. Once other people have signed your key, you can update the KEYS file with the signatures you&#x2019;ve received.</p></div>
-<div class="section">
-<h2>Appendix B: Maven settings<a name="Appendix_B:_Maven_settings"></a></h2>
-<p>You need to change the <tt>~/.m2/settings.xml</tt> file as follows. PGP key id: this is the second part of your key in the KEYS file. For example, this is &#x201c;F07CA77B&#x201d; if the first line of your key in the KEYS file is &#x201c;pub 4096R/F07CA77B 2014-07-31&#x201d;. In case you are not comfortable to keep passwords and key passphrases in human readable files, you can add them just before doing the release, and remove them just after the release. Instead of using the &#x201c;gpg.passphrase&#x201d; tag, you can try using <tt>&lt;gpg.executable&gt;gpg2&lt;/gpg.executable&gt;</tt> (this should prompt you for the passphrase). For the server svn passwords, you could use the <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-encryption.html">Maven password encryption</a>.</p>
-
-<div class="source">
-<pre>&lt;settings&gt;
-  &lt;profiles&gt;
-    &lt;profile&gt;
-      &lt;id&gt;apache-release&lt;/id&gt;
-      &lt;properties&gt;
-        &lt;gpg.keyname&gt;&lt;!-- PGP key id, see above --&gt;&lt;/gpg.keyname&gt;
-        &lt;gpg.passphrase&gt;&lt;!-- PGP key passphrase --&gt;&lt;/gpg.passphrase&gt;
-      &lt;/properties&gt;
-    &lt;/profile&gt;
-    ...
-  &lt;/profiles&gt;
-  &lt;servers&gt;
-    &lt;!-- To deploy a Jackrabbit snapshot --&gt;
-    &lt;server&gt;
-      &lt;id&gt;apache.snapshots.https&lt;/id&gt;
-      &lt;username&gt;&lt;!-- Apache svn user name --&gt;&lt;/username&gt;
-      &lt;password&gt;&lt;!-- Apache svn password --&gt;&lt;/password&gt;
-    &lt;/server&gt;
-    &lt;!-- To stage a Jackrabbit release --&gt;
-    &lt;server&gt;
-      &lt;id&gt;apache.releases.https&lt;/id&gt;
-      &lt;username&gt;&lt;!-- Apache svn user name --&gt;&lt;/username&gt;
-      &lt;password&gt;&lt;!-- Apache svn password --&gt;&lt;/password&gt;
-    &lt;/server&gt;
-    ...
-  &lt;/servers&gt;
-&lt;/settings&gt;
-</pre></div></div>
-                  </div>
-            </div>
-          </div>
-
-    <hr/>
-
-    <footer>
-            <div class="container-fluid">
-                      <div class="row-fluid">
-                              <p >Copyright &copy;                    2015
-                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
-            All rights reserved.      
-                    
-      </p>
-        </div>
-
-        
-        
-          
-    
-    
-    <div id="ohloh" class="pull-right">
-      <script type="text/javascript" src="http://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
-    </div>
-        </div>
-    </footer>
-        </body>
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2015-11-25 
+ | Rendered using Apache Maven Fluido Skin 1.3.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20151125" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Jackrabbit - Creating Releases</title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
+
+    
+                  </head>
+        <body class="topBarEnabled">
+          
+    
+    
+            
+    
+    
+    <a href="http://github.com/apache/jackrabbit">
+      <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
+        src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
+        alt="Fork me on GitHub">
+    </a>
+  
+                
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top ">
+      <div class="navbar-inner">
+                <div class="container-fluid">
+        <a data-target=".nav-collapse" data-toggle="collapse" class="btn btn-navbar">
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </a>
+                
+                                                                                <a class="brand" href="index.html"  title="Apache Jackrabbit">
+
+                                
+                                                                                                                    <img src="images/logos/jlogo.gif" alt="Apache Jackrabbit" />
+                
+                </a>
+                    
+                                <ul class="nav">
+                          <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Jackrabbit <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="index.html"  title="Welcome">Welcome</a>
+</li>
+                  
+                      <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
+</li>
+                  
+                      <li>      <a href="articles.html"  title="Articles">Articles</a>
+</li>
+                  
+                      <li>      <a href="frequently-asked-questions.html"  title="FAQ">FAQ</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/jackrabbit/FrontPage"  title="Jackrabbit Wiki">Jackrabbit Wiki</a>
+</li>
+                  
+                      <li>      <a href="jackrabbit-history.html"  title="Jackrabbit History">Jackrabbit History</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="getting-started-with-apache-jackrabbit.html"  title="Getting Started">Getting Started</a>
+</li>
+                  
+                      <li>      <a href="standalone-server.html"  title="Standalone Server">Standalone Server</a>
+</li>
+                  
+                      <li>      <a href="jackrabbit-components.html"  title="Jackrabbit Components">Jackrabbit Components</a>
+</li>
+                  
+                      <li>      <a href="first-hops.html"  title="First Hops">First Hops</a>
+</li>
+                  
+                      <li>      <a href="jcr-api.html"  title="JCR & API">JCR & API</a>
+</li>
+                  
+                      <li>      <a href="jackrabbit-architecture.html"  title="Jackrabbit Architecture">Jackrabbit Architecture</a>
+</li>
+                  
+                      <li>      <a href="deployment-models.html"  title="Deployment Models">Deployment Models</a>
+</li>
+                  
+                      <li>      <a href="jackrabbit-configuration.html"  title="Jackrabbit Configuration">Jackrabbit Configuration</a>
+</li>
+                  
+                      <li>      <a href="node-types.html"  title="Node Types">Node Types</a>
+</li>
+                  
+                      <li>      <a href="object-content-mapping.html"  title="Object Content Mapping">Object Content Mapping</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="jackrabbit-team.html"  title="Jackrabbit Team">Jackrabbit Team</a>
+</li>
+                  
+                      <li>      <a href="jackrabbit-roadmap.html"  title="Jackrabbit Roadmap">Jackrabbit Roadmap</a>
+</li>
+                  
+                      <li>      <a href="building-jackrabbit.html"  title="Building Jackrabbit">Building Jackrabbit</a>
+</li>
+                  
+                      <li>      <a href="mailing-lists.html"  title="Mailing Lists">Mailing Lists</a>
+</li>
+                  
+                      <li>      <a href="issue-tracker.html"  title="Issue Tracker">Issue Tracker</a>
+</li>
+                  
+                      <li>      <a href="source-repository.html"  title="Source Repository">Source Repository</a>
+</li>
+                  
+                      <li>      <a href="continuous-integration.html"  title="Continuous Integration">Continuous Integration</a>
+</li>
+                  
+                      <li>      <a href="website.html"  title="Website">Website</a>
+</li>
+                  
+                      <li>      <a href="creating-releases.html"  title="Creating Releases">Creating Releases</a>
+</li>
+                  
+                      <li>      <a href="supporting-software-attribution.html"  title="Attribution">Attribution</a>
+</li>
+                  
+                      <li>      <a href="privacy-policy.html"  title="Privacy">Privacy</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache Software Foundation <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org/foundation/how-it-works.html"  title="Introduction">Introduction</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"  title="Sponsorship">Sponsorship</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"  title="Current Sponsors">Current Sponsors</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+          
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                <div id="bannerLeft">
+                <h2>Apache Jackrabbit Site</h2>
+                </div>
+                      </div>
+        <div class="pull-right">  </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                    
+                  <li id="publishDate">Last Published: 2015-11-25
+                   </li>
+                      
+                
+                    
+      
+                            </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+                    
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Jackrabbit</li>
+                              
+      <li>
+  
+                          <a href="index.html" title="Welcome">
+          <i class="none"></i>
+        Welcome</a>
+            </li>
+                
+      <li>
+  
+                          <a href="downloads.html" title="Downloads">
+          <i class="none"></i>
+        Downloads</a>
+            </li>
+                
+      <li>
+  
+                          <a href="articles.html" title="Articles">
+          <i class="none"></i>
+        Articles</a>
+            </li>
+                
+      <li>
+  
+                          <a href="frequently-asked-questions.html" title="FAQ">
+          <i class="none"></i>
+        FAQ</a>
+            </li>
+                
+      <li>
+  
+                          <a href="http://wiki.apache.org/jackrabbit/FrontPage" class="externalLink" title="Jackrabbit Wiki">
+          <i class="none"></i>
+        Jackrabbit Wiki</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jackrabbit-history.html" title="Jackrabbit History">
+          <i class="none"></i>
+        Jackrabbit History</a>
+            </li>
+                              <li class="nav-header">Documentation</li>
+                              
+      <li>
+  
+                          <a href="getting-started-with-apache-jackrabbit.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                
+      <li>
+  
+                          <a href="standalone-server.html" title="Standalone Server">
+          <i class="none"></i>
+        Standalone Server</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jackrabbit-components.html" title="Jackrabbit Components">
+          <i class="none"></i>
+        Jackrabbit Components</a>
+            </li>
+                
+      <li>
+  
+                          <a href="first-hops.html" title="First Hops">
+          <i class="none"></i>
+        First Hops</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jcr-api.html" title="JCR & API">
+          <i class="none"></i>
+        JCR & API</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jackrabbit-architecture.html" title="Jackrabbit Architecture">
+          <i class="none"></i>
+        Jackrabbit Architecture</a>
+            </li>
+                
+      <li>
+  
+                          <a href="deployment-models.html" title="Deployment Models">
+          <i class="none"></i>
+        Deployment Models</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jackrabbit-configuration.html" title="Jackrabbit Configuration">
+          <i class="none"></i>
+        Jackrabbit Configuration</a>
+            </li>
+                
+      <li>
+  
+                          <a href="node-types.html" title="Node Types">
+          <i class="none"></i>
+        Node Types</a>
+            </li>
+                
+      <li>
+  
+                          <a href="object-content-mapping.html" title="Object Content Mapping">
+          <i class="none"></i>
+        Object Content Mapping</a>
+            </li>
+                              <li class="nav-header">Development</li>
+                              
+      <li>
+  
+                          <a href="jackrabbit-team.html" title="Jackrabbit Team">
+          <i class="none"></i>
+        Jackrabbit Team</a>
+            </li>
+                
+      <li>
+  
+                          <a href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">
+          <i class="none"></i>
+        Jackrabbit Roadmap</a>
+            </li>
+                
+      <li>
+  
+                          <a href="building-jackrabbit.html" title="Building Jackrabbit">
+          <i class="none"></i>
+        Building Jackrabbit</a>
+            </li>
+                
+      <li>
+  
+                          <a href="mailing-lists.html" title="Mailing Lists">
+          <i class="none"></i>
+        Mailing Lists</a>
+            </li>
+                
+      <li>
+  
+                          <a href="issue-tracker.html" title="Issue Tracker">
+          <i class="none"></i>
+        Issue Tracker</a>
+            </li>
+                
+      <li>
+  
+                          <a href="source-repository.html" title="Source Repository">
+          <i class="none"></i>
+        Source Repository</a>
+            </li>
+                
+      <li>
+  
+                          <a href="continuous-integration.html" title="Continuous Integration">
+          <i class="none"></i>
+        Continuous Integration</a>
+            </li>
+                
+      <li>
+  
+                          <a href="website.html" title="Website">
+          <i class="none"></i>
+        Website</a>
+            </li>
+                
+      <li class="active">
+  
+            <a href="#"><i class="none"></i>Creating Releases</a>
+          </li>
+                
+      <li>
+  
+                          <a href="supporting-software-attribution.html" title="Attribution">
+          <i class="none"></i>
+        Attribution</a>
+            </li>
+                
+      <li>
+  
+                          <a href="privacy-policy.html" title="Privacy">
+          <i class="none"></i>
+        Privacy</a>
+            </li>
+                              <li class="nav-header">Apache Software Foundation</li>
+                              
+      <li>
+  
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="Introduction">
+          <i class="none"></i>
+        Introduction</a>
+            </li>
+                
+      <li>
+  
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                
+      <li>
+  
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Current Sponsors">
+          <i class="none"></i>
+        Current Sponsors</a>
+            </li>
+            </ul>
+                
+                    
+                
+          <hr />
+
+           <div id="poweredBy">
+                   
+    <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
+
+    
+    <div class="g-plusone" data-href="http://www.apache.org/jackrabbit-site/" data-size="tall" ></div>
+
+                   <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <!-- 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. --><h1>Creating Releases</h1>
+<p>This is a how to document for creating Apache Jackrabbit releases. It documents the current release process and needs to be updated as we move forward.</p>
+<div class="section">
+<h2>Release planning<a name="Release_planning"></a></h2>
+<p>Jackrabbit releases are created based on user demand and the availability of fixes and other requested changes. Any committer can declare their plan to cut a release by sending a &#x201c;Apache Jackrabbit x.y.z release plan&#x201d; message to the dev@ list. The plan should refer to Jira for the list of fixes to be included in the release and give a rough estimate of the release schedule. It&#x2019;s OK to revise the plan if needed.</p>
+<p>If you&#x2019;re not a committer, you can send a message to the mailing list asking for a new release to be made. Including the list of specific fixes you need and a short rationale of why you need the release.</p></div>
+<div class="section">
+<h2>Prerequisites for release managers<a name="Prerequisites_for_release_managers"></a></h2>
+<p>You need to be a Jackrabbit committer to prepare and perform a release, but anyone is welcome to help test the release candidates and comment on the release plans.</p>
+<p>You should have a code signing key that is included in the Jackrabbit KEYS file. See Appendix A at the end of this page for more details.</p>
+<p>You also need to tell Maven your Subversion credentials needed for deploying artifacts to the Nexus server at <a class="externalLink" href="https://repository.apache.org/">https://repository.apache.org/</a>. See Appendix B for the required settings.</p></div>
+<div class="section">
+<h2>Release management tasks<a name="Release_management_tasks"></a></h2>
+
+<ol style="list-style-type: decimal">
+  
+<li>Make sure that an appropriate version for the release is entered in Jira and that all the related issues have been resolved. This is also a good time to create a new version in JIRA for the next release.</li>
+  
+<li>Create a <tt>RELEASE-NOTES.txt</tt> file in the root folder of the project to be released. If such a file already exists, update it for the release. See a previous release notes for examples of what to include. The release note report in Jira is a useful source of required information: Open the <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK">Jira Oak</a> page, click on the release, then on the &#x201c;Release Notes&#x201d; button on the top right. When done, commit the file.</li>
+  
+<li>Build and deploy the release artifacts with Maven. See below for the exact steps.</li>
+  
+<li>Close the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> on repository.apache.org.</li>
+  
+<li>
+<p>Upload the artifacts to <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/jackrabbit/">https://dist.apache.org/repos/dist/dev/jackrabbit/</a> (instructions at the end of the build)</p>
+  
+<div class="source">
+<pre>cd /path/to/jackrabbit-dev
+scp -r /path/to/jackrabbit/target/checkout/target/$version $version
+svn add $version
+svn commit -m &quot;Apache Jackrabbit $version release candidate&quot; $version
+</pre></div></li>
+  
+<li>
+<p>Start the vote thread, wait 72 hours. See the vote template generated by the Maven build.</p></li>
+  
+<li>Mark the version as released in Jira: <a class="externalLink" href="https://issues.apache.org/jira/browse/JCR">Jira Project Home</a> -&gt; Project Summary -&gt; Administer Project. Under Versions, click &lt;More&gt;. You&#x2019;ll see all the defined project versions. From the settings menu, choose &#x2018;Release&#x2019; on the version.</li>
+  
+<li>If the vote fails (easy case first) remove the tag from svn, drop the staged repository and revert the version release in Jira- done</li>
+  
+<li>
+<p>If the vote is successful</p>
+  
+<ul>
+    
+<li>close the vote by publishing the results</li>
+    
+<li>copy the release candidate from dev/jackrabbit to release/jackrabbit in <a class="externalLink" href="https://dist.apache.org/repos/dist/">https://dist.apache.org/repos/dist/</a>, and delete any older releases from the same branch (they&#x2019;re automatically archived),</li>
+  </ul>
+  
+<div class="source">
+<pre>svn move -m &quot;Apache Jackrabbit $version&quot; \
+https://dist.apache.org/repos/dist/dev/jackrabbit/$version \
+https://dist.apache.org/repos/dist/release/jackrabbit/$version
+</pre></div>
+  
+<ul>
+    
+<li>release the <a class="externalLink" href="https://repository.apache.org/index.html#stagingRepositories">staged repository</a> for synchronization to Maven central.</li>
+    
+<li>close all the issues included in the release: Jira Project Home -&gt; Change Log -&gt; Choose the released version. From the issue list you have the option to bulk update all of the included issues. Just &#x2018;Transition Issues&#x2019; from &#x2018;Resolved&#x2019; to &#x2018;Closed&#x2019; and you are done!</li>
+  </ul></li>
+  
+<li>
+<p>Update the Jackrabbit web site to point to the new release.</p>
+  
+<ol style="list-style-type: decimal">
+    
+<li>index.md</li>
+    
+<li>downloads.md</li>
+  </ol></li>
+  
+<li>Send the release announcement once the web site and download mirrors have been synced. Please note the announce mails needs to be sent from an @apache.org address.</li>
+</ol></div>
+<div class="section">
+<h2>Steps to build the release artifacts<a name="Steps_to_build_the_release_artifacts"></a></h2>
+<p>The release is built using the Maven release plugin. See the <a class="externalLink" href="http://maven.apache.org/developers/release/releasing.html">Releasing a Maven project</a> guide for more details. Make sure you have added the pgp key information in you maven settings file, especially if you have more than one key installed locally. See <a href="#b">Appendix B</a> for the details.</p>
+<p>In case you don&#x2019;t feel comfortable to keep the passwords in the file <tt>~/.m2/settings.xml</tt> forever, you need to set it now temporarily.</p>
+<p>There have been some problems with certain combinations of Java and Maven versions. A known combinations where releasing was successful is Java 7 with Maven 3.2.2. In case you get an exception &#x201c;Proxy Error&#x201d; in the <tt>release:perform</tt>, see the <a class="externalLink" href="http://status.apache.org/">Apache Services Status Page</a>, however it has been reported that the status page is not always accurate.</p>
+
+<ol style="list-style-type: decimal">
+  
+<li>Execute mvn <tt>release:prepare</tt>. This will update the POM files and tag the release in svn.</li>
+  
+<li>Execute mvn <tt>release:perform</tt>. This will build the tagged release and deploy the artifacts to a staging repository on repository.apache.org. The non-Maven release artifacts are automatically deployed to your home directory on people.apache.org. You only need to add the keyname if you have multiple keys and the code signing keys is not your default key.</li>
+</ol>
+<p>After this is done, you can remove the passwords from the file <tt>~/.m2/settings.xml</tt> if you don&#x2019;t want to keep it there.</p></div>
+<div class="section">
+<h2>Related Links<a name="Related_Links"></a></h2>
+
+<ul>
+  
+<li><a class="externalLink" href="http://www.apache.org/dev/release.html">http://www.apache.org/dev/release.html</a></li>
+  
+<li><a class="externalLink" href="http://www.apache.org/dev/release-signing.html">http://www.apache.org/dev/release-signing.html</a></li>
+  
+<li><a class="externalLink" href="http://wiki.apache.org/incubator/SigningReleases">http://wiki.apache.org/incubator/SigningReleases</a></li>
+  
+<li><a class="externalLink" href="http://www.apache.org/dev/repository-faq.html">http://www.apache.org/dev/repository-faq.html</a></li>
+</ul></div>
+<div class="section">
+<h2>Appendix A: Create and add your key to the Jackrabbit KEYS file<a name="Appendix_A:_Create_and_add_your_key_to_the_Jackrabbit_KEYS_file"></a></h2>
+<p>Follow these instructions to generate your code signing key and to add it to the Jackrabbit KEYS file.</p>
+
+<ol style="list-style-type: decimal">
+  
+<li><a class="externalLink" href="http://www.apache.org/dev/release-signing.html#generate">Generate a code signing key</a> using your @apache.org address as the email and &#x201c;CODE SIGNING KEY&#x201d; as the comment.</li>
+  
+<li>
+<p>The Jackrabbit KEYS file is managed in <a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS">https://svn.apache.org/repos/asf/jackrabbit/dist/KEYS</a>. To modify the file, first checkout the dist directory:</p>
+  
+<div class="source">
+<pre>svn checkout https://svn.apache.org/repos/asf/jackrabbit/dist
+</pre></div></li>
+  
+<li>
+<p>See <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#keys-policy">instructions on how to append your key to the file</a> (or, as an alternative, the beginning of the KEYS file).</p></li>
+  
+<li>
+<p>Commit the change using:</p>
+  
+<div class="source">
+<pre>svn commit -m &quot;Add code signing key&quot; KEYS
+</pre></div></li>
+  
+<li>
+<p>See the changes on <a class="externalLink" href="http://www.apache.org/dist/jackrabbit/KEYS">http://www.apache.org/dist/jackrabbit/KEYS</a> (you may need to wait a few minutes).</p></li>
+</ol>
+<p>You can (but don&#x2019;t need to) get your key <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#apache-wot">linked to the Apache web of trust</a>. Once other people have signed your key, you can update the KEYS file with the signatures you&#x2019;ve received.</p></div>
+<div class="section">
+<h2>Appendix B: Maven settings<a name="Appendix_B:_Maven_settings"></a></h2>
+<p>You need to change the <tt>~/.m2/settings.xml</tt> file as follows. PGP key id: this is the second part of your key in the KEYS file. For example, this is &#x201c;F07CA77B&#x201d; if the first line of your key in the KEYS file is &#x201c;pub 4096R/F07CA77B 2014-07-31&#x201d;. In case you are not comfortable to keep passwords and key passphrases in human readable files, you can add them just before doing the release, and remove them just after the release. Instead of using the &#x201c;gpg.passphrase&#x201d; tag, you can try using <tt>&lt;gpg.executable&gt;gpg2&lt;/gpg.executable&gt;</tt> (this should prompt you for the passphrase). For the server svn passwords, you could use the <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-encryption.html">Maven password encryption</a>.</p>
+
+<div class="source">
+<pre>&lt;settings&gt;
+  &lt;profiles&gt;
+    &lt;profile&gt;
+      &lt;id&gt;apache-release&lt;/id&gt;
+      &lt;properties&gt;
+        &lt;gpg.keyname&gt;&lt;!-- PGP key id, see above --&gt;&lt;/gpg.keyname&gt;
+        &lt;gpg.passphrase&gt;&lt;!-- PGP key passphrase --&gt;&lt;/gpg.passphrase&gt;
+      &lt;/properties&gt;
+    &lt;/profile&gt;
+    ...
+  &lt;/profiles&gt;
+  &lt;servers&gt;
+    &lt;!-- To deploy a Jackrabbit snapshot --&gt;
+    &lt;server&gt;
+      &lt;id&gt;apache.snapshots.https&lt;/id&gt;
+      &lt;username&gt;&lt;!-- Apache svn user name --&gt;&lt;/username&gt;
+      &lt;password&gt;&lt;!-- Apache svn password --&gt;&lt;/password&gt;
+    &lt;/server&gt;
+    &lt;!-- To stage a Jackrabbit release --&gt;
+    &lt;server&gt;
+      &lt;id&gt;apache.releases.https&lt;/id&gt;
+      &lt;username&gt;&lt;!-- Apache svn user name --&gt;&lt;/username&gt;
+      &lt;password&gt;&lt;!-- Apache svn password --&gt;&lt;/password&gt;
+    &lt;/server&gt;
+    ...
+  &lt;/servers&gt;
+&lt;/settings&gt;
+</pre></div></div>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+                      <div class="row-fluid">
+                              <p >Copyright &copy;                    2015
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All rights reserved.      
+                    
+      </p>
+        </div>
+
+        
+        
+          
+    
+    
+    <div id="ohloh" class="pull-right">
+      <script type="text/javascript" src="http://www.ohloh.net/p/jackrabbit/widgets/project_users_logo.js"></script>
+    </div>
+        </div>
+    </footer>
+        </body>
 </html>
\ No newline at end of file