Академический Документы
Профессиональный Документы
Культура Документы
Version 7.0.0
Windows, UNIX, and Linux
Introduction
GI11-6360-00
Rational ClearCase and ClearCase LT
®
Version 7.0.0
Windows, UNIX, and Linux
Introduction
GI11-6360-00
Before using this information, be sure to read the general information under “Notices,” on page 37.
Unless otherwise noted, Rational ClearCase refers to both Rational ClearCase and
Rational ClearCase LT throughout this manual.
Orientation
Introduction
Release Notes
Online tutorials
Software Project
Development Management
More Information
Command Reference
Online documentation
Help files
Build
Management Administration
Orientation
Online tutorials
Release Notes
Introduction
Software Project
Development Management
More Information
Command Reference
Online documentation
Help files
Administration
Orientation
Introduction
Release Notes
(See online documentation)
Designer tutorials
(See online documentation)
Database Project
Design Management
Administration
Typographical conventions
This manual uses the following typographical conventions:
v ccase–home–dir represents the directory into which Rational ClearCase, Rational
ClearCase LT, or Rational ClearCase MultiSite has been installed. By default, this
directory is /opt/rational/clearcase on the UNIX system and Linux, and
C:\Program Files\Rational\ClearCase on Windows.
v cquest-home-dir represents the directory into which Rational ClearQuest has been
installed. By default, this directory is /opt/rational/clearquest on the UNIX
system and Linux, and C:\Program Files\Rational\ClearQuest on Windows.
v Bold is used for names the user can enter; for example, command names and
branch names.
v A sans-serif font is used for file names, directory names, and file extensions.
v A serif bold font is used for GUI elements; for example, menu names and
names of check boxes.
v Italic is used for variables, document titles, glossary terms, and emphasis.
Note: In certain contexts, you can use “...” within a pathname as a wildcard,
similar to “*” or “?”. For more information, see the wildcards_ccase
reference page.
v If a command or option name has a short form, a “slash” ( / ) character
indicates the shortest legal abbreviation. For example:
lsc/heckout
The IBM software support Internet site provides you with self-help resources and
electronic problem submission. The IBM Software Support Home page for Rational
products can be found at http://www.ibm.com/software/rational/support/.
Note: When you contact IBM Customer Support, please be prepared to supply the
following information:
v Your name, company name, ICN number, telephone number, and e-mail
address
v Your operating system, version number, and any service packs or patches
you have applied
v Product name and release number
v Your PMR number (if you are following up on a previously reported
problem)
For more information about ISA, including instructions for downloading and
installing ISA and product plug-ins, go to the ISA Software Support page.
A file element is a file that contains source code, requirements data, visual models,
HTML source, XML source, or other data that can be stored in a file system.
0 0 0 0
1 1 1 1
2 2 2
3 3 3
4 4
A versioned object base, or VOB, is a secure repository that stores versions of file
elements and directory elements. Figure 2 displays a VOB.
0 0 0 0
1 1 1 1
2 2 2
3 3 3
3 3
4
Checking out Checking in
the version the version
Figure 3. Using the check out/check in model
temp
lost+found
UCM terminology
A project is a specific product of a development effort, such as a corporate Web site
or order fulfillment process. In UCM, a project is an object that contains the
configuration information (for example, components, activities, and policies)
needed to manage and track work on a product. A typical UCM project in Rational
ClearCase consists of one shared work area and many private work areas (one for
each developer).
A component is a group of source code and other relevant elements or files, such as
a license module or a GUI, that the team develops, integrates, and releases as a
unit. Components constitute parts of a project.
An activity is an object that records the set of files (known as the change set) that a
developer creates or modifies to complete and deliver a development task, such as
a bug fix.Figure 5 displays an activity. Other activities could include an update to a
help file or the addition of a menu item to a GUI component.
Figure 5. An activity
View
Baseline Stream
Figure 6. A stream
A project contains one integration stream, which records the project’s baselines and
enables access to versions of the project’s shared elements. The integration stream
and a corresponding integration view represent the project’s primary shared work
area.
Although the integration stream is the project’s primary shared work area, project
managers can designate a development stream to be a shared work area for several
developers who are working on the same feature.
Element
Version
Component
Baseline
Figure 7. A baseline
When developers join a project, they populate their work areas with the versions
of directory and file elements represented by the project’s recommended baselines.
Alternatively, developers can join a project at a feature-specific development stream
level, where they populate their work areas with the development stream’s
recommended baselines. This practice ensures that all members of the project team
base their development on the same set of files.
If your project team works on multiple components, you may consider using a
composite baseline. A composite baseline is a baseline that selects baselines in other
components. In Figure 8, the ProjBL1 composite baseline selects baselines BL1 and
BL2 of components A and B, respectively. The Proj component does not contain
any elements of its own. Its sole purpose is to contain the composite baseline that
selects the recommended baselines of the project’s components. By using a
composite baseline in this manner, you can identify one baseline to represent the
entire project.
PB1 Component B
Baseline
Baseline BL2
Creating a project
Before creating a UCM project, the project manager maps files and directories in
the product architecture to a set of UCM components. Using utilities provided in
Rational ClearCase, the project manager or administrator converts existing files and
directories from other version control software systems to elements in a VOB. For
details about importing existing files and directories into Rational ClearCase
components, see the IBM Rational ClearCase Guide to Managing Software Projects and
the IBM Rational ClearCase Administrator’s Guide.
The project manager then creates a UCM project, along with its baselines and
integration stream, with the Rational ClearCase Project Explorer. A new project can be
created from scratch or populated with baselines from an existing project.
The project includes a private work area for each developer, displayed in Figure 9,
and one shared work area, displayed in Figure 10. The project manager manages
the shared work area. These areas are explained in more detail in “Joining a
project” on page 10 and “Delivering work to the integration stream” on page 10.
Joe's development
stream
Chris's development
stream
Baseline BL1
Chris's
integration
view
Joining a project
To join the UCM project, use the Join Project wizard to create a development
stream, a development view, and an integration view.
The development stream and development view make up the private work area, where
you work on activities. You use the development view to access and change
elements. The development stream determines which versions of elements are
displayed in each development view.
The integration view gives developers and project managers access to work that has
been delivered to the shared work area.
When you are ready to integrate your work with the work of your team, you
deliver your work from your development stream to the integration stream. The
deliver operation may involve a merge if other team members have already
delivered versions of one or more of the same elements, as displayed in Figure 11.
Deliver
Integration
stream
Baseline BL1
After all team members' work is delivered and merged, you use the integration
view to build and test work in the integration stream. The integration stream
determines which versions of delivered elements are displayed in the integration
view.
You then update, or rebase, your development stream to use the new recommended
baseline, as displayed in Figure 12. The rebase operation updates the development
view to include versions from the new baseline. If the baseline includes new
versions of the same element that you checked in from a private work area (that is,
if other developers have checked in and delivered new versions of the same
element to the integration stream), the rebase operation merges the new versions
into your development stream.
In addition to the set of policies that UCM provides, you can create triggers on
UCM operations to enforce customized development policies. A trigger is a
mechanism that specifies one or more programs or actions to be run whenever a
given Rational ClearCase operation is performed. For details about creating
triggers, see the IBM Rational ClearCase Command Reference and the IBM Rational
ClearCase Administrator’s Guide.
Figure 13. Using a Rational ClearQuest to-do list to find UCM activities
For information about planning and setting up the Rational ClearQuest integration
with UCM, see the IBM Rational ClearCase Guide to Managing Software Projects. For
information about working on activities in a project that is linked to a Rational
ClearQuest user database, see the IBM Rational ClearCase Developing Software
Manual.
Terminology
A branch is an object that specifies a sequence of versions of an element. Each
element has one main branch , which represents the principal line of development.
Each element may also have multiple subbranches, each of which represents a
separate line of development. A branch is displayed in Figure 14.
2
r1_bugs
3
0
4
1
bug404
2
0
3
1
util.h
main
2 V1.0
0 0 0 0
1 1 1 V1.0 1
2 2 V1.0 2 2 V1.0
3 V1.0 3 3 3
4 4 4
To examine versions that are included in a particular release, use a config spec that
uses a label rule to select the versions that were labeled for that release. An
example of how to select versions that are included in a release is displayed in
Figure 17.
0 0 0 0
1 1 1 V1.0 1
2 2 V1.0 2 2 V1.0
3 V1.0 3 3 3
4 4 4
Setting up a project
When project managers set up projects in base ClearCase, they map files and
directories in the product architecture to a set of VOBs (just as project managers
After files and directories are imported into VOBs, the project manager usually
applies labels to a set of versions of elements in those VOBs to designate the
versions from which development should start.
A project team can work on many branches concurrently. In Figure 18, the main
branch represents the integration branch, an r1_port subbranch is a port to a new
platform, an r2_beta subbranch contains work for the beta version of the next
release, and so on.
opt.c
main
r1_port
2
r2_beta 0
3
0
1
4
1
2
2
3
4
smg_bugfix
To incorporate your work into the project, merge the changes on your private
branch to the project branch. If you decide to abandon your work, do not merge
the changes. In either case, when you want to resume your work on the project
branch, change your view back to use the project branch view.
For more information about creating private branches for development work and
merging your work back to the project branch, see the IBM Rational ClearCase
Developing Software Manual.
4
r1_fix
5
0
6
1
7
2
8 bug102
3
0
4
1
5
merge
2
6 merge
Creating labels
A label in base ClearCase is a name that can be attached to a version. Labels are a
powerful tool for project managers. By applying labels to groups of elements, the
relationship of a set of file and directory versions to one another can be defined
and preserved at a given point in the development lifecycle. For example, you
could apply a BASELINE label to all versions that are considered stable after
integration and testing. You can then use this label as the foundation for new
work.
Note: You can also use attributes, hyperlinks, locks, and triggers when using
UCM.
Project managers can use attributes, hyperlinks, and labels to annotate objects in
the VOB. The following section provides definitions of attributes, hyperlinks, and
labels and gives examples of how they can be used.
v Attributes are name-value pairs that are attached to objects. You could use
attributes to attach bug numbers to versions. You could also use them to identify
which versions in a baseline have been tested.
v Hyperlinks connect two VOB objects. For example, you can define a hyperlink to
connect a design specification to its associated executable file.
v Labels identify specific versions of elements. You can use labels in config spec
rules to identify branching points, or to mark all versions that were used in a
build.
Project managers can use locks and triggers to define and enforce project policies.
For example, a project manager could temporarily lock an integration branch to
prevent developers from merging work onto it. A project manager could also create
a trigger that prompts developers to enter the bug number associated with a
checkin and then attaches that bug number to the new, checked-in version.
For details about using Rational ClearCase metadata, see the IBM Rational ClearCase
Guide to Managing Software Projects and the IBM Rational ClearCase Developing
Software Manual.
You can associate change requests with versions of elements using the base
ClearCase integration with Rational ClearQuest. Versions associated with a change
request constitute a change set. In Rational ClearQuest, a page on the change
request’s record form displays its change set information.
You can specify conditions under which developers are prompted to associate
versions with change requests when you configure the integration. For example,
you can require developers to specify a change request associated with a given file
when they check out or check in that file, and you can apply this requirement only
to specific VOBs, branch types, or element types.
peer-to-peer pattern
Boston
San Francisco
Bangalore
If you are a project manager, read “Planning issues.” This section contains
information about using UCM, base ClearCase, Rational ClearQuest, and Rational
ClearCase MultiSite in your organization.
Planning issues
This section describes significant decisions administrators or project managers must
make before installing Rational ClearCase.
If your team plans to use UCM, you need to make the following decisions:
v Which components your team will work on
v What stream hierarchy your project will use
v Which development policies you will enforce
v What naming scheme you will use for baselines
If your team plans to use base ClearCase, you need to make the following
decisions:
v What branching strategy your team will use
v What configuration specification (config spec) rules developers will use so that
their views to select particular versions of elements
v What label types and labels you will use to identify project milestones
If you are using the base ClearCase integration with Rational ClearQuest instead of
UCM, you can associate Rational ClearQuest change requests with Rational
ClearCase versions. For details about configuring this integration, see the IBM
Rational ClearCase Guide to Managing Software Projects.
Installation requirements
Before you install Rational ClearCase at your site, see the IBM Rational ClearCase,
ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide for the following
information:
v Supported platforms and file systems (including system file access for all
supported platforms)
v Hardware and software requirements
Rational ClearCase Site preparation configures the sitewide defaults that users see
when they install Rational ClearCase on their computers. This simplifies sitewide
installation because the Rational ClearCase administrator defines Rational
ClearCase installation parameters for the site only once, rather than requiring
everyone to specify appropriate values for these parameters when they install
Rational ClearCase. Instead, users can accept the default parameter values when
prompted during the installation process.
For detailed information about running Rational ClearCase Site preparation, see
the IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and
Upgrade Guide.
In Table 2, the term administrative VOB refers to a VOB that contains global type
objects, such as branch types, that are copied to client VOBs when users create
instances of the type objects in the client VOBs.
Typically, you should accept the default installation parameters. Consult your
Rational ClearCase administrator before you override any default values.
For detailed information about installing Rational ClearCase, see the IBM Rational
ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide.
Project managers
As a project manager, you are responsible for creating and maintaining the
development environment for your team. The tasks that you perform and the tools
that you use differ depending on whether you use UCM or base ClearCase.
Using UCM
The primary tool used for managing UCM projects is the Rational ClearCase
Project Explorer. The left pane provides a hierarchical view of UCM objects,
starting with the project VOB (PVOB). This view displays components, folders,
projects, and streams. The right pane displays the contents of the object that you
highlight in the left pane. For example, Figure 22 displays activities created in the
integration stream.
OM_proj1.0_Integration
Windows
Several tools that can help you perform project management tasks are included in
Rational ClearCase on Windows:
v The Type Explorer can be used to create branch types and label types
v The View creation wizard and the VOB creation wizard can be used to create
views and VOBs
v The Merge Manager can be used to merge versions of elements between
branches
To run Rational ClearCase, click Start > Programs > IBM Rational > IBM
Rational ClearCase
To run Rational ClearCase LT, click Start > Programs > IBM Rational > IBM
Rational ClearCase LT
Join Project
Rebase Stream
Project Explorer
Base ClearCase
Views Toolbox
The Rational ClearCase Explorer contains three main panes. The Shortcut pane on
the left contains shortcuts for UCM, base ClearCase operations, and your views.
The UCM page contains shortcuts for the following operations:
v Joining a project
v Delivering work to a stream
v Rebasing your stream with a new baseline
v Starting the Project Explorer
The Base ClearCase page contains shortcuts for the following operations:
v Merging versions of an element
v Creating, starting, and removing views
v Updating snapshot views
v Editing a view’s properties
v Running the Rational ClearCase Reporting wizard
After you set a view context, you can use the Folder pane to browse the hierarchy
of folders within your VOBs. The Details pane, on the right, displays versions of
elements within the folder you select. If you are using UCM, the Folder pane also
contains folders for your activities.
Working in UCM
The Project menu of the File Browser contains selections for the following UCM
developer operations:
v Joining a project
v Delivering work to a stream
v Rebasing your stream with a new baseline
v Running the Project Explorer
The Versions menu contains menu items for checking in and checking out files,
comparing versions of elements, and merging versions.
Using cleartool
In addition to GUIs, Rational ClearCase includes a robust command-line interface
utility called cleartool. Table 3 lists cleartool commands that are used to perform
common Rational ClearCase operations. For more information about cleartool
commands, see the IBM Rational ClearCase Command Reference.
Table 3. Frequently used cleartool commands
cleartool Command Description
checkin Creates a new version of an element
checkout Creates a modifiable copy of a version
deliver Merges changes from one stream to another stream
merge Combines the contents of two or more versions of files or
directories into a new version
mkactivity Creates a UCM activity
mkbl Creates a baseline
mkbrtype, mkbranch Creates a branch type; creates a branch on the version tree of an
element
mkelem Creates a file or directory element
mklbtype, mklabel Creates a label type; applies a label to versions of elements
mkproject Creates a UCM project
mkstream Creates a UCM stream
mkview Creates a view
rebase Updates your the configuration of a stream with a new set of
foundation baselines
Developers can use the Front Desk page to set their base ClearCase or UCM view
context. In Figure 24, the developer has chosen to work in UCM and has navigated
to the ucm_proj1_mydev stream within the ucm_proj1 project. The View Details
area displays the view associated with the selected stream.
After setting a view context, developers can use the Rational ClearCase Explorer
within the Visual Studio.NET GUI to perform Rational ClearCase operations, such
as checking out and checking in files and selecting UCM activities to work on.
File Edit View Project Build Debug ClearCase Tools Window Help
Debug
Create View Join Project Submit Default Change Request Run Query
View Details
UCM Views Open Solution New Project Deliver Rebase
Views
ucm_proj1
Change Requests
ucm_proj1_mydev Selected View: ucm_proj1_mydev
Tools ucm_proj1_myint
UCM Project: ucm_proj1
Help
UCM Stream: ucm_proj1_mydev
VS.NET Projects
Name Path
Task (1 item)
C Description Resource In Folder
The declared package does not . . . SampleClass newjava2/example . . .
Writable Insert
To use the Web interface, developers need only a Web browser; they do not need
to install Rational ClearCase on their computers.
http://www.ctg.rational.com:81/ccase/bin/ccweb.exe?session=3viqXVKxk6hFjQOhw%40GxhnRPTDhge22ii3_o& Go Links
Add to ClearCase Update View Find Modified Files Edit View Config
Select View
All VOBs
VOB View (Location: C:\ClearCase_Storage\views\nll_view)
\ CLQ_project
\ install
Check Out Check In Undo Checkout Undo Hijack Compare Merge Properties History
\src
Filter: Include Exclude Filter Unfilter
E L
eclipsed. A VOB object that is not visible because label. An instance of a label type object, supplying a
another object with the same name is currently selected user-defined name for a version. See also object,
by the view. metadata.
element. An object that encompasses a set of versions, label type. A type object that defines a version label for
organized into a version tree. use within a VOB.
element type. A class of versioned file or directory load. To copy a version of an element to a snapshot
objects. Predefined element types are supported in the view and keep track of the checkins, updates, and other
Rational ClearCase environment. Users can define Rational ClearCase operations that affect the element.
additional types that are refinements of the predefined
load rule. A statement in the config spec that specifies
types. When an element is created, it is assigned one of
an element or subtree to load into a snapshot view.
the currently defined element types in its VOB. Each
Config specs can have more than one load rule. See
user-defined element type is implemented as a separate
also version-selection rule.
VOB object.
lost+found. A subdirectory of a VOB’s top-level
extended namespace. The Rational ClearCase
directory, to which elements are moved if they are no
extension of the standard file system pathname
longer cataloged in any version of any directory
hierarchy. Each host has a view-extended namespace,
element.
which allows a pathname to access VOB data using any
view that is active on that host. Each VOB has a
VOB-extended namespace, which allows a pathname to
Glossary 35
types. Each file and directory is an instance of an actually located in a VOB’s derived object storage pool. 2)
element type; each branch is an instance of a branch To convert a nonshareable derived object to a shared
type. derived object.
U
Unified Change Management (UCM). A process,
layered on base ClearCase and Rational ClearQuest
functionality, for organizing software development
teams and their work products. Members of a project
team use activities and components to organize their
work.
V
version. An object that implements a particular
revision of an element. The versions of an element are
organized into a version tree structure. Also: checked-out
version can refer to the view-private file that corresponds
to the object created in a VOB database by the
checkout command.
W
wink in. 1) To cause a shareable derived object to
appear in a view, even though its file system data is
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION ″AS IS″ WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
COPYRIGHT LICENSE:
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
(c) IBM 2006. Portions of this code are derived from IBM Corp. Sample Programs.
(c) Copyright IBM Corp. 2006. All rights reserved.
Trademarks
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Appendix. Notices 39
40 IBM Rational ClearCase and ClearCase LT: Introduction
Index
B Rational ClearCase (continued)
installing
VOB (versioned object base)
glossary definition 36
branches on clients 24
glossary definition 33 installing server software 23
overview 1
planning issues 21
C hardware and software
ccase-home-dir directory xiv requirements 22
Changes since last edition xvii site preparation 22
cleartool 28 Project manager considerations 25
Command-line interface Rational ClearCase MultiSite 19
using cleartool 28 user interfaces
config specs command-line interface 28
glossary definition 33 Rational ClearCase Remote
conventions, typographical xiv Client 31
cquest-home-dir directory xiv Rational ClearCase Web
customer support xv interface 30
using base ClearCase 13
integrating with Rational
D ClearQuest 19
using Unified Change Management
development policies (UCM) 5
implementing 12 integrating with Rational
ClearQuest 12
working in an IDE 29
E Rational ClearCase MultiSite
eclipsed planning issues 22
glossary definition 34 Rational ClearCase Remote Client 31
elements Rational ClearCase Web interface 30
glossary definition 34 Rational ClearCase LT
types differences from Rational
glossary definition 34 ClearCase 4
F S
fire Summary of changes xvii
a trigger
glossary definition 34
T
typographical conventions xiv
H
history
glossary definition 34 U
Unified Change Management (UCM)
integrating with Rational
M ClearQuest 12
MultiSite 19 using 5
planning issues 22 using base ClearCase 13
Using base ClearCase
integrating with Rational
N ClearQuest 19
namespace
extended
glossary definition 34 V
version control
labels
R views
types, glossary definition 34
Overall, how satisfied are you with the information in this book?
How satisfied are you that the information in this book is:
When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any
way it believes appropriate without incurring any obligation to you. IBM or any other organizations will only use
the personal information that you supply to contact you about the issues that you state on this form.
Name Address
Company or Organization
Phone No.
___________________________________________________________________________________________________
Readers’ Comments — We’d Like to Hear from You Cut or Fold
GI11-6360-00 Along Line
_ _ _ _ _ _ _Fold
_ _ _and
_ _ _Tape
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please
_ _ _ _ _do
_ _not
_ _ staple
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold
_ _ _and
_ _ Tape
______
NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES
IBM Corporation
Attn: Dept CZLA
20 Maguire Road
Lexington, MA 02421-3112
_________________________________________________________________________________________
Fold and Tape Please do not staple Fold and Tape
Cut or Fold
GI11-6360-00 Along Line
Printed in USA
GI11-6360-00