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.

Note: The license feature names for Apex changed as of the 2.2.2 release. Refer to Managing Apex Licenses.


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 . Apex and Summit are delivered on CD-ROM by default and on magnetic tape (by special request and additional cost). For tape installs, skip to step 6. For CD-ROM installs, do steps 4 and 5 and then skip to step 7.

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

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

6 . For tape installs, you must rewind the tape and load the install scripts using tar. The exact command for reading the tape depends on your tape drive's device name and whether your tape drive is local or remote.

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

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

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


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2002, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS