This chapter details how to install Rational Rose for UNIX/Linux from the distribution media.
The following topics are covered in this section:
This document provides you with the following information:
On-line documentation is available in either PDF or HTML formats. Adobe Acrobat® Reader is required to view PDF files; a Web browser is required for HTML documents. The installation tool will install Adobe Acrobat Reader and Netscape Navigator.
A copy of the Adobe Acrobat Reader is available on the Rational Rose for UNIX/Linux CD in the extras/acrobat directory. A copy of Netscape Navigator is available in the extras/netscape directory on the Rational Rose for UNIX/Linux CD.
To install Rose for UNIX/Linux you will need a UNIX workstation running either Solaris 2.5.1, 2.6, 7, or 8, HP-UX 10.20, 11.00, or 11.11, SGI IRIX 6.5.5, AIX 4.3.2, Tru64 Unix 4.0f, or Linux x86 Red Hat 6.2 or 7.0.
Before starting the installation, you need:
There are no known problems associated with upgrading from a previous release to this release of Rose for UNIX/Linux.
Before running this version of Rose 2001, there are several actions that must be taken. These are described in Initial Runtime Instructions When Upgrading .
The following list gives a brief outline of what takes place during a "typical" installation.
The following sections provide a summary of the steps you take when installing Rational software products and the FLEXlm license server software.
For rational_dir, supply a pathname such as: /vendor/rational. The rational_dir directory needs to be visible on all computers from which you wish to run this product, and must be writable by the installer's user name. Also, the NFS name for rational_dir must be the same on all computers.
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 follow.
Solaris 2.x with volume management mounts to the /cdrom directory. This happens automatically when you load the CD-ROM drive. You have volume management if the vold daemon is running on your system.
# mkdir /cdrom
# mount -r -F hsfs /dev/dsk/c0t6d0s0 /cdrom
# mkdir /cdrom
# mount -r -F cdfs /dev/dsk/c0t2d0 /cdrom
# mkdir /cdrom
# mount -r -v cdrfs /dev/cd0 /cdrom
IRIX 6.x with volume management mounts /CDROM automatically after loading the CD into the CD-ROM drive. You have volume management if the mediad daemon is running on your system.
# mkdir /cdrom
# mount -r -t iso9660 /dev/scsi/sc0d610 /cdrom
# mkdir /cdrom
# mount -r -t cdfs -o rrip /dev/rz4c /cdrom
# mount /mnt/cdrom
# mkdir /mnt/cdrom
# mount -t iso9660 /dev/cdrom /mnt/cdrom
Exit root and go to the /cdrom directory and run the rs_install command. For Solaris with volume management, go to /cdrom/cdrom0.
# exit
% cd /cdrom # (or /cdrom/cdrom0)
% ./rs_install
Rational recommends that you follow the menus and prompts and let rs_install guide you through the install.
This section provides instructions about how to install Rational Rose for UNIX/Linux. 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 install.
Default values, where provided, are enclosed in square brackets. To accept the default value, simply press the enter key.
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.
The rs_install command can also be run under the following aliases if you only want to run a specific portion of the install:
license_check allows you to run the FLEXlm lmstat command for counted licenses and the exinstal command for any license file (not port@host). The lmstat command queries the license server for a list of licenses that are in the license pool. The exinstal command checks the license file format and license codes to see if everything is consistent.
Problems may occur when trying to perform a remote installation of Rational Rose for UNIX/Linux in a secure environment (for example, remote access to other machines is through rsh) if the environment does not have access to rsh or remsh. To install Rational Rose for UNIX/Linux in this situation, perform a local installation of the software rather than a remote installation. If you experience further problems, contact Rational customer support.
You may 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 of 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.
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. Once you get to the Enter Install Mode screen you can choose one of three options:
Rose 98i, Rose 2000e, and Rose 2001 for UNIX licenses are valid for this release. To utilize existing licenses select the first rs_install option under the menu:
To install Startup or Evaluation licenses, select the third rs_install option under the menu:
Rational has recently introduced AccountLink, a new Web-based License management tool that provides additional flexibility and control of your Rational Software license keys. All license transactions should be done through AccountLink.
Prior to accessing AccountLink to request permanent license(s) you will need the following information:
Access AccountLink at http://www.rational.com/accountlink and follow the instructions provided by license_setup or rs_install to complete permanent license setup.
If you do not have access to the internet you may also request licenses by completing the appropriate HTML fax license request located in the CD-ROM license_request_forms directory:
The Rational Licensing Support Fax Number information is provided at the bottom of each form.
For CD-ROM installs, unmount the CD-ROM drive with the following commands.
For Solaris with volume management (vold is running):
% eject cd
% su
# eject cdrom
All others must unmount the CD as root:
% su
# umount /cdrom
Once you have installed the latest version of Rose for UNIX/Linux, and after all users have switched to using it, you can remove the old release to reclaim disk space.
Rational includes an uninstall script in its config directory. You can uninstall the previous release of a product 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.
You also need to kill -TERM a font server ("xfs") running from the release you plan to uninstall. Use ps to determine the process ID of the font server and then run kill -TERM process ID prior to uninstalling the release.
With the valid path to the Rose 2001 license daemon established and verification that the release font server is not running, 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 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(s) 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.