svn commit: r1387181 - /subversion/site/publish/docs/release-notes/1.8.html

[st...@apache.org]

Author: stsp
Date: Tue Sep 18 14:24:31 2012
New Revision: 1387181

URL: http://svn.apache.org/viewvc?rev=1387181&view=rev
Log:
* publish/docs/release-notes/1.8.html: Document 'svnadmin freeze'.

Modified:
    subversion/site/publish/docs/release-notes/1.8.html

Modified: subversion/site/publish/docs/release-notes/1.8.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.8.html?rev=1387181&r1=1387180&r2=1387181&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.8.html (original)
+++ subversion/site/publish/docs/release-notes/1.8.html Tue Sep 18 14:24:31 2012
@@ -476,7 +476,9 @@ tool is running. The resulting copy migh
 general-purpose backup tools do not know anything about consistency
 requirements of Subversion repositories. It is recommended to use
 incremental hotcopy instead. Alternatively, if network support is
-required for the backup procedure, <tt>svnsync</tt> should be used.</p>
+required for the backup procedure, <tt>svnsync</tt> should be used.
+There is also a new <a href=#"svnadmin-freeze">svnadmin freeze</a> command
+which allows third-party tools to access a live repository safely.</p>
 </div>
 
 </div>  <!-- incremental-hotcopy -->
@@ -570,6 +572,31 @@ without requiring a working copy for use
 
 </div> <!-- svnadmin-lock -->
 
+<div class="h4" id="svnadmin-freeze">
+<h4>New 'svnadmin freeze' command
+  <a class="sectionlink" href="#svnadmin-freeze"
+    title="Link to this section">&para;</a>
+</h4>
+
+<p>The new <tt>svnadmin freeze</tt> command can be used to run an arbitrary
+program while preventing concurrent commits to the repository. The program
+is invoked by <tt>svnadmin</tt> with a provided parameter list. This can
+be used to safely use third-party backup tools on a live repository:</p>
+<pre>
+$ svnadmin freeze /svn/my-repos rsync -av /svn/my-repos /backup/my-repos
+</pre>
+
+<p>The above will obtain a write lock on the <tt>my-repos</tt> repository
+to prevent concurrent commits, and run
+<a href="http://rsync.samba.org">rsync</a> to back up the repository.
+Clients trying to commit concurrently will wait until the write lock
+becomes available again. If the command takes too much time clients
+trying to commit might time out. It is recommended to run commands
+which complete very quickly, such as a command to trigger creation
+of a filesystem snapshot.</p>
+
+</div> <!-- svnadmin-freeze -->
+
 <div class="h4" id="svndumpfilter-deltas">
 <h4>'svndumpfilter' now supports dump files with deltas
   <a class="sectionlink" href="#svndumpfilter-deltas"