IBM E02D1LL-E - Rational Rose Enterprise Installation guide

Type
Installation guide

This manual is also suitable for

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 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
© 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 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/.
© 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).
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.
© 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 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.
© 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 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 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46

IBM E02D1LL-E - Rational Rose Enterprise Installation guide

Type
Installation guide
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI