IBM E02D1LL-E - Rational Rose Enterprise Installation guide

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

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 Web 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

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

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 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

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/.

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).

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:

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.

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 You 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 You 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. You 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

– You 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.

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, 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.

Note: You cannot run two different versions of Rose on the same machine.

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. You 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.

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.

4 IBM Rational Rose: Installation Guide

Select a deployment method

The IBM Rational Setup wizard provides the following deployment options for

your installation of IBM Rational products:

v Installation from a CD

v Installation from a Web download

v Enterprise deployment from a release area on your network

v Silent installation

For a description of these options and instructions to set up these deployments, see

“Configuring deployment” on page 9.

Chapter 1. Planning the installation 5

6 IBM Rational Rose: Installation Guide

Chapter 2. Configuring the installation

Administrator privileges

To install Rational Rose on a Windows

®

operating system, you must be logged on

to a Windows domain account that is a member 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 a license 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:

v AccountLink is a Web-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.

v The 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.

v The License Key Administrator (LKAD) is used to import license keys on target

systems that run Rational products and change license configurations.

v The License Tools utility provides an interface to managing the FLEXlm License

Manager, the license server software.

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 a technote titled “The recommended setup for IBM Rational FLEXlm

licensing and other third party vendors on a license 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 a release area and site defaults file. See

“Creating a release 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 a high-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.

8 IBM 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 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 2 describes

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 a Web

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 a Passport 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 a network

release area and customize the product installation. This

option enables multiple clients to install from a designated

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 a variety of users. When a fix 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 a release 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. A silent

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 a release area and site defaults file

A release area is a network 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 a standard installation from

the release area.

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 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 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 13.

If users click siteprep.exe without specifying a site defaults file and a sitedefs.dat

file is not in the release area, the Site Preparation wizard creates a new site defaults

file.

Using the Setup Wizard to create a release area and site defaults

file

This section explains how you can use the Setup wizard to create a release 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 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 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 a fix pack to a release area, see “Applying a fix 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

Page is loading ...

IBM E02D1LL-E - Rational Rose Enterprise Installation guide

This manual is also suitable for

IBM E02D1LL-E - Rational Rose Enterprise Installation guide

Related papers

Other documents