Installing Rational Rose Unix on x86_64
Search
Google
Web
cognitus.net

Introduction

If you are like me and own a licensed copy of Rational Rose Unix or just happen to be a user trying one of the demo copies, you may notice a few problems with the current and previous distributions if you try to install them on a non-supported Linux distribution or on one of the newer Intel x86_64 boxes. In latter the installation aborts almost immediately due to it not recognizing this specific hardware architecture.

Not to fear as the program does appear to run perfectly fine once installed, and I have personally been running it for quite some time on an x86_64 machine. It is just a matter of doing some tweaking to the installation files to be able to actually get it on the machine. This page documents the steps that I followed to get Rational Rose Unix v 2003.06.14 running on my personal machine.

Even though I know of no problems with the instructions on this page, I have to state the following:

These instruction are provided as is and with no implied warranty – use them at your own risk. I assume absolutely no liability for any damage which results either from the direct or indirect use of the information and instructions outlined on this page.

Host Information

First we will assume you have downloaded the Rational Rose Unix tar.gz file and expanded it into a directory which we will refer to as the <src dir> from herein. Your next step in the installation is obtaining a new license from Rational which is, for a permanent node-locked license, keyed to machine host name and something called the host id. You can get the host name simply by executing the command `uname -m` but that still leaves the host id. To generate the host id you are going to need to run the <src dir>/rs_hostinfo program.

This is where we encounter the first problem when installing under x86_64. The <src dir>/rs_hostinfo program will do an architecture check and will not recognize it. Because of this fact, it will return an error message and exit without providing the host id required to update your license key. To work around this problem, edit <src dir>/rs_hostinfo and look for the following section:

Linux*2.* )
    case `uname -m` in
    i?86 )
        arch=i386_linux2
        sys=$arch
        RCP=/usr/bin/rcp
        ;;
    ia64 )
        arch=i386_linux2
        sys=$arch
        RCP=/usr/bin/rcp
        ;;
    esac

Once you locate this segment of code there are a number of ways to modify it. Since we want to add functionality instead of removing it and so <src dir>/rs_hostinfo recognizes x86_64 as a valid architecture change that section so that it reads:

Linux*2.* )
    case `uname -m` in
    i?86 )
        arch=i386_linux2
        sys=$arch
        RCP=/usr/bin/rcp
        ;;
    x86_64 )
        arch=i386_linux2
        sys=$arch
        RCP=/usr/bin/rcp
        ;;		
    ia64 )
        arch=i386_linux2
        sys=$arch
        RCP=/usr/bin/rcp
        ;;
    esac

After you save your modifications <src dir>/rs_hostinfo should recognize your architecture and execute successfully provide the host name and host id for obtaining your new license.

Installing the License Key

If you have followed the previous steps, the next part consists of the installation of the Rational Rose into the desired target directory. This step is identical to that required for a normal installation i.e. you simply execute the rs_install command from the <src dir> of Rose. Proceed as usual until you get to the following License Check Menu screen with option 3 selected as shown below.

     Rational Rose - License Check Menu

     1)  Check license keys in:
         /usr/local/rose/config/suse-10.dat

     2)  Start or restart the license server.
         Will check if a license server is running.  If not, will start it.
         If it is running, will restart it.

---> 3)  Check license server using lmstat.  Will check for these licenses:

License Feature                  Description
Rose98_Unix                      Rational Rose for UNIX
DevelopmentStudioUNIX            Rational Suite DevelopmentStudio for UNIX
rose_enterprise_windows          Rational Rose Enterprise Edition

     4)  License settings for Rational Rose up-to-date.

     f)  Forward to the next menu to continue...
     b)  Back to the previous menu.
     q)  Quit rs_install.  Enter q! to quit without saving your inputs.
     ?)  Help.

    Enter menu option: [3] 

A quick note – when executing option 2 of the License Check you will probably get an error. It is safe to ignore it and proceed to the screen shown.

For the next step, where <target dir> indicates the directory you told the installation program to put your working copy of Rational Rose Unix, you need to open a new window and edit the

<target dir>/config/start_lmgrd_on_[hostname]

file. Locate the following line:

LICENSE_EXE=$LICENSE_DIR/lmgrd

Modify that line so the section reads as indicated below and then save the file:

LD_ASSUME_KERNEL="2.4.1"
export LD_ASSUME_KERNEL
LICENSE_EXE=$LICENSE_DIR/lmgrd

Checking Installed License Keys

Once you have finished saving the

<target dir>/config/start_lmgrd_on_[hostname]

file with the modifications execute it so that the license server begins running. After you have started the license server return to the installation screen and hit enter so that option 3 runs. If the license server has started and the license is valid you should seem something similar to:

    Checking license server for Rational Rose licenses:

    Running the FLEXlm 'lmstat' command...

/usr/local/rose/base/cots/flexlm.7.0f/i386_linux2/lmstat -a \
    -c /usr/local/rose/config/suse-10.dat

Users of Rose98_Unix:  (Total of 1 license available)
Users of DevelopmentStudioUNIX: NOT LICENSED
Users of rose_enterprise_windows: NOT LICENSED

    2 of the 3 license components are not being served.
    This may be okay, since 1 license is being served.

    Press the Enter key to continue, q to quit rs_install: 

So now proceed through normal installation – in my case I used the ‘Typical Installation’ option. The <src dir>/rs_install program should create all of the target directories and basic configuration but then fail during post installation with the error message indicating an unknown architecture:

    Installing: /usr/local/rose/config/version_map.rose [rev 17]
Unknown system architecture: Linux 2.6.13-15.7-smp x86_64
------------------------------------------------------------------------------
    The rs_install command completed successfully.
    Defaults saved in:
    /usr/local/rose/config/defaults/rs_install.R2003.2003.06.14.root
    rs_install log file:
    /usr/local/rose/releases/rose.2003.06.14/rs_install.suse-10.root.log

    End of rs_install.

Fixing the PostInstall Process

The rest of our work will be performed in the <target dir>. Do NOT re-rerun anything from the <src dir> or you may have to start from the beginning.

Having given that warning, open the file

<target dir>/releases/rose.<version>/install/check_reqs

and make the following modifications:

Find the lines:

#-----------------------------------------------------------------
check_networking() {
#-----------------------------------------------------------------
# Check that networking has been configured.

Modify them to read:

#-----------------------------------------------------------------
check_networking() {
#-----------------------------------------------------------------
# Check that networking has been configured.

return 0

Find the lines:

#-----------------------------------------------------------------
check_obs_os_ver() {
#-----------------------------------------------------------------
# Check that the O/S version we are running on is not obsolete.

Modify them to read:

#-----------------------------------------------------------------
check_obs_os_ver() {
#-----------------------------------------------------------------
# Check that the O/S version we are running on is not obsolete.

return 0

Find the lines:

#-----------------------------------------------------------------
check_os_ver() {
#-----------------------------------------------------------------
# Check that the O/S version matches one from the expected list.

Modify them to read:

#-----------------------------------------------------------------
check_os_ver() {
#-----------------------------------------------------------------
# Check that the O/S version matches one from the expected list.

return 0

Save the modifications to <target dir>/releases/rose.<version>/install/check_reqs and then open

<target dir>/releases/rose.<version>/install/share/install_lib

for editing. Find the lines which read:

SYS_REL=`$UNAME -r`
SYS_MACH=`$UNAME -m`

Modify them to read:

SYS_REL="2.4.1"
SYS_MACH="i386"

Save that file and now we are down to the final step.

Simply execute the command

<target dir>/releases/rose.<version>/rs_install

and proceed as normal. The command should finish the post_install process and leave you with a working version of Rational Rose Unix with the executable located at:

<target dir>/releases/rose.<version>/bin/rose

Finishing Up

On caveat if you bypassed the inetd check as shown in this page. Since the license server will not start automatically, you must run it by hand prior to starting up the rose binary proper. This is done simply by executing the command:

<target dir>/config/start_lmgrd_on_[host name]

Thats it and you should be up and running. I hope this has helped others to simplify the installation of their copy of Rational Rose Unix to an x86_64 machine.

Let me know if you run into any issues.


©2003-2006 Michael M. Lampkin

All rights reserved.

Use of this website signifies your agreement to the Terms of Use.