Helix SwarmHelix Swarm
Loading...

running.convert_mode.html

  • //
  • guest/
  • paul_allen/
  • p4convert-maven/
  • docs/
  • p4convert/
  • publicsite-generated/
  • running.convert_mode.html #1
  • View
  • Commits
  • Open Download .zip Download (10 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>Convert Mode // 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="chapter.running.html" title="Running P4Convert" />
  9.       <link rel="prev" href="chapter.running.html" title="Running P4Convert" />
  10.       <link rel="next" href="running.post_conversion.html" title="Post Conversion [Conversion Mode]" />
  11.       <meta name="Section-title" content="Convert Mode" />
  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="section" id="running.convert_mode">
  33.                <div class="titlepage">
  34.                   <div>
  35.                      <div>
  36.                         <h2 class="title" style="clear: both">Convert Mode</h2>
  37.                      </div>
  38.                   </div>
  39.                </div>
  40.                <p>
  41.                   Convert Mode is more advanced and requires knowledge of the Perforce
  42.                   Journal replay and Archive file store. This mode can only be used for
  43.                   single shot conversions and cannot be used incrementally. The performance
  44.                         of Convert Mode is significantly better than Import Mode (x100
  45.                         sometimes!).
  46.                       
  47.                </p>
  48.                <p>
  49.                         After using Convert Mode the administrator will need to run
  50.                         several commands to rebuild the Perforce server and upgrade the
  51.                         metadata. Please refer to the <a class="xref" href="running.post_conversion.html" title="Post Conversion [Conversion Mode]">Post Conversion [Conversion Mode]</a>
  52.                         section for step-by-step instructions.
  53.                       
  54.                </p>
  55.                <p>
  56.                         To use this mode set:
  57.                       
  58.                </p><pre lang="ini" class="programlisting">
  59. com.p4convert.p4.mode=CONVERT
  60. </pre><div class="section" id="running.convert_mode.configuration">
  61.                   <div class="titlepage">
  62.                      <div>
  63.                         <div>
  64.                            <h3 class="title">Configuration options specific to Conversion Mode</h3>
  65.                         </div>
  66.                      </div>
  67.                   </div>
  68.                   <div class="orderedlist">
  69.                      <ol class="orderedlist" type="1">
  70.                         <li class="listitem">
  71.                            <p>
  72.                                           Perforce server root address (path should end with a
  73.                                           slash (<code class="literal">/</code>)), the default is set to 
  74.                                           <code class="envar">p4_root/</code> under you local directory:
  75.                                         
  76.                            </p><pre lang="ini" class="programlisting">
  77. com.p4convert.p4.root=<em class="replaceable"><code>/full/path/to/p4_root/</code></em>
  78. </pre></li>
  79.                         <li class="listitem">
  80.                            <p>
  81.                                           Change list offset from which to start conversion (handy for batched conversions):
  82.                                         
  83.                            </p><pre lang="ini" class="programlisting">
  84. com.p4convert.p4.offset=<em class="replaceable"><code>0</code></em>
  85. </pre></li>
  86.                         <li class="listitem">
  87.                            <p>
  88.                                           Generated journal names (useful to increment the prefix when running
  89.                                           batched conversions):
  90.                                         
  91.                            </p><pre lang="ini" class="programlisting">
  92. com.p4convert.p4.jnlIndex=<em class="replaceable"><code>0</code></em>
  93. com.p4convert.p4.jnlPrefix=<em class="replaceable"><code>jnl.</code></em>
  94. </pre></li>
  95.                         <li class="listitem">
  96.                            <p>
  97.                                           Mimic the 2011.1 or greater credit behavior on rollbacks /
  98.                                           downgrades (to enable set value to <code class="literal">true</code>):
  99.                                         
  100.                            </p><pre lang="ini" class="programlisting">
  101. com.p4convert.p4.downgrade=<em class="replaceable"><code>false</code></em>
  102. </pre></li>
  103.                         <li class="listitem">
  104.                            <p>
  105.                                           Perforce normalises line-endings when storing the file on the server
  106.                                           and restores them based on the client workspace options and platform
  107.                                           type. However, in special cases it can be useful to store
  108.                                           line-ending in the server and use the 'share' option in the client.
  109.                                           To disable normal line-ending support set the following option to
  110.                                           <code class="literal">false</code>:
  111.                                         
  112.                            </p><pre lang="ini" class="programlisting">
  113. com.p4convert.p4.lineEnding=<em class="replaceable"><code>true</code></em>
  114. </pre></li>
  115.                         <li class="listitem">
  116.                            <p>
  117.                                           For non Unicode servers, or to simplify storage of hi-ASCII files,
  118.                                           setting the following option to <code class="literal">false</code> will store the file
  119.                                           as <code class="literal">binary</code>:
  120.                                         
  121.                            </p><pre lang="ini" class="programlisting">
  122. com.p4convert.p4.unicode=<em class="replaceable"><code>false</code></em>
  123. </pre></li>
  124.                      </ol>
  125.                   </div>
  126.                </div>
  127.             </div>
  128.          </div>
  129.       </div>
  130.       <div id="nav" class="toc"></div>
  131.       <div id="search">
  132.          <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>
  133.          <div class="controls">
  134.             <div class="substring"><input type="checkbox" class="substring" name="substring" value="hide" checked="1" /><span class="description">Hide partial matches</span></div>
  135.             <div class="highlighter"><input type="checkbox" class="highlight" name="highlight" value="show" checked="1" /><span class="description">Highlight matches</span></div>
  136.          </div>
  137.          <div class="count"><span class="number">0</span> matching pages
  138.                   
  139.          </div>
  140.          <ul class="results"></ul>
  141.       </div>
  142.       <div id="footer">
  143.          <div class="container"><a accesskey="p" class="nav-prev" title="Press 'p', or left-arrow, to view the previous page" href="chapter.running.html"><span class="glyphicon glyphicon-chevron-left"></span><div class="label">Previous</div>
  144.                <div class="title">Running P4Convert</div></a><a accesskey="n" class="nav-next" title="Press 'n', or right-arrow, to view the next page" href="running.post_conversion.html"><span class="glyphicon glyphicon-chevron-right"></span><div class="label">Next</div>
  145.                <div class="title">Post Conversion [Conversion Mode]</div></a></div>
  146.       </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>
  147. </html>
# Change User Description Committed
#1 13899 Paul Allen added docs to gradle 10 years ago