p4 admin

Synopsis

Syntax

Description

To stop the server, use p4 admin stop. This locks the database to ensure that it is in a consistent state upon server restart, and then shuts down the Perforce background process. (For Windows users, this works whether you are running Perforce as a server or a service.)

To take a checkpoint, use p4 admin checkpoint [prefix]. This is equivalent to logging in to the server machine and taking a checkpoint with p4d -jc [prefix]. A checkpoint is taken and the journal is copied to a numbered file. If a prefix is specified, the files are named prefix.ckp.n or prefix.jnl.n respectively, where n is a sequence number. You can store checkpoints and journals in the directory of your choice by specifying the directory as part of the prefix. (Rotated journals are stored in the P4ROOT directory, regardless of the directory in which the current journal is stored.) If no prefix is specified, the default filenames checkpoint.n and journal.n are used.

Use the -z option to save the checkpoint and journal files in compressed form.

The p4 admin journal command is equivalent to p4d -jj. For details, see the System Administrator's Guide.

The files are created in the server root specified when the Perforce server was started.

Options

-z	For p4 admin checkpoint, save the checkpoint and saved journal file in compressed (gzip) format, appending the .gz suffix to the files.
g-opts	See the Global Options section.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
N/A	N/A	super

• Because p4 admin stop shuts down the Perforce server, you may see an error message indicating that the connection between the client and server was closed unexpectedly. You can ignore this message.

• For more about administering Perforce, see the Perforce System Administrator's Guide.

Examples

p4 admin stop	Stop the Perforce server
p4 admin checkpoint	Create a checkpoint named checkpoint.n, and start a new journal named journal, copying the old journal file to journal.n, where n is a sequence number.
p4 admin checkpoint name	Create a checkpoint named name.ckp.n, and start a new journal named journal, copying the old journal file to name.jnl.n, where n is a sequence number.