Rational Rose RealTime Installation Guide

Additional Settings

See the Rose RealTime User’s Guide for additional environment variables and startup options.

Chapter 3

Before installing Rose RealTime, ensure that you have a supported system configuration. The system requirements are listed in Chapter 2, Platform requirements — Windows NT, of the Rational Rose RealTime Release Notes. An InstallShield wizard setup program is provided to facilitate installing Rational Rose RealTime on Windows NT. You must have administrator privileges to install this software.

A minimum of 65 MB of disk space is required to install Rose RealTime.

To install Rational Rose RealTime, follow these steps:

1. Load the Rational Rose RealTime CD into your CD-ROM drive.

   If the system is configured with the autorun feature enabled, the setup program will run automatically and you may continue with step 3.

2. Run Setup.
   Use the Windows Explorer to open a window displaying the contents of the CD-ROM drive. For example, double-click "My Computer" and then double-click the icon for the Rose RealTime CD. Double-click the Setup.exe icon to run Setup.

   Note that the .exe file name extension may not be visible.

   The Setup dialog appears, followed by the Welcome dialog.

3. Click Next to view the License Agreement.
   You must accept the license agreement to proceed.

   If you do not agree with the terms of the license agreement, the installation should be aborted. All software and documentation should be returned to Rational Software.

   If you accept the terms and conditions of the license agreement, click Yes.

4. Enter your name and the name of your company, and click Next.

5. Enter your installation key and click Next.

   Your install key can be found in the Welcome letter that you received with your product shipment.

6. The products to be installed are displayed—these are based on the Installation keys. Click Next.

7. Choose the Destination folder and click Next.

8. The default Destination folder where the software will be installed is:
   C:\Program Files\Rational\ Rose RealTime\6.0
   Use the Browse button to change the default destination folder. Avoid spaces in directory names if you are integrating with Tornado, OSE or VRTX. See theRelease Notes for more information.

9. Choose the Program folder name and click Next. The default Program folder name is Rational Rose RealTime 6.0. This is the folder where Rose RealTime will appear under Start > Programs.

10. An information summary is provided. To edit settings, click Back.
    To continue, click Next.
    Installation begins.

11. When the installation is finished, the Setup Complete dialog appears letting you choose whether to restart your computer. We strongly recommend you click Yes, I want to restart my computer now.

12. Click Finish.

Testing your environment

You must have Microsoft Visual C++ 5.0 or 6.0 installed on your system and configured to be run from the DOS prompt to make use of the code generation and execution capabilities of Rose RealTime.

The following instructions will help you to determine whether you have Visual C++ properly installed and configured on your system.

To perform testing on your environment, proceed as follows:

1. Open a Windows NT command prompt from the Windows Start menu as follows:
   Start > Programs > Command Prompt.

2. Type nmake then hit Enter.

3. Type cl then hit Enter.

If your environment is correct, then these two applications should report errors similar to the ones below:

Command Prompt
Microsoft^® Windows NT^TM
© Copyright 1985-1996 Microsoft Corp.
C:\>nmake
Microsoft^® Program Maintenance Utility Version 6.00.8168.0
Copyright© Microsoft Corp 1988-1998. All rights reserved.

NMAKE = fatal error B1864: MAKEFILE not found and no target specified
Stop.

C:\>cl
Microsoft^® 32-bit C/C++ Optimizing Compiler Version 12.00.8168 for 80x86
Copyright © Microsoft Corp 1984-1998. All rights reserved.

Usage = cl { option... } filename... { /link linkoption... }

If your environment is NOT properly configured, then you will see an error similar to this one:

Command Prompt
C:\> nmake
The name specified is not recognized as an internal or external command, operable program or hatch file.

Note: If you get this error message, your compiler environment setup is improperly installed. Please contact your System Administrator to verify.

---

[Next]  [Prev]  [TOC] 

---

[Next]  [Prev]  [TOC] 

---

Chapter 4

License Key Information

Rational Rose RealTime, like most Rational software, is a licensed product. This means that you cannot run the product without a license key. The license key is listed on your Rational Startup License Key Certificate, included in this shipment.

Note: Your Startup License keys will expire on the date as indicated on the Startup License key Certificate. Submit your permanent license key request as soon as possible. For detailed information on licensing, see the Licensing chapter in Getting Started with Rational Rose RealTime.

The license key certificate contains a startup key required for product use. A startup key allows you to start running the software and continue running it for a limited period of time. You must request a permanent license before the temporary one expires.

The product you purchased has either a node-locked (client-based) or a floating (server-based) license. Both types of licenses can run with either startup or permanent license keys.

Startup License

The startup license keys are time-limited and allow you to start using Rose RealTime immediately.

Note: You must follow the instructions below to activate the startup license key.The instructions on the envelope and the Startup License Certificate are not valid for your Rose RealTime startup license. The startup key is valid for about eight weeks after the product shipment date.

Permanent License

You will need to acquire a permanent license key to use the software beyond the expiration date of the Startup license key. See "Obtaining a permanent license".

Installing a Startup License

Based on the type of license you have purchased and received in your temporary license certificate, you will need to start with a different file.

1. Go to the directory ROSERT_HOME/license (%ROSERT_HOME%\license on NT and $ROSERT_HOME/license on Unix).

   There will be a different template for each of the different license types available for Rational Rose RealTime:

   • developer_floating_startup.dat
   • developer_nodelocked_startup.dat
   • modeler_floating_startup.dat
   • modeler_nodelocked_startup.dat

2. Locate the Startup License Key certificate that accompanied your product shipment, which is in an envelope. Your company’s name is printed on the certificate and shows through the envelope window.

3. Based on the license type and product name indicated on this certificate, copy the appropriate template file to a new file named license.dat in the same directory.
   For example, if you have purchased a Rational Rose RealTime Developer Edition with Floating Licenses, copy the file developer_floating_startup.dat to license.dat in the %ROSERT_HOME%\license directory.

4. Make the license.dat file writable:
   1. Right-click the license.dat file and select Properties from the pop-up menu.
   2. In the General tab, ensure the Read-only checkbox is unchecked.

5. Open an editor on the license.dat file:
   1. Double-click on the file.
      The Open With dialog appears.
   2. Select Notepad.

6. Replace the string <Expiration Date> and <License Key> with what is specified on the Rational Startup License Key Certificate. Enter the information exactly as indicated.

   Remove the angle brackets ("<" ">") from the entered strings (expiration date, license key, hostname / quantity if floating licenses are being installed). For example, if "27-may-1999" was on the Startup License Key Certificate, replace the string "<Expiration Date>" in the license file with "27-may-99".

   For Node-locked licenses:

   • Do not fill in the quantity from the license certificate.

   For Floating licenses:
   • Fill in the name of the host platform where the license server (Imgrd) will run.
   • Replace <hostname> with the host name of server that will run the license manager.
   • You are also required to fill in the <quantity>.

   Note: For startup keys always use:

   • the number ZERO "0" (not the letter O)
   • the number ONE "1" (not the letter l) when entering the License Key
   • enter the date in the following format: dd-mm-yy

7. Save the edited license.dat file and exit the editor.

8. Make the license.dat file read-only.
   1. Right-click the license.dat file and select Properties from the pop-up menu.
   2. In the General tab, ensure the Read-only checkbox is checked.

9. If you are installing floating licenses, start the license manager. "Licensing" on page 25 of Getting Started with Rational Rose RealTime.

Now you are ready to start Rose RealTime.

To get a guided introduction to the primary tools and concepts for constructing and executing real-time models in Rational Rose RealTime:

1. Start Rational Rose RealTime.

2. Select Help > Help Topics.

3. Click Tour Rose RealTime.

To start building and running a model, click Quickstart Tutorial.

Your Startup License will expire on the date indicated by the Expiration Date.

 

Obtaining a permanent license

On the license key certificate you will find an availability date for your permanent key. This is the date on which your keys will be made available to allow you to request your permanent keys through the Rose RealTime license administrator.

Obtaining a node-locked license

To request a permanent license from Rational:

1. On Unix execute Rose RealTime with a -license option, for example, "RoseRT -license".

   On Windows NT select Start > Program > Rational Rose RealTime 6.0 > Rational Rose RealTime License Administrator.

   The following screen is displayed:

   click to enlarge
   
   License Request file

2. Enter the complete information on the form and save the license request file using the Save Form... button. You may optionally use the workstation disk id (DISK_SERIAL_NUM) or the network address of the network interface card installed on your system to identify your workstation.

3. Copy the contents of the file saved in step 3 into the text of a standard email message. Note: Do not add any information to this text. Include only the contents of the file saved in step 3.

4. Email the request to license@rational.com. Note: Do not attach the file directly to the email message. It will not be accepted by the automated license key generation utility.

5. You will receive a new license.dat via return email.

6. Backup your existing license.dat file and replace it with the newly received license file and rename it to license.dat.

7. Restart your local toolset session as appropriate.

---

[Next]  [Prev]  [TOC] 

---

[Next]  [Prev]  [TOC] 

---

Chapter 5

Installing Rose Uninstalling Rational Rose RealTime

Unix
To uninstall Rose RealTime, follow these steps:

1. Remove the installation directory and all of its contents.
2. Save any user data files in another location before removing the installation directory.

Windows NT
To uninstall Rose RealTime, follow these steps:

1. From the Start menu, select Programs > Rational Rose RealTime 6.0 > Uninstall Rational Rose RealTime 6.0.
   All directory items and registry settings are removed from your system.
   If the temporary license file was still on your system and was set to read-only, the license directory must be removed manually.

---

[Next]  [Prev]  [TOC]