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">¶</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"