p4 configure

Set and manage server configuration variables.

Syntax

p4 [g-opts] configure set [P4NAME#|server_id#]variable=value
p4 [g-opts] configure unset [P4NAME#|server_id#]variable
p4 [g-opts] configure show [allservers | P4NAME | variable]

Description

Configuration variables are used to control and customize the behavior of the Perforce service.

The configuration variables are described in:

Configurable settings might affect the client, the server, or a proxy.

The p4 configure command provides one way to change the configuration of an active server. For information on how you set configurables that affect the client or the proxy, see Configurables.

You can set configurables in the following ways for the server; methods are shown in order of precedence:

Use p4 configure show to display the configuration state of the current server, a named server, or any configurable. Each configurable is displayed along with its value and an indication of what method was used to set it. Use p4 configure unset to unset the value of a configurable.

After installing Perforce, it is good practice to enable process monitoring by setting monitor to 1 or 2, require ticket-based authentication by setting security to 3 or 4, and preventing the automatic creation of new users by setting dm.user.noautocreate to 1 or 2. Setting dm.user.resetpassword to 1 is also advisable; new users that you create (and to whom you assign an initial password) are forced to reset their passwords before they can issue commands.

Static, dynamic, and read-only configurables

Changes to dynamic configurables take effect the next time the server receives a new connection. Changes to static configurables, require a server restart. Values of read-only configurables may not be changed.

Changes to most configurables take effect immediately; for example, you do not have to restart the service in order for changes to configurables such as monitor (enable/disable the p4 monitor command) or security (set the security level) to take effect.

Changes to P4AUTH, P4PORT, the startup.n configurables used in replicated environments, net.tcpsize, and net.backlog require a restart.

To restart the server, use p4 admin restart.

Setting configurables in distributed environments

Servers can be identified by name. In replicated and distributed environments, a master can control the settings of multiple replicas by specifying the server name as part of the configurable. For example, the following command sets the value of the serviceUser configurable for an edge server (tokyo_edge). The command is executed on the commit server.

$ p4 set tokyo_edge#serviceUser=svc_tokyo_edge

See Helix Versioning Engine Administrator Guide: Multi-Site Deployment for details.

Accessing configurables when the server is down

If the Helix server is not running or you cannot access the server, you can use the p4d command to list, set, and unset server configurables:

For more information, see Accessing Server Configuration Variables:

http://answers.perforce.com/articles/KB_Article/Accessing-Server-Configuration-Variables

Options

set variable=value

Sets the named variable to the provided value.

unset variable

Unsets the named variable.

show

Shows the current configuration of the server currently specified by P4PORT.

Note

Regarding the maximum size of the db.monitor table, see db.monitor.shared configurable, and note that p4 configure show indicates the actual maximum, but p4 configure show allservers indicates a manual preference that is only enforced if sufficient memory is available.

show allservers

Shows the configuration variables for all servers known to the system.

show variable

Shows the setting of a specific configuration variable.

show P4NAME

If a Helix server was invoked with -InP4NAME or with the P4NAME environment variable set to a server name, shows the settings of the named server.

g-opts

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

super

Related Commands

To list all counters and their values

The p4 configure command replaces many of the settings formerly set by p4 counter.

p4 counters