Developer Resources
Board support packages
Foundry27 projects
Forums
Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Momentics® Professional Edition IDE 4.0.1 Installation Note -- Windows Hosts

QNX® Momentics® Professional Edition IDE 4.0.1

Date of this edition: April 12, 2007

Target OS: QNX® Neutrino® 6.3.0 SP1 or later

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

Note: For Windows Vista, you must use the QNX Momentics Development Suite 6.3.0 SP3 or later with QNX Momentics IDE 4.0.1 because earlier versions of QNX Momentics aren't supported on Windows Vista.

For more information about IDE 4.0.1, see the release notes, which you'll find in IDE_directory/install/ide/4.0/rel_ide_4.0.1.html after you've installed IDE 4.0.1. For the most current version of these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

Note: We're deprecating support for Windows NT; QNX Momentics 6.3.0 is the last release that you can use with this host.
Caution: If you installed an experimental version of this software, uninstall it before installing the production version.

Contents

System requirements

Host OS:

  • Windows Vista
  • Windows XP SP2
  • Windows 2000 SP4
  • Windows NT4 SP6a
Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MB 512 MB
Disk space 2.1 GB 2.1 GB
Monitor 1024*768 1280*1024

To install IDE 4.0.1, you need a minimum of 400 MB of disk space, including temporary space, used for installing the required files. About half of this disk space must be where your temporary directory resides.

The System Profiler requires a minimum color depth of 16 bits.

Note:
  • Windows NT doesn't include usp10.dll; the DLL for the Uniscribe Unicode script processor. You can download the Windows 98 version of usp10.dll from support.microsoft.com/kb/q249973.
  • Depending on the version of Windows that you're using (e.g. Windows 2000), you might need some additional libraries to support the advanced graphics (e.g. alpha blending, antialiasing, patterns and transformations) used in some perspectives and views. If you receive the following error: 
    SWTException: Unable to load graphics library

    you will need to download the GDI+ library from the following location: http://www.microsoft.com/downloads/details.aspx?FamilyID=6a63ab9c-df12-4d41-933c-be590feaa05a&DisplayLang=en. (Ref# 39915)

Installing IDE 4.0.1

Note: If you have an existing installation of IDE 4.0 on your machine, you can use the IDE Software Updates manager to update the IDE to version 4.0.1 (see "Upgrading using the IDE Software Update manager"); otherwise, you will need to follow the alternate installation instructions for a new installation (see "Performing a new installation of the IDE").

IDE 4.0.1 doesn't change any user files. For a list of the affected files, see IDE_directory/install/ide/4.0.1/shiplist after installing IDE 4.0.1. Use WordPad to view the contents of the shiplist file.

Note:
  • If you've installed QNX Momentics versions 6.2.1 and 6.3.0 so that they coexist on your Windows host, note that:
    • You can't install IDE 4.0.1 when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0. On a Windows XP system, choose Start-->All Programs-->QNX Momentics 6.3.0-->Configuration.
    • If you switch from 6.2.1 to 6.3.0, you may have to log out of your user session and log back in before installing IDE 4.0.1.
  • If you haven't set your HOME environment variable, the IDE 4.0.1 installer sets it to be the directory where you installed QNX Momentics (e.g. C:\QNX630). (Ref# 20566)
  • For Windows Vista, you must use the QNX Momentics Development Suite 6.3.0 SP3 or later with QNX Momentics IDE 4.0.1 because earlier versions of QNX Momentics aren't supported on Windows Vista.
Caution: Installing IDE 4.0.1 removes any third-party Eclipse plugins on your host. You'll have to reinstall them after installing IDE 4.0.1.

Upgrading using the IDE Software Update manager

If you have an existing installation of IDE 4.0 on your machine, use the IDE Software Updates manager to update the IDE to version 4.0.1.

To update from IDE 4.0 to 4.0.1 using the Software Updates manager:

  1. Log in as a user who has system-administrator privileges.
  2. Start the QNX Momentics IDE.
  3. Click Help-->Software Updates-->Find and install.
  4. Select Search for updates of the currently installed features.
  5. Click Finish.
  6. If prompted for an update site, click OK to select the default update site, or choose another mirror site from the list.
  7. When prompted, log into your myQNX account with a valid user name and password, and then click OK.
  8. Select QNX Momentics Update Site.

    You can expand QNX Momentics Update Site to see the selection of QNX momentics IDE 4.0.1.v20070221-LXrUHoJhrJnxRzy for installation.

  9. Click Next.
  10. Carefully review the license agreements for the update. If the terms of all these licenses are acceptable, select I accept the terms in the license agreements. Do not proceed to download the features if the license terms are not acceptable. If a feature selected for installing includes optional features, a page is displayed to let you select whether you want to continue.
  11. Click Next.
  12. Click Finish.
  13. Click Install All to allow the installation process to proceed.
  14. After the new feature and plugins are downloaded successfully, and their files are installed into the IDE on the local computer, a new configuration is formulated.
  15. Click Yes when prompted to exit, and restart the workbench for this update to take effect.

Optionally, you can install the SDK only after you've successfully installed the IDE 4.0.1 update.

To install the SDK:

  1. From within the IDE, click Help-->Software Updates-->Find and install.
  2. Select Search for new features to install.
  3. Click Next.
  4. Select QNX Momentics Update Site.
  5. Click Finish.
  6. When prompted, log into your myQNX account and click OK.
  7. Expand QNX Momentics Update Site and select Eclipse SDK Updates.
  8. Click Next.
  9. Carefully review the license agreements for the update. If the terms of all these licenses are acceptable, select I accept the terms in the license agreements. Do not proceed to download the features if the license terms are not acceptable. If a feature selected for installing includes optional features, a page is displayed to let you select whether you want to continue.
  10. Click Next.
  11. Click Finish.
  12. Click Install All to allow the installation process to proceed.
  13. Click Yes when prompted to exit and restart the workbench for this update to take effect.

Next, you will need to update qconn.

To update qconn on your development system:

  1. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu.
  2. Click OK to agree to let the IDE update qconn.

Next, you will need to determine if you need to install the optional Memory Analysis Tool Patch. For instructions about this patch, see "Updating the Memory Analysis Target Patch".

If you need to install this patch, go to the QNX Download Center (from the QNX website, click Download Center-->Products & Updates-->QNX Momentics-->QNX Momentics 6.3.x-->QNX Momentics 6.3.0 Service Pack 2 and related downloads-->QNX Momentics 6.3.0 Service Pack 2 Patches and Updates and to download the patch-630SP2-0525-malloc-g.tar. Follow the instructions in the installation notes for the Memory Analysis Target Patch (ID 525).

Performing a new installation of the IDE

Note:

If you currently have IDE 4.0 installed and you do not use the IDE Software Updates manager to update the IDE, you must first uninstall IDE 4.0 before you can install IDE 4.0.1. Close all QNX Momentics applications before you begin this process. For detailed instructions about uninstalling IDE, see "Uninstalling the IDE".

If you installed the QNX Momentics Development Suite 6.3.0 on a machine that currently has version 6.2.1, and you selected "No" when prompted to upgrade the environment variables, you won't be able to install IDE 4.0.1. (Ref# 19585)

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.

To perform a new installation of IDE 4.0.1:

  1. Log in as a user who has system-administrator privileges.
  2. Log into your myQNX account on our website, and then go to the Download Center.
  3. Download the IDE 4.0.1 package, ide-4.0.1-nnnnnnnnnnn-win32.exe, where nnnnnnnnnnn is the 11-digit build number. The package is an executable (.exe) file.
    Note: Windows might insert a number in square brackets before the first period in the filename (e.g. ide-4[0].0.1_nnnnnnnnnnn-win32.exe) These extra characters shouldn't cause any problems.
  4. Double-click the file in Windows Explorer or run it at the command line.
    Note:
    • For Windows XP, the IDE might display a security warning when you perform the installation. 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 IDE 4.0.1.

    During the installation process, you'll be prompted to install the libmalloc patch. For information about this patch, see "Updating the Memory Analysis Target Patch".

  5. Follow the instructions provided by InstallShield.
  6. Next, you will need to determine the additional patches you should install:
    • qconn Patch for IDE 4.0.1 -- the patch ID you use depends on which version of the OS you've installed: Patch ID 0486 (Core OS 6.3.2 or 6.3.2A), Patch ID 0487 (6.3.0 SP2 or 6.3.0 SP3), or Patch ID 0488 (6.3.0 SP1). You need to apply this update as described in the Installation Notes for the individual patch files.

      You can also let the QNX Software Updates installer automatically update qconn for you. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu, and click OK to let the IDE update qconn on your host.

    • After you install IDE 4.0.1 for Windows Vista configurations, you must install the QNX Command Line Tools Windows Vista Patch (Patch ID 522) prior to the initial launch of IDE 4.0.1. This patch is available for download from the QNX website, www.qnx.com.
Note:
  • To profile shared libraries and DLLs with the Application Profiler, you need to update libc on your host system, by downloading the libc Patch for IDE 4.0 (Patch ID 383) from our website and installing it on your system.
  • The first time you use the IDE, you're prompted to choose a location for your workspace. If you already have a workspace, choose a different location because the IDE 4.0.1 workspace might not be compatible with earlier versions of the IDE.
  • Windows Vista includes a new account policy, called User Account Control (UAC), that will impact various administrative features within the IDE, such as the automatic update feature. To successfully run the IDE, you must have administrator privileges. (Ref # 44027)

    To disable UAC on your Windows Vista configuration:

    1. Click Start-->Settings-->Control Panel.
    2. Under User Accounts and Family Safety, select Add or remove user accounts.
    3. Select one of the user accounts from the list. For example, Guest account.
    4. Select Go to the main User Account Page.
    5. Under Make changes to your user account, select Change security settings.
    6. For the Use User Account Control (UAC) to help protect your computer option, clear this checkbox so that it is not selected.
    7. Reboot your computer to make these changes take effect.

Updating the Memory Analysis Target Patch

Before installing this patch, you need to determine the patch number of the Memory Analysis Target Patch that you have currently installed on your system.

To verify if you should install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525) on your system:

  1. Run bash.
  2. Navigate to the location base_dir/patches.
  3. Run the following command:

    ls */rel*libmalloc_g*.html

    If the command returns the message "No such file or directory", install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525).

    If the command returns one or more files, each file will have the following format:

    630<version>-<number>/rel_libmalloc_g_patch<number>.html

    where:

    • version is the product version identifier assigned to the patch
    • number is the identifier assigned to the patch

    If you have only files in which the number is less than 0525, then you should install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525). Otherwise, if the number is greater than 0525, and the patch with that number has been applied on your system, then you should not install patch 0525.

Installing the qconn update

After you've installed IDE 4.0.1, you may need to update qconn on your target systems to take advantage of the new features. IDE 4.0.1 will work with older versions of qconn, but not all features will be available.

Note: Only users with system administrator privileges can perform updates to qconn.

To update qconn on your development system:

  1. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu.
  2. Agree to let the IDE update qconn on your host.

You then need to update the version of qconn on your target machine. How you do this depends on your target system; you might have to build a new image, or you might simply have to copy the new version to your target. For example:

  1. Use slay qconn on the target to stop any existing qconn.
  2. Copy $QNX_TARGET/target/usr/sbin/qconn to your target system's /usr/sbin directory.
  3. Make sure the qconn in the target's /usr/sbin directory is executable; if it isn't, use chmod +x to make it executable.
  4. On the target, launch the new qconn.

Uninstalling the IDE

Note:

Before you can uninstall QNX Momentics completely, you must uninstall the qconn update (if previously installed), followed by the IDE, and then any BSPs, DDKs, TDKs, or other products.

If you uninstall IDE 4.0.1, you will need to manually delete two folders before you can reinstall the IDE. For more information about deleting these folders, see Ref# 46061 in the section "Known issues: Windows-hosted IDE" in the Release Notes.

Caution: Use our uninstaller to remove the IDE; if you attempt to delete the directories, your machine might become in an inconsistent state, and you may not be able to run the IDE.

To uninstall the IDE, do the following:

  1. Log in as a user who has system-administrator privileges.
  2. If you have the qconn update installed, you will need to uninstall it:
    1. Start the QNX Momentics IDE.
    2. Select Help-->Software Updates-->Qconn Updates.
    3. Click OK when you are prompted to uninstall qconn.
    4. Close the QNX Momentics IDE.
  3. To continue with uninstalling the QNX Momentics IDE, open the Control Panel (e.g. on Windows XP, choose Start-->Settings-->Control Panel).
  4. Select Add or Remove Programs.
  5. Select "QNX Momentics Professional Edition IDE 4.0.1," then click the Remove button. The uninstaller removes the IDE and also restores qconn and the malloc libraries.

How can I tell if I've already installed IDE 4.0.1?

To determine whether or not you've installed IDE 4.0.1:
Run the qconfig command and look for IDE 4.0.1 in the output.

To see what qconfig's output looks like, see the "Determining your base directory," section 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 Service Pack 3
            Version: 6.3.0 SP3
     Base Directory: C:/QNX630
           QNX_HOST: C:/QNX630/host/win32/x86
         QNX_TARGET: C:/QNX630/target/qnx6

Additional Packages

	  Package Name: QNX Momentics Professional Edition IDE
	       Version: 4.0.1
	          Base: QNX Momentics 6.3.0 SP1, SP2 or SP3
	  Install Path: C:/Program Files/QNX Software Systems/Momentics/IDE4

	  Package Name: QNX Neutrino Core OS
	       Version: 6.3.2
	          Base: QNX Momentics 6.3.0 SP1, SP2 or SP3
	  Install Path: C:/QNX630

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

Getting started with the documentation

After you've installed your development suite, you'll find an extensive set of online documentation in HTML format. In the IDE, choose Help-->Help Contents, and then click on QNX Momentics Professional Edition.

You might want to start with A Roadmap to the QNX Momentics Professional Edition. This "roadmap" page contains links to the various HTML booksets that accompany the OS (e.g. System Architecture, Programmer's Guide, Library Reference, Utilities Reference, etc.).

Note: This package doesn't update the QNX Momentics documentation outside the IDE (i.e. the version in ${QNX_TARGET}/usr/help/product).

You'll find the installation and release notes in the IDE_directory/install/ide/4.0.1 directory, where IDE_directory is the directory where you installed the IDE (for example, on Windows, the default is C:\Program Files\QNX Software Systems\Momentics\IDE4).

Note: For the most current version of these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

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.

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.