p4 replicate

Poll for journal changes on one Helix Server for forwarding to another Helix Server.

Syntax

p4 replicate [-j token] [-s statefile] [-i interval] [-k -x -R] [-J prefix]  
             [-T tables] [-o output] [command]

Syntax conventions

Description

This command polls for new journal entries from a Helix Server, and either outputs them to standard output, or, if a command is specified, pipe the journal records to the command, which is spawned as a subprocess.

Options

-i interval

Specify a polling interval, in seconds. The default is two seconds. To disable polling (that is, to check once for updated journal entries and then exit), specify an interval of 0.

-j token

Specify a journal number or position token of the form journalnum/byteoffset from which to start replicating metadata. If this option is specified, it overrides any state file specification.

-J prefix

Specifies a filename prefix for the journal, such as that used with p4d -jc prefix.

-k

Keep the pipe to the command subprocess open between polling intervals.

-o savefile

Specify a file for output. If a command subprocess is specified, both the subprocess and the specified savefile are provided with the output.

-R

The -R option causes p4 replicate to attempt reconnection to the server in the event of connection loss or serious error. A polling interval must be specified with -i interval.

-s statefile

Specify a state file which tracks the most recent journal position. You can also use the statefile configurable to specify the state file.

-T tables

Supply a list of database tables (for example, db.have) to exclude from export.

-x

Exit the p4 replicate command when journal rotation is detected.

g-opts

See Global options.

Usage Notes

Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required

N/A

N/A

super

  • Use p4 replicate in situations where you need to replicate metadata (but not archived files), or when you need to perform filtering operations on metadata. In most situations, replication with p4 pull is preferable to p4 replicate.
  • See Replication in the Helix Core Server Administrator Guide.

Related Commands

To update file content as well as journal records

p4 pull

To display journal or checkpoint records in raw form

p4 export