Convert Mode

Convert Mode is more advanced and requires knowledge of the Perforce Journal replay and Archive file store. This mode can only be used for single shot conversions and cannot be used incrementally. The performance of Convert Mode is significantly better than Import Mode (x100 sometimes!).

After using Convert Mode the administrator will need to run several commands to rebuild the Perforce server and upgrade the metadata. Please refer to the Post Conversion [Conversion Mode] section for step-by-step instructions.

To use this mode set: 

com.p4convert.p4.mode=CONVERT

Configuration options specific to Conversion Mode

  1. Perforce server root address (path should end with a slash (/)), the default is set to p4_root/ under you local directory: 

    com.p4convert.p4.root=/full/path/to/p4_root/

  2. Change list offset from which to start conversion (handy for batched conversions): 

    com.p4convert.p4.offset=0

  3. Generated journal names (useful to increment the prefix when running batched conversions): 

    com.p4convert.p4.jnlIndex=0
com.p4convert.p4.jnlPrefix=jnl.

  4. Mimic the 2011.1 or greater credit behavior on rollbacks / downgrades (to enable set value to true): 

    com.p4convert.p4.downgrade=false

  5. Perforce normalises line-endings when storing the file on the server and restores them based on the client workspace options and platform type. However, in special cases it can be useful to store line-ending in the server and use the 'share' option in the client. To disable normal line-ending support set the following option to false: 

    com.p4convert.p4.lineEnding=true

  6. For non Unicode servers, or to simplify storage of hi-ASCII files, setting the following option to false will store the file as binary: 

    com.p4convert.p4.unicode=false