Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

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

QNX® Momentics® Development Suite 6.3.0 SP1

Date of this edition: April 16, 2007

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4, or NT SP6a

You must install QNX Momentics 6.3.0 before installing Service Pack 1.
For more information about Service Pack 1, see the release notes, which you'll find in ${QNX_TARGET}\etc\readme\patches\6.3.0sp1\rel_6.3.0_SP1.html after you've installed SP1.
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.
As mentioned in the installation note for QNX Momentics 6.3.0, we've deprecated support for Windows NT hosts. QNX Momentics 6.3.0 is the last release that you can install on Windows NT.

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.

System requirements
Related products
Installation procedure
Uninstalling SP1
How can I tell if I've already installed SP1?
Determining your base directory
Getting started with the docs
Technical support

System requirements

SP1 requires 990 MB of disk space, which includes the space required for backups and temporary space used in installing the files. SP1 won't take up this much space once it's installed, because it replaces some existing files.

Installation procedure

The SP1 installer backs up the affected files, and it stores the backup in the base_directory\install\backup\patches\6.3.0sp1 directory (see "Determining your base directory," below). The backup files are:

backup.jar: Software files.
backupDoc.zip: Documentation.

If you interrupt the backup, or it fails, the installation is aborted. Before you can try again to install SP1, you must delete these directories:

base_directory\install\backup\patches\6.3.0sp1
base_directory\install\patches\6.3.0sp1

SP1 doesn't change any user files. For a list of the affected files, see the shiplist file in each directory under $QNX_TARGET\install after installing SP1. Use WordPad to view the shiplist file.

Service Pack 1 updates all of the components of QNX Momentics that you've installed.
If you chose not to install all components of QNX Momentics, and you install this service pack, then if you later decide to install additional components, you must uninstall SP1 first. Similarly, if you install the Standard Edition and then install SP1, if you want to upgrade to the Professional Edition, you must uninstall SP1 first.
If you use the IDE, back up the .metadata directory on your system before you install SP1. It's typically base_directory\workspace\.metadata (see "Determining your base directory," below). You'll need this backup if you later decide to uninstall SP1.
Close all QNX Momentics applications before you install SP1.
If you haven't set your HOME environment variable, the SP1 installer sets it to be the directory where you installed QNX Momentics (e.g. C:\QNX630). (Ref# 20566)

To install SP1, do the following:

If you installed 6.3.0 on a machine that already had 6.2.1, and you selected "No" when prompted about upgrading the environment variables, you won't be able to install SP1. (Ref# 19585)

Workaround: Do the following:

Open %PROGRAMFILES%\QNX Software Systems\qconfig\qnx_momentics_6.3.0.xml in a text editor.
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>.
From the Start menu, choose All programs or Programs, then choose QNX Momentics 6.3.0-->Configuration.
Switch your configuration either from 6.2.1 to 6.3.0, or from 6.3.0 to 6.2.1. Click OK.
Repeat steps 3 and 4 to make sure that the environment is set correctly.
Repeat steps 3 and 4 to set the configuration to be 6.3.0 (if it wasn't already).
If you find that the above steps don't make a difference, then log out and in again.

Log in as a user who has system-administrator privileges.
Log into your myQNX account on our website, and then go to the Download Center.
Download the SP1 package, 6.3.0sp1-win32-nnnnnnnnnnn.exe, where nnnnnnnnnnn is the 11-digit build number. The package is an executable (.exe) file.

Windows might insert a number in square brackets before the first period in the filename (e.g. 6[1].0sp1-win32-nnnnnnnnnnn.exe) These extra characters shouldn't cause any problems.

Double-click the file in Windows Explorer or run it at the command line.

Windows XP SP2 may display a security warning when you install SP1. You can verify the archive's checksum when you download the file from our website.
If InstallShield complains that it can't find a JVM, make sure that you've successfully installed QNX Momentics 6.3.0 before you try to install QNX Momentics 6.3.0 SP1.

Follow the instructions provided by InstallShield.

Uninstalling SP1

If you want to uninstall QNX Momentics completely, uninstall SP1 and any BSPs, DDKs, TDKs, or other products before you uninstall QNX Momentics itself.

If you delete or rename the backup that was made when you installed SP1, or if the backup has been corrupted, the uninstaller will warn you. Continuing to uninstall SP1 will leave your system with an incomplete version of QNX Momentics 6.3.0, and you won't be able to reinstall SP1; you'll likely have to completely reinstall QNX Momentics 6.3.0.

To uninstall SP1, do the following:

Log in as a user who has system-administrator privileges.
Open the Control Panel (e.g. on Windows 2000, choose Start-->Settings-->Control Panel).
Select Add or Remove Programs.
Select "QNX Momentics Development Suite 6.3.0 Service Pack 1," then click the Remove button.
If you use the IDE, restore the .metadata directory on your machine from the backup that you made before you installed SP1. You'll need to reimport any projects that you created in the IDE since you installed SP1.

How can I tell if I've already installed SP1?

To determine whether or not you've installed SP1, either:

Look for "QNX Momentics Development Suite 6.3.0 Service Pack 1" in the Add or Remove Programs control panel.
Or:
Check for the existence of the base_directory\install\patches\6.3.0sp1 directory (see "Determining your base directory," below).

Determining your base directory

To determine the base directory for QNX Momentics, open a command shell and use the qconfig command. For example:

C:\>qconfig
QNX Installations

  Installation Name: QNX Momentics 6.3.0
            Version: 6.3.0
     Base Directory: C:/QNX630/
           QNX_HOST: C:/QNX630/host/qnx6/x86/
         QNX_TARGET: C:/QNX630/target/qnx6/

The base directory in this example is C:/QNX630/, but it could be different on your machine, depending on your host OS and where you installed QNX Momentics.

Getting started with the docs

For information about QNX Momentics 6.3.0, see:

the Release Notes in the Download area of our website
the Welcome message at ${QNX_TARGET}\etc\welcome\index.html
the online documentation at ${QNX_TARGET}\usr\help\product\momentics\bookset.html.

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.