Preface
This guide (previously titled Perforce Server Administrator Guide: Fundamentals) describes the installation, configuration, and management of the Helix versioning engine (Perforce server). This guide covers tasks typically performed by a system administrator (for instance, installing and configuring the software and ensuring uptime and data integrity), as well as tasks performed by a Perforce administrator, such as setting up Perforce users, configuring Perforce depot access controls, resetting Perforce user passwords, and so on.
This guide focuses on the installation, configuration, and management of a single Perforce server. For information on the installation, configuration, and management of multiple distributed servers as well as of proxies and brokers, see Helix Versioning Engine Administrator Guide: Multi-site Deployment
Because Perforce requires no special system permissions, a Perforce administrator does not typically require root-level access. Depending on your site’s needs, your Perforce administrator need not be your system administrator.
Both the UNIX and Windows versions of the Perforce service are administered from the command line. To familiarize yourself with the Perforce Command-Line Client, see the P4 Command Reference.
About this manual
This manual includes the following chapters:
Chapter | Contents |
---|---|
Discusses the basic client-server architecture for connected and disconnected clients. Describes the basic administration workflows for installing, configuring, and managing the Perforce server. |
|
Describes how to install the Perforce service or upgrade an existing installation |
|
Explains basic configuration options for enabling DVCS, accepting client requests, case sensitivity, logging, and P4V settings. |
|
Explains how you work with each type of depot to organize and archive your work. |
|
Explains how you encrypt client-server communication and how you authenticate and authorize users. |
|
Explains how you back up and recover versioned data and Perforce meta data. |
|
Describes how you can monitor the Perforce server and its use of system resources: disk space, processes, commands, locked files, user file access, and logging. |
|
Provides information about managing code sharing, distributed development, users, changelists, disk space, processes, and Windows deployments. |
|
Outlines some of the factors that can affect the performance of a Perforce server, provides a few tips on diagnosing network-related difficulties, and offers some suggestions on decreasing server load for larger installations. |
|
Explains how jobs enable users to link changelists to enhancement requests, problem reports, and other user-defined tasks. Describes the template that defines jobs and explores the use of third party defect tracking systems. |
|
Explains how you use different kids of scripts to customize the behavior of server processing. |
|
Provides complete reference information for the command used to start and configure the Perforce server. |
|
Explains how you move an existing Perforce server from one machine to another . |
|
Provides license information. |
What’s new in this guide for the 2016.1 release
This section provides a list of changes to this guide for the Perforce Server 2016.1 release. For a list of all new functionality and major bug fixes in Perforce Server 2016.1, see the Perforce Server 2016.1 Release Notes.
Major changes
- Updates to information about triggers
-
The following information has been added:
- How the content of
%submitserverid%
changes depending on the deployment where the submit happens. See Trigger script variables for more information. - Triggers for commands that respond to pushes and fetches. For information, see Additional triggers for push and fetch commands
- The use of TMP and TEMP variables when using triggers on Windows. For more information, see Execution environment.
- Which environment variables you can access from a trigger. See Execution environment for more information.
- Clarification about the use of timeouts with triggers. See Execution environment for more information.
- Clarification about using the
p4 diff2
command in a change content trigger. See Triggering on submits for more information. - The
%specdef%
variable is defined for form triggers It is expanded to the spec string of the form in question. This allows derived APIs to parse forms as part of triggers by loading the spec string as an argument. See Triggering on forms for more information.
- How the content of
Minor changes
- Allow the Perforce Windows service to run under a regular user account
- Information has been added to explain how this can be done. See Windows services and servers for more information.
- Clarification of the use of a prefix with the -jc option
- For more information, see Creating a checkpoint.
- You can use a file path to specify a structured log file
- See Enabling structured logging for more information.
- A new
route.csv
structured log - Log the full network route of authenticated client connections. Errors
related to
net.mimcheck
are also logged against the related hop. See Enabling structured logging for more information. - Only static labels need to be unloaded
- See Unload old client workspaces, labels, and task streams for more information.
- Rebalancing database trees
- New information has been added. See Other server configurables for more information.
- Best to store journal files and checkpoints on different drives
- See Usage Notes for more information.
Helix documentation
The following table lists and describes key documents for Helix users, developers, and administrators. For complete information see the following:
http://www.perforce.com/documentation
For specific information about… | See this documentation… |
---|---|
Introduction to version control concepts and workflows; Helix architecture, and related products. |
|
Using the command-line interface to perform software version management and codeline management; working with Helix streams; jobs, reporting, scripting, and more. |
|
Basic workflows using P4V, the cross-platform Helix desktop client. |
|
Working with personal and shared servers and understanding the distributed versioning features of the Helix Versioning engine. |
|
|
P4 Command Reference, |
Installing and administering the Helix versioning engine, including user management, security settings. |
|
Installing and configuring Helix servers (proxies, replicas, and edge servers) in a distributed environment. |
Helix Versioning Engine Administrator Guide: Multi-site Deployment |
Helix plug-ins and integrations. |
IDEs: Using IDE Plug-ins |
Developing custom Helix applications using the Helix C/C++ API. |
|
Working with Helix in Ruby, Perl, Python, and PHP. |
Syntax conventions
Helix documentation uses the following syntax conventions to describe command line syntax.
Notation | Meaning |
---|---|
|
Monospace font indicates a word or other notation that must be used in the command exactly as shown. |
italics |
Italics indicate a parameter for which you must supply specific information. For example, for a serverid parameter, you must supply the id of the server. |
[ |
Square brackets indicate that the enclosed elements are optional. Omit the brackets when you compose the command. Elements that are not bracketed are required. |
… |
Ellipses (…) indicate that the preceding element can be repeated as often as needed. |
element1 | element2 |
A vertical bar ( | ) indicates that either element1 or element2 is required. |
Please give us feedback
We are interested in receiving opinions on this manual from our users. In particular, we’d like to hear from users who have never used Perforce before. Does this guide teach the topic well? Please let us know what you think; we can be reached at [email protected].
If you need assistance, or wish to provide feedback about any of our products, contact [email protected].