Shared archives between replica and master

Sharing archives is supported between a master and replica server, or between a commit server and edge server, but replica servers cannot share archives with other replica servers.

Typical replication Shared archives

Typically, a replicaClosed A Helix Core Server that automatically maintains a full or partial copy of the master server's metadata and that might contain related file content. The replica copies from its master by using 'p4 pull' or 'p4 journalcopy'. A replica can be used as a backup server for disaster recovery. server retrieves both its metadata and file archives from the master server on the user-defined pull interval. For example p4 pull -i 1

This configuration requires the P4TARGET server to send the archives files to the replica.

If a replica server is configured to share the same physical archive files as the master server:

  • the replica accesses the archives directly, so archive files are not transferred
  • the replica and master can:
    • run on the same machine, or
    • share storage over a network shared storage, where network latency affects performance.

To share archives, on the replica, set the lbr.replication configurable to shared either in the server spec or manually:

  • only metadata is retrieved on the pull interval
  • the "shared" archive files are not retrieved until requested by a client
  • new files are not automatically transferred
  • purged files are not removed

Shared archives can form part of a High Availability configuration.

Warning

When archive files are directly shared between a replica and master server, the replica must have lbr.replication set to shared. Otherwise, the files in the archive might be corrupted.

To configure a replica to share archive files with a master

  1. Ensure that the clocks for the master and replica servers are synchronized.

    Nothing needs to be done if the master and replica servers are hosted on the same operating system.

    Synchronizing clocks is a system administration task that typically involves using a Network Time Protocol client to synchronize an operating system’s clock with a time server on the Internet, or a time server you maintain for your own network.

    See http://support.ntp.org/bin/view/Support/InstallingNTP.

  2. If you have not already done so, configure the replica or edge server. See Deployment architecture.

  3. Set server.depot.root on the master and replica, or the commit and edge, to point to the shared archive location for relative depot map paths to use. For example,

    p4 configure set master#server.depot.root=/data/depots
    p4 configure set replica#server.depot.root=/data/depots

    Note

    Review any absolute depot map paths to ensure the replica server has access to write files to that absolute shared archive location. The replica server enforces correct lbr.replication settings when archives are being shared. Therefore, the replica server needs to write files to the shared archive locations noted by any depot map paths. See Providing map information in Helix Core Command-Line (P4) Reference.

  4. Set lbr.replication=shared either in the replica's server spec or manually using a command similar to this:

    p4 configure set replica#lbr.replication=shared

  5. Restart the replica.

Result

The result of this configuration:

  • commands that would schedule the transfer of file content, such as p4 pull -u and p4 verify -t are rejected

  • if startup configurables, such as startup.N=pull -u, are defined, the replica server attempts to run such commands. Because the attempt to retrieve archive content is rejected, the replica’s server log will contain an error similar to this:

    Perforce server error:
        2023/11/03 09:08:22 pid 87949 service-od@21131 background [p4d/2023.1/LINUX26X86_64/2442900] 'pull -u -i 1'
        This command is not used with a replica server which uses lbr.replication=shared.

See also

Replication checks