QNX® Momentics® Development Suite 6.3.0 Professional and Standard Editions Installation Note -- Windows Hosts

QNX® Momentics® Development Suite 6.3.0

Date of this edition: April 18, 2007

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Microsoft Windows XP, 2000, or NT

If you've already installed an evaluation version of QNX Momentics 6.3.0, and you've purchased and received a commercial QNX License Certificate, please go to "Commercializing your evaluation software," below.
We're deprecating support for Windows NT hosts. This is the last release of QNX Momentics that you can install on NT.
For the most up-to-date version of these notes, log into your myQNX account, and then go to the Download Center area of www.qnx.com.
We highly recommend that you install Service Pack 1 after installing QNX Momentics 6.3.0. For more information, see the Download Center area of our website.

If you upgrade to Windows Vista, you must also upgrade to QNX Momentics 6.3.0 SP3, and then download and install the Command Line Tools Windows Vista Patch (Patch ID 522) after installing QNX Momentics but before using it or installing any other QNX product; otherwise, the command-line tools, the shell, and the IDE itself might be unstable.

Technical support
System requirements
Installation procedure
Installing the Rational Rose Adaptation Layer
Important notes
Commercializing your evaluation software
Uninstalling QNX Momentics
Getting started with the docs

Technical support

If you have any questions, comments, or problems with a QNX product, please contact Technical Support. For more information, see the How to Get Help chapter of the Welcome to QNX Momentics guide or visit our website, www.qnx.com.

System requirements

Host OS:

Windows XP SP1
Windows 2000 SP4
Windows NT SP6a

	Minimum	Recommended
Processor	Pentium III, 700MHz	Pentium 4, 2GHz or more
RAM	256M	512M RAM
Disk space	1.5G	1.5G
Monitor	1024*768	1280*1024

Installation procedure

QNX Momentics 6.3.0 includes everything you need to build for all supported platforms (ARM, MIPS, PowerPC, SH-4, XScale, and x86).

If you installed a beta version of QNX Momentics 6.3.0, you must uninstall it before installing the released version. See "Uninstalling QNX Momentics," below.

If you install Neutrino in a partition on a Windows machine and later use Windows software to create another partition, you'll lose your Neutrino partition.

To install this software:

Boot into Windows and log in as the system administrator.
Insert the QNX Momentics 6.3.0 Installation CD. The installation should start automatically; if it doesn't, double-click qnxSetupWin32.exe in the root directory of the CD.
Follow the instructions on your screen.
If you install 6.3.0 on a machine that already has 6.2.1, select "Yes" when prompted about upgrading the environment variables. Otherwise, you won't be able to install future releases; see "Important notes," below.

Java's AWT and Swing aren't supported in 16 color mode; they require a minimum of 256 colors. If you get a message, "Unable to run in graphical mode," run the installer in console mode, by typing this in a DOS prompt window:

drive:\qnxSetupWin32.exe -console

where drive is the drive letter for your CD drive.

Congratulations -- you've completed the installation! Your desktop should now include two new icons:

QNX Momentics Welcome -- information about 6.3.0
QNX Momentics IDE

After installing, you're asked to activate the product, either online or by email. If you don't activate the product within the specified timeframe, the product will cease to function until you activate it. No personal data is transferred during the activation process.

If you choose not to activate at the time of installation, you can activate later by selecting Programs-->QNX Momentics 6.3.0-->License Management-->Activate License from the Start menu, or by entering the following at the command prompt:

[drive]\Program Files\QNX Software Systems\bin\qnxactivate -a

where drive is the name of the drive where you installed QNX Momentics.

Installing the Rational Rose Adaptation Layer

You must install the Rational Quality Architect - RealTime Edition 2003 Build 6.5 before installing the Rational Rose Adaptation Layer. You must have installed QNX Momentics 6.3 before you use the Adaptation Layer.

To install the Rational Rose Adaptation Layer, go to the Rose directory on the QNX Momentics installation CD, and run qnxSetupRRAL.exe. You'll need your PE license key.

The Adaptation Layer is installed as a subdirectory of where you installed Rational Rose (e.g. C:\Program Files\Rational\Rose RealTime\C++\TargetRTS).

Important notes

We now provide two shells:
- Bash shell (bash.exe)
- Korn shell (ksh.exe)
You'll find these executables under ${QNX_HOST}/usr/bin (e.g. C:\QNX630\host\win32\x86\usr\bin). You may want to create desktop shortcuts for these or other executables you'll use often.
The QNX Momentics IDE shortcut has a working directory set to C:\QNX630 (or wherever you installed the software). By default, users who aren't system administrators don't have write access for this directory. You might want to change the shortcut so that it starts the IDE in a directory that non-administrator users can write in.
If you install 6.3.0 on a machine that already has 6.2.1, and you select "No" when prompted about upgrading the environment variables, you won't be able to install future releases. (Ref# 22740)
Workaround: Do the following:
1. Open %PROGRAMFILES%\QNX Software Systems\qconfig\qnx_momentics_6.3.0.xml in a text editor.
2. Edit the file so that <host> and <target> tags use the proper base directory. For example, if your <base> tag is <base>C:/QNX630</base>, then your <host> tag should be <host>C:/QNX630/host/win32/x86</host>, and your <target> tag should be <target>C:/QNX630/target/qnx6</target>.
3. From the Start menu, choose All programs or Programs, then choose QNX Momentics 6.3.0-->Configuration.
4. Switch your configuration either from 6.2.1 to 6.3.0, or from 6.3.0 to 6.2.1. Click OK.
5. Repeat steps 3 and 4 to make sure that the environment is set correctly.
6. Repeat steps 3 and 4 to set the configuration to be 6.3.0 (if it wasn't already).
7. If you find that the above steps don't make a difference, then log out and in again.
On Windows, the QNX-provided echo.exe interprets the Windows \ separator as an escape character. As a result, environment variable settings won't work if you use \ as a path separator; use / instead. (Ref# 19924)
If your PATH contains quotation marks, ln-w doesn't work properly. (Ref# 20046)
In Windows, make sure your HOME environment variable is set if you're on a network. If you don't set HOME, then gdb may become unresponsive because it will waste time searching over the network for its initialization files. (Ref# 20566)
When you install QNX Momentics, the installer sets the QNX_HOST and QNX_TARGET environment variables. If you want to install any additional products from our website, and you want to run the installer from the website instead of saving it on your machine, don't use a browser or shell that was open before you installed QNX Momentics. An old browser or shell won't have those environment variables set, so the installer will think that you haven't installed QNX Momentics.

Commercializing your evaluation software

If you installed an evaluation copy of QNX Momentics 6.3.0, and you've now received a commercial QNX License Certificate, do the following to add your commercial license:

Choose Programs-->QNX Momentics 6.3.0-->License Management-->Add License from the Start menu, or enter the following at the command prompt:
```
[drive]\Program Files\QNX Software Systems\bin\qnxactivate -l
  
```
where drive is the name of the drive where you installed QNX Momentics.
In the QNX Momentics License Key Entry dialog, fill in the field with the license-key information that's on your commercial QNX License Certificate.
When you've finished entering the information, click Add to save the license-key information and configure your QNX Momentics tools to use this file.

Uninstalling QNX Momentics

To uninstall QNX Momentics, do the following:

Log in as the system administrator.
Do one of the following:
- Choose Programs-->QNX Momentics 6.3.0-->Uninstall QNX Momentics 6.3.0 from the Start menu.
  or:
- Choose Add or Remove Programs from the Control Panel.
  or:
- Go to the directory where you installed QNX Momentics and run _uninstall/qnx630/uninstaller.exe.
Restart your system.

In some cases, if you uninstall QNX Momentics, the Add or Remove Programs window still lists some BSPs, DDKs, and TDKs. Press F5 while in Add or Remove Programs to refresh the list and show what's actually installed.

Getting started with the docs

For information about QNX Momentics 6.3.0:

Read the Release Notes on the CD
Double-click the QNX Momentics Welcome icon on your desktop (or view ${QNX_TARGET}/etc/welcome/index.html).
See the online documentation at ${QNX_TARGET}/usr/help/product/momentics/bookset.html.

You can install and work with multiple versions of QNX Neutrino. Whether you're using the command line or the IDE, you can choose which version of the OS to build programs for. For more information, see the IDE User's Guide or the QNX Neutrino Programmer's Guide.

QNX Technical Articles