Return-Path: 
 <commits-return-32767-apmail-commons-commits-archive=commons.apache.org@commons.apache.org>
X-Original-To: apmail-commons-commits-archive@minotaur.apache.org
Delivered-To: apmail-commons-commits-archive@minotaur.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id A076CFA98
	for <apmail-commons-commits-archive@minotaur.apache.org>;
 Sat, 23 Mar 2013 20:13:58 +0000 (UTC)
Received: (qmail 11229 invoked by uid 500); 23 Mar 2013 20:13:58 -0000
Delivered-To: apmail-commons-commits-archive@commons.apache.org
Received: (qmail 11169 invoked by uid 500); 23 Mar 2013 20:13:58 -0000
Mailing-List: contact commits-help@commons.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@commons.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@commons.apache.org>
List-Post: <mailto:commits@commons.apache.org>
List-Id: <commits.commons.apache.org>
Reply-To: dev@commons.apache.org
Delivered-To: mailing list commits@commons.apache.org
Received: (qmail 11162 invoked by uid 99); 23 Mar 2013 20:13:58 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 23 Mar 2013 20:13:58 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 23 Mar 2013 20:13:56 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id 567D423888FE;
	Sat, 23 Mar 2013 20:13:36 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1460220 -
 /commons/cms-site/trunk/content/xdoc/releases/release.xml
Date: Sat, 23 Mar 2013 20:13:36 -0000
To: commits@commons.apache.org
From: bodewig@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20130323201336.567D423888FE@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: bodewig
Date: Sat Mar 23 20:13:35 2013
New Revision: 1460220

URL: http://svn.apache.org/r1460220
Log:
Adapt post-release instructions for svnpubsub and Nexus

Modified:
    commons/cms-site/trunk/content/xdoc/releases/release.xml

Modified: commons/cms-site/trunk/content/xdoc/releases/release.xml
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/releases/release.xml?rev=1460220&r1=1460219&r2=1460220&view=diff
==============================================================================
--- commons/cms-site/trunk/content/xdoc/releases/release.xml (original)
+++ commons/cms-site/trunk/content/xdoc/releases/release.xml Sat Mar 23 20:13:35 2013
@@ -40,10 +40,11 @@
     <ul>
       <li>
         The signed release candidate source and binary distributions and release notes are available
-        in ~/public_html/commons-foo-1.2-RC3.
+        in https://dist.apache.org/repos/dist/dev/commons/foo.
       </li>
       <li>
-        The maven artifacts associated with the release are available in ~/public_html/commons-foo-1.2-RC3/maven.
+        The maven artifacts associated with the release are available in a closed Nexus staging
+        repository.
       </li>
     </ul>
     </p>
@@ -51,31 +52,35 @@
 
   <subsection name='1 Move Releases Into Distribution Directories'>
     <p>
-    On people.apache.org, change directory to the distribution directory for your component:
-    <pre>
-      cd /www/www.apache.org/dist/commons/foo/ </pre>
-    </p>
-    <p>
-    Move source distributions, their detached signatures and md5 sums into position. 
-    All source versions live in the <em>source</em> subdirectory.
-    <pre>
-      mv ~/public_html/foo-1.2-RC3/commons-foo-1.2-src* source </pre>
-    </p>
-    <p>
-    Move the binary distributions, their detached signatures and md5 sums into position. 
-    All binary versions live in the <em>binaries</em> subdirectory.
-    [Note: the source must have been moved already, otherwise the following command will
-    also be applied to the source files.]
-    <pre>
-      mv ~/public_html/foo-1.2-RC3/commons-foo-1.2* binaries </pre>
-    </p>
-    <p>
-    Double check the permissions for both binaries and source distributions.
-    The file permissions should be "-rw-rw-r--" and the group should be "commons", for example:
-    <pre>
-      -rw-rw-r--  1 userid   commons     203 Feb 21 23:45 commons-foo-1.2-src.tar.gz.asc
+      The distribution area of commons releases is populated from
+      <a href="https://dist.apache.org/repos/dist/release/commons/">https://dist.apache.org/repos/dist/release/commons/</a>
+      via svnpubsub.  In order to publish the release, you must move the distributions files
+      from <code>dev</code> to <code>release</code>.
+    </p>
+    <p>You can perform multiple <code>svn mv</code> operations (with or without local
+      working copies) or you can use <a href="http://svnbook.red-bean.com/en/1.8/svn.ref.svnmucc.re.html">svnmucc</a>,
+      for example:</p>
+    <pre>
+      svnmucc -U https://dist.apache.org/repos/dist \
+          mv dev/commons/foo/RELEASE-NOTES.txt release/commons/foo \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.asc release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.md5 release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.asc release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.asc release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.md5 release/commons/foo/binaries \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.asc release/commons/foo/binaries \
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.asc release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.md5 release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.asc release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.asc release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.md5 release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.asc release/commons/foo/source \
+          -m "Publish commons-foo 1.2 Release"
     </pre>
-    </p>
   </subsection>
 
   <subsection name='2 Update Release Directory'>
@@ -86,14 +91,12 @@
     If this document is not present, then copy one from an existing release directory
     and edit that.
     </p>
+    <p>The README must be https://dist.apache.org/repos/dist/release/commons/foo/README.html</p>
     <p>
     Update the latest release number. Please also read through and correct any mistakes you find
     and fix other items (eg. urls) which need updating. 
     </p>
     <p>
-    Copy the revised <code>README.html</code> into the binary and source directories, replacing any old versions.
-    </p>
-    <p>
     <a name='Check KEYS file'/>
     <strong>Check KEYS file</strong><br/>
     Check the <code>KEYS</code> file located in the main release directory. This should contain all the 
@@ -101,85 +104,22 @@
     that it contains the public key you've used to sign these releases. The <code>KEYS</code> file 
     gives instructions on how to do this.
     </p>
-    <p>
-    <strong>Symbolic Links</strong><br/>
-    These are no longer to be used, so please
-    <a href="http://www.apache.org/dev/mirror-step-by-step.html#symbolic_links">do not use symbolic links in mirrored directories!</a>
-    <strong>Update RELEASE-NOTES</strong><br/>
-    Replace the current <code>RELEASE-NOTES.txt</code> with the new release notes.
-    <pre>
-    mv ~/public_html/foo-1.2-RC3/RELEASE-NOTES.txt .
-    </pre>
-    </p>
   </subsection>
 
   <subsection name='3 Deploy Maven Artifacts'>
-    <p>
-    Download maven-metadata.xml for commons foo from repo1.maven.org.  This file is located in the top-level
-    directory for the component.  The file should contain a <code>versioning</code> element, similar to the following:
-    <pre>
-    &lt;versioning&gt;
-      &lt;release&gt;1.1&lt;/release&gt;
-      &lt;versions&gt;
-        &lt;version&gt;1.0&lt;/version&gt;
-        &lt;version&gt;1.1&lt;/version&gt;
-      &lt;/versions&gt;
-      &lt;lastUpdated&gt;20091011214529&lt;/lastUpdated&gt;
-    &lt;/versioning&gt; </pre>
-    </p>
-    <p>
-    Create a <code>version</code> element for 1.2, update the <code>release</code> version and update
-    the date in the <code>lastUpdated</code> element:
-    <pre>
-    &lt;versioning&gt;
-      &lt;release&gt;1.2&lt;/release&gt;
-      &lt;versions&gt;
-        &lt;version&gt;1.0&lt;/version&gt;
-        &lt;version&gt;1.1&lt;/version&gt;
-        &lt;version&gt;1.2&lt;/version&gt;
-      &lt;/versions&gt;
-      &lt;lastUpdated&gt;20100401214529&lt;/lastUpdated&gt;
-    &lt;/versioning&gt; </pre>
-    </p>
-    <p>
-    Create the hash files, maven-metadata.xml.sha1 and maven-metadata.xml.md5 for the updated metadata file.
-    If you do not have openssl or another suitable utility installed locally, you can upload the edited
-    maven-metadata.xml file to people.apache.org and use the following commands to create these files:
-    <pre>
-    md5 -q maven-metadata.xml > maven-metadata.xml.md5
-    sha1 -q maven-metadata.xml > maven-metadata.xml.sha1 </pre>
-    </p>
-    <p>
-    Your Maven artifacts (jar and pom files with hashes and signatures) should be placed in 
-    <code>/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2/</code> on
-    people.apache.org. This assumes that your component has been migrated to use the org.apache.commons groupId.
-    If the component still uses commons-foo as its groupId, the deployment location should be
-    /www/people.apache.org/repo/m2-ibiblio-rsync-repository/commons-foo/commons-foo/1.2.  If your RC directory
-    includes a "maven" subdirectory including the maven artifacts, you can move the maven artifacts using 
-    the following commands (assuming the org.apache.commons groupId):
-    <pre>
-    mkdir /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2
-    chgrp commons ~/public_html/foo-1.2-RC3/maven/*
-    chmod g+w ~/public_html/foo-1.2-RC3/maven/*
-    mv ~/public_html/foo-1.2-RC3/maven/* /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2 </pre>
-    </p>
-    <p>
-    Double-check permissions on the newly created directory and the deployed files.  Also double-check that all
-    of the artifacts have hashes and signature files associated with them.
-    </p>
-    <p>
-    The updated <code>maven-metadata.xml</code> and its sha1 and md5 hashes should be placed in the directory
-    above the deployed artifacts 
-    (<code>/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo</code> if
-    org.apache.commons is the groupId).
-    </p>
+    <p>Login to the Nexus web interface, select your staging repository and
+      <a href="http://www.apache.org/dev/publishing-maven-artifacts.html#promote">promote</a> it.</p>
     <p>
     The files placed here will be mirrored (after some delay) to the public distribution
     repository on <a href="http://repo1.maven.org/maven2/">http://repo1.maven.org/maven2/</a>.
     </p>
   </subsection>
 
-  <subsection name='4 Test Main Site Downloads'>
+  <subsection name="4 Create Subversion Tag for the Final Release">
+    <p>Copy the release candidate tag in subversion to a name without RC in its name.</p>
+  </subsection>
+  
+  <subsection name='5 Test Main Site Downloads'>
     <p>
     Wait until the release files are available from the main Apache web site 
     (<code>http://www.apache.org/dist/commons/foo/</code>), then confirm things are good.
@@ -207,7 +147,7 @@
     </p>
   </subsection>
 
-  <subsection name="5 Update Component Build and Website">
+  <subsection name="6 Update Component Build and Website">
     <ul>
     <li>
     <strong>Update trunk version</strong>
@@ -223,7 +163,7 @@
     </ul>
   </subsection>
 
-  <subsection name='6 Create Announcements'>
+  <subsection name='7 Create Announcements'>
     <p>
     Announce the availability of the new release. 
     </p>
@@ -237,7 +177,7 @@
     <ol>
     <li>The release artifacts are available on the mirrors.</li>
     <li>The component website including the updated download page has been updated on the public site
-        http://commons.apache.org/foo.</li>
+      http://commons.apache.org/proper/foo.</li>
     <li>If the component publishes maven artifacts, these artifacts have been replicated to the central
         maven repo at repo1.maven.org. (Clear your local repo of the release artifacts and either activate
         the clirr report with the updated version info or update a local project with a dependency to the new
@@ -255,7 +195,7 @@
     </p>
   </subsection>
 
-  <subsection name='7 Post Release Cleanup'>
+  <subsection name='8 Post Release Cleanup'>
     <p>
     That's it! The release is out there - but there is still some tidying up to be done.
     </p>
@@ -265,9 +205,10 @@
     Unless old versions are especially required, remove them from the dist directory. This 
     will cause the files to also be deleted from the mirrors and
     save them some diskspace as well as simplifying things for users. 
-    Note that the contents of the /www/www.apache.org/dist directory is regularly copied to
-    /www/archive.apache.org/dist and from there transferred to host archive.apache.org.
-    Deleting files from the standard distribution directories does <i>not</i> delete
+      Note that the contents of the http://www.apache.org/dist directory is regularly copied to
+      http://archive.apache.org/dist.
+    Deleting files from the standard distribution directories
+      on https://dist.apache.org/repos/dist/release/commons/ does <i>not</i> delete
     them from the archive dist directories so users will
     still be able to access old files even when they are not available from the mirrors.
     </li>
@@ -281,7 +222,7 @@
     <li>
     <strong>Update DOAP file</strong>
     Update the component's <a href="http://projects.apache.org/guidelines.html">DOAP file</a>
-    with details of the released version:
+    and add a new entry with details of the released version:
     <pre>
       &lt;release&gt;
         &lt;Version&gt;