files/chapter.running.html

chapter.running.html 

  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>Running P4Convert // 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="config.advanced.html" title="Advanced Configuration" />
  10.       <link rel="next" href="running.convert_mode.html" title="Convert Mode" />
  11.       <meta name="Section-title" content="Running P4Convert" />
  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.running">
  33.                <div class="titlepage">
  34.                   <div>
  35.                      <div>
  36.                         <h1 class="title">Running P4Convert</h1>
  37.                      </div>
  38.                   </div>
  39.                </div>
  40.                <div class="section" id="running.import_mode">
  41.                   <div class="titlepage">
  42.                      <div>
  43.                         <div>
  44.                            <h2 class="title" style="clear: both">Import Mode</h2>
  45.                         </div>
  46.                      </div>
  47.                   </div>
  48.                   <p>
  49.                      Import Mode will pull in file revisions from a Subversion dump file or CVS repository,
  50.                            adding them to the Perforce Server specified by the connection details in the
  51.                            configuration options. To use this mode set:
  52.                          
  53.                   </p><pre lang="ini" class="programlisting">
  54. com.p4convert.p4.mode=IMPORT
  55. </pre><p>
  56.                            Care should be taken when adding data to a pre-existing Perforce Server
  57.                            that the revision actions do not conflict with revisions already in the
  58.                            Perforce Server; typically, this can occur if the Server has been in-use
  59.                            since the previous migration.
  60.                          
  61.                   </p>
  62.                   <p>
  63.                            To avoid such scenarios the import should either be to a unique depot, to
  64.                            avoid conflict, or the Perforce Server should be Read Only during
  65.                            subsequent migrations. After a conversion is complete, it is possible to
  66.                            merge the new data with an existing depot using tools like
  67.                            <span class="application">PerfMerge++</span>.
  68.                          
  69.                   </p>
  70.                   <p>
  71.                            The converter will check that your Perforce Server has no pending changes,
  72.                            and will abort a conversion if any are detected.
  73.                          
  74.                   </p>
  75.                   <div class="section" id="running.import_mode.configuration">
  76.                      <div class="titlepage">
  77.                         <div>
  78.                            <div>
  79.                               <h3 class="title">Configuration options specific to Import Mode</h3>
  80.                            </div>
  81.                         </div>
  82.                      </div>
  83.                      <div class="orderedlist">
  84.                         <ol class="orderedlist" type="1">
  85.                            <li class="listitem">
  86.                               <p>
  87.                                              Perforce server address and port (escape the '<code class="literal">:</code>'
  88.                                              with '<code class="literal">\:</code>'):
  89.                                            
  90.                               </p><pre lang="ini" class="programlisting">
  91. com.p4convert.p4.port=<em class="replaceable"><code>localhost\:4444</code></em>
  92. </pre></li>
  93.                            <li class="listitem">
  94.                               <p>
  95.                                              Default user and client for server connection:
  96.                                            
  97.                               </p><pre lang="ini" class="programlisting">
  98. com.p4convert.p4.client=<em class="replaceable"><code>p4-client</code></em>
  99. com.p4convert.p4.user=<em class="replaceable"><code>p4-user</code></em>
  100. </pre></li>
  101.                            <li class="listitem">
  102.                               <p>
  103.                                              Client workspace root used to import files into Perforce:
  104.                                            
  105.                               </p><pre lang="ini" class="programlisting">
  106. com.p4convert.p4.clientRoot=<em class="replaceable"><code>/Users/bruno/ws/</code></em>
  107. </pre></li>
  108.                            <li class="listitem">
  109.                               <p>
  110.                                              If Security is set to level 1 or greater, then the
  111.                                              <em class="replaceable"><code>p4-user</code></em> must have
  112.                                              <span class="emphasis"><em>admin</em></span> permissions in the Protection table and
  113.                                              the password supplied as a string (the
  114.                                              default is set to <code class="envar">ws/</code> under your local directory):
  115.                                            
  116.                               </p><pre lang="ini" class="programlisting">
  117. com.p4convert.p4.passwd=<em class="replaceable"><code>PaSSwoRd</code></em>
  118. </pre></li>
  119.                            <li class="listitem">
  120.                               <p>
  121.                                              Alternatively if the user is already logged in and there is a valid
  122.                                              ticket, then leave the password field unset and set your environment
  123.                                              for <code class="envar">P4TICKETS</code> (don't rely on the
  124.                                              <code class="envar">P4TICKETS</code> unset default as <span class="command"><strong>p4-java</strong></span>
  125.                                              will not find your ticket file).
  126.                                            
  127.                               </p>
  128.                            </li>
  129.                         </ol>
  130.                      </div>
  131.                      <div class="warning admonition">
  132.                         <h3 class="title">Warning</h3>
  133.                         <p>
  134.                                      For long running conversions where authentication is required, please
  135.                                      insure that the conversion user has an "Unlimited" login timeout.
  136.                                    
  137.                         </p>
  138.                      </div>
  139.                   </div>
  140.                </div>
  141.             </div>
  142.          </div>
  143.       </div>
  144.       <div id="nav" class="toc"></div>
  145.       <div id="search">
  146.          <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>
  147.          <div class="controls">
  148.             <div class="substring"><input type="checkbox" class="substring" name="substring" value="hide" checked="1" /><span class="description">Hide partial matches</span></div>
  149.             <div class="highlighter"><input type="checkbox" class="highlight" name="highlight" value="show" checked="1" /><span class="description">Highlight matches</span></div>
  150.          </div>
  151.          <div class="count"><span class="number">0</span> matching pages
  152.                   
  153.          </div>
  154.          <ul class="results"></ul>
  155.       </div>
  156.       <div id="footer">
  157.          <div class="container"><a accesskey="p" class="nav-prev" title="Press 'p', or left-arrow, to view the previous page" href="config.advanced.html"><span class="glyphicon glyphicon-chevron-left"></span><div class="label">Previous</div>
  158.                <div class="title">Advanced Configuration</div></a><a accesskey="n" class="nav-next" title="Press 'n', or right-arrow, to view the next page" href="running.convert_mode.html"><span class="glyphicon glyphicon-chevron-right"></span><div class="label">Next</div>
  159.                <div class="title">Convert Mode</div></a></div>
  160.       </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>
  161. </html>
# Change User Description Committed
#1 13899 Paul Allen added docs to gradle 10 years ago