p4 server
Synopsis
Create, modify, or delete a Perforce server specification.
Syntax
p4 [g-opts
] server
serverID
p4 [g-opts
] server -g
p4 [g-opts
] server -d
serverID
p4 [g-opts
] server -o [-l]
serverID
p4 [g-opts
] server -i [-c edge-server|commit-server]
p4 [g-opts
] server -c edge-server|commit-server serverID
Description
A server specification describes the high-level configuration and intended usage of a Perforce server. For installations with only one Perforce server, the server specification is optional.
The p4 server
command puts the server spec into a temporary file and
invokes the editor configured by the P4EDITOR
variable. Saving
the file creates or saves changes to the server specification.
The ClientDataFilter:
, RevisionDataFilter:
, and ArchiveDataFilter:
fields are intended for use in replicated environments where you wish to
filter out unnecessary data. (For instance, a build farm replica has
little need to replicate the state, including the have list, for every
open client workspace on the master server.) For further information
about filtering in replicated environments, see Helix Versioning Engine Administrator Guide: Multi-site Deployment.
Warning
It is best if ArchiveDataFilter:
is kept static. You must reseed the
server if you change this filter.
An operator type user may not execute this command.
Form Fields
Field Name | Type | Description |
---|---|---|
|
Read-only |
A unique identifier for this server. This must match the contents of
the server’s If the server type is |
|
Writable |
Server executable type. One of the following:
Each type may offer one or more services. See next. |
|
Writable |
The
The The
The The
|
|
Writable |
The You can leave this blank or you can set it to the same value as the serverid. |
|
Writable |
The |
|
Writable |
For an edge server, this optional field specifies the external address used for connections to a commit server. This field must be set for the edge server to enable parallel submits in a federated environment. |
|
Writable |
An optional description for this server. |
|
Writable |
The service user name used by the server. For additional information about the use of this field, see the section "Service users" in the chapter "Perforce Replication" in Helix Versioning Engine Administrator Guide: Multi-site Deployment. |
|
Writable |
For a replica server, this optional field can contain one or more patterns describing how active client workspace metadata is to be filtered. Active client workspace data includes have lists, working records, and pending resolves. To include client data, use the syntax:
To exclude client data, use the syntax:
All patterns are specified in client syntax. |
|
Writable |
For a replica server, this optional field can contain one or more patterns describing how submitted revision metadata is to be filtered. Submitted revision data includes revision records, integration records, label contents, and the files listed in submitted changelists. To include depot data, use the syntax:
To exclude depot data, use the syntax:
All patterns are specified in depot syntax. |
|
Writable |
For a replica server, this optional field can contain one or more patterns describing the policy for automatically scheduling the replication of file content. If this field is present, only those files described by the pattern are automatically transferred to the replica; other files are not transferred until they are referenced by a replica command that needs the file content. Files specified in the To automatically transfer files on submit, use the syntax:
To exclude files from automatic transfer, use the syntax:
All patterns are specified in depot syntax. WarningIt is best if this filter is kept static. You must reseed the server if you change this filter. |
|
Writable |
For an edge or commit server, this optional field, which is displayed only
when you use the
If this field is present when invoked with |
Options
|
Set or change configuration values used to set up the distributed environment
on an edge or commit server. The specified service dictates which configuration
values can be set. Configuration fields are initially populated with the
configured values if set, default values if unset, or After exiting from the form, any configuration commands in this field will be
run on the current server for the scope of the For more information, see the section "Shortcuts to configuring the server" in Helix Versioning Engine Administrator Guide: Multi-site Deployment. |
|
Delete the named server specification. |
|
Generate a new serverID as part of the form. |
|
Read a server specification from standard input. You can combine this option with the |
|
Use with |
|
Write the named server specification to standard output. |
|
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 |
see discussion below |
Only super can run p4 server
in update mode (using -i
, -g
,
and -d
options). Non-operators can run p4 server
in non-update
mode (using -o
or -o
-g
options). Operators cannot run p4
server
at all.