Use this procedure to install IBM® Rational® Rhapsody® Developer, IBM Rational Rhapsody Architect for Software, IBM Rational Rhapsody Architect for Systems Engineers,
or IBM Rational Rhapsody Designer for Systems Engineers on
a Microsoft Windows system.
Before you begin
You must have either administrator privileges for the machine
on which you are installing the product or know the credentials for
an administrative account to be able to install the product successfully.
An administrative account can write to the Program Files directory
and the Windows registry.
In the latter case, you can enter the credentials for the administrative
account during the installation process for the product.
If
you are installing
Rational Rhapsody on
the Windows Vista operating
system:
- You must know the security and redirection principles that are
used by the Windows Vista
operating system. For example, the Vista operating system has higher
security settings for the Program Files directory; therefore, certain
installation files might be redirected to other locations on your
system during the installation process. If you install Rational Rhapsody in C:\Program
Files\IBM\Rational\Rhapsody, most of the installation files
are installed in that location and its subdirectories, but the writable rhapsody.ini file
and sample model files might be installed in a user directory, such
as C:\Users\<username>\AppData\Local\VirtualStore\Program
Files\IBM\Rational\Rhapsody. For more information, see
the technote in the related links about the default Rational Rhapsody file
locations when installed on Windows Vista.
- To run the installation, you must be logged in as an administrator,
not a user with administrator rights. If you are not logged in as
an administrator and try to install the product, the Error
registering Rhapsody.tlb message is displayed and you cannot
begin the installation again until you log in as an administrator.
If you are installing Rational Rhapsody on
the Windows 7 operating system:
- Normally, when you install the product on the Windows 7 operating system the installation
files are subject to the same redirection method as mentioned in the
previous note about installing on the Windows Vista
operating system. Some files are written in the default installation
directory and other files in the USERS directory. If you want to install
all the files in one specific directory (to which you have full permission),
add an environment variable called IgnoreAllUsersProfile to
the list of system variables for your workstation before you install
the product. Set the value for the IgnoreAllUsersProfile variable
to TRUE. You can add this system environment variable
through the Windows System
Properties window.
- To be able to install the product when you are not logged on with
administrator privileges but you know the credentials for an administrative
account, ensure that the User Account Control window is enabled to
open. During the installation process, it is on this window that you
enter the credentials for an administrative account. Set the User
Account Control Settings window to Always Notify.
For more information about the User Account Control Settings window,
see the article in the related links about User Account Control settings.
About this task
This procedure to install the product uses the setup.exe file.
If you want to install the product on a Windows system as a background operation
or silent installation, use the .msi setup program
instead; see the topic on installing Rational Rhapsody silently
on a Windows system.
To
view a video that shows installing the product, see the topic in the
related links about a demonstration of installing Rational Rhapsody.
Procedure
- If you have downloaded a compressed file, extract the installation
files to a temporary directory.
- In the installation directory for Rational Rhapsody,
double-click the setup.exe file to start the installation
wizard.
- For Windows XP
system only: If you are not logged on with administrator privileges,
the Install Program As Other User window opens. Enter the credentials
for an administrative account, and click OK.
- Select the language to be used for the product,
and click OK.
- If the installation wizard determines that the Microsoft
Visual Studio C++ 2008 SP1 Redistributable Package (x86) needs to
be installed, a window opens to let you do so. Click Install.
- The installation wizard guides you through the installation
process. Click Next to continue.
Note: If the installation wizard detects a previous version
of Rational Rhapsody on
your system, a message explains that the previous version is going
to be replaced with the current version.
- The IBM Software
License Agreement page opens. To continue with the installation, you
must accept the license agreement. Click Next.
- On the Choose Edition page,
select the edition of the product you want to install, and click Next.
Note: Rational Rhapsody Developer
is required for Eclipse users.
- For Rational Rhapsody Developer
and Rational Rhapsody Architect for Software only: Select
your languages:
- On the Destination Folder page, select the
installation folder:
- If Java is
enabled, select the Java development
environment for your computer and set the path to the location for
it, and then click Next.
- For Rational Rhapsody Developer
only: If enabled, select your development environments and set
the paths to those environments, and click Next.
A mark (such as a check mark or an asterisk [*]) next to a development
environment option means that the installation wizard found it on
your machine.
- Select any of the add-on products listed
on the Add-on Installation page if they are available for the edition
of Rational Rhapsody you
are installing. Some add-on products might already be selected for
your edition. Click Next.
Important: Some of these add-on products require separately
purchased licenses.
- Rational Rhapsody Gateway
Add On - Requirements Traceability connects Rational Rhapsody to IBM Rational DOORS®, IBM Rational RequisitePro®,
and other requirements authoring tools provided by other vendors for
requirements traceability throughout the lifetime of a project, and
to navigate online between the design and the requirements. Basic
export to Rational DOORS and Rational RequisitePro is
included in base products. Advanced bidirectional Rational DOORS and Rational RequisitePro synchronization,
impact analysis, coverage analysis, and integration with other authoring
tools is included with the IBM Rational Rhapsody Tools
and Utilities Add On.
- Rational Rhapsody XMI
Toolkit - XML Metadata Interchange imports and exports
model information to or from other tools and is part of the Rational Rhapsody Tools
and Utilities Add On.
- Rational Rhapsody TestConductor Add On provides
model-driven testing to automate testing tasks; defines tests with
code and graphically with sequence diagrams, statecharts, activity
diagrams, and flowcharts; and runs the tests interactively or in batch
mode.
- Rational Rhapsody Automatic
Test Generation Add On is the engine in the Rational Rhapsody Testing
Environment that verifies the functionality of the system. It uses
the UML model information and the generated source code as the basis
for analysis and to create executable test cases.
- Rational Rhapsody RulesComposer
Add On is the editor for rules-based model transformations.
Select this add-on if you want to use it to write your own code generator,
or if you want to use rules to customize the formatting of the C code
generation in IBM Rational Rhapsody Developer for C.
For a comparison of the primary methods to generate customized C code,
with or without the use of the Rational Rhapsody RulesComposer
Add On, see the topic in the related links about generating customized
C code.
- Siemens Teamcenter Systems Engineering Interface is
part of the Rational Rhapsody Tools
and Utilities Add On and requires .NET framework 1.1.
- Automotive, AUTOSAR system authoring and behavioral
design and AutomotiveC profile provides support for development
of applications including behavior for AUTOSAR with Rational Rhapsody Developer for C and
includes the AutomotiveC, AUTOSAR, and FixedPoint profiles.
- Automotive, AUTOSAR system authoring includes
the AUTOSAR profiles for designing AUTOSAR with Rational Rhapsody Architect for Software in
the C and C++ languages, and Rational Rhapsody Architect for Systems Engineers and Rational Rhapsody Designer for Systems Engineers.
- Systems Engineering Add On provides functions
to assist in the development of SysML and Harmony profile projects.
- Rational System Architect Interface provides IBM Rational System Architect enterprise
customers the ability to import Rational System Architect DoDAF
(non-ABM) into a Rational Rhapsody project.
- Microsoft Visual Studio Workflow Integration supports
using Visual Studio as an IDE.
- DoDAF - DoD Architecture Framework requires
a separate license and .NET framework 3.5 and is required for the
DoDAF profile.
- MODAF - UK Ministry of Defence Architecture Framework.
- Rational DOORS Interface is
the legacy interface to Rational DOORS that
provides export and traceability of design requirements.
- Microsoft Visual Basic for Applications.
- If you selected the Siemens Teamcenter Systems Engineering
Interface add-on, enter the URL for your Teamcenter server, and then
click Next.
- Specify your license information, and click Next.
- Review your installation settings, and click Install.
- For Windows Vista
and Windows 7 only: If
you are not logged on with administrator privileges, enter the credentials
for an administrative account on the User Account Control window,
and click Yes.
- When your installation is done, click Finish.
What to do next
Start Rational Rhapsody and
test it to see that it works as expected; see the topic about starting
the product on a Windows system.
For example, open one of the sample models; see the topic on examining Rational Rhapsody samples.