<!DOCTYPE html><html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Setup // P4Convert: User Guide</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1 with Perforce customizations" />
<link rel="home" href="copyright.html" title="P4Convert: User Guide" />
<link rel="up" href="copyright.html" title="P4Convert: User Guide" />
<link rel="prev" href="about.incremental_updates.html" title="Incremental Updates (front door)" />
<link rel="next" href="setup.caveats.html" title="Caveats" />
<meta name="Section-title" content="Setup" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" href="vendor/bootstrap/css/bootstrap.css" />
<link rel="stylesheet" href="vendor/prettify/prettify.css" />
<link rel="stylesheet" href="css/perforce.css" />
<link rel="stylesheet" href="css/print.css" media="print" />
<link rel="shortcut icon" href="images/favicon.ico" />
<!--[if lt IE 9]>
<script type="text/javascript" src="vendor/respond/respond.min.js"></script>
<link rel="stylesheet" type="text/css" href="css/ie.css"/>
<![endif]-->
</head>
<body><a id="page-top"></a><div id="header">
<div class="container"><button name="toc" type="button" class="toc"><span class="glyphicon glyphicon-list"></span></button><span class="logo"><a href="http://www.perforce.com/documentation"></a></span><h1><a href="index.html" class="title"><span class="brand"></span><span class="guide-title">P4Convert: User Guide</span><span class="guide-subtitle">
(April 2015)
</span></a></h1><a title="Download a PDF version of this guide" class="pdf" href="ethel.pdf"><span class="glyphicon glyphicon-book"></span></a><button name="search" type="button" class="search" title="Search this guide"><span class="glyphicon glyphicon-search"></span></button></div>
<div id="progress"></div>
</div>
<div id="content" class="content" tabindex="-1">
<div class="container">
<!---->
<div class="chapter" id="chapter.setup">
<div class="titlepage">
<div>
<div>
<h1 class="title">Setup</h1>
</div>
</div>
</div>
<div class="section" id="setup.requirements">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both">System Requirements</h2>
</div>
</div>
</div>
<div class="orderedlist">
<ol class="orderedlist" type="1">
<li class="listitem">
<p>
[SVN] an unzipped Subversion dump file of the repository to be converted
(generated without the <em class="parameter"><code>--delta</code></em> flag).
</p>
</li>
<li class="listitem">
<p>
[CVS] an unzipped CVSROOT directory containing the RCS files of the
repository to be converted.
</p>
</li>
<li class="listitem">
<p>
System must have <span class="bold"><strong>Java SE Runtime 1.7</strong></span>.
</p>
</li>
<li class="listitem">
<p>
System must have the Perforce Server binaries 2010.2 or greater.
</p>
</li>
<li class="listitem">
<p>
[Import Mode] A running Perforce Server (typically empty) with no
pending changes in the conversion area.
</p>
</li>
<li class="listitem">
<p>
[Convert Mode] An empty Perforce Root directory for the generated
archive and journal files.
</p>
</li>
</ol>
</div>
<div class="section" id="setup.requirements.resource_tips">
<div class="titlepage">
<div>
<div>
<h3 class="title">Resource Tips:</h3>
</div>
</div>
</div>
<p>
Running some conversions, particularly in Conversion Mode can
be very memory intensive, as a mapping of revisions and integrations
is kept in memory. For large conversions, or conversions with
excessive branching, more memory will needed by the JVM.
</p>
<p>
The <em class="parameter"><code>--info</code></em> option will scan the Subversion dump
file and report usage data to help estimate the required memory for
Convert Mode. For example:
</p><pre lang="bash" class="programlisting">
java -jar p4convert.jar --type=SVN --repo=<path_to_svn_dumpfile> --info
</pre><p>
Use the <em class="parameter"><code>-Xmx</code></em> flags to increase the memory
allocated to the JVM. For example, to allocate 64GB (65536MB) use:
</p><pre lang="bash" class="programlisting">
java -Xmx65536M -jar p4convert.jar --config=myConfig.cfg
</pre></div>
</div>
</div>
</div>
</div>
<div id="nav" class="toc"></div>
<div id="search">
<div class="input"><input id="search-text" type="search" placeholder="Search this guide" /><button name="clear" type="button" class="clear"><span class="glyphicon glyphicon-remove-sign"></span></button></div>
<div class="controls">
<div class="substring"><input type="checkbox" class="substring" name="substring" value="hide" checked="1" /><span class="description">Hide partial matches</span></div>
<div class="highlighter"><input type="checkbox" class="highlight" name="highlight" value="show" checked="1" /><span class="description">Highlight matches</span></div>
</div>
<div class="count"><span class="number">0</span> matching pages
</div>
<ul class="results"></ul>
</div>
<div id="footer">
<div class="container"><a accesskey="p" class="nav-prev" title="Press 'p', or left-arrow, to view the previous page" href="about.incremental_updates.html"><span class="glyphicon glyphicon-chevron-left"></span><div class="label">Previous</div>
<div class="title">Incremental Updates (front door)</div></a><a accesskey="n" class="nav-next" title="Press 'n', or right-arrow, to view the next page" href="setup.caveats.html"><span class="glyphicon glyphicon-chevron-right"></span><div class="label">Next</div>
<div class="title">Caveats</div></a></div>
</div><script type="text/javascript" src="vendor/jquery/jquery-1.11.3.min.js"></script><script type="text/javascript" src="vendor/bootstrap/js/bootstrap.js"></script><script type="text/javascript" src="vendor/cookie/jquery.cookie.js"></script><script type="text/javascript" src="vendor/highlight/jquery.highlight.js"></script><script type="text/javascript" src="vendor/jsrender/jsrender.js"></script><script type="text/javascript" src="vendor/touchwipe/jquery.touchwipe.min.js"></script><script type="text/javascript" src="vendor/prettify/prettify.js"></script><script defer="1" type="text/javascript" src="js/index.js"></script><script defer="1" type="text/javascript" src="js/toc.js"></script><script defer="1" type="text/javascript" src="js/perforce.js"></script></body>
</html>