TOC PREV NEXT INDEX DOC LIST MASTER INDEX


Installation Quick Start

This chapter details how to install the Apex and Summit releases from the distribution media.

The following topics are covered in this section:

Installation Prerequisites

Before starting the installation, you need:

Note: Additional hardware and software requirements are discussed in Prerequisites.

License Preparation

If you want to integrate Rational licensing with an existing license manager, you need to know the name of the license server and the location of the license file.

You will also need to provide a TCP port number for the license server. The default port number is 1706. Use it unless you have already assigned that port number to another application.

Check for conflicts by searching the /etc/services file or, if you are running the Network Information Service (NIS), by entering this command:

Note: The default port number for other Rational products is also 1706. Specify the same port number in all installations if you are using the same license server.

Installation Steps

1 . Log into any workstation that:

2 . Create the Rational root directory, which is referred to as rational_dir throughout this guide:

3 . As root, make a directory (if one does not already exist) to be the mount point for the CD-ROM drive. The following examples for each platform uses the directory /cdrom. Make sure you know the device name of the CD-ROM drive. If you do not know the device name for the CD-ROM drive, consult your system administrator. Mounting commands for different operating systems are as follows:

    Note: If the following error occurs when attempting to read the CD-ROM on your DEC Alpha machine:

      /dev/rz4c on /cdrom: No such device.

      Verify that /dev/rz4c is the correct device name. If so, it may be necessary to have your system administrator include "options CDFS" in the system configuration file. Once this has been done, it will be necessary to rebuild the kernel. Refer to "man cdfs(4)" for additional information.

4 . Exit root and go to the /cdrom directory and run the cdinstall command. For Solaris with volume management, go to /cdrom/cdrom0. For SGI/IRIX with volume management, go to /CDROM 

    # exit
% cd /cdrom 
% ./cdinstall

    From the cdinstall menu, enter the "rd" key to set the rational_dir directory where you are going to be installing each product. Enter the "sp" key to select a product. Enter the "go" key to begin the install. .

5 . Load the Apex/Summit components from the media: 

    % cd rational_dir/releases/apex.ver/install
% ./install

    The install program allows you to quickly and easily load the default product from the release media with very little user input. If you want to install something other than the default product, you must tailor the installation

    The install program has 5 menus. When you run it, you start from the General Menu. You must traverse to the Product-Configuration Menu or the Group Menu and tailor the install. Option `t' will traverse you to one of these 2 menus. From there, you can use option `t' to traverse to the next menu or use option `r' to return to the previous menu. The menus are:

    General Menu
    Product-Configuration Menu]     (optional)
    Group Menu
    Component Menu
    Storage-Location Menu

    At each menu, you can select option `h' to get help.

    The Product-Configuration Menu allows you to select one, and only one, product configuration. If there is only one product on the release media, this menu is skipped. If you install the wrong product configuration, it is best to uninstall the product (see Chapter 8) and then start over with step 5 or 6 to install the correct configuration.

    The Group Menu allows you to select or deselect a group of components to install. Each group is numbered for you to easily specify a particular one. You may select one or more group numbers at a time separated by commas or a range x-y.

    The Component Menu allows you to select or deselect a component to install. You may enter one or more component numbers at a time.

    FLEXlm license code is included for all platforms. However, FLEXlm will only be installed by default for the platform you are running the install on. To install a copy of FLEXlm for another platform, you must tailor the install in the Component Menu.

    When the install script finishes, you are done with the release media. Store the CD-ROM (or tape) in a safe place in case you ever need to reinstall the product.

    Note: If you have problems installing Rational products run the rreport script located in the install directory. It will help you gather the information needed by Rational support.This script allows you to e-mail or FTP the information directly to Rational.

6 . If you are installing Apex or Summit and you do not have the licenses listed in Managing Apex Licenses, you will need to run the next three scripts.

a . Enter: 

    % ./get_license_info

    This script will help you gather the information you need for configuring your licenses.

    After running this script, contact Rational and provide us with the information saved in the LICENSE_INFORMATION file. The phone numbers for Rational are also in this file.

b . After contacting Rational and receiving your license key(s), use your favorite text editor to add them to your license file. This file should have been specified by you when you ran get_license_info.

c . After updating your license file, enter:

7 . Enter: 

    % ./post_install

    This script will prompt you for configuring parts of Apex or Summit that you have installed. You may need to refer to other chapters in this guide or the release note if you are not sure how to respond.

    The first task of post_install is to set the license file location or use existing licensing through the FLEXlm port@host mechanism. If an existing license server is to be used, you must now enter the license file full pathname or the port@host. If the license manager is not running, or if it is not installed correctly, post_install will display an error message. If necessary, check that your license file is correct and restart the license server. If post_install still does not work, contact Rational Technical Support.

    If the license file is accessible from the machine you are running post_install on, use the full pathname of the file so that it can check that all licenses are valid before attempting to fix-up the new Apex installation.

    The post_install script will perform step 10. It prompts you, asking if you want it to do this.

    If you are running any Apex or Summit layered products such as TestMate, answer yes when asked to update the Apex or Summit startup file.

8 . If you did not create a symbolic link during post install, create a symbolic link to the current release: 

    % cd rational_dir
% ln -s releases/apex.ver apex

    This allows Apex and Summit users to reference rational_dir/apex, thereby minimizing the impact of new installations on their personal startup files.

    If the symbolic link rational_dir/apex already exists and is pointing to a previous release of Apex or Summit, switch it to point to the new release when you are ready to make the new release the default release for your user community: 

    % cd rational_dir
% rm apex
% ln -s releases/apex.ver apex

    Then users will get the new release next time they start Apex or Summit.

9 . For CD-ROM installs, unmount the CD-ROM drive.

10 . If you are upgrading from a previous release, after installation is complete, upgrade your subsystems and views using the apex_upgrade command or the GUI equivalent Control > Maintenance > Upgrade to New Release.

IBM Rational Software Corporation 
http://www.ibm.com/software/rational
Copyright IBM Corpoiration 2004. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX