Rational IBM Rational Rose

Version 7.0.0
Windows

Installation Guide

GI11-6296-00

Rational IBM Rational Rose

Version 7.0.0
Windows

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 . . . . . . . . Contacting IBM Customer Support for Rational software products . . . . . . . . . . . Downloading the IBM Support Assistant . . . . vii . vii . vii Site defaults file required for each product . Change to search order for license keys . . . . . . . 17 . 17

Chapter 4. Installing Rational Rose

. . 19
. 19 . 20 . 20 . . . . . . . . . . . . . 20 21 21 22 22 22 23 23 23 23 23 24 24 25

Chapter 1. Planning the installation . . . 1

Preliminary installation information . . Preparing to install IBM Rational Rose . Once IBM Rational Rose is installed . Upgrading from a previous version . . . Setting up Rational Common Licensing . Select a deployment method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 4 4 4 5

Chapter 2. Configuring the installation

Administrator privileges . . . . . . . . Configuring licensing . . . . . . . . . Licensing Rational Rose variants . . . . . Configuring Rational Common Licensing . . Configuring deployment . . . . . . . . Selecting a deployment method . . . . . Creating a release area and site defaults file Setting up silent installations of IBM Rational products . . . . . . . . . . . . . Silent installation setup . . . . . . . Testing a silent installation . . . . . . Rational_install log file . . . . . . . . . . . . . . . . . . .

. 7
. 7 . 7 . 7 . 7 . 9 . 9 . 10 . . . . 13 14 14 14

Before you start the Rational Setup wizard . . . Installing from a release area . . . . . . . Installation from a CD or Web download . . . Running the IBM Rational LaunchPad and Setup wizard . . . . . . . . . . . . . . . Interrupting an installation . . . . . . . . Rational Setup wizard warnings and blocks . . Performing a silent installation . . . . . . . Overview of silent installation . . . . . . Running a silent installation . . . . . . . Command syntax for setup.exe . . . . . . . Synopsis . . . . . . . . . . . . . Description . . . . . . . . . . . . Options and arguments . . . . . . . . Example . . . . . . . . . . . . . Command syntax for MSIEXEC.exe . . . . . Licensing your software . . . . . . . . . Licensing products on Windows Terminal Servers

Chapter 5. Uninstalling Rational software . . . . . . . . . . . . . . 27

Before you uninstall Rational products . To uninstall Rational products . . . Removing a Rational fix pack . . . . . . . . . . . . . . 27 . 27 . 28

Appendix. Notices . . . . . . . . . . 29 Index . . . . . . . . . . . . . . . 33

Chapter 3. Installing this product as part of IBM Rational Suite . . . . . . 17

Copyright IBM Corp. 1993, 2006

iii

iv

IBM Rational Rose: Installation Guide

Tables
1. 2. 3. Instructions for basic licensing tasks . . . . . 8 Deployment methods . . . . . . . . . 9 Warnings and blocks . . . . . . . . . 21 4. Requesting and installing IBM Rational license keys . . . . . . . . . . . . . . . 24

Copyright IBM Corp. 1993, 2006

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

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.

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

Click the Start > Settings > Control Panel. Double-click the System icon and select the Environment tab. Click Path Variable in the User Variable section of the dialog box. 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. 1. 2. 3. 4.

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

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

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

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 Understand Rational Common Licensing mechanics, license management tools, and license types. Obtain license keys. Instructions Review the IBM Rational License Management Guide as part of the installation planning process and select appropriate license types. 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. 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.

Install the Rational License Server and install license keys.

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.

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 Installation from the IBM Rational Rose CD Installation from a Web download Description 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. 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

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

b. On the Sharing page of the properties window, click SHARE this folder and supply a meaningful name, such as Rose 7.0 Release Area. The Setup wizard creates a shortcut to the site defaults file only if the release area is created under a network share. The shortcut opens in the release area, for example, as sitedefs or Rosedevelopers without the file extension.dat. 2. Log in as a user with Administrator rights on the local computer. 3. Insert the IBM Rational Rose Disk(s) into the computers CD drive. If more than one disk exists for the Rose product you are installing, insert Disk 1. If you have downloaded the software, click Setup.exe after you extract the files. The Setup wizard starts. If autorun is disabled on your computer, click Start > Run and enter cd_drive: \Setup.exe where cd_drive is the letter of the CD drive. The Setup wizard guides you through the software installation. Click Next to open the page. Note: Your release may include the following Rose products. Insert the disk appropriate to the Rose variant you wish to install: v IBM Rational Rose Enterprise Edition v IBM Rational Rose Modeler Edition v IBM Rational Rose Professional Ada Edition v IBM Rational Rose Professional C++ Edition v IBM Rational Rose Professional Data Modeler Edition v IBM Rational Rose Professional J Edition v IBM Rational Rose Professional VisualBasic Edition The Product Selection page lists all products available for installation. Select the product that you want to create a release area for. Click Next. Select the Enterprise Deployment option in the Deployment Method page. Click Next. Depending on the product you have selected, you will see one or more custom configuration pages in the wizard. Use the Help to provide instructions in this section of the wizard. Enter the required information in each page of the wizard. (All required information is shown in the left panel of the wizard with a red dot.) To navigate through the pages, you can either click Next to see them sequentially or click the page title in the left pane to access the page directly. In the Completion pages, you must fill in the Description page and the Create a Release Area page. The Launch Installation page is optional. a. In the Description page, enter a description for users. When you are finished, click Next. b. In the Create a Release Area page, enter the release area location and file name for the site defaults file (*.dat) that you are creating. Do not use double-byte characters. If you want to use the site defaults file to install software on your computer, click Next to go to the Launch Installation page. Select Launch installation by using these settings. Save the site defaults information to a file and proceed with the installation on your computer. Click Done and then click Next. Skip to Testing your site defaults file on page 12 for the rest of the instructions.
Chapter 2. Configuring the installation

4. 5. 6.

7.

11

If you only want to create a release area, click Done and then Next to create the site defaults file. 8. When the Setup Complete page opens, review the current information related to new features and known issues in the readme file. You can also view the IBM developerWorks Web pages. Click Finish to complete the installation of the release area. Applying a fix pack to a release area: If you want to apply a fix pack to the Rational products in your environment, you must re-create the release area as if users are installing the products on their desktops for the first time. This new release area is used to update and install Rational desktop products. After you create this new release area, disable the old one. Disabling the old release area prevents access to the previous version of Rational products and allows access if users need to restore a system to the previous version of Rational products.

Specifying the IBM Rational license server

You can provide a license server name in the Setup wizard if you are using floating licenses. You can provide the license server name if you plan to have users install from a release area or run a silent installation from the release area. If your product requires a license key and you do not provide the server name, the License Key Administrator (LKAD) starts at the end of the installation.

Testing your site defaults file

When you create a release area, you have the option to install the product on your desktop. To test the site defaults file: 1. In the Launch Installation page, select Launch installation using these settings and then click Done and Next. 2. When the Rational Setup Wizard Completed page opens, click Finish to complete the installation of the release area. 3. When the installation begins, click Next. Choose to accept or not to accept the IBM Rational software license agreement in the License Agreement page. v If you accept the license agreement, the Setup wizard continues. v If you do not accept the license agreement, exit the Setup wizard by clicking Cancel and Finish. 4. Specify the Destination folder and click Next, or change the destination by clicking Change. 5. The Site Default Configuration page includes the release area description that you entered previously. Specify whether to use the site defaults that you set for your own computer. Either click Use the standard configuration (the site defaults that you set) or I will create my own custom client configuration. v If you select I will create my own custom client configuration: The Custom Setup page displays product features to select. Do not use the number displayed in Custom Setup or click the Space button on that page. When you click Next, you can change any of the existing site default values. (Any changes to the site default values apply only to this single installation.) After modifying the values, click Done and then click Install to begin the installation.

12

IBM Rational Rose: Installation Guide

v If you select Use the standard configuration, the features for the existing site default values are used for the installation. To begin the installation, click Next and then click Install . 6. If files required for the installation are in use while the Setup wizard is running and shared components must be installed, the Setup wizard may need to restart your computer. If so, a Restart Windows page opens. Select Restart or Dont Restart. If you select Dont Restart, the wizard reminds you that the installation cannot complete until Windows restarts. The second part of the installation process starts after you log on. 7. When the Setup Complete page opens, review the current information related to new features and known issues in the readme file. In addition, you can view the IBM developerWorks Web pages. Click Finish to complete the installation.

Running the Site Preparation Wizard to create multiple site defaults files
In some cases, your site might require multiple site defaults files. For example, if several users use Rational Rose but need to work with different default settings (such as Rational Rose features), you can create one site defaults file for each group of users. To create multiple site defaults for a release area: 1. Create the initial release area as described in Using the Setup Wizard to create a release area and site defaults file on page 10. Set up this area with the site-specific parameters needed by the first group of users. 2. Open the site defaults file created in Step 1 (sitedefs.dat, for instance) by clicking File > Open. The Site Preparation wizard displays the values set in sitedefs.dat. Keep the values that apply to both groups and change the values to meet the needs of the second group. 3. Click File > Save as to save a new site defaults file. You are prompted to enter a file name and folder for the new site defaults file. v If you started the site preparation on the command line and specified a file-name argument for the site defaults file (for example, sitedefs.dat) the Folder and File name fields include this information. You can save the modified site defaults files with a new file name, for example sitedefs_roseclient.dat. v If no file name was specified, the File name field is blank. Type a file name that does not currently exist in the release area. If you enter the name of an existing site defaults file, a warning message opens. You can overwrite the existing file or specify a different file name to create a new site defaults file. You can create additional site defaults files in this way.

Setting up silent installations of IBM Rational products

Silent installation is a method of installing Rational products on client computers without intervention from users. It greatly reduces the work of an administrator during a deployment. It also ensures that the correct software configuration is installed on each server and desktop. This section describes how to set up and test the performance of a silent installation.
Chapter 2. Configuring the installation

13

Silent installation setup

The basic steps for setting up a silent installation are explained in the following list. 1. Create a site defaults file and a release area (optional) on the network. a. Use the Enterprise Deployment option in the Rational Setup wizard to create a site defaults file and a release area to deploy the product to your users. For instructions, see Creating a release area and site defaults file on page 10. Or use the Site Preparation wizard by double-clicking siteprep.exe in the CD image or IBM download package (or enter siteprep.exe on the command line) to create a site defaults file without the release area. b. You can customize site defaults files for different sets of users. For more information, see Running the Site Preparation Wizard to create multiple site defaults files on page 13. 2. Enter the command setup.exe /g to start the Setup wizard and test the site defaults file. You should not see any installation screens displayed on your computer during the installation. (See Command syntax for setup.exe on page 23 for the full command.) The file directs the Rational Setup wizard to install program files in a specific directory on your computer. If the computer must be restarted, it restarts automatically. When you log on again, the installer restarts and finishes. When the installation is finished, you do not see an installation complete screen. If you did not specify the license server in the site defaults file, you or your users might have to configure licensing manually after the Setup wizard finishes. 3. Give users the following information so that they can perform silent installations on their computers. v Path to the site defaults file and the Setup.exe file in the release area or the shortcut to the site defaults file. (The shortcut does not have a .dat suffix.) v Silent installation commands. v Installation directory (where the Setup wizard installs the files on your desktop). v License key information, if necessary. Also, ensure that users remove all IBM Rational products from their desktops. Users who install silently do not see the message to remove previous versions of IBM Rational products. The installation does not proceed until all products are removed. The message is saved in the users installation log file. If the installation fails, tell users to examine the log file. For information about setup.exe command syntax, see Command syntax for setup.exe on page 23 or type setup / ?.

Testing a silent installation

After you create the site defaults file, test it by running a silent installation. Follow the instructions in Running a silent installation on page 22.

Rational_install log file

The Setup wizard does not display an error summary. The file Rational_install.log records all installation activities. You and a customer support representative can use this file to trace most installation errors.

14

IBM Rational Rose: Installation Guide

By default, the installation log file is in the TEMP directory. The location of the directory is set in the TEMP environment variable on the computer. To find the location, open a command window and type echo %TEMP% at the prompt. This folder and file may be hidden. To display them in Windows Explorer, select Show Hidden Files and Folders when searching for the file. The installation log is not cumulative. The log file is overwritten when you perform another installation or when you repair or modify an existing installation. If you need to save the log, either copy it to a different location or rename it before you install another product.

Chapter 2. Configuring the installation

15

16

IBM Rational Rose: Installation Guide

Chapter 3. Installing this product as part of IBM Rational Suite

In this release of IBM Rational Suite, the products offered can only be installed individually. You can no longer install a collection of Rational products as a single Rational Suite. The products are installed separately to support patching and upgrading. If you are installing Rational products for the first time, follow the instructions in the installation guide for each product that you install. If you have installed a Rational product that was a part of Rational Suite, review the upgrade section of this guide carefully. Version 7.0 is a major release that includes changes to installation and other operating processes, dependencies between products, and interoperability with product integrations. In some cases, tasks must be performed in a specific sequence, for example, upgrading server components before upgrading clients. As of version 7.0, all Rational products installed on a computer must be the same version. How different versions are removed depends on which versions are installed. v If you installed multiple Rational products as part of Rational Suite, and those products are version 2003.06.xx, installing version 7.0 of any product uninstalls all products in Rational Suite, not just the one you are upgrading. After installing a product in the current release, you must reinstall all other version 7.0 Rational products that you use. v If you installed multiple Rational products as part of Rational Suite, and those products are version 2002.05.00 or earlier, you must uninstall all other Rational products that you use and reinstall them individually. v If you installed multiple Rational products not as part of Rational Suite, when you install version 7.0 of any product, the other products are not uninstalled. You must install and upgrade each product separately.

Site defaults file required for each product

You can no longer use the Site Preparation wizard to create a single site defaults file that installs multiple products of Rational Suite. For version 7.0, you must create and run a site defaults file for each product.

Change to search order for license keys

If you have a license for a previous release of Rational Suite, that license is valid in the current release, but the search order for the license key has changed. In earlier releases, when a product from Rational Suite was installed, the Rational License Key Administrator (LKAD) application tried to find a license key that corresponded to Rational Suite. If such a key was not available, LKAD searched for a key that corresponded to the product itself. In version 7.0, LKAD looks for the product-specific license key first. You can still use the License Usage Mapper in LKAD to change this search order or have the application not search for a Rational Suite key. For more information about licensing, see the IBM Rational License Management Guide.
Copyright IBM Corp. 1993, 2006

17

18

IBM Rational Rose: Installation Guide

Chapter 4. Installing Rational Rose

This section describes how to install Rational Rose using the Rational Setup wizard. It includes instructions for the following tasks: v Installing from a release area on page 20 v Installation from a CD or Web download on page 20 v Running the IBM Rational LaunchPad and Setup wizard on page 20 v Interrupting an installation on page 21 v Rational Setup wizard warnings and blocks on page 21 v Performing a silent installation on page 22 v Command syntax for setup.exe on page 23 v Command syntax for MSIEXEC.exe on page 24 v Licensing your software on page 24

Before you start the Rational Setup wizard

The following general requirements are necessary to run the Rational Setup wizard on your system. v Log in as a user with administrator privileges. v Verify that your system meets the minimum requirements and is running on the correct operating system, see the IBM Rational Rose Release Notes. v Make available a backup copy of your registry and system directories. Also see, Backup guidelines in Preparing to install IBM Rational Rose. v If you have Rational products on your system from a previous release, this installation process uninstalls them. Back up any local files and data related to those versions. v Before you begin the installation, stop all applications. v Turn off all virus protection software. These programs often run in the background and interfere with the performance of the installation application because the virus protection checks each file that is installed. v If you do not have the correct version of Windows Installer software on your computer, the Setup wizard installs it. If you cancel the installation, the updated version of Windows Installer is not removed. In some cases, you might have to restart the computer. v The Setup wizard uses C:\Program Files\Rational as the default installation directory. v The Setup wizard requires that you install all IBM Rational products in the same directory. If you already have Rational products installed on the computer, the Setup wizard installs additional Rational products in the same directory. v The Setup wizard installs Microsoft Core Components and some additional files on the same drive as the operating system (often drive C), even if you have specified an alternate drive for installation. These files can require 5 to 15 MB of temporary disk space on your hard disk.

Copyright IBM Corp. 1993, 2006

19

Installing from a release area

Your administrator can configure a release area for installing Rational products. All installation files are included and configured to install the product by running a site default file. When you install products from a release area, the installation screens present default values. You should accept these values by running a standard rather than customized configuration; if you have any concerns about the default values, see your administrator. To install a Rational product from the release area: 1. Ask your administrator for the name of the release area and one of the following: v The site defaults file, if the administrator configured one other than the default (sitedefs.dat). v A defaults shortcut, such as sitedefs_roseclient or sitedefs_roseclient.lnk. 2. Log on to your local system as a user with administrator privileges. 3. Run the installation v In a command window, use the cd command to navigate to the root directory of the release area. Then enter the command setup.exe; include a site defaults file if your administrator has configured one, for example:
setup.exe sitedefs_roseclient.dat

v In Windows Explorer, expand the mapped drive and run the shortcut specified by your administrator, for example, sitedefs_roseclient.lnk or sitedefs_roseclient. For more information about the Setup wizard, see Running the IBM Rational LaunchPad and Setup wizard.

Installation from a CD or Web download

This section describes a typical installation of a product from the product CD or from a software package that you downloaded from the IBM Rational Licensing and Download center. 1. Log in as a user with Administrator rights on the local machine. 2. Insert the IBM Rational product-name Disk (or, Disk 1 if multiple disks) into the CD drive. If autorun is enabled, the installation begins. If autorun is disabled, click Start > Run and enter the following command where cd_drive is the letter of the CD drive: cd_drive:\Setup.exe 3. If you downloaded the software, extract the files and click Setup.exe. The Setup wizard starts.

Running the IBM Rational LaunchPad and Setup wizard

The LaunchPad starts the Setup wizard, which guides you through the software installation. To continue the installation process, follow the instructions that the LaunchPad and Setup wizard provide. The following provides information about the steps of the Setup wizard. 1. If the product you are installing has been translated to the language of your operating system, the language selector is the first window that opens after you start the Setup wizard. You can select English or the language of your operating system.

20

IBM Rational Rose: Installation Guide

2. From the LaunchPad page, you can access additional information about the product or proceed with the installation. 3. On the Deployment Method page, select Desktop installation from CD image. 4. The Upgrade Warning is displayed if you have previous versions of Rational products on your computer. If you continue with the installation, these products are uninstalled. 5. The License Agreement page displays the IBM Rational software license agreement. You must agree to the agreement before continuing with the installation. To accept the agreement, click Agree; to exit from the installation, click Decline. 6. The Destination Folder page displays the default destination folder for the installation. To select a different destination folder for the installation, click Change. You cannot modify this selection if you have installed other Rational products from this release on this computer. 7. If you are installing from a release area, the Site Default Configuration page opens. To accept the site default values configured by your administrator, click Use the standard configuration. Use the custom installation option if your administrator recommends it. 8. If you are using the custom configuration option, the Custom Setup page is displayed. 9. Click Install. 10. A Restart Windows page opens if the Setup wizard needs to restart your computer. The second part of the installation process begins after you log on again. 11. After the Setup Complete page opens, review the information related to new features and known issues in the readme file. In addition, you can view the IBM developerWorks Web pages. To complete the installation, click Finish.

Interrupting an installation
If you close the Setup wizard while the installation is in progress, your computer might be in an unstable state, and you might need to restart it.

Rational Setup wizard warnings and blocks

If you encounter blocks or warnings during the installation procedure and do not remember the entire message, see Table 3.
Table 3. Warnings and blocks Warning or block You are attempting to install on an unsupported operating system. You are attempting to install on a system with an unsupported browser. Solution Install the product on a supported operating system. For a complete list of supported operating systems and service packs, see the release notes. For a complete list of supported browsers, see the release notes.

You are attempting to install on a For a complete list of supported versions, see the system that has an version of Microsoft release notes. Office that is not compatible with SiteCheck. You are attempting to install on an unsupported version of WebSphere Studio. Use a supported version. For the complete list of supported operating systems, see the release notes.
Chapter 4. Installing Rational Rose

21

Table 3. Warnings and blocks (continued) Warning or block MDAC and ODBC. Solution If the correct MDAC and ODBC drivers are not installed on your computer, the Setup wizard installs version 2.7 of the Microsoft Data Access Components (MDAC) and Open Database Connectivity (ODBC) drivers. For more information, read Microsoft Knowledge Base Article 216149.

Performing a silent installation

A silent installation uses the same parameters to install a Rational software product on one or more computers without using the interactive user interface.

Overview of silent installation

Your administrator can set up a site defaults file so that many users can perform unattended installations of a product with the same parameters. The site defaults file directs the Setup wizard to install program files in a specific directory on your computer. For information about setting up a silent installation, see Setting up silent installations of IBM Rational products on page 13. When you start the silent installation, you do not see any installation screens. If required, your computer restarts automatically, and you must log on again. When the installation finishes, you do not see a screen that indicates the installation is complete. If your administrator did not specify the license server in the site defaults file or if you are using a node-locked license key, you might have to configure licensing manually after the Setup wizard finishes. For more information, see Licensing your software on page 24.

Running a silent installation

To run a silent installation, your administrator must give you the following information: v The path to the site defaults file and the file setup.exe in the release area or shortcut to the site defaults file. (The shortcut does not have a .dat file extension). v The installation directory in the Setup wizard, which installs the files on your desktop. v License key information, if necessary. Also, verify that you have removed all previous versions of Rational products. Users who install silently do not see the warning message to remove these products. The installation does not proceed until all of these products are removed. This warning message is saved in the installation log file. Examine this file if the installation fails. Note: If you perform the silent installation, but do not have administrator rights on the machine, there is no indication that the product installation has failed. To use the site defaults file in silent mode: 1. (Optional) Map a local drive to the release area.

22

IBM Rational Rose: Installation Guide

2. Click Start > Run and enter the following commands where local-drive is the mapped drive or the path to setup.exe and filename is the name of the site defaults file: local-drive: \setup.exe /g C:\filename.dat The product specified in the site defaults file is installed from the source directory to the installation directory. The default installation directory is C:\Program Files\Rational\Rational-products. If necessary, your computer restarts. You must then log on manually; The installer restarts and finishes. When the installation finishes, you do not see a message to indicate that the installation is complete. If your administrator did not specify the license server in the site defaults file, you might have to configure licensing manually after the Setup wizard finishes. If the Setup wizard detects insufficient disk space on the desktop, the wizard will cancel the installation and note the error in the Rational_install.log file in your TEMP directory. The location of the directory depends on the environment variable set on the computer. To find the location, open a command window and type echo %TEMP% at the prompt. There is no command to cancel a silent installation.

Command syntax for setup.exe

Installs a Rational product from a Windows Command Prompt.

Synopsis
setup [/g silent_install] path-to-sitedefs.dat [/lv logfilename] [/d default_language]

Description
The setup command starts the Rational Setup Wizard, which installs the product on your computer. When running the setup command, you must specify the location of the filesitedefs.dat. For more information about installing from a release area and using sitedefs.dat, see Installing from a release area on page 20. The command also has the options to run a silent installation, create a detailed log file, and install the product in the default language of your operating system.

Options and arguments

/g Specifies to run setup.exe in silent mode. When you specify this option, your Rational product is installed without a progress bar or notification that the installation process has completed. Specifies to create a log file of the installation process. You must specify the location for the log file. Specifies to install the product in the default language of the operating system. If you do not use this option, you are prompted to specify a language even for a silent installation.

/lv /d

Example
Runs a silent installation, creates a log file, and installs the product in the default language of the operation system.
setup /g \rational_release\rose_sitedefs.dat /lv C:\temp\rose_install_log.txt /d

Chapter 4. Installing Rational Rose

23

Command syntax for MSIEXEC.exe

If you want more options when installing products from the command line, you can also use MSIEXEC.exe. For information about this application and its parameters, go to http://www.microsoft.com/resources/documentation/ windows/xp/all/proddocs/en-us/msiexec.mspx. You can also open a help window by running MSIEXEC.exe /? from a Windows Command Prompt to see an abbreviated display of the command and its parameters.

Licensing your software

In all cases, you need a license key to start the product. Your license administrator can tell you which license key to use and where to obtain it. The License Key Administrator (LKAD) is a tool that imports license keys to your license server. LKAD provides a wizard to simplify the process. The Rational Setup wizard installs LKAD with each IBM Rational product. If the product is not already licensed, you can start the LKAD wizard when the installation process is finished. You can also start LKAD by clicking Start > Programs > IBM Rational > IBM Rational License Key Administrator. The LKAD main window and wizard page open simultaneously. For more information, see the LKAD Help. If you do not see the License Key Administrator (LKAD) start at the end of the installation, your product is already licensed. Follow the instructions in Table 4 to license your IBM Rational product.
Table 4. Requesting and installing IBM Rational license keys Type of license key Permanent node-locked Where to request license key AccountLink (www.ibm.com/software/ rational/support/licensing/) How to install Import the key on your desktop with the License Key Administrator (LKAD) wizard. To configure your client to point to the license server, use the License Key Administrator (LKAD) wizard. Your administrator must install and set up the license server first. (For instructions, see the IBM Rational License Management Guide.) If your administrator has set up a release area, you might not have to specify the license server in the LKAD wizard.

Permanent floating AccountLink (www.ibm.com/software/ rational/support/licensing/)

24

IBM Rational Rose: Installation Guide

Table 4. Requesting and installing IBM Rational license keys (continued) Type of license key Where to request license key How to install Configure your desktop to point to the Rational License Server by using the License Key Administrator (LKAD) wizard. Your administrator must install and set up the license server first. (For instructions, see the IBM Rational License Management Guide.) If your administrator has set up a release area, you might not have to specify the license server in the LKAD wizard. Evaluation node-locked Your sales representative Import the node-locked key on your desktop with the License Key Administrator (LKAD) wizard.

Evaluation floating Your sales representative

Licensing products on Windows Terminal Servers

To use IBM Rational products that support hosted development on Windows Terminal Servers, you must have floating licenses.

Chapter 4. Installing Rational Rose

25

26

IBM Rational Rose: Installation Guide

Chapter 5. Uninstalling Rational software

This section provides information about removing earlier versions of Rational software before upgrading to a new version.

Before you uninstall Rational products

This section provides general requirements that must be met before removing Rational products. It also describes which components the Setup wizard does and does not remove from the computer. v If you plan to move the application to another system, first return the license key file to your Rational software account. Use AccountLink to return a node-locked or floating license key. To find AccountLink, go to www.ibm.com/software/rational/support/licensing/ and click IBM Rational Licensing and Download Center . For more information about moving licenses or returning licenses, see the IBM Rational License Management Guide. v Removing a Rational product does not delete the license key file, project databases, and other files that you created while using the product. If you plan to install an upgrade of the Rational product to a different drive or use a new installation path, back up these files and manually remove them. If you do not remove them, the Setup wizard may find these files and install the application in the previous location rather than the new location. v Before removing the Rational products (including the Rational license server) from clients, record the specified license server host names in the License Key Administrator (LKAD). 1. Start the LKAD. Click Start > Programs > IBM Rational > IBM Rational License Key Administrator. 2. Find the host names. Click Settings > Client/Server Configuration. 3. After you install the new Rational products, reset the license server name in the LKAD. The LKAD wizard starts after the installation. If the wizard does not start, click Start > Programs > IBM Rational Software > IBM Rational License Key Administrator. v Removing Rational Rose does not remove its data from the computer. If you reinstall Rational Rose on the same computer, you must install it in the same directory to see the data. v To remove Rational products from a Windows NT, Windows 2000, or Windows XP computer, you must have Windows administrator privileges on the local system. v Make sure that no one is using the application or any associated files. You cannot remove files that are in use.

To uninstall Rational products

Use the Add or Remove Programs function in the Windows Control Panel to select and remove the IBM Rational product. Click Start > Control Panel > Add or Remove Programs. Highlight the product and click Remove.

To uninstall from the command line

If you want to uninstall Rational products from the command line, you must use the MSIEXEC.exe application. For information about this command and its

Copyright IBM Corp. 1993, 2006

27

parameters, go to http://www.microsoft.com/resources/documentation/ windows/xp/all/proddocs/en-us/msiexec.mspx or run MSIEXEC.exe /? from a Windows Command Prompt.

Removing a Rational fix pack

After a fix pack is applied, you cannot uninstall the updates it makes on your computer. To revert to your previous IBM Rational product configuration: v Uninstall all IBM Rational products for which the fix pack was applied. v Install the preferred version of the Rational product again.

28

IBM Rational Rose: Installation Guide

Appendix. Notices
This information was developed for products and services offered in various countries throughout the world. IBM may not offer the products, services, or features discussed in this document in every country. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Copyright IBM Corp. 1993, 2006

29

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Department BCFB 20 Maguire Road Lexington, MA 02421 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. USE OF SAMPLES CONTAINED IN THIS INFORMATION: This information may contain sample application programs in source language, which illustrates programming techniques on various operating platforms. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (c) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (c) Copyright IBM Corp. _enter the year or years_. All rights reserved. ADDITIONAL NOTICES: Additional legal notices may be included with the license agreement accompanying the licensed program described in this document. TRADEMARKS: AIX, ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearGuide, ClearQuest, DB2, DB2 Universal Database, DDTS, Domino, IBM, Lotus Notes, MVS, Notes, OS/390, Passport Advantage, ProjectConsole Purify, Rational, Rational Rose, Rational Suite, Rational Unified Process,

30

IBM Rational Rose: Installation Guide

RequisitePro, RUP, S/390, SoDA, SP1, SP2, Team Unifying Platform, WebSphere, XDE, and z/OS are trademarks of International Business Machines Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product or service names may be trademarks or service marks of others.

Appendix. Notices

31

32

IBM Rational Rose: Installation Guide

Index A
administrator privileges Windows 7

P
privileges requirements for Windows 7

V
version upgrades 4 virus protection software 19

C
CDs installing from 20 client software installing on Windows command syntax MSIEXEC.exe 24 setup.exe 23 customer support vii 19

R
Rational Common Licensing configuring 7 management tools for 7 setup tasks 4 Rational Setup wizard before running, requirements 19 default installation path 19 stopping services 19 Rational Suite changes to license keys 17 different versions of, and installation requirements 17 Rational_install log about 14 registry backup copy 19 release areas about 10 creating with Setup wizard 10 fix packs for 12 installing from 20 removing products silent installation 22

W
Web downloads installing from 20

D
deployment methods about 5 compared 9 configuring 9 disk space temporary 19

F
fix packs applying to release area 12 FLEXlm licensing mechanism 4

S
Setup wizard blocks and warnings 21 interrupting 21 setup.exe command syntax 23 silent installations about 22 how to run 22 setting up 13 testing 14 site defaults files changes to, and Rational Suite 17 creating 10 creating multiple 13 creating with Setup wizard 10 silent installation, using in 22 system directories backup copies 19

I
installation path default 19

L
License Key Administrator about 24 license keys changes to search order how to obtain 8 tools for and 24 license servers specifying 12 log files Rational_install 14 17

M
Microsoft Core Components installing 19 MSIEXEC.exe 24

U
upgrading products different versions 4 heterogeneous verisons 4 requirements to uninstall 17

Copyright IBM Corp. 1993, 2006

33

34

IBM Rational Rose: Installation Guide

Printed in USA

GI11-6296-00