Configure Perforce repository using template

You should have Perforce client installed on the build machine. Contact http://www.perforce.com for licensing information. Here is the list of properties you need to configure in order to set up a Perforce repository using template

Perforce port

The Perforce port in the format of <port>, or <servername>:<port>, where <servername> and <port> will be replaced by the actual Perforce server name and the port number.

User name

User name to access the above Perforce server. This user should have the rights to create and edit client specifications and to checkout and label code.

Password

Password for the above user. Can be blank, if your Perforce server does not use password based security.

Template client name

Specify name of the Perforce client which will be used as template for this repository. When checkout, QuickBuild will create a new client with the specification, options and line ending the same as the client template specified here. But the root directory will be choosed by QuickBuild internally based on settings of the active configuration. Name of the new client is also determined by QuickBuild (see below property).

Client name

Optionally specify name of the client which will be created by QuickBuild to check out code for build. If not specified, this name will be generated automatically.

[Warning]Warning

It is suggested that you leave this value empty here to let QuickBuild determines the client name based on current checkouts directory to avoid potential conflicts.

Label (or change number) to checkout

Specify the label or change number to checkout. If not specified, head revision of specified template client will be retrieved.

Perforce client options

Specifies options when create Perforce client. Valid options are: allwrite, clobber, compress, locked, modtime, rmdir. Different options should be separated by spaces.

Line end

Set line ending character(s) for client text files. The following values are possible:

local: use mode native to the client
unix: UNIX style
mac: Macintosh style
win: Windows style
share: writes UNIX style but reads UNIX, Mac or Windows style

This property is optional. If not specified, the value will default to "local".

Ignore existing label spec?

Specifies whether or not to ignore existing label spec when the label created by QuickBuild is already exist in Perfoce depot. If this value is set "yes", existing label spec will be discarded when apply new label spec; otherwise, new client spec will be appended to existing label spec.

[Note]Note

This property only takes effect when QuickBuild tries to create label on this repository (though the label step).

Lock label?

Specifies whether or not to check the lock option when create label in Perforce depot.

[Note]Note

This property only takes effect when QuickBuild tries to create label on this repository (through the label step).

Path to p4 executable

Specify path to your p4 executable file, for example: /usr/local/bin/p4. It should be specified here, if it does not exist in the system path.

Revision log base build version

Specify version of the build since which the revision log will be retrieved. If left empty, revision log will not be retrieved.

Quiet period

Number of seconds the current repository should be quiet (without checkins) before QuickBuild decides to check out the code from this repository for a build. This is used to avoid checking out the code in the middle of some other checkins. This property is optional. When set as 0, quiet period will not be used before checking out the code to build.

Login mapping

Choose login mapping for this repository. Login mapping is used to map repository login to QuickBuild user. It can be configured at "login mappings" tab of the configuration.