Chapter 3. Configure repositories

Table of Contents

Configure Base Clearcase
Configure Clearcase UCM repository
Configure CVS repository
Configure File system repository
Configure Perforce repository
Configure Subversion repository
Configure Visual Sourcesafe repository
Configure StarTeam repository

This chapter describes how to configure various repositories.

Configure Base Clearcase

You should have Clearcase client installed on the build machine. Also you should make sure that the account running your application server or servlet container is able to access your Clearcase server and that it can make snapshot views. Here is the list of properties you should configure for this repository:

Clearcase view stgloc name

Name of the Clearcase server-side view storage location which will be used as-stgloc option when creating Clearcase view for the current project. Either this property or "Explicit path for view storage" property should be specified.

Explicit path for view storage

This property is required only when the Clearcase view stgloc name property is empty. If specified, it should be parent directory of .vws directory for created snapshot view. For example, if you specify \\server1\dir1 here, QuickBuild will use \\server1\dir1\<view tag>.vws as the -vws option to create Clearcase view. Here <view tag> will be replaced by actual view tag.

[Note]Note

This value should be a writable UNC path on Windows platform.

Config spec

Config spec used by QuickBuild to create Clearcase snapshot view for a build. If you copy the config spec from your dynamic view, do not forget to add load lines after the config spec for each directory you need, like this:

include \\server\ClearCase\configspecs\myconfigspec.txt
load \myvob\modules\module1
load \myvob\modules\module2
Modification detection config

This property will take effect if there are some LATEST versions from some branch to fetch in the above config spec. It is used by QuickBuild to determine, if there are any changes in the repository since the last build. This property consists of multiple entries with each entry per line. Each entry is of the format <path>:<branch>. <path> is a path inside a vob. This path should start from the vob name, for example: \myvob\modules\mymodule. <branch> stands for name of the branch. For sub branches, you don't need to specify the names of any "super" -branches, just the name of the actual branch is enough.

Extra options when creating snapshot view

You may optionally specify extra options for the cleartool mkview sub command used by QuickBuild to create related Clearcase snapshot view for the current project. Options that can be specified here are restricted to -tmode, -ptime, and -cachesize. For example you can specify -tmode insert_cr to use Windows end of line text mode.

Path to cleartool executable

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

Quiet period

Number of seconds 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 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 code to build.