Perforce 2006.1 Command Reference
<< Previous Chapter
p4 add
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 annotate

p4 admin

Synopsis

Perform administrative operations on the server.

Syntax

p4 [g-opts] admin checkpoint [-z ] [ prefix ]
p4 [g-opts] admin journal [-z ] [ prefix ]
p4 [g-opts] admin stop

Description

The p4 admin command allows Perforce superusers to perform administrative tasks whether they are on the host running the Perforce server or not.

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

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.


Perforce 2006.1 Command Reference
<< Previous Chapter
p4 add
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 annotate
Please send comments and questions about this manual to [email protected].
Copyright 1999-2006 Perforce Software. All rights reserved.
Last updated: 06/23/06