Perforce 2007.3 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 dbstat [ -h ] [ -a | dbtable... ]
p4 [g-opts] admin journal [ -z ] [ prefix ]
p4 [g-opts] admin stop
p4 [g-opts] admin updatespecdepot [ -a | -s type ]

Description

The p4 admin command allows Perforce superusers to perform administrative tasks even when working from a different machine than the one running the Perforce Server.

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-1 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-1 are used.

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.

The p4 admin dbstat command displays statistics on the internal state of the Perforce Server's database. The dbtable correspond to the db.* files in your server's root directory. This command is typically used in conjunction with Perforce technical support for purposes of estimating disk seeks due to sequential database scans.

The p4 admin updatespecdepot command causes the Perforce Server to archive stored forms (specifically, client, depot, branch, label, typemap, group, user, and job forms) into the spec depot. If the -a flag is used, all of the form specification types are archived. If the -s flag option is used, then only those of the specified type are archived. Only those forms that have not yet been archived are created.

Options

-z

For p4 admin checkpoint and p4 admin journal, save the checkpoint and saved journal file in compressed (gzip) format, appending the .gz suffix to the files.

-h

For p4 admin dbstat, display a histogram showing distances between leaf pages.

-a

For p4 admin dbstat, display statistics for all tables.

For p4 admin updatespecdepot, update the spec depot with all current forms.

dbtable

For p4 admin dbstat, display statistics for only the specified tables (for instance, db.have, db.user, and so on.)

-s type

For p4 admin updatespecdepot, update the spec depot with forms of the specified type, where type is one of client, depot, branch, label, typemap, group, user, or job.

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-1, 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-1, where n is a sequence number.


Perforce 2007.3 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-2007 Perforce Software. All rights reserved.
Last updated: 11/29/07