Académique Documents
Professionnel Documents
Culture Documents
Version 7.0.0
Windows
GI11-6365-00
Rational ClearCase, ClearCase MultiSite, and ClearCase LT
®
Version 7.0.0
Windows
GI11-6365-00
Before using this information, be sure to read the general information under Appendix C, “Notices,” on
page 101.
iv IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Upgrading Rational ClearCase Web and other Additional configuration tasks . . . . . 78
products using the Rational Web Platform Before you remove Rational ClearCase
(RWP) . . . . . . . . . . . . . . 67 data from the Rational ClearCase LT
Importing Open SSL certificates from an server . . . . . . . . . . . . . 82
earlier version of RWP . . . . . . . 68 Installing the Rational ClearCase LT client . . 82
Upgrading the Rational ClearCase Remote Rational ClearCase LT client installation
Client . . . . . . . . . . . . . . 68 checklist . . . . . . . . . . . . 83
Cross-version compatibility . . . . . . 68 Licensing Rational ClearCase LT . . . . 84
Supported client/server combinations 68 Upgrading from Rational ClearCase LT to full
Upgrading the Rational ClearCase Remote Rational ClearCase software. . . . . . . 84
Client to version 7.0 . . . . . . . . 69 Upgrade checklist . . . . . . . . . 84
Rational ClearCase Remote Client for What happens when you upgrade . . . 85
Eclipse . . . . . . . . . . . . 69 Upgrade options . . . . . . . . 85
Rational ClearCase Remote Client . . . 70 Upgrade considerations . . . . . . 86
Rational ClearCase Remote Client for Preparing to upgrade . . . . . . . . 88
Visual Studio. . . . . . . . . . 71 Acquiring Rational ClearCase licenses 89
Establishing your Rational ClearCase
Appendix A. Installing and upgrading release area . . . . . . . . . . 89
Rational ClearCase LT . . . . . . . . 73 Remove all Rational ClearCase LT
Before installing Rational ClearCase LT . . . 73 views . . . . . . . . . . . . 89
Installing this product as part of IBM Rational The simple upgrade procedure . . . . . 90
Suite . . . . . . . . . . . . . . 73 If you cannot upgrade all your clients at
Site defaults file required for each product 74 the same time . . . . . . . . . 90
Change to search order for license keys . . 74 Performing the upgrade . . . . . . 90
Upgrading from a previous version . . . . 74 The upgrade-and-merge procedure . . . 92
Overview of Rational ClearCase LT server Performing the upgrade and merge . . 92
and client computers . . . . . . . . . 74 Creating new UCM views that use
Rational ClearCase Web server . . . . . . 75 existing streams . . . . . . . . . 94
Migrating Rational ClearCase LT to Rational cclt2cc command line options . . . . . 95
ClearCase . . . . . . . . . . . . . 76
Installing the Rational ClearCase LT server 76 Appendix B. Supported Data Code Page
Rational ClearCase LT server installation locales for Rational ClearCase and
checklist . . . . . . . . . . . . 76 Rational ClearCase LT . . . . . . . . 97
Selecting a Rational ClearCase LT server 77
Rational ClearCase LT server setup . . . 78 Appendix C. Notices . . . . . . . . 101
Installation order for Rational
ClearCase LT . . . . . . . . . . 78
Contents v
vi IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Tables
1. Recommended reading path for Rational 13. Deployment methods . . . . . . . 35
ClearCase installation documentation . . 3 14. Additional deployment tasks . . . . 37
2. Preinstallation checklist . . . . . . . 7 15. Warnings and blocks . . . . . . . 48
3. Supported platforms for Rational 16. Requesting and installing IBM Rational
ClearCase and MultiSite . . . . . . 9 license keys . . . . . . . . . . 53
4. Supported releases for Rational 17. Custom setup in the Setup Wizard 55
ClearCase Remote Client . . . . . . 10 18. Additional enterprise deployment
5. Server requirements for Rational postinstallation tasks . . . . . . . 56
ClearCase z/OS Extensions Remote 19. CCRC client/server compatibility 68
Build feature . . . . . . . . . . 10 20. Rational ClearCase LT server
6. Supported file systems by platform 11 installation checklist . . . . . . . 76
7. Disk space required for Rational 21. Rational ClearCase LT native client
ClearCase files and upgraded system installation checklist . . . . . . . 83
files . . . . . . . . . . . . . 11 22. Rational ClearCase Web client
8. Supported Rational ClearCase installation checklist . . . . . . . 83
configurations for multiple language 23. Checklist for upgrading Rational
environments . . . . . . . . . . 13 ClearCase LT to Rational ClearCase
9. Vendor integration requirements 15 software . . . . . . . . . . . 84
10. Compatibility: Views with VOBs 18 24. Supported Data Code Page Locales for
11. Instructions for basic licensing tasks 24 Rational ClearCase . . . . . . . . 97
12. Instructions for basic licensing tasks 30
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.
v A monospaced font is used for examples. Where user input needs to be
distinguished from program output, bold is used for user input.
v Nonprinting characters appear as follows: <EOF>, <NL>.
x IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Rational ClearCase documentation road map
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
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/.
xii IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
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)
Downloading the IBM Support Assistant
The IBM Support Assistant (ISA) is a locally installed serviceability
workbench that makes it both easier and simpler to resolve software product
problems. ISA is a free, stand-alone application that you download from IBM
and install on any number of machines. It runs on AIX, (RedHat Enterprise
Linux AS), HP-UX, Solaris, and Windows platforms.
For more information about ISA, including instructions for downloading and
installing ISA and product plug-ins, go to the ISA Software Support page.
Before beginning the installation process, read the IBM Rational ClearCase and
ClearCase MultiSite Release Notes. Table 1 provides a summary of the
recommended reading path, based on your deployment option.
2 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 1. Recommended reading path for Rational ClearCase installation
documentation
Scenario Reading path
If you are a new full Rational ClearCase Chapter 1, “Planning your installation,”
user, use the Enterprise deployment or on page 1
release-area option.
Chapter 2, “Configuring your
installation,” on page 7
4 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v Maintain and manage the Rational License Server as a single, multiple, or
redundant server configuration.
These tasks and different types of license keys are described in the IBM
Rational License Management Guide. If you are installing Rational products for
the first time, read this guide carefully before beginning installation.
Preinstallation checklist
Table 2 lists all the recommended prerequisites and includes cross-references
for additional information about installing Rational ClearCase.
Table 2. Preinstallation checklist
Done Task Reference
Review release notes. “Reviewing the release notes” on
page 8
Ensure that your installation meets “System requirements” on page 9
all system requirements.
Learn about the different host types “Rational ClearCase host types” on
that are used by Rational ClearCase. page 16
Designate which hosts assume each “Designating server and client hosts”
logical host type. on page 17
Ensure that you select the “VOB database schema versions” on
appropriate VOB database schema page 17
version.
If you are running different versions “Operational compatibility across
of Rational ClearCase on multiple versions of Rational ClearCase” on
Rational ClearCase hosts, ensure page 18
compatibility of clients and servers
among the various versions.
If you plan to install Rational “Planning for Rational ClearCase
ClearCase MultiSite, ensure that MultiSite installation” on page 18
your environment is compatible.
If you plan to install Rational “Ensuring Rational ClearQuest
ClearQuest, ensure that your compatibility with Rational
environment is compatible. ClearCase” on page 20
Plan for Rational ClearCase “Planning for Rational ClearCase
installations on a dual-boot installations on dual-boot
computer. computers” on page 21
Decide whether to enable Remote “Enabling remote administration” on
Administration. page 21
8 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
System requirements
Use this section to determine compatibility of your platforms, file system,
hardware, software, and network before you install Rational ClearCase.
For the latest updates, see the IBM Rational ClearCase and ClearCase MultiSite
Release Notes.
Supported platforms
Table 3 provides a list of the supported platforms for version 7.0 of Rational
ClearCase and MultiSite.
Table 3. Supported platforms for Rational ClearCase and MultiSite
Hardware platform Operating system
Intel Pentium 4 1.4 GHz, or Windows XP Professional SP1, SP2
higher
Windows 2000 Professional SP4; Windows 2000
512 MB RAM required Server SP4; Windows 2000 Advanced Server, SP41
Notes:
1. Rational ClearCase version 7.0 clients support the latest Windows 2000
and Windows XP Professional releases. Earlier releases of Windows, such
as Windows 95, Windows 98, Windows Me, and Windows NT 4.0 SP4, are
no longer supported with this release. Windows XP Home Edition is not
supported. Customers who require support for earlier releases of Windows
must run an earlier version of Rational ClearCase that supports those
releases
2. The IBM Rational ClearCase z/OS Extensions Remote Build feature has
not yet been tested with Windows Server 2003.
The Rational Web Platform provides support for Web interfaces to Rational
ClearCase and other IBM products. All supported Rational ClearCase
platforms support RWP. RWP is installed by default on all servers.
Note: Version 7.0 Web servers are only compatible with version 7.0 VOB
servers.
For more information, see the IBM Rational ClearCase Guide to Installing and
Implementing z/OS Extensions.
Table 5. Server requirements for Rational ClearCase z/OS Extensions Remote Build
feature
Hardware platform Operating system
IBM zSeries z/OS 1.4, 1.5, 1.6, 1.7, including USS
10 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Supported file systems
Table 6 lists the file systems that Rational ClearCase supports.
Table 6. Supported file systems by platform
Platform Supported file systems
Windows 2000 FAT, FAT32, NTFS, LANMAN
Windows XP FAT, FAT32, NTFS, LANMAN
Additionally, snapshot view directories need enough disk space to contain all
files loaded into the snapshot views and all view-private files added to the
views. The amount of space required depends on the number and size of the
files in the views.
Any host that must contain VOB storage or view storage directories must
have enough disk space to contain the files and databases used for storage of
these directories. The amount of space required depends on the characteristics
and use of the VOBs and views.
Supported Rational ClearCase configurations in multiple language
environments
This section provides examples of supported Rational ClearCase
configurations for environments that use multiple languages. These examples
are listed in Table 8.
Note:
v All references to English denote en-US.
v All references to IBM Group-1 languages include all of the following
languages:
12 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
– Japanese
– Simplified Chinese
– Traditional Chinese
– Korean
– French
– German
– Spanish
– Italian
– Brazilian Portuguese
Table 8. Supported Rational ClearCase configurations for multiple language
environments
Product Supported configurations
Rational ClearCase v English VOB servers that run English operating systems
that are accessed by the following types of clients:
– English clients that act as view server hosts and run
English operating systems
– Japanese clients that act as view server hosts and run
Japanese operating systems
v English VOB and view servers that run English operating
systems that are accessed by the following types of
clients:
– English clients that run English operating systems
– Japanese clients that run Japanese operating systems
The Rational ClearCase v Servers
Remote Client
– English VOB servers that run English operating
systems
– English Rational ClearCase Remote Client servers that
act as view server hosts and run English operating
systems
v Clients that access the Rational ClearCase Remote Client
servers
– English Rational ClearCase Remote Client clients that
run English operating systems
– IBM Group-1 language Rational ClearCase Remote
Client clients that run IBM Group-1 language operating
systems
14 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Explorer, the HTML DiffMerge tool, and the Rational ClearCase
Administration Console. Use Internet Explorer 5.5 SP2 or later.
To use Rational ClearCase from a supported Windows host, you must log on
to a domain account (not a local, per-system user account). For more
information about Windows domains, see the IBM Rational ClearCase
Administrator’s Guide.
Operating system vendor Web site
You can find up-to-date information about Microsoft Windows operating
system issues at the Microsoft Web site, http://www.microsoft.com.
Various system tasks are assigned to server hosts. Use these descriptions to
understand and plan the number and types of each host you need to allocate
for your installation. You can designate a single computer as the server that
handles multiple server functions. For more information, see the IBM Rational
ClearCase Administrator’s Guide.
v Server host. Any host on which a VOB or view is created is a server host.
Some hosts may be dedicated servers on which client software is rarely
used. Other server hosts double as clients. All server hosts, and the registry
and license server host, must run Rational ClearCase.
v Registry server host. One host in the network acts as the Rational
ClearCase registry server host. Each host is assigned to a particular registry
server host at Rational ClearCase installation time. This host stores
access-path information for all the VOBs and views in the network. Rational
ClearCase client and server programs on all hosts communicate with the
registry server when accessing Rational ClearCase data. For information
about setting up a registry server host, see “Setting up the registry and
license server hosts for the first time” on page 28. For critical information
about upgrading and preserving your registry server data, see “Upgrading
Rational ClearCase hosts (full ClearCase only)” on page 64.
v License server host. One or more hosts in the network act as license server
hosts, authorizing and limiting Rational ClearCase use according to the
terms of your license agreement. Each host on which Rational ClearCase is
installed is assigned to a particular license server host and communicates
with that host periodically. For information about setting up a license server
host, see “Setting up the registry and license server hosts for the first time”
on page 28 and “Upgrading Rational ClearCase hosts (full ClearCase only)”
on page 64.
v Networkwide release host. One host in the network acts as the
networkwide release host. A directory on this host stores an entire Rational
ClearCase release that has been extracted from distribution media or
downloaded from the IBM Web site. When necessary, patches can be
applied to a release area to update the entire release with the latest
enhancements and defect fixes. The networkwide release host does not need
to run Rational ClearCase.
v IBM Web Platform (RWP) host. If you want to use the Rational ClearCase
Web interface, you need at least one RWP host.
16 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
The RWP server host should have an additional 128 MB of physical
memory beyond what is required to support any VOBs and views on the
host. Unless the RWP host is the Rational ClearCase LT server, do not use
the RWP host as a VOB- or view-server host. RWP is installed automatically
with Rational ClearCase LT.
Attention: Installing RWP on a host that is already running another Web
server may result in a port conflict that can cause RWP or the other Web
server to fail on startup. Install RWP on a host that does not have to run
any other Web servers. If this is impossible, configure the other Web server
to use ports that are not being used by RWP. The default port number used
by RWP is 80. If you cannot use this port for RWP, you must configure
RWP to use another port by running the Site Preparation Tool (see
Chapter 3, “Creating a release area,” on page 35).
For more information about RWP, see the IBM Rational ClearCase
Administrator’s Guide.
Designating server and client hosts
If you are setting up a Rational ClearCase installation for the first time,
designate and configure the registry and license server hosts first. You can
install the registry and license server hosts on the same computer or on
different computers.
You must first set up the registry and license server hosts by creating a release
area and installing the hosts from that release area, using a set of site defaults
that you define. After you set up the registry and license server hosts, you
configure other server hosts where clients can create VOBs and views.
You must also designate the computers you use as clients. All Windows
clients can support dynamic views (if you have installed MVFS), local VOBs,
and snapshot views.
If you are currently using schema version 53, you must reformat your VOBs
to use the newer format. Until you do, users cannot access VOB data after the
server has been upgraded to version 7.0. For more information about
reformatting your VOBs, see the IBM Rational ClearCase Administrator’s Guide.
For more information about this and other upgrade-related scenarios, see
Chapter 5, “Upgrading your Rational ClearCase installation,” on page 63.
As of this release, you must install the latest patches on client computers to
access all VOBs and views in your environment.
A version 7.0 client on Linux and the UNIX system can access a VOB on
Windows by using a snapshot view. However, the snapshot view storage
directory and the VOB storage directory must be on servers running version
7.0 or later.
Planning for Rational ClearCase MultiSite installation
You can install Rational ClearCase MultiSite only on Rational ClearCase server
hosts.
18 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
For upgrade considerations related to Rational ClearCase MultiSite, see
“Guidelines for upgrading Rational ClearCase MultiSite” on page 65.
Avoid configuring any one host to run the Shipping Server for both products,
because uninstalling either product from such a host will remove the Shipping
Server that is used by both products and render the remaining product
inoperable.
If you must install both Rational ClearCase MultiSite and Rational ClearQuest
with the Shipping Server on the same host, ensure that you perform the
following tasks:
v Install Rational ClearCase first.
v Uninstall both products if you ever uninstall either product. If you have
already installed Rational ClearQuest with MultiSite, uninstall only the
shipping server component from Rational ClearQuest, then install Rational
ClearCase with MultiSite.
Note: Administrators should be sure that site configuration files for typical
host systems do not specify installation of the IBM Shipping Server.
Any attempt to install Rational ClearCase on a host where Rational
ClearQuest and the Shipping Server is already installed will fail.
For example, if a host is running Rational ClearCase version 7.0 and has a
VOB whose feature level is 2, you can replicate that VOB to a host running
Rational ClearCase version 4.2. Similarly, if a host is running Rational
ClearCase version 7.0 and has a VOB replica whose VOB family feature level
is 3, you can export a replica-creation packet from that replica and import it
on a host running Rational ClearCase version 2003.06.xx. However, you
cannot import the packet on a host running Rational ClearCase version 4.2.
Rational ClearCase version 4.2 does not support feature level 3.
20 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Note: You must run at least Rational ClearQuest version 7.0 on systems
where Rational ClearCase version 7.0 is installed.
Remote administration capability is useful if, for example, you move your
license server to a new host. You can then change the settings for all clients
from a single computer.
If you do not enable Remote Administration, only the local user can change
that computer’s Rational ClearCase properties.
For more information, see the IBM Rational ClearCase Administrator’s Guide.
Ensuring compatible character-encoding systems
Because the interpretation of multibyte characters is controlled by a host’s
locale setting (established by using the Regional Options tool in the Windows
Control Panel), all tags in a region must use the same character set, and all
hosts in a region must use the same locale setting.
The set of licenses is maintained on the license server. The network can have
one or more license servers. Each license server runs a Rational ClearCase
server process, and so must have Rational ClearCase installed. You set up
your license servers during the installation.
After you determine your initial license allocation (see “Allocating Rational
ClearCase licenses” on page 22), you obtain your Rational ClearCase license
keys from IBM support for Rational products, or from this location:
http://www.ibm.com/software/rational/support/licensing/ .
When calling customer support, be sure you specify that you are using
ClearCase Licensing or Atria licensing, as opposed to Rational Common
Licensing (powered by FLEXlm software).
22 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
This strategy provides for more robustness. If the license server that holds
15 licenses fails, developers can still use Rational ClearCase.
For example, a company has two sites, with 20 developers at site A and 5
developers at site B. The company has three VOBs at site A; two of them are
replicated to site B and one is not replicated. Five developers at site A access
only the unreplicated VOB, and the remaining 15 work in all VOBs. Therefore,
the company needs to purchase the following numbers of licenses:
Rational ClearCase
Site licenses MultiSite licenses
A 20 15
B 5 5
Note: This example assumes that you purchase a Rational ClearCase license
for each developer. If you have fewer Rational ClearCase licenses than
developers, you can purchase a proportionate number of MultiSite
licenses. For example, if site B purchased three Rational ClearCase
licenses, it would also purchase three MultiSite licenses.
Configuring Rational Common Licensing
This section provides an overview of the license management tools used with
IBM Rational products.
The IBM Rational License Management Guide describes the license management
tools and how to set up your license server configuration. It also describes the
different types of license keys and provides instructions for requesting,
installing, upgrading, and moving licenses. If you are installing IBM Rational
products for the first time, you must read this guide to understand the license
configurations available and the processes for obtaining and managing the
license keys.
For more information about the License Tools utility, go to the IBM support
for Rational products Web site at http://www.ibm.com/developerworks/
rational/support/and search for a technote titled “The recommended setup
for IBM Rational FLEXlm licensing and other third party vendors on a license
server.”
24 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 11. Instructions for basic licensing tasks (continued)
Task Instructions
Install the Rational License 1. Install the IBM Rational License Server
Server and install license keys. software. A license key is not required to
operate the license server software. Follow the
instructions in the IBM Rational License
Management Guide. If you use the installation
procedures in this guide, select Rational
License Server on the Product Selection page.
2. Use the License Key Administrator (LKAD)
wizard to install the license keys. The LKAD
wizard starts at the end of installation. To start
the wizard later, click Start > Programs >
IBM Rational > Rational License Key
Administrator.
Note: You must have local administrative
privileges on the computer to import the
license key into the LKAD wizard.
3. Start the Rational License Server. See the IBM
Rational License Management Guide or the
License Key Administrator Help.
4. Give users the name of the license server.
Configure client desktops to 1. Create a release area and site defaults file. See
request licenses from the IBM “Creating a release area and site defaults file”
Rational License Server. on page 37.
2. Give users the shortcut to the release area.
3. Give users the name of the Rational License
Server. They can use the License Key
Administrator (LKAD) wizard to specify the
license server. The LKAD wizard starts at the
end of installation.
http://www.ibm.com/support/docview.wss?&uid=swg21213439
26 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
The Rational ClearCase Doctor detects any problems with your installation
and provides possible solutions. The Server Storage wizard or the Getting
Started wizard assists you in setting up storage directories for VOB and
view storage.
7. You must perform postinstallation tasks before you can begin using the
product in a production environment. For more information, see
“Postinstallation procedures” on page 55.
8. You can create additional site default files by running setup.exe again or
by running siteprep.exe. For more information, see “Running the Site
Preparation Wizard to create multiple site defaults files” on page 41.
9. You install Rational ClearCase on additional servers and clients by running
the appropriate shortcut created in Step 4 on page 26.
Planning your installation location
It is important that you take the following issues into account when planning
where to install Rational ClearCase:
v All IBM products must reside in the same directory tree. For example, if
you have Rational ClearCase installed in C:\Program Files\IBM Rational,
you must also install Rational ClearQuest in C:\Program Files\IBM
Rational as well.
v When you first install a Rational product, you are given a chance to specify
your installation directory location. Be aware that all subsequently installed
Rational products will be automatically installed to this directory.
v The IBM Rational installation program does not currently support
non-ASCII or double-byte characters in the installation directory path.
v In previous releases, the name of the installation destination directory that
you specified included the name of the product, Rational ClearCase. In this
release, specify only the name of the directory where you want the Rational
ClearCase directory to be created. The standard location for this directory is
drive:\Program Files\IBM Rational. If you specify Rational ClearCase in this
path (for example, C:\Program Files\IBM Rational\ClearCase), the product
is installed in C:\Program Files\IBM Rational\ClearCase\ClearCase.
Information on installing for the first time can be found in this section. To
properly take into account upgrade issues, before making your plan, read
Chapter 5, “Upgrading your Rational ClearCase installation,” on page 63 and
the document at the following location:
http://www.ibm.com/support/docview.wss?&uid=swg21213439
Special consideration for registry server hosts: When creating your registry
server, you must set your registry password. For information about setting the
registry password, see the IBM Rational ClearCase Administrator’s Guide.
Setting up the registry and license server hosts for the first time: If you are
setting up your Rational ClearCase environment for the first time, you must
designate and install Rational ClearCase on a registry server host and a
license server host. You can set up one computer to perform both registry and
license server host roles or you can use different computers. To set up these
hosts, create a release area and modify your site defaults as needed using the
procedures in Chapter 3, “Creating a release area,” on page 35. It is common
to set up a release area specifically for the purpose of installing either a
registry or license server host. Select the appropriate Site Preparation options
to designate your server as either a registry or license server host and then
install the appropriate release area. For information about installing from a
release area, see Chapter 4, “Installing servers and clients,” on page 45.
When setting up your release areas, use the Administrative Information page
to designate the current computer as the registry server. When configuring a
license server, use the License Server Type page to enter the license keys that
you received from IBM if you are using ClearCase Licensing. If you are using
Rational Common Licensing, select this option in the Site Preparation Tool.
For more information about postinstallation procedures for configuring
Rational Common Licensing, see “Licensing your software” on page 52.
28 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
After you set up the registry and license server hosts, set up your server hosts
in a similar manner. You can use the same site defaults file and release area
that you created when you set up the registry and license server hosts; you
can also create site defaults if you need to modify the parameters for
additional server hosts. You will then install the server hosts from the
appropriate release areas.
Configuring Rational Common Licensing
This section provides an overview of the license management tools used with
IBM Rational products.
The IBM Rational License Management Guide describes the license management
tools and how to set up your license server configuration. It also describes the
different types of license keys and provides instructions for requesting,
installing, upgrading, and moving licenses. If you are installing IBM Rational
products for the first time, you must read this guide to understand the license
configurations available and the processes for obtaining and managing the
license keys.
For more information about the License Tools utility, go to the IBM support
for Rational products Web site at http://www.ibm.com/developerworks/
rational/support/and search for a technote titled “The recommended setup
for IBM Rational FLEXlm licensing and other third party vendors on a license
server.”
Administrator privileges
To install IBM Rational products on a Windows operating system, you must
be logged on to a Windows domain account that is a member of the local
30 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
computer’s Administrators group. You must also have the correct privileges
regardless of the installation method (including silent installation) that you
use. If you are not logged on with the appropriate privileges, the product
installation fails. You do not see any information in the installation log file
indicating that incorrect privileges caused the failure.
Defining domain accounts
It is necessary to define a Rational ClearCase users group. All users who
perform routine operations using a common set of VOBs and views must
belong to this group. It can be an existing domain global group or one created
specifically for this purpose.
The Rational ClearCase users group must have the following characteristics:
v It must be a domain global group or an Active Directory universal group.
Do not use a domain global group if you are using Active Directory and
the group needs to include other groups.
v If members of the group must access VOBs or views on a Linux or UNIX
host, the group name must be the same as the name of the Rational
ClearCase users group on Linux and the UNIX system. For more
information, see the IBM Rational ClearCase Administrator’s Guide.
Note: If you do not have domain administrator privileges, you must create
the accounts manually before you create a release area. For more
information, see “Defining required domain accounts manually” on
page 31.
Nondomain installations
Except when evaluating Rational ClearCase, do not install Rational ClearCase
software on nondomain systems. For more information about using Rational
ClearCase on nondomain systems, see the IBM Rational ClearCase
Administrator’s Guide.
Select and share a release area location
Determine a location for the release area from which you will install Rational
ClearCase. Make the release area directory shareable across your network.
Even if the drive containing that directory is already shareable, making the
directory itself shareable makes it easier to find the Rational ClearCase release
area. Restrict write permission to the directory to the administrator.
1. In Windows Explorer, right-click the network release area to display the
directory shortcut menu.
2. Click Sharing.
3. In the Properties window, on the Sharing page, click Shared As and
supply a meaningful share name, such as CC70 Release Area.
You will specify the release area location when you run the IBM Setup wizard
to install the product.
Installing Internet Explorer
To function correctly, the Rational ClearCase Explorer, the Rational ClearCase
HTML Diff Merge tool, the Rational ClearCase Automation Library (CAL)
documentation, and the Rational ClearCase Administration Console, including
its Help, require Internet Explorer Version 6 Service Pack 1 (SP1) or later.
Moreover, the Microsoft Management Console (which is used by the Rational
ClearCase Administration Console) may not install correctly without Internet
Explorer Version 6 SP1 or later.
32 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
You can download and install Internet Explorer from the Microsoft Web site
(go to www.microsoft.com/windows/IE).
This chapter explains how to set up a release area and how to use various
options to create site default files.
Note: If you are upgrading from Rational ClearCase LT, follow the
procedures in Appendix A, “Installing and upgrading Rational
ClearCase LT,” on page 73. You will be directed to follow the
procedures in the rest of the book from Appendix A, “Installing and
upgrading Rational ClearCase LT,” on page 73, as required.
Configuring deployment
Configuring deployment of your software product requires that you
understand the types of deployment methods available for your product. You
can then select the appropriate deployment type for your users and configure
your software for the selected deployment method.
Selecting a deployment method
The IBM Rational Setup wizard supports several deployment methods. If you
are planning the product installation for your work environment; select the
deployment type that is most efficient for you and your users. Table 13
describes each deployment type.
Table 13. Deployment methods
Deployment type Description
Installation from the IBM In the Setup wizard, choose this option if you want to
Rational product CD install the product directly from the IBM Rational product
CD by using the Setup wizard. For more information, see
“Installing client software” on page 45.
36 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Additional deployment tasks
Table 14 points to information about other deployment tasks.
Table 14. Additional deployment tasks
Task Instructions
Installing an evaluation copy of the “Installing client software” on page 45
software
Canceling a product installation “Interrupting an installation” on page 48
Reinstalling the product (modify or “Reinstalling a product” on page 59
repair)
Removing a product “Uninstalling Rational software” on page 60
Using command line syntax “Command syntax for setup.exe” on page 51
Troubleshooting your installation “If your installation was not successful” on
page 58
Applying a fix pack “Applying a fix pack to a release area” on
page 40
There are two methods for creating site defaults files. Both methods create a
disk image of product files in a shareable directory on the network. The first
method creates a release area (Enterprise Deployment). The second method
(Site Preparation wizard) does not create a release area. You can also use these
methods to install the product on your computer after creating a site defaults
file.
v Run the Setup wizard on the IBM Rational ClearCase CD or click Setup.exe
after you extract the files. For more information, see “Using the Setup
Wizard to create a release area and site defaults file” on page 38.
When you create a release area from CD, you might be required to replace
the first CD after the second CD is finished copying.
v Run the Site Preparation wizard multiple times to create multiple site
defaults files. For more information, see “Running the Site Preparation
Wizard to create multiple site defaults files” on page 41.
If users click siteprep.exe without specifying a site defaults file and a file
named sitedefs.dat file is not in the release area, the Site Preparation wizard
creates a new site defaults file.
The default site defaults file is sitedefs.dat. If you can run the setup.exe
command with no arguments, the Setup wizard uses the settings in
sitedefs.dat. You can create multiple site defaults files that are specific to
different products or teams and assign them meaningful names, such as
developers.dat or qualityengr.dat. Users can install the product with the
configurations you create by specifying the site defaults file with the setup.exe
command, for example, setup.exe developers.dat. Or you can prepare
shortcuts for these files, such as developers or developers.lnk, which users can
run from their desktops.
When creating a site defaults file, do not add a file name extension, such as
sitedefs.developers.dat. The maximum length of the path for the release area
of an Enterprise Deployment installation is approximately 30-35 characters.
This limit changes, depending on the product being installed and the length
of the paths of the files that each product installs. You might also see different
error messages when the root path exceeds the the maximum length.
If you plan to apply a fix pack to a release area, see “Applying a fix pack to a
release area” on page 40.
1. Make the release area directory shareable. Even if the drive that contains
the directory is already shareable, making the directory itself shareable
makes it easier to find the product release area.
a. In Windows Explorer, right-click the network release area and click
Sharing.
b. On the Sharing page of the properties window, click SHARE this
folder and provide a meaningful name, such as 7.0 Release Area.
The Setup wizard creates a shortcut to the site defaults file only if the
release area is created under a network share. The shortcut opens in
the release area, for example, as sitedefs or developers without the file
extension .dat.
2. Log in as a user with Administrator rights on the local computer.
3. Insert Disc 1 of your software into the computer CD drive. If you have
downloaded the software, click Setup.exe after you extract the files.
The Rational LaunchPad opens. The LaunchPad provides links to the
installation, guide, release notes, and the IBM developerWorks Web site for
Rational products. The LaunchPad also provides a link to proceed with the
product installation. After you click to install the product, the Setup
wizard starts.
38 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
If autorun is disabled on your computer, click Start > Run and enter
cd_drive: \Setup.exe, where cd_drive is the letter of the CD drive.
The Setup wizard guides you through the software installation.
Click Next to open the next page.
4. The Product Selection page lists all products available for installation.
Select the product that you want to create a release area for, and then click
Next.
5. Select the Enterprise Deployment option on the Deployment Method
page, and then click Next.
6. Depending on the product you have selected, you will see one or more
custom configuration pages in the wizard. Use the Help to provide
instructions in this section of the wizard.
Enter the required information on each page of the wizard. (All required
information is marked in the left panel of the wizard with a red dot.)
To navigate through the pages, you can either click Next to see them
sequentially or click the page title in the left pane to access the page
directly.
7. On the Completion pages, you must fill in the Description page and the
Create a Release Area page. The Launch Installation page is optional.
a. On the Description page, enter a description for users. When you are
finished, click Next.
b. On the Create a Release Area page, enter the release area location and
file name for the site defaults file (*.dat) that you are creating.
Do not use double-byte characters.
If you want to use the site defaults file to install software on your
computer, click Next to go to the Launch Installation page. Select Launch
installation by using these settings. Save the site defaults information to a
file and proceed with the installation on your computer. The Site
Preparation wizard does not currently support non-ASCII or double-byte
characters for site default file names. Click Done and then click Next.
For additional instructions, see “Testing your site defaults file” on page 40.
If you want only to create a release area, click Done and then click Next to
create the site defaults file.
8. When the Setup Complete page opens, review the current information
related to new features and known issues in the release notes available by
clicking the readme check box. You can also view the IBM developerWorks
Web pages. Click Finish to complete the installation of the release area.
For more information about how to install products from this release area, see
“Installing client software” on page 45.
After you create this new release area, disable the old one. Disabling the old
release area prevents access to the previous version of Rational products and
allows access if users need to restore a system to the previous version of
Rational products.
40 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
For disk space requirements, see “Disk space requirements” on page
11. Do not use the number displayed in Custom Setup or click the
Space button on that page.
– When you click Next, you can change any of the existing site default
values. (Any changes to the site default values apply only to this
single installation.) After modifying the values, click Done and then
click Install to begin the installation.
v If you select Use the standard configuration, the features for the
existing site default values are used for the installation. To begin the
installation, click Next and then click Install.
6. If files required for the installation are in use while the Setup wizard is
running and shared components must be installed, the Setup wizard may
need to restart your computer. If so, a Restart Windows page opens.
Select Restart or Don’t Restart. If you select Don’t Restart, the wizard
reminds you that the installation cannot complete until Windows restarts.
The second part of the installation process starts after you log on.
7. When the Setup Complete page opens, review the current information
related to new features and known issues in the release notes, which you
can access by selecting the ReadMe check box. In addition, you can view
the IBM developerWorks Web pages. Click Finish to complete the
installation.
Running the Site Preparation Wizard to create multiple site defaults files
In some cases, your site might require multiple site defaults files. For
example, if a database administrators group and a client user group use the
same product but need to work with different default settings in the product,
you can create a site defaults file for each group.
If you enter the name of an existing site defaults file, you see a warning
message. You can overwrite the existing file or specify a different file name to
create a new site defaults file.
This section describes how to set up and test the performance of a silent
installation.
Silent installation setup
The basic steps for setting up a silent installation are described in this section.
1. Create a site defaults file and a release area (optional) on the network.
a. Use the Enterprise Deployment option in the Rational Setup wizard to
create a site defaults file and a release area to deploy the product to
your users. For instructions, see “Creating a release area and site
defaults file” on page 37.
Or use the Site Preparation wizard by double-clicking siteprep.exe in
the CD image or IBM download package, or entering siteprep.exe on
the command line to create a site defaults file without the release area.
b. You can customize site defaults files for different sets of users. For
more information, see “Running the Site Preparation Wizard to create
multiple site defaults files” on page 41.
2. Enter the command setup.exe /g to start the Setup wizard and test the site
defaults file. You should not see any installation screens displayed on your
computer during the installation.
The file directs the Rational Setup wizard to install program files in a
specific directory on your computer. If necessary, the computer restarts.
When you log on again, the installer restarts and finishes. When the
installation is finished, you do not see a screen indicating that the
installation is complete.
42 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
If you did not specify the license server in the site defaults file, you or
your users might have to configure licensing manually after the Setup
wizard finishes.
3. Give users the following information so that they can perform silent
installations on their computers.
v Path to the site defaults file and the setup.exe file in the release area or
the shortcut to the site defaults file. (The shortcut does not have a .dat
file-name extension.)
v Silent installation commands.
v Installation directory (where the Setup wizard installs the files on your
desktop).
v License key information, if necessary.
Also, ensure that users remove all IBM Rational products from their
computers. Users who install silently do not see the message to remove
previous versions of IBM Rational products. The installation does not proceed
until all products are removed. The message is saved in the user’s installation
log file. If the installation fails, tell users to examine the log file. For more
information about this file, see “If your installation was not successful” on
page 58.
For information about setup.exe command syntax, see “Command syntax for
setup.exe” on page 51 or type setup / ?.
Testing a silent installation
After you create the site defaults file, test it by running a silent installation.
Follow the instructions in “Running a silent installation” on page 50.
46 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v In Windows Explorer, expand the mapped drive and run the shortcut
specified by your administrator, for example, sitedefs_client.lnk or
sitedefs_client.
For more information about the Setup wizard, see “Running the Rational
Setup Wizard.”
Installation from a CD or Web download
This section describes a typical installation of a product from the product CD
or from a software package that you downloaded from the IBM Rational
Licensing and Download center.
1. Log in as a user with Administrator rights on the local computer.
2. Insert Disk 1 of the IBM Rational ClearCase CD into the CD drive. If
autorun is enabled, the installation begins. If autorun is disabled, click
Start > Run and enter the following command, where cd_drive is the letter
of the CD drive:
cd_drive:\Setup.exe
3. If you downloaded the software, extract the files and click Setup.exe. The
Setup wizard starts.
Running the Rational Setup Wizard
The Setup wizard guides you through the software installation, regardless of
the deployment method. On each page, click Next to open the next page. The
following procedure guides you through the steps of the Setup wizard.
1. If the product you are installing has been translated to the language of
your operating system, the language selector is the first window that
opens after you start the Setup wizard. You can select English or the
language of your operating system.
2. The next window that opens is the Rational LaunchPad. The Rational
LaunchPad provides links to the installation guide, release notes, and the
IBM developerWorks Web site for Rational products. The LaunchPad also
provides a link to proceed with the product installation. Select this option
to continue with the installation.
3. On the Deployment Method page, select Desktop installation from CD
image.
4. An upgrade warning displays if you have previous versions of Rational
products on your computer. If you continue with the installation, these
products are uninstalled. For more information, see Chapter 5,
“Upgrading your Rational ClearCase installation,” on page 63.
5. The License Agreement page displays the IBM Rational software license
agreement. You must accept the agreement before continuing with the
installation. To accept the agreement, click Agree; to end the installation,
click Decline.
(http://www.ibm.com/support/
docview.wss?&uid=swg21213439).
The version of the IBM product you Install the product on a supported operating
are attempting to install is not system. For a complete list of supported
supported on the current operating operating systems and service packs, see “Disk
system. space requirements” on page 11.
48 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 15. Warnings and blocks (continued)
Warning or block Solution
You are attempting to install on a For a complete list of supported browsers, see
system with an unsupported “Disk space requirements” on page 11.
browser.
You are attempting to install on a For a complete list of supported versions, see
system that has a version of “Disk space requirements” on page 11.
Microsoft Office that is not
compatible with SiteCheck.
You are attempting to install on an Use a supported version. For the complete list
unsupported version of WebSphere of supported operating systems, see “Disk
Studio. space requirements” on page 11.
The version of MSI on this machine You must update MSI to continue with the
is older than the required version installation. Click Yes to proceed.
(version 3.1). You must update this
before the installation can proceed.
Please wait while MSI is being
updated. This may take some time.
Would you like to update the MSI
version now?
The version of the InstallShield You must update the InstallShield scripting
scripting engine on this machine is engine to continue with the installation. Click
older than the required version Yes to proceed.
(version 10.5). You must update this
before the installation can proceed.
Would you like to update the
InstallShield scripting engine now?
The versions of MSI and the You must update MSI and the InstallShield
InstallShield scripting engine on this scripting engine to continue with the
machine is older than the required installation. Click Yes to proceed.
versions (3.1 and 10.5 respectively).
You must update these before the
installation can proceed. Please wait
while is MSI is being updated. This
may take some time. Would you like
to update the MSI and InstallShield
scripting engine now?
MDAC and ODBC. If the correct MDAC and ODBC drivers are
not installed on your computer, the Setup
wizard installs version 2.7 of the Microsoft
Data Access Components (MDAC) and Open
Database Connectivity (ODBC) drivers. For
more information, read Microsoft Knowledge
Base Article 216149.
The site defaults file directs the Setup wizard to install program files in a
specific directory on your computer. For information about setting up a silent
installation, see “Setting up silent installations of IBM Rational products” on
page 42.
When you start the silent installation, you do not see any installation screens.
If necessary, your computer restarts and you must log on again. When the
installation finishes, you do not see a screen indicating that the installation is
complete. If your administrator did not specify the license server in the site
defaults file or if you are using a node-locked license key, you might have to
configure licensing manually after the Setup wizard finishes. For more
information, see “Licensing your software” on page 52.
Also, verify that you have removed all previous versions of Rational products.
Users who perform silent installations do not see the warning message to
remove these products. The installation does not proceed until all of these
products are removed. This warning message is saved in the installation log
file. Examine this file if the installation fails. For more information about this
file, see “If your installation was not successful” on page 58.
Note: If you perform the silent installation but do not have administrator
rights on the computer, there is no indication that the product
installation has failed.
50 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
2. Click Start > Run and enter the following commands, where local-drive is
the mapped drive or the path to setup.exe and filename is the name of the
site defaults file:
local-drive: \setup.exe /g C:\filename.dat
The product specified in the site defaults file is installed from the source
directory to the installation directory. The default installation directory is
C:\Program Files\IBM Rational\IBM Rational-products.
If necessary, your computer restarts. You must then log on manually; the
installer restarts and finishes. When the installation finishes, you do not
see a message indicating that the installation is complete.
If your administrator did not specify the license server in the site defaults
file, you might have to configure licensing manually after the Setup
wizard finishes.
If the Setup wizard detects insufficient disk space on the desktop, the
wizard cancels the installation and notes the error in the
Rational_install.log file in your TEMP directory. The location of the
directory depends on the environment variable set on the computer. To
find the location, open a command window and type echo %TEMP% at the
prompt.
There is no command to cancel a silent installation.
Command syntax for setup.exe
Installs a Rational product from a Windows command prompt.
Synopsis
setup [/g silent_install] path-to-sitedefs.dat
[/lv logfilename] [/d default_language]
Description
The setup command starts the Rational Setup wizard, which installs the
product on your computer. When running the setup command, you must
specify the location of the file sitedefs.dat. For more information about
installing from a release area and using sitedefs.dat, see “Installing from a
release area” on page 46. The command also has the options to run a silent
installation, create a detailed log file, and install the product in the default
language of your operating system.
Example
Runs a silent installation, creates a log file, and installs the product in the
default language of the operation system.
setup /g \rational_release\sitedefs_client.dat /lv C:\temp\install_log.txt /d
You can also see an abbreviated display of the command and its parameters
by running MSIEXEC.exe /? in a Windows command prompt.
Licensing your software
In all cases, you need a license key to start the product. Your license
administrator can tell you which license key to use and where to obtain it.
The License Key Administrator (LKAD) is a tool that imports license keys to
your license server. The LKAD provides a wizard to simplify the process.
The Rational Setup wizard installs the LKAD with each IBM Rational product.
If the product is not already licensed, you can start the LKAD wizard when
the installation process is finished. You can also start the LKAD by clicking
Start > Programs > IBM Rational > Rational License Key Administrator.
The LKAD main window and wizard page open simultaneously. For more
information, see the LKAD Help.
If you do not see the License Key Administrator (LKAD) start at the end of
the installation, your product is already licensed.
52 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Follow the instructions in Table 16 to license your IBM Rational product.
Table 16. Requesting and installing IBM Rational license keys
Type of license Where to request license
key key How to install
Permanent AccountLink Import the key on your desktop
node-locked (www.ibm.com/software/ with the License Key Administrator
rational/support/licensing/) (LKAD) wizard.
Permanent AccountLink To configure your client to point to
floating (www.ibm.com/software/ the license server, use the License
rational/support/licensing/) Key Administrator (LKAD) wizard.
Your administrator must install and
set up the license server first. (For
instructions, see the IBM Rational
License Management Guide.)
Note: After working on the Licensing page, click Apply to apply your
changes before you click OK to close the control panel. Clicking
Apply is mandatory to successfully change license modes, even
after the License Key Administrator has started and you have
obtained keys using that interface.
2. On the Services Startup page, stop and restart Rational ClearCase.
3. If you have selected Rational Common Licensing, the Rational License Key
Administrator will start. for more information, see “Licensing your
software” on page 52.
54 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Note: If you are running Windows XP, you must be using the classic
Windows control panel view to access the Rational ClearCase Control
Panel.
The Custom Setup page lists the features for the product to be installed. The
feature list in an IBM Rational Suite edition includes IBM Rational point
products.
For disk space requirements, see the “Disk space requirements” on page 11.
Ignore the number displayed in Custom Setup and do not use the Space
button on that page.
Table 17. Custom setup in the Setup Wizard
To install/enable Choose product Notes
Rational ClearCase MVFS Enables dynamic view support and associated build
dynamic view management.
support
Creation of views and Local views and VOBs Allows creation of views and VOBs on the local
VOBs on the local host.
host
MultiSite Rational ClearCase An optional add-on to Rational ClearCase that
MultiSite enables project teams to develop software across
multiple locations.
MultiSite Admin Web Rational ClearCase Installs a Web-based interface that allows an
interface MultiSite Admin Web administrator to monitor and manage MultiSite
tasks.
Rational ClearCase Rational ClearCase Web Enables server support for Rational ClearCase Web
Web interface interface browser access.
Postinstallation procedures
After the installation is complete, you may perform several postinstallation
procedures.
Table 18 lists the possible scenarios where additional tasks may need to be
performed, and information about those tasks.
Users who are members of multiple domain groups must set the user
environment variable CLEARCASE_PRIMARY_GROUP to the
domain-qualified name of the Rational ClearCase users group (for example,
NT_WEST\clearusers). This guarantees an unambiguous definition of the
group that the software considers the user’s primary group. Users who are
members of a single domain group do not have to take this step.
56 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
To verify that CLEARCASE_PRIMARY_GROUP has been properly set:
1. Click Start > Programs > Rational Software > ClearCase >
Administration > ClearCase Doctor.
2. Click Start Analysis.
3. When the analysis is finished, click the Topics tab and open the User
Login Account folder.
4. Double-click Primary Group, read the user’s primary group, and verify
that it is correct.
For more information, see the IBM Rational ClearCase Administrator’s Guide.
Specifying Windows domain for credential mapping of Linux and UNIX
system users
If your VOB, view, registry, or license server hosts will be accessed by Linux
and UNIX system clients, you must specify the Windows domain that will be
used to map the credentials of Linux and UNIX system users.
For more information about formatting your VOBs, see Chapter 5, “Upgrading
your Rational ClearCase installation,” on page 63.
Configuring storage with the Server Storage Wizard
If you specified that your computer is to be a Rational ClearCase server, the
Rational ClearCase Server Storage Configuration wizard runs when you first
log on after the installation restarts.
This wizard allows you to specify locations on the server that are available to
Rational ClearCase clients for VOB and view storage directories.
You must log on with the same user ID that you used to run the installation.
The Help for the wizard provides configuration details. For more information
about storage configuration, see the IBM Rational ClearCase Administrator’s
Guide.
Note: Removing Rational ClearCase unregisters storage locations but does not
remove physical data from the computer. The Server Storage Wizard
cannot locate prior storage locations without valid register entries. It is
possible to add registry entries to gain access to physical data following
an uninstall of the product. See the Administrator’s Guide for more
details.
Enabling MultiSite synchronization
You enable Rational ClearCase MultiSite by selecting the option on the
Features page in the Site Preparation Tool.
By default, the installation log file is in the TEMP directory. The location of
the directory is set in the TEMP environment variable on the computer. To
find the location, open a command window and type echo %TEMP% at the
prompt.
This folder and file may be hidden. To display them in Windows Explorer,
select Show Hidden Files and Folders when searching for the file.
58 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
The installation log is not cumulative. The log file is overwritten when you
perform another installation or when you repair or modify an existing
installation. If you need to save the log, either copy it to a different location or
rename it before you install another product.
Diagnosing errors with Rational ClearCase doctor
Rational ClearCase Doctor can analyze your Rational ClearCase servers and
clients for existing and potential problems.
ClearCase Doctor is run by the IBM Setup wizard before installing a new
version of Rational ClearCase; it also runs on a new installation after you log
on. Afterwards, you can set Rational ClearCase Doctor to run each time you
log on (the default), turn it off entirely, or run it in the background. At a
minimum, running Rational ClearCase Doctor in the background can detect
changes in your Rational ClearCase environment that may affect operations.
You can run Rational ClearCase Doctor at any time. Click Start > Programs >
Rational Software > Rational ClearCase > Administration > ClearCase
Doctor.
Reinstalling a product
To modify or repair an installation, use Add or Remove Programs in the
Windows Control Panel.
Before you modify or repair an installation of any product, save the original
installation log to a different location or rename it. If you do not save it, the
log file is overwritten.
60 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v Before removing the Rational products (including the Rational License
Server) from clients, record the specified license server host names in the
License Key Administrator (LKAD).
1. Start the LKAD by clicking Start > Programs > IBM Rational > IBM
Rational License Key Administrator.
2. Find the host names by clicking Settings > Client/Server
Configuration.
3. After you install the new Rational products, reset the license server
name in the LKAD. The LKAD wizard starts after the installation. If the
wizard does not start, click Start > Programs > IBM Rational > IBM
Rational License Key Administrator.
v To remove Rational products from a computer running Windows 2000 or
Windows XP , you must have Windows administrator privileges on the
local system.
v Make sure that no one is using the application or any associated files. You
cannot remove files that are in use.
To uninstall from the command line: If you want to uninstall Rational products
from the command line, you must use the MSIEXEC.exe application. For
information about this command and its parameters, perform one of the
following actions:
v Go to http://www.microsoft.com/resources/documentation/windows/xp/
all /proddocs/en-us/msiexec.msp .
v Enter MSIEXEC.exe /? in a Windows command prompt.
For more information about uninstalling the software and the order in which
you must upgrade Rational ClearCase hosts, see “Planning the installation
process” on page 27.
Planning the order of your upgrade
When upgrading Rational ClearCase hosts, uninstall and reinstall the product
on these hosts, in this order:
v License server host
v Registry server host
v Server hosts
v Client computers
When upgrading your registry server, you must set your registry password.
For information about setting the registry password, see the IBM Rational
ClearCase Administrator’s Guide.
Upgrading server hosts
Consider the following information for upgrading Rational ClearCase server
hosts:
v Make sure that all views and VOBs are fully backed up. For information
about backing up views and VOBs, see the IBM Rational ClearCase
Administrator’s Guide.
v If you have modified any files in ccase–home–dir (by default, C:\Program
Files\Rational\ClearCase), you must save them before installing Rational
ClearCase.
64 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v During the uninstallation process, you will be asked if you want to delete
the Start menu folders. Click Yes.
v Before upgrading your license server, copy your license key string to
another location, such as a text file. When you install your new license
server, you can then copy the string from the text file, for convenience.
Reinstalling using a new directory path
When upgrading, if you cannot install Rational ClearCase in the same
directory tree as the previous release, it is important that you preserve the
\var directory as described in “Upgrading server hosts” on page 64. You also
must copy any changed elements from the \var directory in the previous
Rational ClearCase installation to the \var directory in the new installation.
66 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
2. Install or re-install Rational ClearCase version 2003.06.xx and enable
schema 54 support.
3. Using the cleartool reformatvob command, reformat your VOBs after
installation.
4. Test the reformatted VOB to make sure that you can still perform simple
commands such as checkout and describe.
5. Upgrade to Rational ClearCase version 7.0.
For information about moving VOBs, views, and the registry and license
databases, see the IBM Rational ClearCase Administrator’s Guide.
Upgrading Rational ClearCase Web and other products using the Rational Web
Platform (RWP)
If you are upgrading Rational ClearCase Web, the Rational ClearCase Remote
Client, or other products that utilize the Rational Web Platform (RWP),
perform the following procedure when upgrading only if you have created
customized directive in the /Program Files/Rational/common/rwp/conf
directory. Keep in mind that the new path for RWP version 7.0 is /Program
Files/Rational/common/rwp/IHS.
1. Make a backup of your RWP configuration file (in the /Program
Files/Rational/common/rwp/conf directory). Upgrading to another
version of Rational ClearCase(which contains RWP components) will
overwrite your existing RWP configuration.
2. Uninstall and reinstall Rational ClearCase.
Before you can use SSL certificates from an earlier version of RWP with
Rational ClearCase version 7.0 you must first export the certificates to PKCS12
format. For more information on this task, see the IBM Rational ClearCase
Administrator’s Guide.
68 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v
Client is too old for this server. Please upgrade client software.
v
Client is too new for this server. Please revert client software.
Follow these steps to install GEF with the Eclipse Update Manager:
1. On the Eclipse main menu, click Help > Software Updates > Find and
Install.
2. On the Feature Updates page, select Search for new features to install
and then click Next.
3. On the Update sites to visit page, select the Eclipse.org update site and
expand the option to see a list of available features.
4. Select GEF SDK and then click Next. (Choose a version of GEF that
corresponds with the version of Eclipse that you are using.)
5. On the Search Results page, select Graphical Editing Framework and then
click Next.
6. On the Feature License page, select I accept the terms in the license
agreement... and then click Next. If you do not accept the terms, click
Cancel to end the installation.
Upgrade steps: CCRC version 7.0 does not automatically display in the
Eclipse Update Manager as an update for existing version 6.14.x installations.
The user must follow these steps to upgrade CCRC version 6.14.x to version
7.0:
1. On the Eclipse main menu, click Help > Software Updates > Find and
Install.
2. On the Feature Updates page, select Search for new features to install
and then click Next.
3. On the Update sites to visit page, select the remote update site that refers
to the Rational ClearCase Web server (this was defined during the
installation of version 6.14.x).
4. Select the CCRC version 7.0 feature and continue as usual.
The user now has the CCRC version 7.0 feature installed in their Eclipse
environment. They can choose to activate and deactivate the version as
needed and switch between different versions of CCRC.
70 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Rational ClearCase Remote Client for Visual Studio
The Rational ClearCase Remote Client for Visual Studio (CCRC_VSI) will use
an MSI installer. The user must uninstall CCRC_VSI 6.14.x before they can
install CCRC_VSI version 7.0.
If you are installing Rational products for the first time, follow the
instructions in the installation guide for each product that you install.
If you have installed a Rational product that was a part of Rational Suite,
review the upgrade section of this guide carefully. Version 7.0 is a major
release that includes changes to installation and other operating processes,
dependencies between products, and interoperability with product
integrations. In some cases, tasks must be performed in a specific sequence,
for example, upgrading server components before upgrading clients.
In earlier releases, when a product from Rational Suite was installed, the
Rational License Key Administrator (LKAD) application tried to find a license
key that corresponded to Rational Suite. If such a key was not available, the
LKAD searched for a key that corresponded to the product itself.
In version 7.0, the LKAD looks for the product-specific license key first. You
can still use the License Usage Mapper in the LKAD to change this search
order or have the application not search for a Rational Suite key. For more
information about licensing, see the IBM Rational License Management Guide.
Although some mixed versions of the Rational products are supported across
an enterprise network, all Rational products on a single computer must be the
same version. For example, you cannot run version 2003.06.15 of Rational
ClearQuest with version 7.0 of Rational ClearCase. For upgrade information,
see Chapter 5, “Upgrading your Rational ClearCase installation,” on page 63.
74 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
server. A Rational ClearCase LT server can support multiple VOBs and
views, and can service the needs of many Rational ClearCase LT clients.
v ClearCase LT client. Each ClearCase LT user works at a Rational
ClearCase LT client computer, running commands and programs, various
user interfaces, and other software (for example, development tools, an IBM
Rational Suite, and operating system utilities). Rational ClearCase LT must
be installed on each client.
Install and configure the Rational ClearCase LT server before your users
install the Rational ClearCase LT client or any IBM Rational Suite that
includes a Rational ClearCase LT client. See “Selecting a Rational
ClearCase LT server” on page 77.
Installing the Rational ClearCase LT server
Designate a shared release area by following the procedures in “Select and
share a release area location” on page 32, then install Rational ClearCase
servers by following the server procedures in Chapter 3, “Creating a release
area,” on page 35 and Chapter 4, “Installing servers and clients,” on page
45.
After installation
Perform additional Rational ClearCase LT server tasks. See “Additional
configuration tasks” on page 78.
76 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 20. Rational ClearCase LT server installation checklist (continued)
Done Task
If you plan on removing Rational ClearCase VOB data from a Rational
ClearCase LT server, read the considerations in “Before you remove
Rational ClearCase data from the Rational ClearCase LT server” on page
82.
The Rational ClearCase LT server runs a number of server processes for each
VOB it supports. The server might have to support hundreds of such
processes in addition to supporting network access from many clients. As
such, follow the guidelines in this section when specifying the server’s
physical memory, storage, processor, and network interface hardware. In
addition, you may want to use the performance tuning procedures described
in the chapter “Improving VOB Host Performance” in the IBM Rational
ClearCase Administrator’s Guide.
Note: Instead of using the workstation variant of the operating system, use
the Windows server (Windows 2000 Server, for example). Windows
limits concurrent network access to systems on which Windows 2000
Professional software is installed to a maximum of 10 systems. If you
anticipate that more than 10 Rational ClearCase LT clients will need to
access the Rational ClearCase LT server simultaneously, install
Windows 2000 Server software on your Rational ClearCase LT server.
If you can, log on as a user who is both a local administrator on the Rational
ClearCase LT server and a member of the Rational ClearCase Users Group. It
will simplify installation and setup of the Rational ClearCase LT server.
If you install the client before you try to install the server, on the same
computer (you should not install all Rational ClearCase LT software on the
same computer unless you are evaluating Rational ClearCase LT), the Setup
wizard detects the client software and does not install Rational ClearCase LT
server.
Additional configuration tasks
After the initial installation of a Rational ClearCase LT server, perform these
additional tasks.
1. If you have not already done so, review the IBM Rational ClearCase LT
Release Notes. The document contains the most current information
related to ClearCase LT features and known issues.
2. To install Rational ClearCase LT on your client computers, follow the
instructions in “Installing the Rational ClearCase LT client” on page 82.
78 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
3. Rational ClearCase LT provides support for importing data and metadata
from a variety of vendor configuration management and source code
control systems. It also provides support for importing ordinary files and
directories into Rational ClearCase.
You might want to import files and directories from another
configuration management system or directly from the file system and
put them under Rational ClearCase control. For more information, see the
IBM Rational ClearCase Administrator’s Guide.
4. Create storage locations for your views and VOBs using one of the
following methods:
a. Create a shared directory on your computer, for example: vmshare.
b. Create a storage location for your VOB in the shared directory using
the command line. In the following example, ClearCaseStorage and
VOBs are suggested directory names:
cleartool mkstgloc -vob VOBs \\vmshare\ClearCaseStorage\VOBs
c. Create a storage location for your views in the shared directory using
the command line. In the following example, ClearCaseStorage and
Views are suggested directory names:
cleartool mkstgloc -view Views \\vmshare\ClearCaseStorage\Views
If the commands complete successfully, you will see the following results
for each command:
Created and advertised Server Storage Location.
Host-local path: vmshare:drive-letter:
\ClearCaseStorage\{Views | VOBs}
5. Create a view using the command line:
Note: You can also create a view using the View Creation Wizard, if you
prefer. Click Start > Programs > IBM Rational > Rational
ClearCase > Create View
.
6. To configure the Rational ClearCase Web interface, see IBM Rational
ClearCase Administrator’s Guide.
If the command completes successfully, you will see the following results:
Selected Server Storage Location "VOBs".
Created versioned object base.
Host-local path: VMShare:drive-letter:\ClearCaseStorage\VOBs\sources.vbs
VOB ownership:
owner VMShare\Administrator
group VMShare\None
If the command completes successfully, you will see the following results:
Created versioned object base. Host-local path:
VMshare:drive-letter:\ClearCaseStorage\VOBs\projects.vbs
VOB ownership:
owner VMShare\Administrator
group VMShare\None
80 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
a. In the left pane of the Project Explorer, under the projects folder,
right-click component.
b. Click New > Component in a VOB.
c. In the Create a Component in a VOB window, type the component
VOB, component name, and root directory of the component you
want to create. Click OK.
d. In the Choose a View window, select the view you want to associate
with the component. Click OK.
11. Create a UCM project. See IBM Rational ClearCase Guide to Managing
Software Projects.
a. In the left pane of the Project Explorer, right-click the projects folder,
and click New > Project.
b. In step 1 of the New Project wizard, define the project name and
integration stream name, and add a brief description of the project.
Select the project type, either Traditional parallel development or
Single stream development. When you complete this page, and
subsequent pages, click Next to advance to the next step in the
wizard.
c. In step 2, decide if you want to seed this project with baselines from
an existing stream in another project. If so, select Yes, seed this
project with baselines from the stream selected below and navigate
to the appropriate project in the area below. Otherwise, choose No.
d. In step 3, define your component baselines by first clicking Add. In
the Add Baseline window, select the component to baseline from the
Component: drop-down list. Choose a stream where you want the
baseline defined by clicking Change. Select All Streams to view all
available streams, or Browse to locate a specific stream. After the
desired stream appears in the Baselines: area, select the stream you
want to use and click OK.
e. In step 4, select other options such as which components should be
modifiable, which default promotion level to use, and the default
deliver target. Follow the instructions on the screen.
f. In step 5, specify if the project should be enabled with Rational
ClearQuest. If you have a Rational ClearQuest user database that you
have set up to use with this project, select Yes, use the ClearQuest
databases selected below: or, if not, click No. If you chose Yes, use the
ClearQuest Link area to define the database Connection and User
Database by selecting them from the appropriate drop-down boxes.
You are asked to authenticate with a Rational ClearQuest user name
and password. Click Policies to choose from available policies to apply
to the Rational ClearQuest integration. For information about enabling
your project VOB for use with Rational ClearQuest, see IBM Rational
ClearCase Guide to Managing Software Projects.
You should never remove Rational ClearCase data from a computer unless
that data was used for purposes of evaluation only and you have no intention
of saving it or using it in a production capacity.
82 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Rational ClearCase LT client installation checklist
Use the checklist in Table 21 to help you install the Rational ClearCase LT
client on your desktop. Use the checklist in Table 22 to help you configure the
Rational ClearCase Web client.
Table 21. Rational ClearCase LT native client installation checklist
Done Task
Before installation
Learn about licensing your IBM Rational software. See “Licensing Rational
ClearCase LT” on page 84.
Check the system and software requirements for running Rational
ClearCase LT on your desktop. See “System requirements” on page 9.
Check with your administrator to ensure that the Rational ClearCase LT
server has been installed and configured before you use Rational
ClearCase LT. If you are installing Rational ClearCase LT as part of a
Rational Suite®, see “Installation order for Rational ClearCase LT” on page
78 and “Installing this product as part of IBM Rational Suite” on page 73.
Ensure that you have administrator privileges on your desktop. See
“Administrator privileges” on page 30.
Ask your administrator what deployment type you should select when
installing. See “Installation order for Rational ClearCase LT” on page 78.
Set the CLEARCASE_PRIMARY_GROUP environment variable. See “Setting
the Rational ClearCase primary group” on page 56.
Installing the Rational ClearCase LT client
To install Rational ClearCase LT, see Chapter 4, “Installing servers and
clients,” on page 45. Your administrator should give you the name of the
Rational ClearCase LT server if you are installing Rational ClearCase LT
from a CD. If you are installing from a release area, the server name may
already be included in the site defaults file.
After installation
Create a view. See the Rational ClearCase Help.
Rational ClearCase LT can use a node-locked IBM Rational Suite license key.
After you have installed the node-locked license, use the License Usage
Mapper to specify that Rational ClearCase LT is to use the Rational Suite key.
IBM Rational does not provide a stand-alone node-locked license for Rational
ClearCase LT. For more information about the License Usage Mapper, see the
IBM Rational License Management Guideor the License Key Administrator Help.
Note: Normally, your Rational ClearCase LT clients will use whatever license
server is designated by the Rational ClearCase LT server installation. In
this case, the default licensing mode is Rational Common Licensing. If
the Rational ClearCase LT client is using a full Rational ClearCase
license server, the default licensing mode is ClearCase Licensing.
84 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 23. Checklist for upgrading Rational ClearCase LT to Rational ClearCase
software (continued)
Done Task Information
Establish your Rational ClearCase release “Establishing your Rational
area. ClearCase release area” on
page 89
Check in all checked-out files or directories “Remove all Rational
and remove all Rational ClearCase LT ClearCase LT views” on page
views. 89
Perform either the simple upgrade “The simple upgrade
procedure or the upgrade-and-merge procedure” on page 90 or
procedure. “The upgrade-and-merge
procedure” on page 92
If you are upgrading a VOB that was Ensure you change your old
created using a version of Rational default Rational ClearCase LT
ClearCase LT earlier than version 7.0: region name to the newly
created full Rational ClearCase
region name by performing
the following procedure:
1. Navigate to the Rational
ClearCase control panel by
Clicking Start > Control
Panel.
2. On the Registry page,
change the Windows
region to the name of the
newly created full Rational
ClearCase region name.
3. Click Apply and OK.
4. Mount your VOBs.
Upgrade options
When you upgrade, choose one of two options:
v Simple upgrade
v Upgrade and merge
You can upgrade your Rational ClearCase LT server and its clients in a single
operation or upgrade the server first and upgrade the clients later. A Rational
ClearCase LT client can access an upgraded Rational ClearCase LT server as
long as it can acquire a Rational ClearCase license from that server; but the
client cannot use Rational ClearCase features until it has been upgraded.
The VOBs can remain on the upgraded Rational ClearCase LT server or can
be moved to another Rational ClearCase server.
Upgrade considerations
This section explains the differences in functionality when you upgrade from
Rational ClearCase LT to Rational ClearCase.
86 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
performs both functions. If you choose the upgrade-and-merge option,
existing Rational ClearCase license and registry server hosts perform these
functions.
If you choose the simple upgrade and designate your Rational ClearCase LT
server as the Rational ClearCase license server and registry server host, all
Rational ClearCase LT clients, whether or not they have been upgraded, can
access VOBs and views on the upgraded Rational ClearCase LT server with
minimum reconfiguration.
If you are upgrading and merging with an existing Rational ClearCase site,
you install Rational ClearCase software from that site’s networkwide release
area and can use that release area’s site defaults for the license and registry
server hosts. More Rational ClearCase licenses may be needed after the
upgrade, and you may need to add them to the license database of the
existing license server host.
If you need to access these VOBs from client hosts that are not of the same
platform type (Windows or Linux and the UNIX system) as the Rational
ClearCase LT server, you must create an additional registry region for use by
these clients, and then create tags appropriate for the hosts that use this
region. Step on page 91 of “Performing the upgrade” on page 90 describes
this process.
If you use the upgrade-and-merge option, you can take advantage of existing
registry regions.
VOB access between Windows and Linux and the UNIX system: If you
plan to use Rational ClearCase with both Windows and Linux and the UNIX
system, be aware of an interoperability restriction.
Rational ClearCase hosts running Linux and the UNIX system cannot use
dynamic views to access VOBs hosted on Windows. If your Rational
ClearCase LT server runs Windows and you need to access VOBs on Linux
and the UNIX system using dynamic views, you must move the VOBs to a
Linux and UNIX system server.
If you plan to install such a package, install it after the upgrade is complete.
For more information, see the IBM Rational ClearCase Administrator’s Guide.
Preparing to upgrade
Before you upgrade, complete the following tasks:
v Acquire your Rational ClearCase licenses.
88 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
v Establish your Rational ClearCase release area.
v Remove your Rational ClearCase LT views.
You must create a new networkwide release area with each release, except
when using the upgrade-and-merge procedure (because you use one that
already exists).
90 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
For information about view and VOB storage locations, see the IBM
Rational ClearCase Administrator’s Guide.
4. Run the upgrade tool. Run the cclt2cc upgrade tool. The upgrade tool
performs these tasks:
v Registers VOB storage locations on the upgraded Rational ClearCase LT
server in the server’s default registry region.
v Creates VOB tags for VOBs on the upgraded Rational ClearCase LT
server in the server’s default registry region.
v Changes file system protection information about all VOB storage
directories so that it is appropriate for Rational ClearCase software.
Note: When you upgrade the Rational ClearCase LT server, you must
install Rational ClearCase software in the directory where Rational
ClearCase LT software was installed (normally C:\Program
Files\Rational\ClearCase). Otherwise, the upgrade procedure
cannot complete successfully. This restriction does not apply when
upgrading Rational ClearCase LT clients.
5. Run the upgrade tool. You must next run the cclt2cc upgrade tool. The
upgrade tool performs these tasks:
v Registers VOB storage locations on the upgraded Rational
ClearCase LT server in the server’s default registry region.
v Creates VOB tags for VOBs on the upgraded Rational ClearCase LT
server in the server’s default registry region.
v Changes file system protection information about all VOB storage
directories so that it is appropriate for Rational ClearCase software.
92 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Note: If the installation process detects that a Rational ClearCase LT
server resides on the system, you must uninstall Rational
ClearCase LT software and start the installation again.
cclt2cc is located in the ccase–home–dir\etc\utils directory. To run cclt2cc:
a. Log in as a user with local administrator privilege to the upgraded
Rational ClearCase LT server.
b. Run the command at the Windows command prompt. The following
example upgrades all the VOBs on the Rational ClearCase LT server
and creates tags for them in the server’s default region
ccase–home–dir\etc\utils\cclt2cc -w registry-password
For more information about the cclt2cc tool and associated command-line
options, see “cclt2cc command line options” on page 95.
6. Get information about storage locations and VOBs on the upgraded
server. Log on to the upgraded Rational ClearCase LT server. Run the
cleartool lsstgloc –l and lsvob –l commands to get information about
server storage locations and VOBs on the upgraded server. You need this
information in Step on page 93 and Step on page 93 of this procedure.
7. Register the upgraded server’s storage locations in the existing registry.
On another Rational ClearCase host, one that has network access to the
file system of the upgraded Rational ClearCase LT server and is a
member of the registry in which you want VOBs on the upgraded
Rational ClearCase LT server to have tags, run the cleartool mkstgloc
command to register storage locations on the upgraded Rational
ClearCase LT server.
8. Register and create tags for the upgraded server’s VOBs in the existing
registry. On the same Rational ClearCase host that you used in Step on
page 93, run the cleartool register and mktag commands to register and
check tags for the VOBs on the upgraded Rational ClearCase LT server.
9. Verify that the VOBs are accessible. Verify that all Rational ClearCase
hosts in the region can access the VOBs on the upgraded Rational
ClearCase LT server.
10. Make the upgraded server a member of the existing registry.
Reconfigure the upgraded Rational ClearCase LT server so that it is no
longer a registry server and is instead a member of the existing registry
region.
11. Create an additional Rational ClearCase registry region if needed. If
you require interoperability between Windows and Linux and UNIX
hosts:
a. Create a new region for Linux and UNIX hosts.
b. On Windows hosts, specify this region as a peer region.
For more information about these tasks, see the IBM Rational ClearCase
Administrator’s Guide.
On the Stream page, click Reuse an existing development stream, and then
select the stream you want to reuse.
94 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
cclt2cc command line options
This section summarizes the command line options for the cclt2cc upgrade
tool.
SYNOPSIS
cclt2cc –w tag-registry-password [–v vob-tag-list] [–d destination-region] [–p
vob-tag-prefix]
–w tag-registry-password
The registry password for the tag registry in which new VOB tags will be
created.
–v vob-tag-list
Upgrade only the VOBs in vob-tag-list, a comma-separated list of VOB tags.
–d destination-region
Create VOB tags in destination-region instead of the default.
–p vob-tag-prefix
Create Linux and UNIX VOB tags with a prefix of vob-tag-prefix instead of the
default.
98 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Table 24. Supported Data Code Page Locales for Rational ClearCase (continued)
Lang. Terr. Var. Language Territory CP UNIX® character sets1
fi FI pre-euro Finnish FINLAND 1252 ISO-8859-1,ISO-8859-15
fr BE French BELGIUM 1252 ISO-8859-1,ISO-8859-15
fr BE pre-euro French BELGIUM 1252 ISO-8859-1,ISO-8859-15
fr CA French CANADA 1252 ISO-8859-1,ISO-8859-15
fr CH French SWITZERLAND 1252 ISO-8859-1,ISO-8859-15
fr FR French FRANCE 1252 ISO-8859-1,ISO-8859-15
fr FR pre-euro French FRANCE 1252 ISO-8859-1,ISO-8859-15
fr LU French LUXEMBOURG 1252 ISO-8859-1,ISO-8859-15
fr LU pre-euro French LUXEMBOURG 1252 ISO-8859-1,ISO-8859-15
he IL Hebrew ISRAEL 1255 ISO-8859-8,windows-1255
hr HR Croatian CROATIA 1250 ISO-8859-2
hu HU Hungarian HUNGARY 1250 ISO-8859-2
hu HU euro Hungarian HUNGARY 1250 ISO-8859-2
hu HU pre-euro Hungarian HUNGARY 1250 ISO-8859-2
id ID Indonesian INDONESIA 1252 ISO-8859-1,ISO-8859-15
is IS Icelandic ICELAND 1252 ISO-8859-1,ISO-8859-15
it CH Italian ICELAND 1252 ISO-8859-1,ISO-8859-15
it IT Italian ITALY 1252 ISO-8859-1,ISO-8859-15
it IT pre-euro Italian ITALY 1252 ISO-8859-1,ISO-8859-15
ja JP Japanese JAPAN 932 EUC-JP, IBM-943, Shift_JIS
ko KR Korean KOREA, 949 EUC-KR
REPUBLIC OF
lt LT Lithuanian LITHUANIA 1257 IBM-922,IBM-902
lt LT euro Lithuanian LITHUANIA 1257 IBM-922,IBM-902
lt LT pre-euro Lithuanian LITHUANIA 1257 IBM-922,IBM-902
lv LV Latvian LATVIA 1257 IBM-922,IBM-902
lv LV euro Latvian LATVIA 1257 IBM-922,IBM-902
lv LV pre-euro Latvian LATVIA 1257 IBM-922,IBM-902
mk MK Macedonian MACEDONIA, 1251 ISO-8859-5
FORMER
YUGOSLAV
REPUBLIC OF
ms MY Malay MALAYSIA 1252 ISO-8859-1,ISO-8859-15
nb NO Norwegian NORWAY 1252 ISO-8859-1,ISO-8859-15
Bokmal
nl BE Dutch BELGIUM 1252 ISO-8859-1,ISO-8859-15
nl BE pre-euro Dutch BELGIUM 1252 ISO-8859-1,ISO-8859-15
nl NL Dutch NETHERLANDS 1252 ISO-8859-1,ISO-8859-15
Appendix B. Supported Data Code Page locales for Rational ClearCase and Rational ClearCase LT 99
Table 24. Supported Data Code Page Locales for Rational ClearCase (continued)
Lang. Terr. Var. Language Territory CP UNIX® character sets1
nl NL pre-euro Dutch NETHERLANDS 1252 ISO-8859-1,ISO-8859-15
pl PL Polish POLAND 1250 ISO-8859-2
pl PL euro Polish POLAND 1250 ISO-8859-2
pl PL pre-euro Polish POLAND 1250 ISO-8859-2
pt BR Portuguese BRAZIL 1252 ISO-8859-1,ISO-8859-15
pt PT Portuguese PORTUGAL 1252 ISO-8859-1,ISO-8859-15
pt PT pre-euro Portuguese PORTUGAL 1252 ISO-8859-1,ISO-8859-15
ro RO Romanian ROMANIA 1250 ISO-8859-2
ru RU Russian RUSSIAN 1251 ISO-8859-5,KOI8-RU
FEDERATION
sk SK Slovak SLOVAKIA 1250 ISO-8859-2
sk SK euro Slovak SLOVAKIA 1250 ISO-8859-2
sk SK pre-euro Slovak SLOVAKIA 1250 ISO-8859-2
sl SI Slovenian SLOVENIA 1250 ISO-8859-2
sl SI euro Slovenian SLOVENIA 1250 ISO-8859-2
sl SI pre-euro Slovenian SLOVENIA 1250 ISO-8859-2
sq AL Albanian ALBANIA 1250 ISO-8859-2
sr CS Serbian SERBIA AND 1251 ISO-8859-5
(Cyrillic) MONTENEGRO
sv SE Swedish SWEDEN 1252 ISO-8859-1,ISO-8859-15
sv SE euro Swedish SWEDEN 1252 ISO-8859-1,ISO-8859-15
sv SE pre-euro Swedish SWEDEN 1252 ISO-8859-1,ISO-8859-15
tr TR Turkish TURKEY 1254 ISO-8859-9
uk UA Ukranian UKRAINE 1251 ISO-8859-5,KOI8-U,IBM-
1124
zh CN Chinese CHINA 936 GBK,GB18030,GB2312
(Simplified)
zh HK Chinese HONG KONG 950 big5,EUC-TW
(Traditional) SAR OF CHINA
zh SG Chinese SINGAPORE 936 GBK,GB2312
(Simplified)
zh TW Chinese TAIWAN 950 big5,EUC-TW
(Traditional)
Notes:
1. In addition to the listed character sets, the ASCII character set is also supported for every
locale on Linux and the UNIX system.
100 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
Appendix C. Notices
This information was developed for products and services offered in the
U.S.A. IBM may not offer the products, services, or features discussed in this
document in other countries. Consult your local IBM representative for
information on the products and services currently available in your area. Any
reference to an IBM product, program, or service is not intended to state or
imply that only that IBM product, program, or service may be used. Any
functionally equivalent product, program, or service that does not infringe
any IBM intellectual property right may be used instead. However, it is the
user’s responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.
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.
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 programs and other programs (including this one) and (ii) the mutual
use of the information which has been exchanged, should contact:
IBM Corporation
Department BCFB
20 Maguire Road
Lexington, MA 02421
U.S.A.
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:
102 IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT: Installation and Upgrade Guide
This information contains sample application programs in source language,
which illustrates programming techniques on various operating platforms.
You may copy, modify, and distribute these sample programs in any form
without payment to IBM, for the purposes of developing, using, marketing or
distributing application programs conforming to the application programming
interface for the operating platform for which the sample programs are
written. These examples have not been thoroughly tested under all conditions.
IBM, therefore, cannot guarantee or imply reliability, serviceability, or function
of these programs. You may copy, modify, and distribute these sample
programs in any form without payment to IBM for the purposes of
developing, using, marketing, or distributing application programs
conforming to IBM’s application programming interfaces.
Each copy or any portion of these sample programs or any derivative work,
must include a copyright notice as follows:
(c) (our company name) (year). Portions of this code are derived from IBM
Corp. Sample Programs. (c) Copyright IBM Corp. _enter the year or years_.
All rights reserved.
Trademarks
Java and all Java-based trademarks and logos are trademarks of Sun
Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and
other countries.
Printed in USA
GI11-6365-00