p4 configure
Synopsis
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
p4 help configurables
, in p4 help environment
, and in
“Configurables”. 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:
-
As command line options that are passed at server startup. For example:
$ p4d -v net.keepalive.idle=2700
-
Persistently, using the
p4 configure set
command.This method allows you to set the specified configurable for a named server or for any server.
-
Using environment variables.
When set using environment variables, certain server-related configurables are read-only; you cannot change
P4ROOT
orP4JOURNAL
withp4 configure
. - On Windows using the
p4 set
command. - On Unix, using the
export
command. - Using default values, by taking no action.
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.
configurables used in replicated environments, n
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 Perforce server is not running or you cannot access the server,
you can use the p4d
command to list, set, and unset server
configurables:
-
To list all server configuration variables, use the
-cshow
option. For example:$ p4d -r $P4ROOT -cshow
-
To set or unset values, use
-cset
or-cunset
. For example:$ p4d -r $P4ROOT "-cset myServer#auth.ldap.timeout=30" $ p4d -r $P4ROOT "-cunset myServer#db.replication"
For more information, see Accessing Server Configuration Variables:
http://answers.perforce.com/articles/KB_Article/Accessing-Server-Configuration-Variables
Options
|
Sets the named variable to the provided value. |
|
Unsets the named variable. |
|
Shows the current configuration of the server currently specified by
|
|
Shows the configuration variables for all servers known to the system. |
|
Shows the setting of a specific configuration variable. |
|
If a Perforce server was invoked with |
|
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 |
|