Rational Software Corp.

TOC PREV NEXT INDEX



Installing Rational Suite DevelopmentStudio

This chapter details how to install the Rational Suite DevelopmentStudio and includes the following topics:

Note: If you have not reviewed Before You Install, you should do so before proceeding.


Upgrading Rational Suite DevelopmentStudio

Upgrading from the Beta Version 2001A.04.00

If you installed the beta software for version 2001A.04.00, you must remove the software before installing the final version.

Upgrading from Version 2000.02.10

If you are upgrading from version 2000.02.10, you may use your existing license.

1 Install the product by running rs_install. For complete instructions, see Installing Rational Suite DevelopmentStudio (UNIX Components).

2 Choose option 1, use an existing FLEXlm license file, from the Licensing Options Menu.

3 After you have completed the upgrade, you may wish to remove the previous version to recover disk space. See Removing the Rational Suite DevelopmentStudio Software.

    Note: If you have previously installed version 3.0.1, 3.0.3, or 3.1.0 of Rational SoDA, you may choose to use the installation of FrameMaker+SGML bundled with that release. To do this, copy the entire SoDA directory to a new location and uninstall the previous version of Rational Suite DevelopmentStudio. This way, you do not accidentally remove the previous version of Rational SoDA when you uninstall the Suite.

Upgrading from a Release Prior to Version 2000.02.10

As of version 2000.02.10, all license management is done through Rational AccountLink, a new online licensing web tool. You need to return your old license keys and request new license keys before you can install Rational Suite DevelopmentStudio. For information, see Requesting License Keys.

1 Install the product by running rs_install. For complete instructions, see Installing Rational Suite DevelopmentStudio (UNIX Components).

2 Choose option 2, setup a permanent or term-license-agreement, from the Licensing Options Menu.

3 After you have completed the upgrade, you may wish to remove the previous version to recover disk space. See Removing the Rational Suite DevelopmentStudio Software.

    Note: If you have previously installed version 3.0.1, 3.0.3, or 3.1.0 of Rational SoDA, you may choose to use the installation of FrameMaker+SGML bundled with that release. To do this, copy the entire SoDA directory to a new location and uninstall the previous version of Rational Suite DevelopmentStudio. This way, you do not accidentally remove the previous version of Rational SoDA when you uninstall the Suite.


Installing Rational Suite DevelopmentStudio (UNIX Components)

This section provides instructions about how to install Rational Suite DevelopmentStudio. The rs_install command is a complete installer that includes licensing setup, license checking, product installation, and product setup. Rational recommends that you follow the menus and prompts and allow rs_install to guide you through the installation.

Default values, where provided, are enclosed in square brackets. To accept the default value, simply press the Enter key.

Installing in Secure Environments

Problems may occur when trying to perform a remote installation of Rational Suite DevelopmentStudio in a secure environment (for example, remote access to other machines is through ssh) if the environment does not have access to rsh or remsh. To install Rational Suite DevelopmentStudio in this situation, perform a local installation of the software rather than a remote installation. If you experience further problems, contact Rational Technical Support.

Installing Multiple OS Versions of Rational Suite DevelopmentStudio

If you wish to install different OS versions of Rational Suite DevelopmentStudio (for example, Solaris and HP-UX) on the same file server, it is recommended that you install them in different rational directories (referred to as rational_dir). If you install them into the same Rational directory, you will not be able to uninstall a single OS version later, if necessary. The uninstall script will remove all OS versions that reside in the same Rational directory.

Stopping and Restarting an Installation

You can stop an installation by entering q to quit the installation. If you choose q, most of your input is saved in a user defaults file that is located in rational_dir/config/defaults. The file name itself is in the following format: rs_install.release_name.user_name.

The user defaults file contains general purpose defaults that relate to you and the license server that you configure. It also keeps track of the product-specific information for the installation of this specific Suite and version.

Note: If you enter q!, your entries are not saved to the user defaults file.

You can restart the installation by running rs_install again.You should notice that many of your entries appear as the default value. Simply press the Enter key to continue with the installation. After you get to the Enter Install Mode screen you can choose one of three options:

Note: Rational Rose and Rational SoDA are always automatically installed regardless of the setting. This will not affect any user areas for Rational Rose or Rational SoDA that were set up in an earlier installation.

To install Rational Suite DevelopmentStudio (UNIX Components):

1 Log on to the install client. This may be any UNIX computer that:

­ Gives you access to a CD-ROM drive

­ Mounts the file system into which you will load the Rational Suite DevelopmentStudio release

­ Runs the operating system specified on the Rational Suite DevelopmentStudio CD (Solaris 2.5.1, 2.6, Solaris 7 or Solaris 8; or HP-UX 10.20, 11.0 or 11.11)

    Note: You do not need to be root to install the product.

2 Place the Rational Suite DevelopmentStudio CD in the CD-ROM drive.

3 Run the installation script, rs_install, which is located at the root level of the CD.

    ./rs_install
    

      rs_install can be invoked with a number of options. For example, the -no_log (-nl) option can be used to stop rs_install from creating a log file. To see a listing of all available options, run rs_install -help.

4 Enter the directory where you will install Rational Suite DevelopmentStudio.

    Note: For the Rational directory, supply a pathname such as: /vendor/rational. The directory needs to be visible on all computers from which you want to run this product, and must be writable by the installer's user name. Also, the NFS name for the directory must be the same on all computers.

5 Read through the license agreement and answer yes (y) to accept the terms.

6 Choose your license configuration option from the Product and License Configuration Selection Menu. Options 1 applies to the Rational Suite DevelopmentStudio installation.

Option

Description

1


Choose this option to install Rational Suite DevelopmentStudio.

2-7

Choose one of these options to install an individual point product.
Note: You need to have an individual product license for the product specified. These options are not intended to be used for the Suite installation but rather to provide a means of using the Rational Suite DevelopmentStudio CD to install individual point products that you may have purchased separately.

7 Choose your license option from the Licensing Options Menu.

Option

Description

1


Choose this option if you already have an existing license file for version 2000.02.10 or later of Rational Suite DevelopmentStudio.
Note: Rational has changed the way licenses are handled in version 2000.02.10. If you are upgrading from a release prior to version 2000.02.10, you should select option 2. Before you do so, you will need to return your old license key and request a new license key through AccountLink. For more information see Requesting License Keys.
Caution: Selecting this option will not upgrade the license server software automatically. It is highly recommended that you upgrade the license server software from FLEXlm 6.0i to FLEXlm 7.0f if you have not already done so. This will allow you to take advantage of the new features and help optimize your license server's performance. If you choose not to upgrade and experience frequent problems such as internal errors or vendor daemon errors, you should upgrade the license server software as a first step to addressing these issues. To do this, run rs_install again, select option 2, and enter the license key manually (see step 11).

2


Choose this option if you have a permanent license key or a Term License Agreement (TLA).
This is a full installation that upgrades both the Rational Suite products and the license server software (FLEXlm 7.0f).
Note: You need to have either the license file (filename.upd) stored in a known location on the license server or you need a printout of the contents of the license file available to proceed with the install. rs_install prompts you to provide the location of the license file or gives you the option to enter the license key information manually. If you do not have a license file containing your license keys, see Requesting License Keys.

3


Choose this option if you do not have a permanent license yet and you want to install the product immediately, or if you want to install the product for evaluation purposes.
Because the license keys are uncounted, option 3 does not start the license server as part of the license check. A license server process is started if you are serving both UNIX and Windows evaluation licenses on a UNIX license server. This is because the Windows License Key Administrator (LKAD) requires the port and host information (port@host) when configuring access to a UNIX license server.
This is a full installation that upgrades both the Rational Suite products and the license server software (FLEXlm 7.0f).
Note: You need to have your license key certificate available as rs_install prompts you for information contained in the certificate.

8 Do one of the following:

9 Enter the path to the license file or enter the port information.

    Note: If the license server is running, it is preferable to specify the port. Enter port@host, where port is the TCP/IP port number used by the license server and the host is the hostname of the license server.

10 Enter the temporary license key information from your license key certificate.

11 Provide your license file information by doing one of the following:

12 Define the location for the license.dat file that will be created from the information supplied by the license_for_server.upd file. By default, rs_install creates the license.dat file and stores it in the rational_dir/config directory.

    Choose either the default path (option 1) that rs_install has selected or choose option 2 to specify an alternate path.

    Note: If you are prompted for port@host information, simply press the Enter key.

13 Proceed with the License Check Menu. Do one of the following:

14 The Product Customization Menu allows you to refine your Suite product installation. The default settings are shown in Figure 5. To toggle the installation setting between yes and no, enter the product number. Once you have the settings you desire, enter f to forward to the next menu.

    Note: To accommodate heterogeneous environments, the Product Customization Menu gives you the ability to install Rational Unified Process (RUP) for IBM and Microsoft environments on a UNIX server. The default installation settings install the UNIX version of RUP (generic) but you may install any or all variants to support existing clients running in IBM or Microsoft environments. To install other versions of RUP, enter the corresponding number for the variant that you want to install. To deselect the generic version of RUP, enter its number to change the selection to no.

Figure 5 Product Customization Menu

15 The Rational Rose Product Component Customization Menu allows you to customize your Rose installation. To toggle the installation setting between yes and no, enter the product number. Once you have the settings you want, enter f to forward to the next menu.


Warning: Some components have dependencies and deselecting one may affect the performance of another. Contact Rational Technical Support for more information about component dependencies.

16 If you chose to install SoDA in Step 14, the SoDA Product Configuration Menu is displayed. All options install SoDA demos and training files.

Option

Description

1


Choose this option to install the domains for Rational Suite DevelopmentStudio (Rose and ClearQuest).
Note: In earlier releases, option 1 installed all domains. Be sure to choose option 4 if you wish to install all the SoDA domains.

2


Choose this option to install the Rose domain for SoDA.

3


Choose this option to install the Rose RealTime domain for SoDA.

4


Choose this option to install all SoDA domains (Apex, Rose, Summit, TestMate, ClearCase, ClearQuest, and Rose RT).

17 The SoDA Product Component Customization Menu allows you to customize your SoDA installation. To toggle the installation setting between yes and no, enter the product number. After you have the settings you want, enter f to forward to the next menu.

18 The Install Documentation Menu allows you to customize your online documentation installation.

19 The Install Mode Menu allows you to decide whether you want rs_install to prompt you before it reinstalls a product, skip a product if it is already installed on your system, or reinstall the product without confirmation.

    The installation process starts.

20 You are prompted to configure the cache directory for Rational Purify, Rational PureCoverage, and Rational Quantify. Do one of the following:

21 Are you configuring Rose to work with Apex? Enter a value Yes or No.

    If you chose Yes, you will need to provide the path to the Apex directory.

22 Define the read/write privileges: Owner writable, Owner and group writable, or Writable by all.

23 Are you configuring SoDA to work with Apex? Enter a value Yes or No.

    If you chose Yes, you will need to provide the path to the Apex directory.

24 Enter the FrameMaker + SGML directory. Do one of the following:

    Note: This release of SoDA does not include FrameMaker + SGML. You need to have either version 5.5 or 6.0 installed to use SoDA.

25 Use ClearQuest with SoDA? Enter a value Yes or No.

    If you choose Yes, you will be prompted to provide the path to the ClearQuest installation. If you chose to install ClearQuest in Step 14, the default path is rational_dir/releases/ClearQuestClient.2001a.04.00. You can accept the default or specify another path.

26 If you answered Yes to install the Rose RT domain in Step 17, you are prompted whether or not you want to use RoseRT with SoDA? Enter a value Yes or No.

27 The Web Setup Menu allows you to enter the URLs for a Requisite Web server or a ClearQuest Web server. These applications run on a Windows server and can be accessed by UNIX developers through a web browser. Do one of the following:

28 If you chose to install more than one Rational Unified Process variant in Step 14, you are prompted to select which variant you wish to use as the primary. Enter an option (1-3) to select the primary variant. The default setting is the UNIX (Generic) version of RUP.

    Note: You may change the primary RUP variant at any time by running the post_install command. For more information see Changing the Primary RUP Variant.

The installation of the Rational Suite DevelopmentStudio is now complete.


Verify Your Installation

It is recommended that you verify that your installation is working properly. This test ensures that both the installation and licensing are working. If you experience any problems, refer to the Administering Licenses, and the Troubleshooting.

Note that Rational Rose, SoDA, and ClearQuest require configuration before actual use. For configuration information, please see the Configuring Rational Rose for UNIX, and the Configuring Rational SoDA of this document. For ClearQuest configuration, please see the ClearQuest Release Notes (HTML) and Installing Rational ClearQuest (PDF) documents.

To verify your installation:

1 Test the UNIX installation and licensing by running Rose and SoDA.

    Note: rs_setup.csh and rs_setup.ksh are setup scripts. For additional information on the setup script see Running Rational Suite DevelopmentStudio for UNIX: User Setup Script.


Running Rational Suite DevelopmentStudio for UNIX: User Setup Script

Installation creates two setup scripts which set up the environment to run all the components of DevelopmentStudio for UNIX. These can be used as a common logon for users, and as a convenient point for additional customization.

For csh, tcsh, or compatible shells, source the following from the .cshrc file:

Use the following aliases to start a Suite product:

Product

Start command

Rational Rose

% rose (to start Rose)
% modelint (to start Rose Model Integrator)
% analyzer (to start Rose C++ Analyzer)


Rational SoDA for FrameMaker

% soda

Rational Purify
Rational PureCoverage
Rational Quantify


% purify
% purecov
% quantify

See the Installing and Getting Started Rational Purify Rational PureCoverage Rational Quantify manual for a full description of start command options.

Rational ClearQuest

% clearquest

Rational Unified Process

% viewrup_gen (for UNIX RUP)
% viewrup_ibm (for IBM RUP)
% viewrup_msft (for Microsoft RUP)

% viewrup (starts the primary RUP)
Note: If you only chose to install one variant of RUP then you may use the viewrup command to start it. You only need to use the environment-specific commands if you have more than one variant installed and that variant has not been defined as the primary.


Integrating Products That Are Not Part of the Suite

You may choose to add products that are not part of the Suite after you have installed Rational Suite DevelopmentStudio. The following products are examples:

If you answered no to adding any of these products when you ran rs_install, you may install them later and simply run post_install. The post_install command allows you to run a subset of rs_install that includes prompts for integrating other products with Rational Suite DevelopmentStudio.

Rational Requisite Web and Rational ClearQuest Web

Rational Suite DevelopmentStudio includes Rational ClearQuest; however, you may want to give UNIX developers access to ClearQuest running on a Windows server. This is done by providing the URL to the Windows ClearQuest Web server.

For these two products, you may use the web_setup command to define the URLs for the Requisite Web and ClearQuest Web servers. The web_setup command allows you to run a subset of rs_install and includes the prompts for defining the location of these servers. The server information is recorded in the rpweb and cqweb scripts.


Changing the Primary RUP Variant

After you have installed Rational Suite DevelopmentStudio using rs_install, you can change the primary RUP variant at any time by running the post_install command. This only applies if you have installed more than one RUP variant.


Installing Rational Suite DevelopmentStudio (Windows Components)

This section describes how to install the Windows components of Rational Suite DevelopmentStudio for UNIX.

Step

Action

1 Are you using a single UNIX server to manage licenses for both the UNIX and Windows components?


Continue with Installing Rational Suite DevelopmentStudio (Windows Components).

2 Are you using a Windows server to manage licenses for the Windows components?


You must install the license server software on the Windows server before you install the Windows components. See Installing the FLEXlm License Server on Windows.

To install Rational Suite DevelopmentStudio (Windows Components):

1 Install RequisitePro on the Windows application server(s).

a Insert the Rational Solutions for Windows CD into the system's CD-ROM drive.

    The setup program should start automatically. If autorun is disabled on the system, click Start > Run, then using the drive letter of the CD-ROM drive, enter drive:\SETUP.EXE.

b On the Choose Product screen, the default selection must be changed to Rational Suite DevelopmentStudio for UNIX (Windows Components). To make the change, click the drop-down list, and then pick the Rational Suite DevelopmentStudio for UNIX (Windows Components) selection.


Warning: Failure to select Rational Suite DevelopmentStudio for UNIX (Windows Components) will cause the licensing to fail and the Windows products will be unusable. You cannot have Rational Suite DevelopmentStudio for UNIX (Windows Components) installed on the same computer as other Rational Suites for Windows products.

Note: If you wish to install the Windows version of ClearQuest, you will need to install it separately. (Earlier versions of DevelopmentStudio for UNIX installed the Windows version of ClearQuest by default. Now that ClearQuest for UNIX is available, the Windows version is no longer the default.) The Windows license key provided with this version of the Suite will work for both RequisitePro and ClearQuest on the Windows platform.

c At the Setup Configuration screen, select Custom.

d At the Choose Features screen, click the Web Server Components item. Leave the other selections they are.

e Continue through the installation wizard until complete.

2 Set the license server through the Windows License Key Administrator.

a Launch the License Key Administrator from the Installation Wizard, or from the Start > Programs > Rational Suite DevelopmentStudio for UNIX > License Key Administrator menu item.

b Select the Settings tab, and then click the Search Server box. Do one of the following:

­ If you are using a single UNIX server to manage licenses for both the UNIX and Windows components, enter the UNIX license Server IP address or hostname in the License Server Name field.

­ If you are using a Windows server to manage licenses for the Windows components, enter the Windows license server IP address here.

3 Check that RequisitePro is licensed correctly by starting RequisitePro from Start > Program Files > Rational Suite DevelopmentStudio for UNIX.

    If this step fails, then licensing has not been set up correctly. Additional licensing information can be found in Administering Licenses.


Configuring and Testing Requisite Web

If any RequisiteWeb users will access RequisiteWeb through the UNIX version of Netscape Navigator, you will have to do the steps outlined in the Configuring for UNIX Navigator Access topic. After installation, that topic and other configuration information can be found on your RequisitePro server at:

If the HTML documentation files were installed on the UNIX server, the same information can be found at rational_dir/docs/html/reqweb_install/RequisiteWebInstall.html

To test Requisite Web:

1 Enter the rpweb command on the UNIX host.


Removing the Rational Suite DevelopmentStudio Software

After you have installed the latest version of DevelopmentStudio for UNIX, and after all users have switched to using it, you can remove the old release to reclaim disk space.

Running the Uninstall Program

Rational includes an uninstall script in its config directory. You can uninstall an earlier release of a product or Suite by running this script in the rational_dir directory.

Before you run uninstall, you must verify that your system startup file has a valid path to the Rational license daemon. See The License Manager. Open this file and search for the string lmgrd.

If the file contains the following pathname, it is correct:

If the pathname does not look like this, you must change the path.

If you have set up the Rose/ClearCase integration on the server running uninstall, you will see a message regarding "rose" and "rose_unit" merge and compare operations. The type manager (or managers) which manage these operations for "rose" and "rose_units" will include links to this release in relation to the merge and compare operations. The messages will include instructions describing how to correct the merge and compare links that become obsolete after uninstalling this release.

With the valid path to the DevelopmentStudio for UNIX license daemon established, you are ready to run uninstall. Running the script with no command line arguments causes it to display the list of products in the releases directory. You will be prompted for the product or Suite to uninstall. If there is only one product, you will be asked for confirmation before the uninstall takes place. You must be the installer of the product to uninstall it. If you select a Suite, you will be given a chance to review the products in the Suite that would be uninstalled as part of the Suite uninstall. The default action will be to remove all of the point-products and the Suite directory.

Example:

If you have installed more than one version of Rational Suite DevelopmentStudio in the same rational_dir directory, the uninstall program will only uninstall the products for a particular Suite if that same product is not a member of another Suite. For example, if Suite 1.0 contains SoDA 3.0.0c and Purify 4.4 and Suite 2.0 contains SoDA 3.0.1 and Purify 4.4, Purify 4.4 is common to both, so it will not be uninstalled until both Suites have been uninstalled. The license software will only be removed when the last Suite using it is removed. In all cases, you can select one or more products in the Suite to be spared from the uninstall operation.

Note: Manually removing the Suite directory does not remove the Suite. The only things in the Suite directory are the Suite documentation, Suite installation tools and Suite data.


Next Steps


Rational Software Corporation  http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX