======================================== Rational Rose RealTime README File Release 6.01, May, 1999 ======================================== Thank you for installing Rational Rose RealTime. The Rational Rose RealTime readme file contains updates that were not available when the hardcopy and online versions of the Release Notes were published. For additional information regarding Rational Rose RealTime, please refer to the Rational Rose RealTime website at www.rational.com/products/rosert. NOTE: If you are viewing this document in Wordpad, please use the word-wrap option under View/Options/Text. To make this document easier to read, you can enlarge the Wordpad window to its maximum size. CONTENTS: Installation Information .................... 1 Known Install Limitations .................... 2 Uninstall Information ....................... 3 Licensing Information ....................... 4 Known Licensing Limitations ................. 5 Licensing Support ........................... 6 Updates ..................................... 7 Rational Suite Web Site ..................... 8 Contacting Rational Tech Support ............ 9 Contacting Rational Software ................ 10 Legal Information ........................... 11 ========================================================== 1. Installation Information ========================================================== Minimum System Requirements: ______________________________________ PLATFORM REQUIREMENTS - WINDOWS NT: The minimum supported configuration for running Rose RealTime 6.01 on Windows NT is: - Windows NT 4.0, Build 1381 with service pack 3 or service pack 4. - Minimum Pentium 150 MHz or faster CPU. - Minimum 64 MB of RAM, we recommend 128 MB. - Minimum 65 MB of disk space for the Rose RealTime installation. - Minimum 800 * 600 * 256 color video resolution or better. - Postscript printer for printing. - Browser requirement - Internet Explorer 4 / Internet Explorer 5 or Netscape Navigator 4.51. Internet Explorer 4 or 5 is recommended. ______________________________________ PLATFORM REQUIREMENTS - UNIX: The minimum supported configuration for running Rose RealTime 6.01 on UNIX is: - Solaris 2.5.1, Solaris 2.6 or HPUX 10.20 - We recommend 128 MB of RAM. - Minimum 150 MB of disk space for the Rose RealTime installation. - Postscript printer for printing. - Browser requirement - Netscape Navigator 4.51 minimum. At the time of release Internet Explorer 5 for UNIX had not been tested. Refer to the product web site (www.rational.com/products/rosert) for the latest update on this. ______________________________________ TOOLSET REQUIREMENTS: HTML Browser An HTML browser is required to access the online Help provided with Rose RealTime. Supported browsers are: - Netscape Navigator version 4.51 or greater, we recommend version 4.51 or greater. - Internet Explorer version 4 or greater. For optimum online Help performance, use Internet Explorer 4 or 5. At the time of release Internet Explorer 5 for UNIX had not been tested for compatibility. ______________________________________ COMPILER: You must have a C++ compiler installed on your system if you wish to make use of the code generation and execution capabilities of Rose RealTime. Different compilers are required for host workstation and for embedded system targets. The list of supported compilers and targets is provided in the Getting Started Guide. ______________________________________ REAL-TIME OPERATING SYSTEM: If you are planning to deploy your model on a real-time operating system, your operating system, hardware and tool lineup must be one of the supported lineups listed in the Getting Started Guide. If you are not using a supported lineup, you may be able to obtain support for your lineup from a Rational RoseLink partner, or by customizing the Rose RealTime Services Library for your target. See the C++ Target Guide for instructions on customizing the Services Library and compiling for new target platforms. After your installation has been completed, we recommend that you get started by reviewing the online tutorial. See the tours and tutorials reference, which can be found through Help > Help Topics. ========================================================== 2. Known Installation Limitations ========================================================== There were no known installation limitations at the time of release. Refer to the Rational Rose RealTime Install Guide for complete installation information. ========================================================== 3. Uninstall Information ========================================================== Unix To uninstall Rose RealTime, follow these steps: - Remove the installation directory and all of its contents. - Save any user data files in another location before removing the installation directory. ______________________________________ Windows NT To uninstall Rose RealTime, follow these steps: - 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 a startup or permanent license was copied into the license directory, this directory must be removed manually. ______________________________________ Refer to the Rational Rose RealTime website at www.rational.com/products/rosert and the Release Notes for additional information. ========================================================== 4. Licensing 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 key is listed on your Rational Startup License Key Certificate, included in this shipment. The product you purchased has either a node-locked (client-based) or a floating (server-based) license. The license key certificate contains a startup key required for product use. A startup key allows you to start running the software and will allow you to run for a limited period of time. A startup license key administrator is included with the product to allow you to install your startup license key easily. You must run the Permanent License Administrator to request permanent keys for your installation. Startup - The startup license key contains information used by the license manager. You must follow the instructions in chapter 4 - "License Key Information" of the Rational Rose RealTime Install guide. 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 8 weeks after the product shipment date. Permanent - You'll need to acquire a permanent license key to use the software beyond the expiration date of the Startup license key. Follow the steps for "Obtaining a permanent license" in the Rational Rose RealTime Install Guide. This section walks you through the process of requesting and installing a permanent key in your environment. For a full description of license types, installation and usage please consult the "Rational Rose RealTime Install Guide". Licensing Tips: - The License Server runs on a UNIX or Windows NT 4.0 platform. It will not run on Windows 95 or Windows 98. - If you need to move licenses from one machine to another, please contact Rational Licensing Support. - Please run the License Administrator and issue your request for permanent keys immediately after you complete the installation. The startup license keys will expire on the date as specified on the Rational Startup License Key Certificate. Note the date on which the permanent keys will be available from the Rational licensing server. ========================================================== 5. Known Licensing Limitations ========================================================== There were no known licensing limitations at the time of release. ========================================================== 6. Licensing Support ========================================================== If you have questions about Rational Software licensing, please contact the Licensing Support group nearest you: AMERICAs Phone: 800-728-1212; Fax: 781-676-2510 Email: lic_americas@rational.com EUROPE, ISRAEL, AND AFRICA Phone: +31 23 554 10 62; Fax: +31 23 554 10 69 Email: Lic_europe@rational.com NORTH ASIA PACIFIC (Mainland China, Hong Kong, and Taiwan) Phone: +852 2143 6382; Fax: +852 2143 6018 Email: Lic_apac@rational.com SOUTH ASIA PACIFIC (Australia, New Zealand, Malaysia, Singapore, Indonesia, Thailand, The Philippines, Vietnam, Guam and India) Phone: +612 9419 0100; Fax: +612 9419 0160 Email: Lic_apac@rational.com JAPAN Phone: +81 3 5423 3611; Fax: +81 3 5423 3622 Email: Lic_japan@rational.com KOREA Phone: +82 2 556 9420; Fax: +82 2 556 9426 Email: Lic_apac@rational.com ========================================================== 7. Updates ========================================================== Refer to the Rational Rose RealTime website at www.rational.com/products/rosert for the latest product and documentation updates. The following updates were available at the time of release: - Visual Diff for HPUX 10.20 was not available at the time of release. Please refer to the Rational Rose RealTime web site at: http://www.rational.com/products/rosert for the latest information and product updates. - For complete details on the integration with the Rational SoDA Document Automation product, please consult the Rational Rose Real Time web site at: http://www.rational.com/products/rosert. - In order to integrate with the Rational ClearCase configuration management system, you must enable the "preserve case" option in the ClearCase MVFS tab as Rose RealTime is case sensitive when performing file operations. In the ClearCase Homebase tool, select the MVFS tab - ensure the "preserve case" check box is selected. - Rose RealTime is tightly integrated with leading configuration management systems to perform the majority of CM operations. However, it does not replace the CM tool's interface for advanced configuration operations. In these cases you should use the CM tool directly to take advantage of its full power. Examples of operations that are simpler to perform directly through the CM tool are: - Reverting to an earlier model configuration that is structurally different from the current version. - Moving part of a model forward from an old version to an intermediate version that is not in the latest lineup. - If you are using batch scripts to perform unattended operations and wish to avoid dialogs which require user response, you should ensure the application is not visible. This can be enabled by including the following line in the batch script: RoseRTApp.Visible = False - Converting Rose 98 and Rose 98i models that have components of the same name will result in model conversion errors and errors in the component diagrams when these models are brought forward into Rose RealTime. In these cases, resolve the naming conflict in Rose 98 or Rose 98i before attempting the model conversion. - Prior to converting a Rose 98 or Rose 98i model, it is recommended that model errors are identified and corrected (where possible) through the use of the Check Model utility in Rose. - Visual Diff for Rational Rose RealTime is designed to be used for generating differences for small files and models. Large models can be managed by checking the "Control All Units" option in the model specification. This will create separate files for each significant model element. These files can the be checked individually by the Visual Diff utility. Attempts to run Visual Diff on complete, large models will require large amounts of memory and CPU time. - If you have updated a model outside of the toolset, e.g. through a file copy or perhaps a CM get outside of the toolset, the modified files will not be regenerated by the toolset. In these cases, a Rebuild All should be run from within the toolset to resynchronize. - At times, a warning dialog appears when starting the online help using Navigator 4.51 on UNIX. The warning does not affect the functionality or operation of the help system. - If online help does not start up and you are using Internet Explorer 5, please shutdown any other Internet Explorer sessions and re-launch help. - With any of the UNIX platforms, a right-click on any of the buttons in a specification dialog will raise a File Menu in the pop-up window. The correct display should be a "What's this?" in the pop-up window. Any selection made after the right-click will still behave as "What's this?". - If you are using an NCD X Terminal, there is a problem with the Java applet for Netscape on this particular configuration which results in not being able to view the online help. Please consult the Rose RealTime web site for updated information. - Note that Rose RealTime workspace exchange between the Windows NT and UNIX operating systems is not supported. The various types of model files can be exchanged freely between platforms, but workspace (.rtwks) files can not be shared between UNIX and Windows NT platforms. ========================================================== 8. Rational Rose RealTime Web Site ========================================================== Please visit the Rational Rose RealTime Web site often for the latest release notes, patches, model examples and other information, at: http://www.rational.com/products/rosert Along with your software shipment, you received an envelope containing a Startup License Key Certificate for this product. You need this key in order to run your software. The startup license key will expire in approximately 8 weeks. To continue running the software, please be sure to request your permanent key as soon as it is available. Availability date is also listed on your Startup License Key Certificate. Please check the Installation Guide for detailed instructions regarding License Key Administration. ========================================================== 9. Contacting Rational Technical Support ========================================================== If you encounter any problems while installing or running Rational Rose RealTime, please check the release notes and this README File to see if it is a known problem. If a problem is not yet documented in the release notes or in this Readme File, please call Rational Technical Support so we can investigate it, provide you with a workaround, and track the problem for future action. Technical Support for Rational Rose RealTime is available at: support@rational.com Other contact information for Rational Rose RealTime is available: - On the Rational web page http://www.rational.com/rosert - In the Getting Started with Rational Rose RealTime guide - In the Rational Rose RealTime online help ========================================================== 10. Contacting Rational Software ========================================================== Rational Software Corporation 18880 Homestead Road Cupertino, CA 95014 Toll-free: 800-728-1212 (within the continental United States) Tel: 408-863-9900 E-mail: ratlinfo@us.ibm.com Web: http://www.rational.com ========================================================== 11. Legal Information ========================================================== Copyright © 1993-1999 Rational Software Corporation. All rights reserved. Copyright © 1999 ObjecTime Limited. All rights reserved. Portions Copyright © 1992-1999 Summit Software Company. All rights reserved. Licensee shall not incorporate any GLOBEtrotter Software (FLEXlm libraries and utilities) into any product or application the primary purpose of which is software license management. This document is subject to change without notice. Please consult the Rational Rose RealTime online help to review the product license agreement in it's entirety. ______________________________________ 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, Rational Rose, ClearCase, and Rational Unified Process 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. ObjecTime (and clock design) and ObjecTime are registered trademarks of ObjecTime Limited in Canada, the United States and in other countries. Microsoft, Windows, Windows NT, and Visual SourceSafe are trademarks or registered trademarks of Microsoft Corporation. T Quatrani VISUAL MODELING WITH RATIONAL ROSE AND UML, (pages 3, 4, 29, 39, 73, 142, 153). © 1998 Addison Wesley Longman Inc., -Reprinted by permission of Addison Wesley Longman. All rights reserved.