Rational Software Corp.

TOC PREV NEXT INDEX



Installation and Licensing

Please refer to the Rose for UNIX/Linux Installation Guide that is provided as your primary guide for installing and setting up licensing for this product.

If you encounter any problems while installing or licensing the Rose product, please check here first to see if it is a known problem. If a problem is not yet documented, please contact Rational Technical Support so we can investigate it, provide you with a workaround, and track the problem for future action.

This chapter contains the following sections:


General Install Information

As a precaution, always make back ups of any Rose model files that you will be accessing with this software.

This product includes FLEXlm, a licensing product from Globetrotter, Inc. A startup license key that allows you to start using your product immediately is shipped with this product. You must obtain a separate permanent license from Rational in order to continue using this product beyond this startup key expiration date. Please refer to the licensing section of the Installation Guide for detailed instructions on obtaining and installing permanent licenses. Also, see Licensing Information for any last minute licensing notes.

Note: Rose 98i, 2000e, 2001,2001a, and 2002 for UNIX licenses are valid for this release. You will not need to utilize the startup licenses or obtain new permanent licenses if you are already utilizing Rose 98i, 2000e, 2001, or 2001a for UNIX licenses.

Pre-Installation Information

You may want to back up your Registry prior to running the installation program. Specifically, we recommend you make backups of the following files:

Follow these steps to back up path maps:

1 Run regedit and navigate to HKEY_CURRENT_USER\Software\Rational Software\Rose\Virtual Path Map

2 Click Registry > Export Registry File...

Follow these steps to restore path maps:

1 Run regedit and navigate to HKEY_CURRENT_USER\Software\Rational Software\Rose\Virtual Path Map

2 Click Registry > Import Registry File... and import the file you exported.

System Requirements

Before installing this software, please verify that your system meets the minimum system requirements listed below. If the requirements are not met, the product may not install and/or operate correctly.

Note: All platforms may not be available at this time. Contact Rational technical support for platform availability information.

The following 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 large models.

Table 1 Hardware Requirements
Hardware Item

Recommendation

For

Memory
256 + (32 * N) MB of RAM (where N is the number of users running Rose simultaneously on a given workstation)
Use
Server
A midrange UNIX/Linux server or client UNIX/Linux workstation (Sun servers: Sparc Station 20 and above)
Use
Client
An AIX, Solaris, HP-UX, SGI IRIX, or Tru64 Unix workstation running the required operating system level as described in the following table under operating system software requirements. The UNIX/Linux workstation must be capable of displaying X Windows or a PC running eXceed version 6.1or higher to display X windows or for Rose on Linux x86, a PC running with Xfree and Xi Graphics X servers on Linux. It is recommended to use more than 256 colors in your graphics card/monitor configuration.
Use
Disk space
400 MB for loading release + 1-3 MB for each Rose model
Installation, Use
CD-ROM
Mounted as a UNIX/Linux file system
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.

Table 2 Software Requirements
Software Item

Requirement

For

Operating system1
AIX 4.3.2 Solaris 2.5.1, 2.6, 7, 8 (kernel revision January 2000 and later) HP-UX2 10.20 (ACE release3), 11.00, and 11.11 SGI IRIX 6.5.5 Tru64 Unix 4.0f Linux x86 Red Hat 6.2, 7.0 and 7.1
Use
C++ Compiler #include files
AIX CSet ++ 3.6.6 Solaris SC 5.0 HP-UX 10.20: HP aC++ B3910B A.01.21 HP aC++ B3910B A.01.19.02 Language Support Library HP-UX 11.00:
   HP aC++B3910B A.03.13
   HP aC++B3910B X.03.11.10 Language Support Library
IRIX C++ 7.3.1.1m Tru64 for Unix C++ 6.2 Linux x86 g++ 2.95.2
Analyzer
JDK, JFC, and J2EE
JDK 1.1.6 JFC 1.1 (swing classes for 1.1) JDK 1.2 (based on 1.2.1) J2SE 1.2 (based on 1.2.2) J2SE 1.3 J2EE 1.2 or any of the major Java IDEs

Java
Rose J supports the following Java IDE's. Use the JDK appropriate to your IDE.4 - Forte for Java Internet Edition 2.0 & 3.0(Solaris & Linux only) - Forte for Java Community Edition 2.0 & 3.0(Solaris & Linux only) - JBuilder 4.0, 5.0, and 6.0 Professional Edition (Solaris & Linux only) - JBuilder 4.0, 5.0, and 6.0 Foundation Edition (Solaris & Linux only)

Port map daemon
Must be running
Installation, Use
TCP/IP
Must be running
Installation, Use
Host names
Must be configured
Installation, Use
Page/Swap space
Generally three times the space in swap as RAM available
Use
X Window System
Native X11R5 or X11R6 (except HP 10.20)
X news on Sun with OpenWindows 3
PC X server eXceed version 6.1 or higher In addition, when running Rose for Linux x86, XFree and Xi Graphics X servers on Linux
Use
Window Manager
MWM (Motif Window Manager) version 1.2 vuewm on HP-UX 4dwm on SGI IRIX dtwm (CDE (Desk Top) version 1.0) olwm (Open Look Window Manager) on SUN is supported, but icons of Rose for UNIX/Linux may not integrate well with other icons on the screen In addition to those listed above, Rose for Linux x86 will run with the GNOME desktop environment with the Enlightenment window manager and the KDE desktop environment with the lcwm window manager. The following Window Managers are not supported: olvwm (olwm with virtual screens) Rose for UNIX/Linux will not remain on original virtual desktop, but rather will follow when other desktops selected. twm (shipped with X11) tvtwm (twm with virtual screens) fwm gwm fvwm
Use
1 All platforms may not be available at this time. Contact technical support for availability information.

2 HP9000 Series 700.

3 Rose requires that an ACE release be installed to run properly on HP-UX 10.20. To determine if an ACE release is installed, run /usr/sbin/swlist | grep ACE.

4 See the Rose_IDE_Link_README file in the release for Rose UNIX/Linux IDE Link Integration setup information, prior to using the IDE Link integration. The Rose_IDE_Link_README file will also list the supported / tested Java versions to utilize with IDE Links and J Pattern features.

Hardware/Software Patch Requirements

Please see "Operating System Runtime and/or Patch Requirements" in the Installation Guide for system patch requirements.

When installing and running Rose for UNIX/Linux for the first time, you will be alerted if hardware or software patches are necessary. If running on a Solaris or HP-UX server, Rose for UNIX/Linux will attempt to automatically determine if patches are necessary on your server and/or Solaris display, and will advise accordingly.

You may also run the following anytime to determine if your computer requires operating system patches to run Rose for UNIX/Linux.

Running and Displaying on SGI IRIX - Hang Can Occur

This issue typically occurs when running on an SGI IRIX multi-processor machine and displaying to any SGI machine. If you encounter a Rose Hang, under these circumstances, install the patched "libX11.so" library in your Rose release as described below.

If you encounter any problems, after installing this patch contact Rational Technical Support.

1 Make sure your Rose process is no longer running. (Use ps to determine if the process is running, and "kill -TERM [pid]" if it is necessary to kill the process.)

2 As the owner of these files, cd rational_dir/releases/rose.I.J.K/install/patches/mips_irix_n32

3 cp libX11.so rational_dir/releases/rose.I.J.K/mips_irix_n32/lib/.

4 Run rose_cleanup.

5 Run rose.

Configuring Window Manager So Pop-Up Windows Will Remain On Top of their Parent Windows

Configure your Window Manager such that pop-up windows will remain on top of their parent windows, in compliance with the Windows API. Under X11, Window Managers may implement different strategies for maintaining the Z-order of pop-up windows.

In order to keep pop-ups on top, if possible:

There is no specific configuration to keep pop-up (transient) windows on top. Pop-up windows are kept on top by default.

Running Multi-threaded GUI Applications on Multi-processor Solaris 2.6 Computers

If Rose for UNIX/Linux hangs when running on a multi-processor Solaris 2.6 computer, verify that the Solaris 2.6 server and display (if applicable) includes the Sun Solaris XSun Patch 105633-32 or higher. This patch includes a fix for Sun Defect 4233280, Sun SO#3918581 (multi-threaded applications crash/hang on 2.6 multiprocessor computers). To check for this patch, run

showrev -p | grep 105633

on both the server running Rose and the display (if display Solaris 2.6).

When installing or running the application for the first time, Rose will advise if this patch is installed or required.

Displaying on Ultrabook, Using PGX Graphics Card

A CDE crash may occur when displaying Rose for UNIX/Linux on a Ultrabook using a PGX Graphics Card, if SUN Solaris patch 105362-26 is installed.

If using a PGX Graphics Card, we recommend that SUN Solaris patch 105362-20 be installed as this is the latest version tested and determined to be compatible with this release.

If you encounter the CDE crash, uninstall patch 105362-26 and if possible install "105362-20". If SUN Solaris patch "105362-20" is not installed, the following may occur:

If you uninstall patch 105362-26 and encounter any of the issues described above, contact Rational Technical Support if patch 105362-20 is not available.

Running Rose for UNIX/Linux on HP-UX 11.00 with HP-UX OS Patch PHSS_21493

Rose for UNIX/Linux requires HP-UX OS Patch PHSS_17327 (X/Motif 2.1 Dev Kit Mar99 Periodic Patch). This Patch requires PHSS_17326 (X/Motif2.1 Runtime Mar99 Periodic Patch). PHSS_17326 has been superseded by HP-UX OS Patch PHSS_23823.

It is important to use PHSS_23823 as Rose for UNIX/Linux will not start (display) if an earlier version of this patch is installed (i.e. PHSS_21493).

If it is necessary to have a Motif Xlib runtime patch prior to PHSS_23823 and you encounter this issue, refer to the following instructions to workaround this problem:

1 Make sure your Rose process is no longer running. (Use ps to determine if the process is running, and "kill -TERM [pid]" if it is necessary to kill the process.)

2 As the owner of these files,

    cd rational_dir/releases/rose.I.J.K/install/patches/hppa_hpux/hp11

3 cp libX11.3 rational_dir/releases/rose.I.J.K/hppa_hpux/hp11/lib/.

4 chmod 555 rational_dir/releases/rose.I.J.K/hppa_hpux/hp11/lib/libX11.3

5 Run rose_cleanup.

6 Run rose.

MainWin Runtime Components

When Rose for UNIX/Linux runs for the first time, an $MWUSER_DIRECTORY directory is created which includes MainWin files and directories. Rose is created utilizing MainWin (developed by Mainsoft) and requires specific MainWin components to operate correctly. $MWUSER_DIRECTORY may be set to serve as the windows directory. For example, $MWUSER_DIRECTORY may be set to $HOME/.windows. If $MWUSER_DIRECTORY is not set, the default location will be $HOME/windows.

Within the $MWUSER_DIRECTORY directory, you will find the following type of files and directories:

Rational Rose for UNIX/Linux includes "mw" directory

Rational uses MainWin (by Mainsoft) to rehost Rose for UNIX/Linux platforms. Specific MainWin runtime components are included in Rose. Below is a description of the type of MainWin files included in Rose for UNIX/Linux under the rational_dir/rel*/rose*/mw directory.


Installing and Utilizing Fonts Compatible on Both PC and UNIX/Linux Displays

Rose for UNIX/Linux now includes the following release fonts which are compatible and may be used on both the PC and UNIX/Linux displays:

As it now is possible to display these same fonts on UNIX/Linux and the PC - models, etc. created on the PC (using these fonts) should display easily and accurately in Rose for UNIX/Linux on PC and UNIX/Linux displays. Furthermore, utilization of these fonts will provide the following additional enhancements:

Font files (in *.pcf - portable compiled format), are now included in the rational_dir/releases/rose.I.J.K/mw/fonts directory of your release. This directory also includes the following fonts* files:

A fontserver.cfg file is included in the rational_dir/releases/rose.I.J.K/mw directory. This file is used when starting the font server to provide the new fonts to the Rose application. A font server (xfs) is also provided in the rational_dir/releases/rose.I.J.K/mw/bin_<os>_optimized directory.

Making The Release Fonts Available on Your $DISPLAY

Prior to running Rose for UNIX/Linux for the first time, run rational_dir/releases/rose.I.J.K/bin/rose_cleanup. Upon starting Rose for UNIX/Linux, you will notice some new messages in relation to the availability of the new fonts. Rose will attempt to determine if the new fonts are available for your $DISPLAY, by running the new Rose for UNIX/Linux rose_fonts utility.

UNIX/Linux DISPLAY with visibility to Rose fonts

rose_fonts will make the fonts available to your DISPLAY by including the path to rational_dir/releases/rose.I.J.K/mw/fonts/ in your DISPLAY's font path.

DISPLAY other than UNIX/Linux (i.e. PC using eXceed) or UNIX/Linux DISPLAY without visibility to Rose fonts

In this case, fonts must be made available by using a font server and including the font server in the DISPLAY's font path.

rose_fonts will determine if a font server is providing access to the Rose fonts, as described below:

If Necessary To Configure Existing Font Server

If a font server is running on the Rose server and it is not already providing access to the Rose fonts, contact your System Administrator to perform this setup or refer to the man pages for xfs(1). The following advises how to configure an existing font server on SUN Solaris.

Note: Configuring an existing font server to provide access to the Rose fonts may produce less than optimal font results, based on the font paths included in the fontserver.cfg's catalogue setting. This is due to a potential Rose 2000e for UNIX/Linux font mapping issue that is currently under investigation. If you elect to continue with the following instructions, and you encounter poor font results please notify Rational Technical Support and remove the Rose font support from your fontserver.cfg file.

If you elect not to add the Rose font support (as described next) or elect to remove the Rose font support from an existing font server Rose will continue to operate correctly, however the font enhancements listed in Installing and Utilizing Fonts Compatible on Both PC and UNIX/Linux Displays will not be available and you may encounter the following defects:

Adding Rose fonts to Existing Font Server on SUN Solaris

To add Rose font support to an existing font server on SUN (it may be necessary to su to root to perform these actions):

Rose (upon starting) should indicate that the Rose fonts are now available.

Upon performing this setup, it will be important to update the fontserver.cfg file if Rose is uninstalled or moved to a different location (path changes).

Starting a Font Server

If a font server is not running (on the server running Rose), rose_fonts will start a font server provided in the release, if necessary. This is necessary if the DISPLAY is not a UNIX/Linux display, or if the display does not have direct visibility to the fonts provided in the Rose release.

X Font Commands Utilized by rose_fonts

The following commands are typically located in one of the following directories: /usr/openwin/bin, /usr/bin/X11, /usr/X11R6/bin, /usr/openwin/lib/X11, or /usr/openwin/include/X11. The font server "xfs" is provided in your release in rational_dir/releases/rose.I.J.K/mw/bin-$arch_optimized.

To Start a Font Server

xfs -config rational_dir/releases/rose.I.J.K/mw/fontserver.cfg -port 7100

To Set the Font Path

xset +fp rational_dir/releases/rose.I.J.K/mw/fonts/ (direct path to fonts in release)

xset +fp tcp/$host:7100 (font server path)

To Determine if Rose Fonts Available

xlsfonts | grep -i mainwin

xlsfonts may hang if a font path includes a path to a font server which is not running. rose_fonts will not let xlsfonts run for longer than a specified period of time (typically 30 seconds), to safeguard against this event. If an xlsfonts hang occurs, rose_fonts will provide status with recommendations.

rose_fonts Overview

In summary, rose_fonts will provide the Rose fonts to your DISPLAY by either setting the font path to point to the fonts in the release (UNIX/Linux display with visibility to the fonts), or by setting the font path to a running font server if the font server is providing access to the Rose fonts. rose_fonts will use "xset" to set the font path, "xfs" to start a font server (if necessary) and "xlsfonts" to determine if the Rose fonts are available after the setup has been performed. If a font server is already running and does not already provide support for the Rose fonts, manual setup is necessary (i.e. see Adding Rose fonts to Existing Font Server on SUN Solaris ) to complete the Rose font setup. In this case, manual set up is required as it is often necessary to su to root to perform this action. rose_fonts will provide messages describing the current status each time Rose is started.

Contact Rational Technical Support if you should have any questions or encounter any difficulties accessing or utilizing the new Rose fonts.

If Rose Fonts Not Available

There may be occasions when the Rose fonts will not be available. rose_fonts will alert you if, when starting Rose, if the Rose fonts are not available. If this occurs, Rose will continue operate correctly, however the font enhancements listed in Installing and Utilizing Fonts Compatible on Both PC and UNIX/Linux Displays will not be available and you may encounter the following defects:

To Eliminate Output from "rose_fonts" When Running Rose

Each time that you start Rose, rose_fonts determines whether the Rose Fonts are available, attempting to make the fonts available when necessary. Each time Rose is started, rose_fonts displays messages advising current Rose Font status. In order to eliminate output from rose_fonts, set the following environment variable prior to running Rose.

setenv ROSE_NO_FONT_MSG 1

Setting this environment variable will allow rose_fonts to run, but will refrain from printing Rose Font status messages.


Licensing Information

There are three license types supported by Rose for UNIX/Linux:

For a full description of license types, installation and usage, please consult the Rational Rose for UNIX/Linux Installation Guide.

The software you receive includes a temporary startup license. You must install the software and follow the steps detailed in the Installation Guide to acquire node-locked or floating license for your product. For users who are upgrading from Rose 98i for UNIX/Linux or after, you may use your existing license key to run Rose for UNIX/Linux.


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