P4 Code Review integration properties

Property

Meaning

Since P4V Version

P4.Swarm.URL

Set to the URL for the P4 Code Review server to enable the integration with P4V.

2014.3

P4.Swarm.URL.xxxx

If multiple P4 Code Review servers exist, include the serverid, which is represented by xxxx.

2015.1

P4.Swarm.Timeout

Set the timeout value for the P4V integration with P4 Code Review. By default, this is 10 seconds.

2014.3

Configure P4 Code Review connections

For P4V to connect to a P4 Code Review server, it must know where the server is installed. Because P4 Code Review is a web application, a URL can specify its location.

The P4 Code Review or P4V administrator uses the P4.Swarm.URL.xxxx property to specify the location of a P4 Code Review server.

  • To identify the location of a single P4 Code Review server, use either the P4.Swarm.URL or the P4.Swarm.URL.xxxx syntax, depending on whether the server has a serverid. For example, the following command specifies that the location of the server given by 10.5.40.145:1666 is https://my_swarm_server.com.

    p4 -p "10.5.40.145:1666" property -a -n P4.Swarm.URL -v "https://my_swarm_server.com"
  • To identify the location of several P4 Code Review server instances, use the P4.Swarm.URL.xxxx syntax, and specify the server id for each P4 Code Review server each time you invoke the p4 property command. For example:

    p4 -p "10.5.40.145:1666" property -a -n P4.Swarm.URL.svr1 -v "https://my_swarm_server1.com"
    p4 -p "10.5.40.145:1667" property -a -n P4.Swarm.URL.svr2 -v "https://my_swarm_server2.com"

    Using the server id format is only necessary if you are using a Centralized authorization server (P4AUTH) or if you are deploying multiple instances of P4 Code Review against replicas or edge servers.

When P4V attempts to connect to a server that has no serverid, it checks to see if the property P4.Swarm.URL is set, and it uses that URL to access P4 Code Review. If the property is not set, P4V does not attempt to access the P4 Code Review.

When P4V attempts to connect to a server that has a serverid,

  1. P4V asks the server for its server id and gets, for example, svr1.
  2. P4V checks the setting of P4.Swarm.URL.svr1, and it uses that URL to attempt to access P4 Code Review server.
  3. If P4.Swarm.URL.svr1 is not set, P4V checks the value of P4.Swarm.URL and uses that value to attempt to access the P4 Code Review server.
  4. If P4.Swarm.URL is not set, P4V does not attempt to access the P4 Code Review.

If there is a value both for both URLs when P4V attempts to connect to a P4 Code Review server, the serverid match takes precedence.

The user issuing the p4 property command must have an account on the specified P4 Code Review server.

You can use the p4 property command to list the current properties of the P4 Code Review server; for example:

p4 -p "10.5.40.145:1666" property -l -A
 P4.Swarm.Timeout = 10 (any) #1
 P4.Swarm.URL.main-1666 = https://my_swarm_server1.com