Loading...
Helix SwarmHelix Swarm
Loading...

chapter.setup.html

  • //
  • guest/
  • paul_allen/
  • p4convert-maven/
  • docs/
  • p4convert/
  • publicsite-generated/
  • chapter.setup.html #1
  • View
  • Commits
  • Open Download .zip Download (9 KB) 
  1. <!DOCTYPE html><html>
  2.    <head>
  3.       <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  4.       <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5.       <title>Setup // P4Convert: User Guide</title>
  6.       <meta name="generator" content="DocBook XSL Stylesheets V1.78.1 with Perforce customizations" />
  7.       <link rel="home" href="copyright.html" title="P4Convert: User Guide" />
  8.       <link rel="up" href="copyright.html" title="P4Convert: User Guide" />
  9.       <link rel="prev" href="about.incremental_updates.html" title="Incremental Updates (front door)" />
  10.       <link rel="next" href="setup.caveats.html" title="Caveats" />
  11.       <meta name="Section-title" content="Setup" />
  12.       <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  13.       <link rel="stylesheet" href="vendor/bootstrap/css/bootstrap.css" />
  14.       <link rel="stylesheet" href="vendor/prettify/prettify.css" />
  15.       <link rel="stylesheet" href="css/perforce.css" />
  16.       <link rel="stylesheet" href="css/print.css" media="print" />
  17.       <link rel="shortcut icon" href="images/favicon.ico" />
  18.       <!--[if lt IE 9]>
  19.   <script type="text/javascript" src="vendor/respond/respond.min.js"></script>
  20.   <link rel="stylesheet" type="text/css" href="css/ie.css"/>
  21. <![endif]-->
  22.    </head>
  23.    <body><a id="page-top"></a><div id="header">
  24.          <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">
  25.                                    (April 2015)
  26.                                  </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>
  27.          <div id="progress"></div>
  28.       </div>
  29.       <div id="content" class="content" tabindex="-1">
  30.          <div class="container">
  31.             <!---->
  32.             <div class="chapter" id="chapter.setup">
  33.                <div class="titlepage">
  34.                   <div>
  35.                      <div>
  36.                         <h1 class="title">Setup</h1>
  37.                      </div>
  38.                   </div>
  39.                </div>
  40.                <div class="section" id="setup.requirements">
  41.                   <div class="titlepage">
  42.                      <div>
  43.                         <div>
  44.                            <h2 class="title" style="clear: both">System Requirements</h2>
  45.                         </div>
  46.                      </div>
  47.                   </div>
  48.                   <div class="orderedlist">
  49.                      <ol class="orderedlist" type="1">
  50.                         <li class="listitem">
  51.                            <p>
  52.                                         [SVN] an unzipped Subversion dump file of the repository to be converted
  53.                                         (generated without the <em class="parameter"><code>--delta</code></em> flag).
  54.                                       
  55.                            </p>
  56.                         </li>
  57.                         <li class="listitem">
  58.                            <p>
  59.                                         [CVS] an unzipped CVSROOT directory containing the RCS files of the 
  60.                                         repository to be converted.
  61.                                       
  62.                            </p>
  63.                         </li>
  64.                         <li class="listitem">
  65.                            <p>
  66.                                         System must have <span class="bold"><strong>Java SE Runtime 1.7</strong></span>.
  67.                                       
  68.                            </p>
  69.                         </li>
  70.                         <li class="listitem">
  71.                            <p>
  72.                                         System must have the Perforce Server binaries 2010.2 or greater.
  73.                                       
  74.                            </p>
  75.                         </li>
  76.                         <li class="listitem">
  77.                            <p>
  78.                                         [Import Mode] A running Perforce Server (typically empty) with no
  79.                                         pending changes in the conversion area.
  80.                                       
  81.                            </p>
  82.                         </li>
  83.                         <li class="listitem">
  84.                            <p>
  85.                                         [Convert Mode] An empty Perforce Root directory for the generated
  86.                                         archive and journal files.
  87.                                       
  88.                            </p>
  89.                         </li>
  90.                      </ol>
  91.                   </div>
  92.                   <div class="section" id="setup.requirements.resource_tips">
  93.                      <div class="titlepage">
  94.                         <div>
  95.                            <div>
  96.                               <h3 class="title">Resource Tips:</h3>
  97.                            </div>
  98.                         </div>
  99.                      </div>
  100.                      <p>
  101.                                 Running some conversions, particularly in Conversion Mode can
  102.                                 be very memory intensive, as a mapping of revisions and integrations
  103.                                 is kept in memory. For large conversions, or conversions with
  104.                                 excessive branching, more memory will needed by the JVM.
  105.                               
  106.                      </p>
  107.                      <p>
  108.                                 The <em class="parameter"><code>--info</code></em> option will scan the Subversion dump
  109.                                 file and report usage data to help estimate the required memory for
  110.                                 Convert Mode. For example:
  111.                               
  112.                      </p><pre lang="bash" class="programlisting">
  113. java -jar p4convert.jar --type=SVN --repo=&lt;path_to_svn_dumpfile&gt; --info 
  114. </pre><p>
  115.                                 Use the <em class="parameter"><code>-Xmx</code></em> flags to increase the memory
  116.                                 allocated to the JVM. For example, to allocate 64GB (65536MB) use:
  117.                               
  118.                      </p><pre lang="bash" class="programlisting">
  119. java -Xmx65536M -jar p4convert.jar --config=myConfig.cfg
  120. </pre></div>
  121.                </div>
  122.             </div>
  123.          </div>
  124.       </div>
  125.       <div id="nav" class="toc"></div>
  126.       <div id="search">
  127.          <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>
  128.          <div class="controls">
  129.             <div class="substring"><input type="checkbox" class="substring" name="substring" value="hide" checked="1" /><span class="description">Hide partial matches</span></div>
  130.             <div class="highlighter"><input type="checkbox" class="highlight" name="highlight" value="show" checked="1" /><span class="description">Highlight matches</span></div>
  131.          </div>
  132.          <div class="count"><span class="number">0</span> matching pages
  133.                   
  134.          </div>
  135.          <ul class="results"></ul>
  136.       </div>
  137.       <div id="footer">
  138.          <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>
  139.                <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>
  140.                <div class="title">Caveats</div></a></div>
  141.       </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>
  142. </html>
# Change User Description Committed
#1 13899 Paul Allen added docs to gradle 10 years ago