Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Option

Description

Anchor
perforcePortOptionDescription
perforcePortOptionDescription
Port

Specify the Perforce server address. The format is host:port.

Anchor
perforceClientOptionDescription
perforceClientOptionDescription
Client

Click this radio button to directly specify the client workspace. The workspace should already be created by Perforce client applications like P4V or P4Win. Only mapping rules are used from the configured client workspace. The client name is ignored.

Warning
titlePerformance impact

When this option is used, internal TeamCity source caching on the server side is disabled, which may worsen the performance of clean checkouts. For maximum performance, we recommend using Client Mapping option (see below)

Anchor
perforceClientMappingOptionDescription
perforceClientMappingOptionDescription
Client Mapping

Click this radio button to specify the mapping of the depot to the client computer.
If you have Client mapping selected, TeamCity handles file separators according to OS/platform of a build agent where a build is run. To enforce specific line separator for all build agents, use Client having LineEnd option specified in Perforce instead of Client mapping. Alternatively you can add an agent requirement to run builds only on specific platform.

Info
titleTip

Use team-city-agent instead of the client name in the mapping.

Example:

Code Block
//depot/MPS/... //team-city-agent/...
//depot/MPS/lib/tools/... //team-city-agent/tools/...

Anchor
perforceUserOptionDescription
perforceUserOptionDescription
User

Specify the user login name.

Anchor
perforcePasswordOptionDescription
perforcePasswordOptionDescription
Password

Specify the password.

Anchor
perforceCharsetOptionDescriptionperforcePathtop4ExecutableOptionDescriptionperforceCharsetOptionDescription
Charset
Select the character set used on the client computer.
perforcePathtop4ExecutableOptionDescription
Path to P4 executable

Specify the path to the Perforce command-line client: p4.exe file).

Anchor
perforceTicketBasedAuthenticationOptionDescription
perforceTicketBasedAuthenticationOptionDescription
Ticket-based authentication

Check this option to enable ticket-based authentication.

Anchor
perforcePathtop4ExecutableOptionDescriptionperforceCharsetOptionDescriptionperforcePathtop4ExecutableOptionDescription
Path to Perforce Command-Line Client Specify the path to the Perforce Command-Line Client (usually, it's p4.exe file).
perforceCharsetOptionDescription
Charset

Select the character set used on the client computer.

Support UTF-16 encoding

Enable this option if you have UTF-16 files in your project.

Workspace options for checkout on agent

If needed, you can set here the following options for p4 client command: Options, SubmitOptions, and LineEnd.

Info

To customize the workspace name when using client side checkout add following configuration parameter at the Build Parameters page:
teamcity.perforce.workspace.prefix

Excerpt Include
TCD65:ClearCase
TCD65:ClearCase
nopaneltrue

...