IBM E02D1LL-E - Rational Rose Enterprise User manual

Rational®IBM Rational Rose
Installation Guide
Version 7.0.0
Windows
GI11-6296-00


Rational®IBM Rational Rose
Installation Guide
Version 7.0.0
Windows
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 aprevious version.......4
Setting up Rational Common Licensing .....4
Select adeployment 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 adeployment method .......9
Creating arelease area and site defaults file ..10
Setting up silent installations of IBM Rational
products ...............13
Silent installation setup .........14
Testing asilent 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 arelease area ........20
Installation from aCD or Web download ....20
Running the IBM Rational LaunchPad and Setup
wizard ................20
Interrupting an installation .........21
Rational Setup wizard warnings and blocks ...21
Performing asilent installation ........22
Overview of silent installation .......22
Running asilent 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 aRational 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
® products can be found at http://www.ibm.com/software/rational/
support/.
Voice Support is available to all current contract holders by dialing atelephone
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:
vYour name, company name, ICN number, telephone number, and e-mail
address
vYour operating system, version number, and any service packs or patches
you have applied
vProduct name and release number
vYour PMR number (if you are following up on apreviously reported
problem)
Downloading the IBM Support Assistant
The IBM Support Assistant (ISA) is alocally installed serviceability workbench that
makes it easier to resolve software product problems. ISA is afree, 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:
vFederated search
vData collection
vProblem submission
vEducation roadmaps
For more information about ISA, including instructions for downloading and
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 ahigh-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 acountry.
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).
Note: The most up to date Release Note information will be available at the IBM
Publications Center (as indicated above).
Preparing to install IBM Rational Rose
General guidelines
Pre-installation guidelines:
vShut down all other Windows programs before running the Setup program.
vIf you are removing IBM Rational Rose from anetwork environment, be sure
that no one is using the application or any of its associated files. You cannot
remove files that are in use.
vTurn off all virus protection software. These programs often run in the
background and interfere with the installation and file decompression process.
vTurn off any user interface managers or desktop environments that run on top of
Microsoft Windows.
vChange to astandard VGA video driver while IBM Rational Setup is running, or
disable video features such as virtual screens or screen switching.
vChange to astandard mouse driver, or disable special mouse features that
perform tasks such as leaving pointer trails or changing pointer sizes.
vTo ensure that your system meets the minimum installation requirements, see
Server, system and software Requirements in the IBM Rational Rose Release Notes.
vIf you are upgrading Rose and you have other IBM Rational products installed
on your system, see Version Compatibility Guidelines.
vGet alicense key to run Rose on your desktop. See Configuring Rational
Common Licensing under the Configuring licensing section for more information.
vMake 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

vAsk your administrator for the correct deployment type. See Selecting a
deployment method.
vSee Change to search order for license keys for adescription of the order in
which license keys are applied in this release.
vWhen 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.
vIn 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
vThe 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.
vThe 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 alist 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:
vYou are using aU.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.
vYour site may mandate that you obtain shared files directly from the source (for
example, from Microsoft), rather than using files supplied by athird party. Or
your site may prohibit end users from installing shared components.
vYou may want to install equivalent files that are localized in your language.
2IBM 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 anon-U.S.
English language. If you clear this check box, you can save and print the list of
files that need to be updated. You will need to update the files yourself.
vThere may be alater 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:
vModel files
–You should always have aback 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.
v
Path Maps
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, anew 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 avariant on the same desktop
If multiple variants of Rational Rose are installed on asingle Windows desktop,
you can only run the last variant installed. For example, if you install Rose
Modeler Edition, and then install Rose Professional JEdition, you can only run the
Rose Professional Jvariant.
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
vRational Rose does not support dual boot systems where both operating systems
are on the same partition.
vIf 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. Anew, 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.
vThe 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.
Note: You cannot run two different versions of Rose on the same machine.
Upgrading from aprevious version
If you are upgrading from aprevious 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 asingle 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 akey
part of the installation process. You must accomplish the following licensing
service tasks:
vObtain license keys by using AccountLink, aWeb-based tool available from the
IBM Rational Licensing and Download center.
vInstall and configure the IBM Rational License Server.
vConfigure client desktops to import keys to the Rational License Server.
vMaintain and manage the IBM Rational License Server as asingle, multiple, or
redundant server configuration.
These tasks, as well as 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.
4IBM Rational Rose: Installation Guide

Select adeployment method
The IBM Rational Setup wizard provides the following deployment options for
your installation of IBM Rational products:
vInstallation from aCD
vInstallation from aWeb download
vEnterprise deployment from arelease area on your network
vSilent installation
For adescription of these options and instructions to set up these deployments, see
“Configuring deployment” on page 9.
Chapter 1. Planning the installation 5

6IBM Rational Rose: Installation Guide

Chapter 2. Configuring the installation
Administrator privileges
To install Rational Rose on aWindows
® operating system, you must be logged on
to aWindows domain account that is amember of the local 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.
Configuring licensing
Licensing Rational Rose variants
IBM Rational Rose uses alicense key for the variant of Rose that you install, or a
Rational Suite key that includes that Rose variant.
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.
The following tools are used to manage Rational Common Licensing:
vAccountLink is aWeb-based tool available from the IBM Rational Licensing and
Download Center and is used to obtain license keys.
Note: At the time of publication, AccountLink is the online license fulfillment
tool for IBM Rational software customers. In the future, AccountLink will
be replaced by the Rational License Key Center, an online system that
offers additional features and an easier license key fulfillment experience.
You will access the new system, when it is available, using the same
location on the Web that is currently used for AccountLink:
http://www.ibm.com/software/rational/support/licensing/. This page
will provide all of the information and instructions you need to manage
license keys using the Rational License Key Center.
vThe IBM Rational License Server, which you must install from it’s CD, monitors
license access, tracks the number of simultaneous users, and performs other
tasks related to managing licenses.
vThe License Key Administrator (LKAD) is used to import license keys on target
systems that run Rational products and change license configurations.
vThe License Tools utility provides an interface to managing the FLEXlm License
Manager, the license server software.
©Copyright IBM Corp. 1993, 2006 7

For more information about the License Tools utility, go to the IBM Rational
Support Web site at http://www.ibm.com/developerworks/rational/support/and
search for atechnote titled “The recommended setup for IBM Rational FLEXlm
licensing and other third party vendors on alicense server.”
For instructions about obtaining and managing licenses, see Table 1.
Table 1. Instructions for basic licensing tasks
Task Instructions
Understand Rational Common
Licensing mechanics, license
management tools, and license
types.
Review the IBM Rational License Management Guide as
part of the installation planning process and select
appropriate license types.
Obtain license keys. Use AccountLink to obtain license keys. You can also
use the document titled Important Licensing and
Installation Information on the Proof of Entitlement
certificate to request license keys.
Install the Rational License Server
and install license keys.
1. Install the IBM Rational License Server 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, or you can click Start >
Programs >IBM Rational >IBM Rational
License Key Administrator.
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
request licenses from the IBM
Rational License Server.
1. Create arelease area and site defaults file. See
“Creating arelease area and site defaults file” on
page 10.
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.
This chapter provides ahigh-level guide to planning the installation of your IBM
Rational software product. Both administrators and users of the product should
read this chapter before beginning the installation.
8IBM Rational Rose: Installation Guide

Configuring deployment
Configuring deployment of IBM Rational Rose requires that you understand the
types of deployment methods available. You can then select the appropriate
deployment type for your users and configure your software for the selected
deployment method.
Selecting adeployment 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 2describes
each deployment type.
Table 2. Deployment methods
Deployment type Description
Installation from the IBM
Rational Rose CD
In the Setup wizard, choose this option if you want to
install the product directly from the IBM Rational Rose CD
by using the Setup wizard.
Installation from aWeb
download
This method is not available in the Setup wizard. Each user
can download the product from the IBM Rational Licensing
and Download center, as follows:
1. Go to http://www.lotus.com/services/cwepassport.nsf
/wdocs/pacustomers to enroll in the Passport
Advantage
® Program.
This site provides all the necessary information for
purchasing and downloading IBM Rational Software
online.
2. Once you are aPassport Advantage member, visit
http://www.ibm.com/software/howtobuy
/passportadvantage/paocustomer/ to purchase and
download Rational products.
Enterprise Deployment In the Setup wizard, choose this option to create anetwork
release area and customize the product installation. This
option enables multiple clients to install from adesignated
release area.
The site defaults file created by the administrator with the
Setup wizard allows users to either install predefined
configurations of the product or install the product with
different default settings. You can use one or more site
defaults files to support avariety of users. When afix pack
becomes available, it can be applied to the release area, and
users can reinstall from the updated release area.
For more information, see “Creating arelease area and site
defaults file” on page 10.
Silent installation This method is not available in the Setup wizard. It is an
option for performing unattended installations. Asilent
installation does not require users to select options or make
decisions. Silent installations ensure that all users have the
same products, features, and options on their desktops.
These installations can reduce your work as you deploy a
product in your development environment.
For more information, see “Setting up silent installations of
IBM Rational products” on page 13.
Chapter 2. Configuring the installation 9

Creating arelease area and site defaults file
Arelease area is anetwork shared drive that contains installation files that you
install by using the Setup wizard and that you configure for easy and consistent
installation by users. These files include one or more site defaults files that contain
default settings that apply to all users who perform astandard installation from
the release area.
There are two methods for creating site defaults files. Both methods create adisk
image of product files in ashareable directory on the network. The first method
creates arelease area (Enterprise Deployment). The second method (Site
Preparation wizard) does not create arelease area. You can also use these methods
to install the product on your computer after creating asite defaults file.
vRun the Setup wizard on the IBM Rational Rose 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 10.
When you create arelease area from CD, you might be required to replace the
first CD after the second CD is finished copying.
vRun 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 13.
If users click siteprep.exe without specifying asite defaults file and asitedefs.dat
file is not in the release area, the Site Preparation wizard creates anew site defaults
file.
Using the Setup Wizard to create arelease area and site defaults
file
This section explains how you can use the Setup wizard to create arelease area
and populate it with site defaults files. You can use this release area to install
Rational products on servers or client desktops.
The default site defaults file is sitedefs.dat. If users 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_rose.dat or
qualityengr_rose.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_rose.dat.Or you can prepare shortcuts for these files, such as
developers_rose or developers_rose.lnk,which users can run from their desktops.
When creating asite defaults file, do not add afile name extension, such as
sitedefs.developers.dat.The maximum length of the path for the release area of a
Rose 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 maximum length.
If you plan to apply afix pack to arelease area, see “Applying afix pack to a
release area” on page 12.
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
10 IBM Rational Rose: Installation Guide