In this section:
General Source Control Settings
scontrol.timeout
This setting specifies the timeout value for operations with source control.
Acceptable Values
| [secods] | The timeout for operations with your source control system. The default value is 60. |
|---|
scontrol.branch
This setting specifies a custom name for the tested branch. This setting may be used to describe unique runs. If it is not specified, the tested branch is detected automatically based on code provided for analysis.
Acceptable Values
| [name] | The name of the tested branch. |
|---|
Git Source Control Settings
If you are going to report authorship information from Git to DTP, the cloned repository should not be shallow. A Git repository is considered shallow if the file .git/shallow exists. Git may not accurately produce authorship data when checking out shallow clones from a repository. You should check out full clones to retrieve accurate authorship information.
scontrol.rep{n}.type
This setting specifies that the repository type is Git.
Acceptable Values
| git | The Git repository identifier. |
|---|
scontrol.git.exec
This setting specifies the path to git executable. If not set, assumes git command is on the PATH.
Acceptable Values
| [path] | The path to the git executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.git.url
This setting specifies the remote repository URL.
Acceptable Values
| [URL] | The URL to the remote repository. |
|---|
Example Usage
scontrol.rep1.git.url=git://hostname/repo.git
scontrol.rep{n}.git.workspace
This setting specifies the directory that contains the local git repository.
Acceptable Values
| [path] | The path to the directory with the local git repository. |
|---|
Use double backslashes to specify the file path on Windows.
Shallow Clones
A Git repository is considered shallow if the file .git/shallow exists. Git may not accurately produce authorship data when checking out shallow clones from a repository. You should check out full clones to retrieve accurate authorship information.
Mercurial Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Mercurial.
Acceptable Values
| hg | The Mercurial repository identifier. |
|---|
scontrol.hg.exec
This setting specifies the path to the external client executable.
Acceptable Values
| [path] | The path to the external client executable (the default is hg). |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.hg.url
This setting specifies the remote repository URL.
Acceptable Values
| [URL] | The URL to the remote repository. |
|---|
Example Usage
scontrol.rep1.hg.url=http://hostname/path
scontrol.rep{n}.hg.workspace
This setting specifies the directory that contains the local Mercurial repository.
Acceptable Values
| [path] | The path to the directory with the local Mercurial repository. |
|---|
Use double backslashes to specify the file path on Windows.
Perforce Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Perforce.
Acceptable Values
| perforce | The Perforce repository identifier. |
|---|
scontrol.perforce.exec
This setting specifies the path to the external client executable.
Acceptable Values
| [path] | The path to the external client executable (the default is p4). |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.perforce.host
This setting specifies the Perforce server host.
Acceptable Values
| [host_name] | The Perforce server host name. |
|---|
scontrol.rep{n}.perforce.port
This setting specifies Perforce server port.
Acceptable Values
| [port_number] | The Perforce server port number. The default port is 1666. |
|---|
scontrol.rep{n}.perforce.login
This setting specifies the Perforce user name.
Acceptable Values
| [user_name] | The Perforce user name. |
|---|
scontrol.rep{n}.perforce.password
This setting specifies user's password to Perforce (optional if the ticket is used for authentication).
Acceptable Values
| [password] | The password to the Perforce source control. |
|---|
scontrol.rep{n}.perforce.client
This setting specifies the client workspace name as specified in the P4CLIENT environment variable or its equivalents. The root directory for specified workspace should be configured correctly for the local machine.
Acceptable Values
| [client] | The client workspace name. |
|---|
Subversion Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Subversion.
Acceptable Values
| svn | The Subversion repository identifier. |
|---|
scontrol.svn.exec
This setting specifies the path to an external client executable (svn).
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.svn.url
This setting specifies the protocol, server name, port and starting repository path.
The URL should not include the project name and a trailing slash (/) to ensure that DTP can properly process information about your files.
Acceptable Values
| [URL] | The URL. |
|---|
Example Usage
scontrol.rep1.svn.url=svn://buildmachine.foobar.com/home/svn
scontrol.rep{n}.svn.login
This setting specifies the Subversion user name.
Acceptable Values
| [user_name] | The Subversion user name. |
|---|
scontrol.rep{n}.svn.password
This setting specifies user's password to Subversion (not encoded).
Acceptable Values
| [password] | The password to the Subversion source control. |
|---|
scontrol.rep.svn.branch
This setting allows you to specify the SVN branch if the branch name is not automatically detected. This may occur when your Subversion repository structure is other than the recommended layouts.
Acceptable Values
| [name] | The name of the tested branch |
|---|
Example Usage
scontrol.rep.svn.branch=myproject-release20170115
Microsoft Team Foundation Server Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Team Foundation Server.
Acceptable Values
| tfs | The TFS repository identifier. |
|---|
scontrol.rep{n}.tfs.url
This setting specifies the URL to TFS repository.
Acceptable Values
| [URL] | The URL to the TFS repository. |
|---|
Example Usage
scontrol.rep{n}.tfs.url=http://localhost:8080/tfs
scontrol.rep{n}.tfs.login
This setting specifies the TFS username.
Ensure you provide the same username that you used to configure the TFS repository on your machine.
Acceptable Values
| [user_name] | The TFS username. |
|---|
scontrol.rep{n}.tfs.password
This setting specifies user's password to TFS .
Acceptable Values
| [password] | The password to the TFS source control. |
|---|
Deprecated Source Control Management Systems
AccuRev Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is AccuRev.
Acceptable Values
| accurev | The AccuRev repository identifier. |
|---|
scontrol.accurev.exec
This setting specifies the path to an external client executable (accurev).
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.accurev.host
This setting specifies the AccuRev server host.
Acceptable Values
| [host_name] | The AccuRev server host name. |
|---|
scontrol.rep{n}.accurev.port
This setting specifies AccuRev server port.
Acceptable Values
| [port_number] | The AccuRev server port number. The default port is 1666. |
|---|
scontrol.rep{n}.accurev.login
This setting specifies the AccuRev user name.
Acceptable Values
| [user_name] | The AccuRev user name. |
|---|
scontrol.rep{n}.accurev.password
This setting specifies user's password to AccuRev.
Acceptable Values
| [password] | The password to the AccuRev source control. |
|---|
ClearCase Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is ClearCase.
Acceptable Values
| ccase | The ClearCase repository identifier. |
|---|
scontrol.ccase.exec
This setting specifies the path to an external client executable (cleartool).
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.ccase.vob
This setting specifies the VOB's mount point - the path at which the VOB will be accessed by the user.
Acceptable Values
| [path] | The path to the VOB's mount point . |
|---|
Use double backslashes to specify the file path on Windows.
Example Usage
scontrol.rep.ccase.vob=X:\\myvob
scontrol.rep.ccase.vob=/vobs/myvob
scontrol.rep{n}.ccase.vob_tag
This setting specifies the VOB's unique tag in the ClearCase network region.
Acceptable Values
| [tag] | The tag VOB unique tag. |
|---|
CVS Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is CVS.
Acceptable Values
| cvs | The CVS repository identifier. |
|---|
scontrol.rep{n}.cvs.root
This setting specifies the full CVSROOT value.
Acceptable Values
| [root_value] | The CVSROOT value. |
|---|
scontrol.rep{n}.cvs.pass
This setting specifies the plain or encoded password. The encoded password should match password in the .cvspass file.
- For CVS, use the value in .cvspass from within the user's home directory.
- For CVSNT, use the value store in the registry under HKEY_CURRENT_USER\Software\Cvsnt\cvspass
The password is saved in the registry when you first log into the CVS repository from the command line using cvs login. To retrieve the password, go to the registry (using regedit) and look for the value under HKEY_CURRENT_USER->CVSNT> cvspass. This displays your entire login name (e.g., :pserver:exampleA@exampleB:/exampleC) and encrypted password value.
Acceptable Values
| [password] | The CVSROOT value. |
|---|
scontrol.rep{n}.cvs.useCustomSSHCredentials
This setting enables or disables using the cvs login and password for EXT/SSH connections.
Acceptable Values
| true | Enables using credentials for for EXT/SSH connections |
|---|---|
| false | Default. Disables using credentials for for EXT/SSH connections |
scontrol.rep{n}.cvs.ext.server
This setting specifies which CVS application to start on the server side if connecting to a CVS server in EXT mode and has the same meaning as the CVS_SERVER variable.
Acceptable Values
| [cvs_aplication_name] | The CVS application name. The defualt is cvs. |
|---|
scontrol.rep{n}.cvs.ssh.loginname
This setting specifies the login for SSH connections (if an external program can be used to provide the login).
Acceptable Values
| [login] | The login used for SSH connections. |
|---|
scontrol.rep{n}.cvs.ssh.password
This setting specifies the password for SSH connections.
Acceptable Values
| [password] | The password used for SSH connections. |
|---|
scontrol.rep{n}.cvs.ssh.keyfile
This setting specifies the private key file to establish an SSH connection with key authentication.
Acceptable Values
| [file] | The key file to establish an SSH connection. |
|---|
scontrol.rep{n}.cvs.ssh.passphrase
This setting specifies the passphrase for SSH connections with the key authentication mechanism.
Acceptable Values
| [passphrase] | The passphrase. |
|---|
scontrol.rep{n}.cvs.useShell
This setting specifies enables or disables an external program (CVS_RSH) to establish a connection to the CVS repository.
Acceptable Values
| true | The external program is enabled. |
|---|---|
| false | Default. The external program is disabled. |
scontrol.rep{n}.cvs.ext.shell
This setting specifies the path to the executable to be used as the CVS_RSH program. Command line parameters should be specified in the cvs.ext.params property.
Acceptable Values
| [path] | The path to the executable that is used as the CVS_RSH program . |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.cvs.ext.params
This setting the parameters to be passed to an external program. The following case-sensitive macro definitions can be used to expand values into command line parameter:
- {host}: repository host
- {port}: port
- {user}: cvs user
- {password}: cvs password
- {extuser}: parameter cvs.ssh.loginname
- {extpassword}: parameter cvs.ssh.password
- {keyfile}: parameter cvs.ssh.keyfile
- {passphrase}: parameter cvs.ssh.passphrase
Serena Dimensions Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Serena Dimensions.
Acceptable Values
| serena | The Serena Dimensions repository identifier. |
|---|
scontrol.serena.dmroot
This setting specifies the path to an external client executable.
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
Example Usage
scontrol.serena.dmroot=C\:\\Program\ Files\ (x86)\\Serena\\Dimensions\ 2009\ R2\\CM\\
scontrol.rep{n}.serena.login
This setting specifies the Serena user name.
Acceptable Values
scontrol.rep{n}.serena.password
This setting specifies user's password to Serena Dimensions.
Acceptable Values
| [password] | The password to the Serena Dimensions source control. |
|---|
scontrol.rep{n}.serena.host
This setting specifies the Serena server host.
Acceptable Values
| [host_name] | The Serena server host name. |
|---|
scontrol.rep{n}.serena.dbname
This setting specifies the name of the database for the product you are working with.
Acceptable Values
| [name] | The name of the database. |
|---|
scontrol.rep{n}.serena.dbconn
This setting specifies the connection string for the database specified with the scontrol.rep{n}.serena.dbname opion.
Acceptable Values
| [connection_string] | The connection string for the database. |
|---|
scontrol.rep{n}.serena.locale
This setting specifies the language that will be used,
Acceptable Values
| [language_identifier] | The identifier of the language that will be used. |
|---|
Example Usage
scontrol.rep{n}.serena.locale=en_US
scontrol.rep{n}.serena.mapping
If the project has been downloaded/moved to a location other than default work area, use this option to specify a mapping between the project or stream with the Serena repository and the local project. If you are working in the default work area, you do not need to define mappings.
StarTeam Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is StarTeam.
Acceptable Values
| starteam | The StarTeam repository identifier. |
|---|
scontrol.rep{n}.starteam.host
This setting specifies the StarTeam server host.
Acceptable Values
| [host_name] | The StarTeam server host name. |
|---|
sscontrol.rep{n}.starteam.port
This setting specifies StarTeam server port.
Acceptable Values
| [port_number] | The StarTeam server port number. The default port is 49201. |
|---|
scontrol.rep{n}.starteam.login
This setting specifies the StarTeam user name.
Acceptable Values
| [user_name] | The StarTeam user name. |
|---|
scontrol.rep{n}.starteam.password
This setting specifies user's password to StarTeam (not encoded).
Acceptable Values
| [password] | The password to the StarTeam source control. |
|---|
scontrol.rep{n}.starteam.path
This setting specifies the project, view, or folder that you are currently working with.
You can specify a project name (all views will be scanned when searching for the repository path), project/view (only the given view will be scanned) or project/view/folder (only the specified Star Team folder will be scanned). This setting is useful for working with large multi-project repositories.
Acceptable Values
| [path] | The path to the current project, view or folder. |
|---|
Use double backslashes to specify the file path on Windows.
Example Usage
scontrol.rep.starteam.path=proj1scontrol.rep.starteam.path=proj1/view1scontrol.rep.starteam.path=proj1/view1/folderAscontrol.rep.starteam.path=proj1/view1/folderA/folderB
scontrol.rep{n}.starteam.workdir
This setting specifies a new working directory for the selected view's root folder (if the path represents a view) or a new working directory for the selected folder (if the path represents a folder) when the scontrol.rep.starteam.path setting points to a StarTeam view or folder.
Acceptable Values
| [path] | The path to the new working directory. |
|---|
Use double backslashes to specify the file path on Windows.
Example Usage
scontrol.rep.starteam.workdir=C:\\storage\\dvscontrol.rep.starteam.workdir=/home/storage/dv
Synergy/CM Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Synergy/CM.
Acceptable Values
| synergy | The Synergy/CM repository identifier. |
|---|
scontrol.synergy.exec
This setting specifies the path to an external client executable (ccm).
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.synergy.host
This setting specifies the machine on which synergy/cm engine runs. Local host is used when this setting is not configured. For Web mode, the host must be a valid Synergy Web URL with protocol and port.
Acceptable Values
| [host_name] | The Synegry/CM server host name. |
|---|
Example Usage
scontrol.rep1.synergy.host=http://synergy.server:8400
scontrol.rep{n}.synergy.dbpath
This setting specifies the absolute path to the Synergy database.
Acceptable Values
| [path] | The path to the Synergy database. |
|---|
Use double backslashes to specify the file path on Windows.
Example Usage
scontrol.rep1.synergy.dbpath=\\host\db\name
scontrol.rep{n}.synergy.projspec
This setting specifies the Synergy project specification which contains the project name and the project version.
Acceptable Values
| [name-version] | The name and version of the Synergy project. |
|---|
scontrol.rep{n}.synergy.login
This setting specifies the Synergy user name.
Acceptable Values
| [user_name] | The Synergy user name. |
|---|
scontrol.rep{n}.synergy.password
This setting specifies user's password to Synergy (not encoded).
Acceptable Values
| [password] | The password to the Synergy source control. |
|---|
scontrol.rep{n}.synergy.port
This setting specifies Synergy server port.
Acceptable Values
| [port_number] | The Synergy server port number. |
|---|
scontrol.rep{n}.synergy.remote_client
(UNIX only) This setting specifies that you want to start ccm as a remote client. This setting is not used for the Web mode.
Acceptable Values
| [client_name] | The client name. |
|---|
scontrol.rep{n}.synergy.local_dbpath
This setting specifies the path to the location where your database information is copied when you are running a remote client session. If null, then the default location will be used. This setting is not used for the Web mode.
Acceptable Values
| [path] | The path to the database. |
|---|
Use double backslashes to specify the file path on Windows.
Microsoft Visual SourceSafe Source Control Settings
scontrol.rep{n}.type
This setting specifies that the repository type is Visual SourceSafe.
Acceptable Values
| vss | The Visual SourceSafe repository identifier. |
|---|
scontrol.vss.exec
This setting specifies the path to an external client executable (ss).
Acceptable Values
| [path] | The path to the external client executable. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.vss.ssdir
This setting specifies the path to the repository database.
Acceptable Values
| [path] | The path to the database. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.vss.projpath
This setting specifies the VSS project path.
Acceptable Values
| [path] | The path to the VSS project. |
|---|
Use double backslashes to specify the file path on Windows.
scontrol.rep{n}.vss.login
This setting specifies the VSS user name.
Acceptable Values
| [user_name] | The VSS user name. |
|---|
scontrol.rep{n}.vss.password
This setting specifies user's password to VSS .
Acceptable Values
| [password] | The password to the VSS source control. |
|---|
