<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin hotcopy</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html" title="svnadmin Reference—Subversion Repository Administration" />
<link rel="prev" href="svn.ref.svnadmin.c.help.html" title="svnadmin help (h, ?)" />
<link rel="next" href="svn.ref.svnadmin.c.list-dblogs.html" title="svnadmin list-dblogs" />
</head>
<body>
<div xmlns="" id="vcws-version-notice">
<p>This text is a work in progress—highly subject to
change—and may not accurately describe any released
version of the Apache™ Subversion® software.
Bookmarking or otherwise referring others to this page is
probably not such a smart idea. Please visit
<a href="http://www.svnbook.com/">http://www.svnbook.com/</a>
for stable versions of this book.</p>
</div>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin hotcopy</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.help.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Reference—Subversion Repository Administration</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.list-dblogs.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry">
<a id="svn.ref.svnadmin.c.hotcopy"></a>
<div class="titlepage"></div>
<a id="idm13741" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin hotcopy — Make a hot copy of a repository.</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin hotcopy REPOS_PATH NEW_REPOS_PATH</code>
</p>
</div>
<div class="refsect1">
<a id="idm13751"></a>
<h2>Description</h2>
<p>This subcommand makes a <span class="quote">“<span class="quote">hot</span>”</span> backup
of your repository, including all hooks, configuration
files, and, of course, database files. You can run this command at any
time and make a safe copy of the repository, regardless of
whether other processes are using the repository.</p>
<p>Prior to Subversion 1.8, <span class="command"><strong>svnadmin hotcopy</strong></span> always
made a full hot copy of the source repository. Beginning with
Subversion 1.8 it supports incremental copy to the existing
destination copy of the same source repository. By passing the
<code class="option">--incremental</code> option to
<span class="command"><strong>svnadmin hotcopy</strong></span>, you can instruct Subversion to
copy only new revisions and revisions which have changed in size or had
timestamp modifications. The UUID of the hotcopy destination
repository must match the UUID of the hotcopy source repository.
Incremental hotcopy mode is supported for FSFS repositories
only.</p>
<p>If you pass the <code class="option">--clean-logs</code> option,
<span class="command"><strong>svnadmin</strong></span> will perform a hot copy of your
repository, and then remove unused Berkeley DB logs from
the original repository.</p>
</div>
<div class="refsect1">
<a id="idm13762"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.clean_logs"><code class="option">--clean-logs</code></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.incremental"><code class="option">--incremental</code></a>
</pre>
</div>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Warning">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Warning]" src="images/warning.png" />
</td>
<th align="left">Warning</th>
</tr>
<tr>
<td align="left" valign="top">
<p>As described in <a class="xref" href="svn.berkeleydb.limitations.html#svn.berkeleydb.limitations.architectural" title="Architectural Limitations">the section called “Architectural Limitations”</a>, hot-copied
Berkeley DB repositories are <span class="emphasis"><em>not</em></span>
portable across operating systems, nor will they work on
machines with a different <span class="quote">“<span class="quote">endianness</span>”</span> than
the machine where they were created.</p>
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.help.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.list-dblogs.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin help (h, ?) </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin list-dblogs</td>
</tr>
</table>
</div>
<div xmlns="" id="vcws-footer">
<hr />
<img src="images/cc-by.png" style="float: right;" />
<p>You are reading <em>Version Control with Subversion</em> (for
Subversion 1.8), by Ben Collins-Sussman, Brian W. Fitzpatrick,
and C. Michael Pilato.</p>
<p>This work is licensed under
the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.</p>
<p>To submit comments, corrections, or other contributions to the
text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>
