TYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> Untitled

Rose/UNIX 4.0.16b Install Guide

[Next]   [Prev]  [TOC]  [Info]  



Installation Guide Table of Contents

Preface

Before You Start
How to Use This Guide
Conventions
Overview
Installation Checklist
Hardware Configurations
Directory Structure
Prerequisites
Configuration Checklist
Automated Requirements Checking
Hardware Requirements
Loading Rose
Background
Installation Steps
Reading media
Installing More Than One Architecture
Configuring Rose
Background
Installation Steps
Setting Up Your Printer
Setting Up User Files
Using Rose
Appendix A Managing Rose Licenses
How Licenses Work
The License Manager
License Manager Commands
The License File
Format
Feature Name
Options
Obtaining Licenses
Appendix B Contacting Technical Support
Obtaining Information Via the World Wide Web
When Contacting Rational Technical Support
How to Contact Rational Customer Support
Telephone and Fax
Electronic Mail
Anonymous FTP
Mail
Appendix C Operating System Patch(es) Requirements Specification
HP-UX Requirements
Runtime Requirements
If a C++ Release / Runtime Not Installed
HP-UX OS Patches Not Necessary for any 10.20ACE Release
Problem Displaying hp700mt Applications on a Different Platform
AIX Requirements
Runtime Requirements
How To Install "libsvld.a"
SGI Requirements
Runtime Requirements
SGI Patches
To Extract/Install the Patches
SUN Solaris Requirements
Runtime Requirements
To Extract and Install the Patch


Installation Guide Version 4.0.16b



Rose/C++ for UNIX Installation Guide 4.0.16b

Copyright © 1993-1998 Rational Software Corporation.
All rights reserved.

This document is subject to change without notice.

GOVERNMENT RIGHTS LEGEND: Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in the applicable Rational Software Corporation license agreement and as provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14, as applicable.

"Rational", the Rational logo, and Rational's products are trademarks or registered trademarks of Rational Software Corporation in the United States and in other countries. All other names are used for identification purposes only and are trademarks or registered trademarks of their respective companies. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. Microsoft, Windows, Windows NT, and MS-DOS are trademarks or registered trademarks of Microsoft Corporation.


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



 

Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  

Preface

This guide explains how to install Rational Rose/C++®, hereafter Rose, on UNIX platforms.

Before You Start

Before starting the installation, you need:

How to Use This Guide

Proceed straight through all the chapters in this guide, following instructions in the order given.

Conventions

This section summarizes conventions that are followed by this guide and by the scripts you run to install Rose.

Installation Guide

This guide uses the following text conventions:

Example Meaning
rational_dir Indicates a variable element for which you must supply a value. For example, you might enter /someplace/rational instead of rational_dir.
./install Specifies literal text that you enter exactly as shown.
csh Identifies UNIX utilities, pathnames, or filenames.
File:New Specifies the menu and the menu button for an operation. It means: From the File menu, choose the New menu item.
Return Represents a key that must be pressed to initiate or complete an action.
Control-C Represents keys that must be pressed along with one or more modifier keys. For example, while holding down Control, press C.
% Represents your shell prompt when you are a regular user. (Do not type the % as part of the command.)
# Represents your shell prompt when you are the super user (root). (Do not type the # as part of the command.)

Also, the variable element I.J.K is used to represent the current release number, where I is the major release number, J is the minor update number, and K is the micro release number. Please substitute the current release number - for example, 1.0 or 2.5.1 - wherever you see I.J.K.

Installation Scripts

Rose installation scripts can be run on any type of character terminal or in an xterm window on a workstation that is running the X Window System. The scripts assume only that the terminal can print characters and new lines. All output is sent to the shell's standard output or standard error.

The script first prints the Rose version and a copyright notice. Then the script prompts you for any information that it needs. You are allowed to step through the prompts as many times as you wish. Once you are sure that you have provided the proper responses to each prompt, the script proceeds with its installation steps.

Many prompts give you a limited number of choices - for example: yes or no . In such cases, the scripts provide the following interface:

If you enter: The installation script will:
Anything starting with y or Y Assume that you mean yes
Anything starting with n or N Assume that you mean no
Just Return Use the default value displayed in brackets in the prompt message
An Interrupt (usually Control-C ) Exit without doing remaining installation steps
Anything else Ask you to please type Yes or No and repeat the prompt



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  

Overview

This chapter presents an overview of the Rose installation to provide context for the installation procedures that follow.


Installation Checklist

The major steps in the Rose installation are listed below. The time required for each major step will vary with factors such as your experience level, your workstation load, and your network performance.
  1. Read the release note in case it contains updates to the instructions in this guide. 
  2. Read the preface and this chapter in this guide to better understand the procedures that follow. 
  3. Make sure that your workstations satisfy the requirements described in "Prerequisites" in Chapter 2 . You might need your system administrator's help with some of the requirements. 
  4. Load the release media as described in "Loading Rose" in Chapter 3
  5. Complete the installation as described in "Configuring Rose" in Chapter 4 .

Hardware Configurations

You can install Rose on a: You can have different workstations performing each of these roles: More commonly, a file server doubles as the license server, and workstations double as their own compute servers. In the simplest configuration, a stand-alone workstation performs all roles.

If you are installing Rose on a client-server network, observe that you must enter specific commands on specific workstations. For example, daemons that run on the Rose license server must be started on that license server, not on some other workstation.


Directory Structure

The Rose release is structured as follows:
rational_dir/       -Rational Software product area
 base/cots/         -License server, etc.
 config/            -data for installed products
 releases/          -installed products
  rose.4.0.x/       -release 4.0.x of Rose
   install/         -Rose installation scripts

If previous Rose releases or other Rational products have already been installed, directories such as rational_dir , rational_dir /base/cots , and rational_dir /releases will already exist. Since you will not be creating them yourself while installing this Rose releases, make sure that you have write permission to them before starting the installation.

Recommendation: If you have Rose models that were created with a previous Rose release, do not delete your previous release until your models have been successfully converted to Rose 4.0.

The installation scripts log progress to the install/install.log file. In case you encounter a problem with the installation, this file may help you (or Rational Technical Support) diagnose it.

Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



 

Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  

Prerequisites

Ensure that you have the required hardware and software before proceeding with the Rose installation.

Recommendation: Before installing Rose, you might find it helpful to get a copy of the system management guide from your platform vendor.

Note that there may be additional Operating System patch requirements. These are described in Appendix C, " Operating System Patch(es) Requirements Specification ". Refer to this specification before proceeding.


Configuration Checklist

The following tables list the recommended configuration to successfully install and use Rose.

You do not need to log in as root to verify that most of these requirements are satisfied. If all are satisfied, you can proceed with the installation. If any are not satisfied, however, you probably will need help from your system administrator. Changing most of these items requires knowledge of your network and workstation configurations as well as root permissions.

Recommendation: Check all the items listed, noting any requirements that are not satisfied. Give the list of needed changes to your system administrator, wait for the changes to be made, and then proceed with the installation.

The first table contains the hardware requirements for installation and use of this product. Note that the recommended amount of memory is only the suggested minimum amount. Additional memory may improve performance. Your memory requirements will also be larger if you are constructing larger models.

.
Hardware Item Recommendation For
Memory 32 + (16 * N) MB of RAM (where N is the number of users running Rose simultaneously on a given workstation) Use
Server A midrange UNIX server or client UNIX workstation Use
Client Any UNIX workstation or PC capable of displaying X windows Use
Disk space 200 MB for loading release+ 1-3 MB for each Rose model Installation, Use
CD ROM reader Installing from CD ROM Installation
Display Color display Use

The next table contains the software requirements for installation and use of this product. Note that this is also only a suggested amount of swap space. Your requirements may be larger if you expect to construct very large models. If all of your models are small, you may need less than the amount shown here.

Solaris 2.5HP-UX 10.20Digital UNIX 4.0SGI Irix 6.2(where N is the number of users running Rose simultaneously on a given workstation)Sun OpenWindows on Solariswindow manager (mwm),Sun olwm or CDE 1.1
Software Item Requirement For
Operating system AIX 4.1 Use
TCP/IP Must be running Installation, Use
Host names Must be configured Installation, Use
Swap space 100 + (32 * N) MB Use
X Window System MIT X11R5 or X11R6 Use
Window Manager OSF/Motif© 1.2, Use


Automated Requirements Checking

A script named check_rose_reqs is included in the rose.I.J.K/bin directory that is loaded from the Rose release disks. This script can assist you in the verification of required configurations and the minimum recommended resource settings.

While you are installing Rose, the installation scripts automatically use check_reqs -install to verify TCP/IP, the portmap daemon, and host names. These are requirements for the workstation(s) on which you install Rose.

Before using Rose, you (or each Rose user) can use check_rose_reqs to verify TCP/IP, the portmap daemon, host names, memory swap space, pseudo terminals, resource limits, the X Window System, and the Motif window manager. The check_reqs script cannot check the available physical memory on some platforms.


Hardware Requirements

Your hardware can be configured in various ways. For example:

This chapter describes the requirements for a single-user desktop workstation that you will use either stand-alone or with a file server that provides no support other than file service. The desktop workstation will run all Rose processes.

The alternative is to run all Rose processes on a remote compute server, redirecting the display to your local workstation or X-terminal. If the compute server is shared by several Rose users, it will need to be more powerful than a desktop workstation that supports only one Rose user.


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Loading Rose

This chapter provides instructions for loading the Rose release from the Rose release media.


Background

The Rose Release media is delivered on CD-ROM and contains installation scripts and the Rose components. You use the rinstall script to read the installation scripts, and then use one of the scripts to load the Rose components.


Installation Steps

  1. Log into any workstation that:
  2. Do not log in as root. Use a regular login.

  3. If Rational Apex or other Rational products have already been installed, the Rational root directory-referred to as rational_dir throughout this guide-may exist. If so, use it for Rose, too. If it does not already exist, create it:
  4. % mkdir rational_dir

    For rational_dir , supply a pathname such as:

    /someplace/rational

    Note that on a client-server network, rational_dir must be visible (by NFS mounting) to all Rose workstations.

    Then:

    % cd rational_dir

Reading media

Rose/C++ for UNIX is provided on CD-ROM. Follow the following instructions to install from this media.

  1. Place the CD into the CD-ROM reader.
  2. Mount the CD-ROM drive as root. To do this, you will need to make a directory (if one does not already exist), to be the mount point for the CD-ROM drive. Make sure you know the target ID of the CD-ROM drive. If you don't know the device name for the CD-ROM drive, consult your system administrator. Mounting commands for different operating systems are as follows. These examples use the directory /cdrom as the mount point.
  3. Exit the root login.
  4. % exit

  5. After you exit the root login, go to the CD-ROM directory and run the rinstall script. This script will prompt you with a menu to set the rational_dir directory. If the CD contains more than one product, you will be asked to select a specific product to install.
  6. From the rinstall menu, enter the rd key to set the rational_dir directory where you are going to be installing each product. Enter the go key to begin the install.

  7. After rinstall completes, load the Rose components from the CD-ROM:
  8. % cd releases/rose.I.J.K/install % ./install

    The install script 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.

    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.

    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 target operating systems.

  9. When you are done with the installation, unmount the
    CD-ROM drive:

Store the CD-ROM in a safe place in case you ever need to reinstall Rose.


Installing More Than One Architecture

The Rose installation is structured in such a way that executables for several architectures may be present on the same media. You may install executables for more than one platform into the same installation area without conflict, even if those executables come from different sets of media.

The media contains the following kinds of components:

A Platform Independent Component. This component must always be installed. However, if you are installing from more than one media set, it must only be installed once.

A Shared Binary Component for each platform. This component must be installed for each platform on which you will execute any variant of Rose.

A Rose/C++ and Analyzer Component for each platform. This component must be installed for each platform on which you will execute Rose/C++.

A FLEXlm Component for each platform. This component must be installed for each platform on which you will run a Rose license manager. Note that a license manager running on any platform can serve Rose running on any other platform.

Note: Converter components, which must be installed for each platform on which you need to convert models from other OO tools to Rose models, are no longer included on the media. The conversion tools are now available on Rational's World Wide Web page; its URL is http://www.rational.com .


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  

Configuring Rose

This chapter tells you how to configure Rose after loading it from disks. You must complete these steps before using Rose.


Background

To complete the installation, you must run four scripts:

Rose uses the FLEXlm license manager to manage access to the product. FLEXlm manages Rose floating and node-locked licenses. FLEXlm version 5.0b is the version of FLEXlm used, beginning with Rose 4.0.15i. If upgrading from a version of Rose prior to Rose 4.0.15i, you must install FLEXlm 5.0b.

If you want to integrate Rose 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.

You can check for conflicts by searching the /etc/services file or by entering this command if you are running the Network Information Service (NIS).

% ypcat services | grep 1706

Note: 1706 is the default port number for other Rational products. If you are installing Rose, and if you want to use the same license server, specify the same port number.


Installation Steps

  1. Log into any workstation that mounts the file system(s) into which you loaded the Rose release. Do not log in as root . Use a regular login.
  2. Go to Rose's install subdirectory:
  3. % cd rational_dir/releases/rose.I.J.K/install

  4. Enter:
  5. % ./get_license_info

    This script will help you gather the information you need for configuring your Rose license. This information is stored as a part of the
    rational_dir /releases /rose. I.J.K /install/install.log file.

  6. Contact Rational to request an encryption code (also known as a license key) and its expiration date, using one of the following methods:
  7. Enter:
  8. % ./add_license_info

    This script will help you add your licensing information to your license file - for example: license.dat.

  9. Having updated your license file, enter:
  10. % su              # become root
    
    
    
    # ./start_lm
    
    
    
    # exit             # leave root

    This script will help you:

  11. Enter:
  12. % ./post_install

  13. This script customizes the Rose configuration files. The post_install script also instructs you to verify the installation before proceeding.
    1. Note: You need to run post_install for each architecture on which you are installing Rose. For example, if you are installing Rose for use on workstations, some of which are running Solaris and some of which are running HP-UX, you should have already loaded the platform-specific components for both Solaris and HP-UX from your release media. You need to run post_install twice-once while logged into a Solaris system, and once while logged into an HP-UX system.


Setting Up Your Printer

  1. Go to Rose's xprinter subdirectory:
  2. % cd rational_dir/releases/rose.I.J.K/xprinter

    The xprinter directory contains several subdirectories whose names end in PPDS. Each file in a PPDS directory contains the description for a single print device. Most printer descriptions begin with manufacturer and model for the printer the file describes. For example, the printer description xprinter/PCLPPDS/HP3SI.PPD begins:

    *Product:     "(HP LaserJet     IIISi) "
    
    
    
    *ModelName:     "HP LaserJet     IIISi PCL Cartridge"
    
    
    
    *NickName:     "HP LaserJet     IIISi PCL Cartridge"

  3. Search through the PPDS directories until you find the description file for your printer.
  4. Go to the Rose directory:
  5. % cd ..

  6. Give yourself write permission to the WindU file:
  7. % chmod 644 WindU

  8. Open the WindU file for editing.
  9. Make sure that your printer is listed in the [Devices] section of the file. Device listing take the form:
  10. SymbolicName=PPDSPrefix  Type,  VariableName:

    Where:

    For example, the device listing for the HP LaserJet printer described in Step 1 is:

    [Devices]
    
    
    
    HP LaserJet  SI=HP3SI  PCL5,mylaser:

    Note that the device specification determines device-dependent characteristics of output generated by the Rose Print commands. It does not determine the actual printer or file to which the output is written.

    In the [Ports] section of the WindU file, assign the UNIX print command you want used for printing to the VariableName that you defined in the [Devices] section. The command should include any options needed for your printer to recognize a PostScript file. Continuing the example above, the following assignment causes output sent to the printer named HP LaserJet SI to be printed using the UNIX lp command:

    mylaser:=cat | lp

    By default, the lp command sends output to the printer specified in your $LPDEST or $PRINTER environment variable. If you have not set either of these variables, you may want to supply a printer name as an option to the lp command in the port assignment:

    mylaser:=cat | lp -d laser1

  11. Save and close the WindU file.
  12. Remove write permission from the WindU file:
  13. % chmod 444 WindU

    When a user first starts Rose, Rose copies the $ROSE/WindU file into a file called .WindU in the user's home directory. The user then has access to the printers and print command you have to set up. If you make changes to the $ROSE/WindU file after users have begun using Rose, you should merge the new $ROSE/WindU file with each Rose user's .WindU file.


Setting Up User Files

  1. For each user, edit the ~ username /.login or the ~ username /.profile file to source the applicable config file for the UNIX shell in which the user works:
  2. Verify that the config.csh and config.sh files have read permission for the Rose users.
  3. Verify that the Rose directories have execute permission for Rose users.


Using Rose

You have completed the Rose installation. Use the following commands to start Rational Rose products:

Product
Command
Rose/C++

rose_cpp

Analyzer
analyzer

These commands are shell scripts contained in the rational_dir /releases/rose. I.J.K /bin directory. The same scripts can be used to run Rose on any architecture; the scripts automatically determine the architecture and run the appropriate executable for the architecture.


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  

Managing Rose Licenses

When you buy Rose, you purchase some number of node-locked and/or floating licenses. A node-locked license allows you to use Rose on a specific workstation. Floating licenses allow anyone on your network to use Rose as long as a floating license is available. Thus, the number of licenses that you purchase determines the maximum number of users who can use Rose simultaneously.

For example, if you purchased five licenses and three users are currently using Rose, then two more users can use Rose.


How Licenses Work

Licenses are controlled by a license manager (software delivered as part of Rose) that runs on a license server (one of your workstations). The license manager monitors license access, simultaneous usage, idle time, and so on.

When you start Rose, you are initially unlicensed. If a license is available, the license manager gives you a license and you retain it as long as you keep using Rose. When you exit Rose, your license is returned to the license manager and becomes available for another user.

If no license is available, you are unable to use Rose until the license is returned by another user.


The License Manager

Rose uses the Flexible License Manager, FLEXlm, from Globetrotter Software, Inc. The license manager includes the following components:

Once the daemons and license file are in place, all that remains is to start the license daemon, which in turn will start the vendor daemons.

For convenience, you will probably want to augment a system initialization script on your license server to automatically start the license daemon each time the license server boots.

The names, locations, organization, and contents of system initialization scripts varies from system to system. You might begin by looking at the following files:

Rose provides installation scripts to guide you through this setup. They are described in "Configuring Rose" .

Note: You cannot run two rational daemons on the same host, so even though FLEXlm allows you to run multiple lmgrd daemons, you cannot put Rational products under the control of multiple lmgrd daemons on the same host.


License Manager Commands

To verify that your license manager is operational, you can enter these commands on your license server to see if its daemons are running:

% ps axww | grep -v grep | egrep "lmgrd|rational"

or

% ps -e | grep -v grep | egrep "lmgrd|rational"

Their output should include lines similar to the following (your pathnames will vary):

1719  -  S  0:00  /someplace/rational/rose/ROSEARCH/license/lmgrd



 -c  /someplace/rational/rose/license.dat

10424  -  S  0:13  rational  -T  garcon 4



 -c  /someplace/rational/config/license.dat

The license manager supports several system-administration commands.

Command
Description
lmdown
Shuts down license and vendor daemons
lmhostid
Reports license manager host ID of workstation
lmremove
Returns specific licenses to license pool (for example, after a workstation crashes)
lmreread
Rereads license file, starts new vendor daemons
lmstat
Reports status on daemons and feature usage


The License File

The default Rose license file is rational_dir / config/license.dat. As you install Rose, you can merge the Rose license data into another license file that you have already set up for another product.

When users start Rose, the start up script automatically defines the environment variable LM_LICENSE_FILE for them. FLEXlm uses this variable to locate the license file.

Format

The license file is a text file that you can edit with any text editor. Your license file will contain lines similar to:

SERVER garcon 1874350  1706

DAEMON rational /someplace/rational/rose/ROSEARCH/license

FEATURE rose.cpp.sun4 rational 4.00 1-oct-98 6 FBE669014E142A4CF37 " "

In general, one or more server lines are followed by one or more vendor daemon lines, which are followed by one or more feature lines. Rose requires only one of each, but your license file may include data for other products, too.

Each server line contains, in order, the:

Each vendor daemon line contains, in order, the:

Each feature line contains, in order, the:

The tokens on each line can be separated by any amount of white space (spaces or tabs). You can edit only four kinds of tokens in the license file:

All other tokens are included as input to the encryption algorithm that produces the encryption codes on the FEATURE lines.

Note: A DEMO FEATURE Line (includes "DEMO" at the end of the FEATURE Line) is a special temporary license which does not require running lmgrd or start_lm . Licensing is activated when the DEMO FEATURE Line is placed in the license file.


Feature Name

The feature names for Rose have changed from those used in previous releases. Feature names are now of the form rose. product . host. The product is cpp for Rose/C++. The host is sun4 for Solaris, hppa for HP-UX, alpha for Digital UNIX, mips for SGI Irix, and rs6k for IBM AIX.

Note that a single floating license cannot be used to run Rose on more than one architecture. In past Rose releases, while this was not enforced, it was in violation of Rational's license agreement.

If you desire to have one or more floating licenses that may be used across machine architectures, you may obtain such a license (with the host set to " any ") for an additional charge.


Options

You can customize Rose access by:

  1. Creating an options file for the rational daemon.
  2. Adding the pathname of the options file as the fourth field on the DAEMON line for the rational daemon.

An options file allows you to:

For Rose, lines in the options file have this format:

GROUP  name  list_of_users

RESERVE number rose.cpp.host



     {USER | HOST | DISPLAY | GROUP} name

INCLUDE rose.cpp.host {USER | HOST | DISPLAY | GROUP} name

EXCLUDE rose.cpp.host {USER | HOST | DISPLAY | GROUP} name

TIMEOUT  rose  seconds


Obtaining Licenses

Contact Rational Software Corporation to obtain the encryption code for your Rose installation.

Please be prepared to supply the host name and ID number of your Rose license server, the number of licensed users, and the licensing version of your Rose release. The get_license_info installation script will help you gather them. It creates a file called LICENSE_INFORMATION that can be e-mailed to support@rational.com .

Rational Software Corporation will provide your encryption code and its expiration date. The code will be a 20-digit hexadecimal string - for example: 4B868981DB6D7295573E. The date will be in a dd-mmm-yy format - for example: 30-oct-94. The day must be expressed as two digits - for example: 01-oct-98, not 1-oct-98. If your encryption code never expires, the year ( yy ) in your expiration date will be 00.


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  




Contacting Technical Support

This chapter describes procedures for interacting with Rational Software Corporation's Technical Support services.


Obtaining Information Via the World Wide Web

Online support can be found on the World Wide Web at the following locations:

http://www.rational.com/support/index.jsp

This location includes a section for Rose UNIX which provides step by step instructions in relation to using Rose and solving common problems.

http://solutions.rational.com/solutions/

This location includes a search engine to help locate information on commonly asked questions. There is also a section regarding specific Rose UNIX issues.


When Contacting Rational Technical Support

When Contacting Rational Technical Support, please be prepared to supply the following information:

If your site has a designated, on-site support person, please try to contact that person before contacting Rational Technical Support.


How to Contact Rational Customer Support

Rational Customer Support can provide information and assistance via:

Please look at Rational's web site at www.rational.com for current customer support listings.


Telephone and Fax

Telephone support is available Monday through Friday from 6:00 a.m. to 6:00 p.m. Pacific time. International telephone support hours span the normal local business hours.

Sometimes Rational technical support engineers will ask you to fax information to help them diagnose problems. You can also report a technical problem by fax if you prefer. Please mark faxes "Attention: Technical Support" and add your fax number to the information requested above.

The telephone and fax numbers for Rational Technical Support are:

Country  Telephone Number  Fax Number 
United States  408-863-5000 or 800-433-5444  408-863-4300 
Australia, Rational Software Corporation Pty Ltd  +61-2-9419-8455  +61-2-9419-8466 
France, Rational SARL  +33-1-30-12-09-50  +33-1-30-12-09-66 
Germany, Rational GmbH  +49-89-613 769-0  +49-89-613-769-69 
Israel, DSI  +972-3-531-3333  +972-3-531-3322 
Japan, OGIS-RI  +81-3-3779-2541  +81-3-3779-2543 
Sweden, Rational Software AB  +46 8 703-4580  +46 8 751-3096 
Taiwan, Rational International  +886-2-720-1938  +886-2-723-3899 
United Kingdom, Rational Software Corporation Limited  +44-(0)7071-223109  +44-1273-624364 

 


Electronic Mail

You can obtain technical assistance by sending electronic mail to support@rational.com . Electronic mail is acknowledged immediately and is usually answered within one working day of its arrival at Rational. Please include the information requested above with a description of your problem when reporting a problem. When sending e-mail concerning a previously-reported problem, please include in the subject field: "re: Log XXXXX", substituting your assigned support log id for XXXXX.


Anonymous FTP

You can exchange information with Rational through the Internet, using Rational's anonymous FTP site. The service is available 24 hours a day, 7 days a week. To access the site:


Mail

You can also correspond with Rational at the following mailing addresses. Please mark correspondence to expedite its routing once it reaches Rational - for example: "Attention: John Smith" or "Attention: Technical Support."

Rational Software Corporation
18880 Homestead Road
Cupertino, CA 95014
U.S.A.

Rational Software AB
Celera AB, Box 26
S-175 21 Järfälla
SWEDEN

Rational Software Corporation Pty Ltd
Zenith Center
Level 13, 821 Pacific Highway
Chatswood NSW 2067
AUSTRALIA

RATIONAL SOFTWARE DO BRASIL LTDA.
Rua Guarara, 529, conj 72
Jardim Paulista - Sao Paulo - SP 01452-001
BRAZIL

Rational SARL
Immeuble de la Gare
1, Place Charles de Gaulle
78180 - Montigny le Bretonneux
FRANCE - C - 78180

Nihon Rational Software K.K.
SAISEI Ikedayama Bldg 2F
5-10-25 Higashi Gotanda
Shinagawa-ku, Tokyo 141
JAPAN

Rational Software Korea Ltd.
10fl, WonBang Bldg
143-42, Samsung-dong, Kangnam-ku
Seoul, 135-090
KOREA

Rational International
7F-4, 2 Lane 150, Hsin-Yi Road, Sec. 5
Taipei, Taiwan, R.O.C.

Rational Software Corp. (India) Pvt. Ltd.
No. 40, 100 Feet Road, 4th Block
Koramangala, Bangalore 560 034
INDIA

Rational GmbH
Rosenstraße 7
Großhesselohe
Pullach im Isartal D-82049
GERMANY

Rational Technology Limited
First Floor, Olivier House
10 Marine Parade
Brighton
East Sussex BN2 1TL
U.K.


Installation Guide Version 4.0.16b

[Next]   [Prev]   [TOC]   [Info]  



Installation Guide Version 4.0.16b

[Next]  [Prev]   [TOC]   [Info]  



Operating System Patch(es) Requirements Specification

The following describes the Rose/C++ for UNIX operating system runtime and/or patch requirements.

The requirements listed below, are in relation to the following platforms (operating system versions):

Note: This release has been tested with the following patch versions. While we encourage you to contact the appropriate vendor to determine if a patch has been superseded we cannot guarantee release compatibility with a patch version we have not yet tested.

Please contact support@rational.com if you encounter any compatibility difficulties after installing a patch which may have superseded any of the patches listed below.


HP-UX Requirements

Runtime Requirements

Rational Rose/C++ for UNIX requires that the appropriate HP aC++ runtime be installed on your HP-UX 10.20 machine:

To verify the versions installed on your system, run 'what' on each file (ie):

what /usr/lib/aCC/dld.sl

If a C++ Release / Runtime Or Dynamic Loader (Version B.10.27 Or Greater) Not Installed

If the appropriate aC++ runtime is not installed, you will need to install the following necessary HP-UX OS patches.

If /usr/lib/dld.sl (version B.10.27 or greater) is not installed, we recommend installing the following HP-UX OS patch to enhance operation of the dynamic loader (dld.sl) and to avoid erroneous "out of memory" error messages:

These patches are included in your release under the .../install/patches/hppa_hpux directory.

( The 4.0.16b Release included PHSS_13625 which has been recalled by HP. PHSS_10765 is recommended until a new patch PHSS_14716 is available - check with HP to see if this patch is available. )

HP-UX OS Patches Not Necessary for any 10.20ACE Release

The aC++ runtime environment is now part of the standard HP-UX OS distribution, beginning with 10.20ACE, eliminating the need for the HP-UX OS patches described above.

Problem Displaying hp700mt Applications on a Different Platform

When you display an application running on the hp700mt platform to a different platform, the application does not exit properly if you are using a csh or tsh shell. When you exit the application, the xterm continues to receive carriage returns and you must kill your xterm session. If you are displaying on an HP workstation, the application exits properly. HP patch PHCO_13632 is a csh patch that fixes the problem for csh, but a patch for tsh is not available yet. This error typically only occurs with rlogin, so using telnet instead may be a temporary workaround. If this error affects your application, contact Rational Technical Support for the current status.

Note: **Prior to Installing HP-UX OS Patches**
The OS patches included in this release may have been superseded with newer patches. In order to obtain information in relation to the latest HP-UX patch(es), contact either location below.

HP WWW Patch Site (Electronic Support System)

http://us-support.external.hp.com/


AIX Requirements

Runtime Requirements

Rational Rose/C++ for UNIX requires that the "libsvld.a" archive from the AIX Shared Library Hookable Symbols Runtime Environment (RTE) be installed on your system.

Attempting to run Rose/C++ for UNIX without this archive, will typically generate the following error message:

Could not load program 

../release/rose.4.0.16b/rs6k/bin/rose_cpp_exe

Could not load library libsvld.a[dl.so]

How To Install "libsvld.a"

  1. Copy ../install/patches/rs6k/ libsvld.a to /usr/lpp/slhs/lib/libsvld.a
  2. Create a symbolic link in /usr/lib to /usr/lpp/slhs/lib/libsvld.a


SGI Requirements

Runtime Requirements

Rational Rose/C++ for UNIX requires that the following SGI patches be installed on your system.

For your convenience, these patches are included in your release under ../install/patches/mips_irix5.

SGI Patches

To Extract/Install the Patches

For each patch:

  1. Create a directory /tmp/patch_dir and copy the patch to this directory.
  2. gunzip patch
  3. gtar -xvf patch
  4. cd /
  5. su to root and enter "inst -f /tmp/patch_dir" to read the patch README file and to install the patch (see below **Prior to Installing SGI OS Patches** ).

**Prior to Installing SGI OS Patches**

Carefully, read the README file associated with each patch to verify the patch is correct for your specific machine and processor.

In addition, the OS patches included in this release may have been superseded with newer patches. Obtain current patch information from the following SGI website.

SGI WWW Patch Site

http://support.sgi.com/surfzone/patches


SUN Solaris Requirements

Runtime Requirements

Rational Rose/C++ for UNIX requires that the Solaris Shared library patch for C++ ( Patch-ID# 101242-13, or greater)), be included on your system.

For your convenience this patch is included in your release under
../install/patches/sun4_solaris2 .

To verify if this patch has been installed, run the following command:

showrev -p | grep -i 101242-13

To Extract and Install the Patch



*Note: Special Instructions When Installing Patch-ID#: 101242-13 on Solaris 2.6:

This patch may be installed on Solaris 2.6. In order to install the patch, run "pkgadd" as described in the "README.101242-13" file. Do not remove (do not run pkgrm) the SUNWlibC package (if it is installed), as it includes additional files (/usr/lib/libdemangle.so.1 & /usr/lib/libdemangle.so) necessary for Solaris 2.6.


In addition, the OS patch included in this release may have been superseded with a newer patch. Obtain current patch information from the following SUN Web site.

SUN WWW Site

http://access1.sun.com/search.html



Installation Guide Version 4.0.16b

[Next]  [Prev]   [TOC]   [Info]