IBM E02D1LL-E, Rational Rose 7.0.0 Installation Manual
Rational
Version 7.0.0
Windows
®
IBM Rational Rose
Installation
Guide
GI11-6296-00
Rational
Version 7.0.0
Windows
®
IBM Rational Rose
Installation
Guide
GI11-6296-00
Before using this information, be sure to read the general information under “Notices,” on page 29.
7th edition May 2006
© Copyright International Business Machines Corporation 1993, 2006. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Tables . . . . . . . . . . . . . . .v
About this book . . . . . . . . . . . vii
Who should read this book . . . . . . . . . vii
Contacting IBM Customer Support for Rational
software products . . . . . . . . . . . . vii
Downloading the IBM Support Assistant . . . . vii
Chapter 1. Planning the installation . . .1
Preliminary installation information . . . . . .1
Preparing to install IBM Rational Rose . . . . .1
Once IBM Rational Rose is installed . . . . .4
Upgrading from a previous version . . . . . . .4
Setting up Rational Common Licensing . . . . .4
Select a deployment method . . . . . . . . .5
Chapter 2. Configuring the installation .7
Administrator privileges . . . . . . . . . .7
Configuring licensing . . . . . . . . . . .7
Licensing Rational Rose variants . . . . . . .7
Configuring Rational Common Licensing . . . .7
Configuring deployment . . . . . . . . . .9
Selecting a deployment method . . . . . . .9
Creating a release area and site defaults file . .10
Setting up silent installations of IBM Rational
products . . . . . . . . . . . . . . .13
Silent installation setup . . . . . . . . .14
Testing a silent installation . . . . . . . .14
Rational_install log file . . . . . . . . . .14
Chapter 3. Installing this product as
part of IBM Rational Suite . . . . . .17
Site defaults file required for each product . . . .17
Change to search order for license keys . . . . .17
Chapter 4. Installing Rational Rose . .19
Before you start the Rational Setup wizard . . . .19
Installing from a release area . . . . . . . .20
Installation from a CD or We b download . . . .20
Running the IBM Rational LaunchPad and Setup
wizard . . . . . . . . . . . . . . . .20
Interrupting an installation . . . . . . . . .21
Rational Setup wizard warnings and blocks . . .21
Performing a silent installation . . . . . . . .22
Overview of silent installation . . . . . . .22
Running a silent installation . . . . . . . .22
Command syntax for setup.exe . . . . . . . .23
Synopsis . . . . . . . . . . . . . .23
Description . . . . . . . . . . . . .23
Options and arguments . . . . . . . . .23
Example . . . . . . . . . . . . . .23
Command syntax for MSIEXEC.exe . . . . . .24
Licensing your software . . . . . . . . . .24
Licensing products on Windows Terminal Servers 25
Chapter 5. Uninstalling Rational
software . . . . . . . . . . . . . .27
Before you uninstall Rational products . . . . .27
To uninstall Rational products . . . . . . .27
Removing a Rational fix pack . . . . . . . .28
Appendix. Notices . . . . . . . . . .29
Index . . . . . . . . . . . . . . .33
© Copyright IBM Corp. 1993, 2006 iii
iv IBM Rational Rose: Installation Guide
Tables
1. Instructions for basic licensing tasks . . . . .8
2. Deployment methods . . . . . . . . .9
3. Warnings and blocks . . . . . . . . .21
4. Requesting and installing IBM Rational license
keys . . . . . . . . . . . . . . .24
© Copyright IBM Corp. 1993, 2006 v
vi IBM Rational Rose: Installation Guide
About this book
This manual provides requirements and instructions for installing, configuring, and
licensing IBM Rational Rose.
Who should read this book
This guide is intended for those who are responsible for installing Rational Rose.
Contacting IBM Customer Support for Rational software products
If you have questions about installing, using, or maintaining this product, contact
®
IBM
Customer Support as follows:
The IBM software support Internet site provides you with self-help resources and
electronic problem submission. The IBM Software Support Home page for
Rational
support/.
®
products can be found at http://www.ibm.com/software/rational/
Voice Support is available to all current contract holders by dialing a telephone
number in your country (where available). For specific country phone numbers, go
to http://www.ibm.com/planetwide/.
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 easier 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.
ISA includes these features:
v Federated search
v Data collection
v Problem submission
v Education roadmaps
more information about ISA, including instructions for downloading and
For
installing ISA and product plug-ins, go to the ISA Software Support page.IBM
Support Assistant: http://www.ibm.com/software/support/isa/.
© Copyright IBM Corp. 1993, 2006 vii
viii IBM Rational Rose: Installation Guide
Chapter 1. Planning the installation
This chapter provides a high-level guide to planning the installation of IBM
Rational Rose. Both administrators and users of the product should read this
chapter before beginning the installation.
Preliminary installation information
For the most current information related to Rational Rose installation procedures,
product features, and known issues, see the IBM Rational Rose Release Notes at
the IBM Publications Center, as follows:
1. Search http://www.ibm.com for IBM Publications Center.
2. At the IBM Publications Center, select a country.
3. Click Search for Publications.
4. Enter the publication number (GI11-6303-00) in the Publication number field.
You can also access the release notes during the installation from the Launchpad
and once installation is complete from within the product (click Start > Programs >
IBM Rational > IBM Rational Rose > Rose Release Notes).
The most up to date Release Note information will be available at the IBM
Note:
Publications Center (as indicated above).
Preparing to install IBM Rational Rose
General guidelines
Pre-installation guidelines:
v Shut down all other Windows programs before running the Setup program.
v If you are removing IBM Rational Rose from a network environment, be sure
that no one is using the application or any of its associated files. You cannot
remove files that are in use.
v Turn off all virus protection software. These programs often run in the
background and interfere with the installation and file decompression process.
v Turn off any user interface managers or desktop environments that run on top of
Microsoft Windows.
v Change to a standard VGA video driver while IBM Rational Setup is running, or
disable video features such as virtual screens or screen switching.
v Change to a standard mouse driver, or disable special mouse features that
perform tasks such as leaving pointer trails or changing pointer sizes.
v To ensure that your system meets the minimum installation requirements, see
Server, system and software Requirements in the IBM Rational Rose Release Notes.
v If you are upgrading Rose and you have other IBM Rational products installed
on your system, see Version Compatibility Guidelines.
v Get a license key to run Rose on your desktop. See Configuring Rational
Common Licensing under the Configuring licensing section for more information.
v Make sure you have administrator privileges on your desktop. See the
Administrator privileges subsection under Chapter 2. Configuring the installation
for more information.
© Copyright IBM Corp. 1993, 2006 1
v Ask your administrator for the correct deployment type. See Selecting a
deployment method.
v See Change to search order for license keys for a description of the order in
which license keys are applied in this release.
v When installing Rose as part of IBM Rational Suite on Microsoft Windows 2000,
Rose might not run until you add the Rational \Common directory to your user
path. See Adding the IBM Rational directory to your user path if you encounter
this problem.
v In addition to reviewing the remainder of Chapter 1, including but not limited
to:
– File location guidelines
– Shared file guidelines
– Backup guidelines
– Version Compatibility guidelines
Also review the following chapters prior to installing IBM Rational Rose:
– Chapter 2. Configuring the installation
– Chapter 3. Installing this product as part of IBM Rational Suite (If you will be
installing IBM Rational Rose as part of the IBM Rational Suite.)
– Chapter 4. Installing Rational Rose
File location guidelines
v The IBM Rational Software Setup program requires that you install all IBM
Rational products in the same directory. If you already have IBM Rational
products installed on your system, the Setup program installs IBM Rational Rose
in the same directory.
v The Setup program installs Microsoft Core Components and some additional
files on the same drive as the operating system (often the C:\ drive), even if you
have specified an alternate drive for installation. These files can require up to 5 15 MB of disk space on your hard drive.
Shared file guidelines
The IBM Rational Software Setup program installs some shared components, which
are potentially available to other applications on your system. Setup installs the
U.S. English version of these files. It does not overwrite newer file versions.
If the Setup program needs to update shared components, it displays a list of the
shared components that require updates. The files listed must be installed on your
system before the installation can proceed.
In general, we recommend that you allow the installation procedure to install
shared files for you. In the following circumstances, you may want to install the
files yourself:
v Yo u are using a U.S. English system, but installing new files may invalidate your
current environment. In this case, you need to determine how to correct your
environment so that you can run existing tools and the IBM Rational products
you want to install.
v Your site may mandate that you obtain shared files directly from the source (for
example, from Microsoft), rather than using files supplied by a third party. Or
your site may prohibit end users from installing shared components.
v Yo u may want to install equivalent files that are localized in your language.
2 IBM Rational Rose: Installation Guide
The Replace files with newer versions in English check box is selected when you
have installed earlier versions of shared files that are localized to a non-U.S.
English language. If you clear this check box, you can save and print the list of
files that need to be updated. Yo u will need to update the files yourself.
v There may be a later version of the files available. IBM Rational products should
work with the supplied version of shared files or any later versions.
Backup guidelines
You should back up your registry and system directories prior to running the IBM
Rational Rose Setup program. In addition, make system backups of any machines
on which you plan to install Rose. Specifically, we recommend you make backups
of the following files:
v Model files
– Yo u should always have a back up of all your model files. These can include
files that end with .mdl,.cat,.ptl, .red, and .sub files.
– Custom property files (files that end with .pty or .prp)
– There is no need to save .pty files that ship with Rose, because these will be
reinstalled.
– Custom script files (files that end with .ebs or .ebx)
– There is no need to save .ebs or .ebx files that ship with Rose, since these will
be reinstalled.
Path Maps
v
Rose path map variables are saved in the registry.
To backup path map variables:
1. Run regedit and navigate to HKEY_CURRENT_USER\Software\Rational
Software\Rose\Virtual Path Map.
2. On the Registry menu, click Export Registry File.... (On Windows XP, select
File > Export... as there is no Registry and Export Registry File menu.)
To restore path map variables:
1. Run regedit and navigate to HKEY_CURRENT_USER\Software\Rational
Software\Rose\Virtual Path Map.
2. On the Registry menu, click Import Registry File... and import the file you
exported. (On Windows XP, select File > Import... as there is no Registry and
Import Registry File menu.)
Version compatibility guidelines
If you have older IBM Rational products installed on your system, you must
ensure that all IBM Rational products on that system are upgraded to the same
version. Because IBM Rational tools share files and components, a new installation
can cause the older IBM Rational products to stop working. You will see no visual
clue that the older products may be compromised.
Installing a variant on the same desktop
If multiple variants of Rational Rose are installed on a single Windows desktop,
you can only run the last variant installed. For example, if you install Rose
Modeler Edition, and then install Rose Professional J Edition, you can only run the
Rose Professional J variant.
Adding the IBM Rational directory to your user path
When installing Rose on Microsoft Windows 2000, Rose might not run until you
add the Rational\Common directory to your user path. Use the following procedure
to add the directory to your user path:
Chapter 1. Planning the installation 3
1. Click the Start > Settings > Control Panel.
2. Double-click the System icon and select the Environment tab.
3. Click Path Variable in the User Variable section of the dialog box.
4. In the beginning of the existing path, insert the Rational common path
(typically, C:\Program Files\Rational\Common), and then click Set.
5. Click OK to add the path and close the dialog box.
Once IBM Rational Rose is installed
v Rational Rose does not support dual boot systems where both operating systems
are on the same partition.
v If the online Help for an installed Rose Add-In does not appear on the Contents
tab of the Rose online Help, it may be because of an existing .gid file on your
system. To remedy this situation, locate the Add-In’s .gid file in the
rose_release_directory\help\ folder, and delete it. A new, valid .gid file will be
created automatically the first time you open the Add-In’s compiled Help (.hlp)
file. For example, if the Help book for Web Modeler does not appear in the
Contents , delete the webmod.gid file. If the errant .gid file was the problem, you
will see the Web Modeler Help book on the Contents tab the next time you open
the Rose online Help.
v The Rose Data Modeler produces models for several database vendors. The
vendor databases are listed in the IBM Rational Rose Release Notes. There are
no special configuration instructions for Rose Data Modeler. To install and
configure the databases, see the vendor documentation.
Yo u cannot run two different versions of Rose on the same machine.
Note:
Upgrading from a previous version
If you are upgrading from a previous version of the product, review the upgrade
information before you install the current version. If the product was installed as
part of Rational Suite®, all Rational products are uninstalled when you install the
current version.
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 Rational RequisitePro version 2003.06.15 with
Rational Rose version 7.0.
Setting up Rational Common Licensing
Setting up Rational Common Licensing, which is powered by FLEXlm, is a key
part of the installation process. Yo u must accomplish the following licensing
service tasks:
v Obtain license keys by using AccountLink, a Web-based tool available from the
IBM Rational Licensing and Download center.
v Install and configure the IBM Rational License Server.
v Configure client desktops to import keys to the Rational License Server.
v Maintain and manage the IBM Rational License Server as a single, multiple, or
redundant server configuration.
tasks, as well as different types of license keys, are described in the IBM
These
Rational License Management Guide. If you are installing Rational products for the
first time, read this guide carefully before beginning installation.
4 IBM Rational Rose: Installation Guide
Loading...