![]() |
![]() |
![]() |
![]() |
Installing Rational Suite DevelopmentStudio This chapter details how to install the Rational Suite DevelopmentStudio and includes the following topics:
- Installing Rational Suite DevelopmentStudio (UNIX Components)
- Running Rational Suite DevelopmentStudio for UNIX: User Setup Script
- Installing Rational Suite DevelopmentStudio (Windows Components)
- Removing the Rational Suite DevelopmentStudio Software
- Next Steps
Note: If you have not reviewed Before You Install, you should do so before proceeding.
Upgrading Rational Suite DevelopmentStudioUpgrading 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:
- Ask - if you want to reinstall the product
- Skip - if you want rs_install to automatically skip any product that has already been installed
- Reinstall - if you want rs_install to automatically uninstall and reinstall the product.
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.
If the CD-ROM drive is not mounted, supplemental instructions can be found in the appendix, Accessing the CD-ROM Drive.
- 3 Run the installation script, rs_install, which is located at the root level of the CD.
./rs_install
- 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.
- 7 Choose your license option from the Licensing Options Menu.
- 8 Do one of the following:
- If you chose to use an existing license in Step 7, go to Step 9.
- If you chose to set up a temporary license in Step 7, go to Step 10.
- If you chose to set up a permanent license in Step 7, go to Step 11.
- 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.
Go to Step 13.
- 10 Enter the temporary license key information from your license key certificate.
- Expiration date
- License key.
Go to Step 13.
- 11 Provide your license file information by doing one of the following:
- Import the information from the license file automatically by giving the path to the .upd file. This is the file that AccountLink sends to an e-mail account when you request a license. It has the filename format similar to license_for_server.upd.
- Enter none to provide the license key information manually. You will need a printout of the content of the .upd file. Follow the prompts.
- 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:
- If you chose to set up an existing license in Step 7, run through options 1 and 3. Note that these options are the default settings provided by rs_install. There is no need to restart the license server (option 2) if it is already running.
- If you chose to set up a permanent floating license in Step 7, run through options 1-3 sequentially and forward to the next menu. If you chose to set up a permanent node-locked license in Step 7, run through option 1 only. Note that these options are the default settings provided by rs_install.
- If you chose to set up a temporary license in Step 7, run through option 1 and forward to the next menu. Note that these options are the default settings provided by rs_install.
- 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.
- 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.
- 20 You are prompted to configure the cache directory for Rational Purify, Rational PureCoverage, and Rational Quantify. Do one of the following:
- Enter no to accept the default directory.
- Enter yes to specify an alternate location and follow the prompts.
- 21 Are you configuring Rose to work with Apex? Enter a value Yes or No.
- 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.
- 24 Enter the FrameMaker + SGML directory. Do one of the following:
- If you do not have FrameMaker + SGML installed on your system, enter none. Continue with the installation and see Integrating Products That Are Not Part of the Suite after you have finished installing.
- If you have FrameMaker + SGML installed, enter the path.
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:
- If you do not plan to use these web interfaces, enter none.
- If you do not know the URL for these servers, enter none and run the web_setup command after you have the URLs.
- If you know the URLs, enter them now.
- 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 InstallationIt 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.
- 1 Test the UNIX installation and licensing by running Rose and SoDA.
For csh, tcsh, or compatible shells, do the following:
% source rational_dir/rs_setup.csh
% rose
% soda
For ksh, bash, or other Korn-compatible shells, do the following:
$ . rational_dir/rs_setup.ksh
$ rose
$ 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 ScriptInstallation 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:
source rational_dir/rs_setup.csh
For sh, ksh, bash, and other Bourne-compatible shells, source the following from the .profile file:
. rational_dir/rs_setup.ksh
Use the following aliases to start a Suite product:
Integrating Products That Are Not Part of the SuiteYou may choose to add products that are not part of the Suite after you have installed Rational Suite DevelopmentStudio. The following products are examples:
- Adobe FrameMaker + SGML 5.5 or 6.0 (required to use SoDA)
- Rational Apex
- Requisite Web (Windows)
- Rational ClearQuest (Windows)
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 VariantAfter 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 WebIf 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
- 1 Enter the rpweb command on the UNIX host.
% rpweb
rpweb will launch Netscape Navigator, and display the RequisiteWeb URL. If the rpweb command fails, then try sourcing rational_dir/rs_setup.csh.
For csh, tcsh, or compatible shells:
For sh, ksh, bash, and other Bourne-compatible shells:
$ . rs_setup.ksh
$ rpweb
Another method of testing RequisiteWeb is to invoke Netscape Navigator and point it at the RequisiteWeb URL with the following command.
% netscape -install http://requisiteweb_url
Removing the Rational Suite DevelopmentStudio SoftwareAfter 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:
rational_dir
/base/cots/flexlm.
version
/
platform
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.
% cd rational_dir % config/uninstall
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
- If you plan to set up a Windows license server to administer licenses for Requisite Web, see Installing the FLEXlm License Server on Windows.
- If you have ClearCase installed and plan on using it with the DevelopmentStudio for UNIX, then set up the Rose/ClearCase integration by following the directions in the Rose on-line help topic "Configuring the Rose for UNIX/ClearCase Integration".
- If you plan to set up your UNIX license server in a redundant configuration, see Setting up Redundant Servers on UNIX.
- You must configure the following applications before you can use them:
Rational Software Corporation
http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |