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

QNX Technical Articles

QNX® Software Development Platform for x86 Targets 6.5.0: Installation Note — Windows Hosts

QNX® Software Development Platform for x86 Targets 6.5.0: Installation Note — Windows Hosts

Date of this edition: October 10, 2012

Target OS: This development suite produces software that's compatible with x86 targets that are running QNX® Neutrino® 6.5.0.

Host OS: You can install this package on Microsoft Windows 7 Professional 32- and 64-bit, Vista Business 32- and 64-bit, XP Professional SP3, or 2000 SP4.

Caution: If you downloaded QNX SDP 6.5.0 from our website between June 28, 2010 and July 12, 2010, please read the following:

Build 201006230248 of 6.5.0 contained a filesystem error. If you installed that version, uninstall it, and then install build 201007091524. To determine which version you have, check the build number in the archive name or in base_dir/install/qnxsdp/6.5.0/version. On self-hosted QNX Neutrino systems, you can also use the uname -v command to get a version timestamp that identifies the build:

Build Timestamp
201006230248 2010/06/23-02:11:33EDT
201007091524 2010/07/09-14:44:03EDT
Note:
  • This is a special version of QNX SDP that's for x86 targets only. If you want to develop for other targets, install the full QNX Software Development Platform 6.5.0. You can't upgrade the x86 development suite into the full version.
  • If you've already installed an evaluation version of QNX SDP 6.5.0, and you've purchased and received a commercial QNX license or you've received an evaluation extension license, please go to “Commercializing your evaluation software,” below.

Contents

Licensing

QNX SDP 6.5.0 introduces a new licensing scheme:

  • There are several QNX Development License streams that govern how the QNX Software Development Platform can be used in different situations. The key on your license certificate will cause the appropriate license agreement to be displayed when you install QNX SDP; that development license governs your use of the product.
  • 6.5.0 doesn't accept license keys from earlier versions of QNX SDP.
  • If you have a support plan for an earlier version of QNX SDP, you can get a license key for 6.5.0 from our website; go to http://www.qnx.com, log into your myQNX account, and click Upgrade to QNX SDP 6.5.
  • Some licensing is now for a specific user. If your license key indicates that you have a “named user” license, the activation requires that you provide an email address.

Once you've installed the QNX Software Development Platform, you can find all the license agreements in base_dir/install/qnxsdp/6.5.0, where base_dir is where you installed SDP (see the output from the qconfig command).

For more information about license agreements, see the Licensing area of http://www.qnx.com, or email .

Before you start

Before you install this software, please note the following:

  • You must have already installed QNX SDP 6.5.0.
  • It isn't possible to uninstall just QNX SDP 6.5.0 SP1; if you uninstall it, you'll completely uninstall QNX SDP 6.5.0.
  • On Linux and Windows hosts, QNX SDP includes the QNX Momentics Tool Suite, which you can use to develop applications to run on the QNX Neutrino RTOS on a separate target system.
  • QNX SDP for self-hosted QNX Neutrino systems includes the QNX Neutrino RTOS and the QNX Momentics Tool Suite.
  • QNX SDP includes everything you need to build for all supported target platforms (ARM, MIPS, PowerPC, SH-4, and x86). There are also special versions of QNX SDP for x86 targets only.
  • Don't install the x86-only version of 6.5.0 SP1 on the full version of 6.5.0, or the full version of SP1 on the x86-only version of 6.5.0, or else you'll end up with an inconsistent set of software.
  • We post CRC and MD5 checksums with the packages in the Download area on our website. If you download a CD or DVD image or an installer from our website, make sure that its checksum matches that given on the website. On Unix-style OSs (e.g. QNX Neutrino, Linux), you can use the cksum utility to calculate the CRC checksum. Microsoft doesn't support such utilities on Windows, but they're available from third parties.
  • QNX SDP 6.5.0 can coexist with QNX SDP 6.4.0, 6.4.1, and QNX Momentics 6.3, but if you want 6.5.0 to replace 6.4.1, 6.4.0, or 6.3, you must uninstall the older versions and any updates to them before installing 6.5.0.

    Coexistence with QNX Momentics 6.2.1 is supported only on Windows hosts (we didn't support Linux hosts in 6.2.1).

  • For information about new features and known issues in QNX SDP, see the release notes. The online documentation includes a copy, but for for the most up-to-date version, go to our website, www.qnx.com, log into your myQNX account, and then go to Downloads-->QNX Software Development Platform 6.5.x.
  • For information about using BSPs with QNX SDP 6.5.0, see the BSP Migration Guide in the BSPs and Drivers project on Foundry27.
  • Because of some hard-coded paths, don't install QNX SDP on a disk other than C:.
  • In order to install QNX SDP, the QNX license file must be writable by everyone. If the installer stops and warns you that this file isn't writable, you can make it so by right-clicking on C:\Program Files\QNX Software Systems\license and choosing Properties. Make sure that the “Read-only” attribute isn't checked, click Apply, and then click OK. (Ref# 62419)
  • After you install 6.5.0 SP1, your system's start menu includes folders for QNX Software Development Platform 6.5.0 and QNX Software Development Platform 6.5.0 SP1. Use the 6.5.0 folder for starting the IDE, license management, and so on; use the 6.5.0 SP1 folder for starting the uninstaller.
  • We provide the Korn shell (ksh.exe), which you'll find under ${QNX_HOST}/usr/bin (e.g. C:\QNX650\host\win32\x86\usr\bin). You may want to create desktop shortcuts for the executables you'll use often.
  • 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)
  • If you install 6.5.0, and you then install 6.3.2, you need to move the cleanup utility QNXWinCleanup.exe from $QNX_HOST to C:\WINDOWS. (Ref# 56879)

System requirements

Host OS:

  • Windows 7
  • Windows Vista
  • Windows Vista 64-bit
  • Windows XP SP2 or SP3
  • Windows 2000 SP4
Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MBa 512 MBa
Disk space 1.3 GBa 1.3 GBa
Monitor 1024×768 1280×1024

a Windows Vista requires an additional 512 MB of available RAM and disk space.

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

Installing QNX SDP

To install this software:

  1. Boot into Windows and log in as the system administrator.
  2. If you're using Windows Vista or Windows 7, disable User Account Control (UAC). (Ref# 77791).
  3. Log into your myQNX account on our website, and then go to the Download area.
  4. Download the QNX SDP 6.5.0 package, qnxsdp-6.5.0-x86-nnnnnnnnnnnn-win32.exe, where nnnnnnnnnnnn is a build number. The package is an executable (.exe) file.

    Windows might insert a number in square brackets before the first period in the filename, but these extra characters shouldn't cause any problems.

  5. Verify that the checksum of the package matches the one given in the Download area.
  6. Double-click the installer file in Windows Explorer or run it at the command line.
    Note:
    • Windows XP may display a security warning when you install QNX SDP. You can verify the archive's checksum when you download the file from our website.
    • 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:\qnxsdp-6.5.0-x86-nnnnnnnnnnnn-win32.exe -console

      where drive is the drive letter for your CD drive, and nnnnnnnnnnnn is the appropriate build number.

  7. Follow the instructions on your screen. We recommend you use the default location for the software, C:\QNX650.

    The installer will ask if you wish to install a package of GNU Public License programs, such as tar and sed. We recommend that you do so for development machines.

    If QNX Software Systems has a contract with you to support server-based licenses (Automated License Management), you have a special license key that tells the software to enforce these licenses. In this case, the installer presents a panel where you can specify the hostname or IP address of the server, and the port on which the server is listening for connections. If you're using the default port, you can leave the port blank.

  8. Log out and back in again, so that the environment is set up correctly.

Your desktop should now include an icon for starting the QNX Momentics IDE.

Activating QNX SDP

The QNX Momentics Tool Suite and certain related products require activation. 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 your license key indicates that you have a “named user” license, the activation requires that you provide an email address.

Note: If you install QNX SDP using a third-party windows explorer (e.g. Total Commander), the installer doesn't display the Activation window once the installation is complete. (Ref# 59359)

Workaround: Open the QNX SDP Activation dialog by selecting Programs-->QNX Software Development Platform 6.5.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

Activating automatically

If your development host is connected to the Internet, you can activate QNX SDP automatically.

Activating manually

If your machine isn't connected to the Internet, you must activate your software manually from a machine that is, by doing the following:

  1. In the QNX SDP Activation dialog, click Activate Manually.

    The Manual Activation dialog appears with an activate-prompt key. This dialog has a button that you can use to save the activate-prompt key in a file, drive:\Program Files\QNX Software Systems\license\activate_prompt_key.txt, where drive is the name of the drive where you installed QNX SDP. Using this file eliminates the need to retype the key, which can be error-prone.

  2. Transfer the activate-prompt key to the machine that's connected to the Internet.
  3. Go to our website, www.qnx.com, log into your myQNX account, and choose Manual Product Activation.
  4. Enter the activate-prompt key into the form that appears, and then click Generate Response Key. This will return an activate-response key.
  5. Copy the activate-response key and paste it in a file.
  6. Transfer the file into drive:\Program Files\QNX Software Systems\license\activate_response_key.txt on your QNX SDP development host.
  7. If you closed the QNX SDP Activation dialog, open it again by selecting Programs-->QNX Software Development Platform 6.5.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
  8. Choose Activate Manually, and use the Load Response from File button to load the activate-response key, and then click Activate.

If you choose not to activate at the time of installation, you can activate later by selecting Programs-->QNX Software Development Platform 6.5.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 SDP.

Commercializing your evaluation software

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

  1. Choose Programs-->QNX Software Development Platform 6.5.0-->License Management-->Add License from the Start menu, or enter the following at the command prompt:

    base_directory\install\qnxsdp\6.5.0\AddLicense.exe

    where base_directory is where you installed QNX SDP (see “Determining your base directory,” below).

  2. In the QNX SDP License Key Entry dialog, fill in the field with the license-key information.
  3. When you've finished entering the information, click Add to save the license-key information and configure your QNX SDP tools to use this file.
  4. After entering the license key, you'll be presented with the appropriate license agreement. You'll need to accept it in order to successfully add a license.

Uninstalling QNX SDP 6.5.0 and SP1

Note:
  • It isn't possible to uninstall just QNX SDP 6.5.0 SP1; if you uninstall it, you'll completely uninstall QNX SDP 6.5.0.
  • Use the 6.5.0 SP1 uninstaller, not the one for 6.5.0.
  • You should uninstall QNX products in the reverse order in which you installed them. To determine this order, open a bash shell and use a command like this:

    ls -lt `$QNX_HOST/usr/bin/find base_directory -name "*uninstall*.exe"`

    where base_directory is where you installed the QNX Software Development Platform.

To uninstall QNX SDP, do the following:

  1. Log in as a user with system-administrator privileges.
  2. If you're using Windows Vista or Windows 7, disable User Account Control (UAC). (Ref# 77791).
  3. Do one of the following:
    • Choose Programs-->QNX Software Development Platform 6.5.0SP1-->Uninstall QNX Software Development Platform 6.5.0SP1 from the Start menu.

      or:

    • Choose Add or Remove Programs from the Control Panel, select “QNX Software Development Platform 6.5.0SP1”, and then click the Remove button.

      or:

    • On Windows Vista or Windows 7, choose Programs and Features, select “QNX Software Development Platform 6.5.0SP1”, and then click Uninstall/Change.

      or:

    • Go to the directory that contains the QNX650 folder and run QNX650\_uninstall\qnxsdp\6.5.0SP1\uninstaller.exe.
  4. When prompted, restart your machine.
    Caution: When you uninstall QNX SDP, Windows schedules the uninstaller for removal the next time you restart your system. If you don't restart your system, and you reinstall QNX SDP, its uninstaller will be removed the next time you restart your system. (Ref# 62183)
Note:
  • In some cases, if you uninstall QNX SDP, the Add or Remove Programs window still lists some BSPs and DDKs. Press F5 while in Add or Remove Programs to refresh the list and show what's actually installed.
  • If the uninstaller doesn't fully remove all the components, you can use the QNXWinCleanup utility to clean up your machine. You can find this utility and documentation for it in the Utilities directory on the DVD, or on our website.
  • If you have other versions of QNX SDP installed, you need to explicitly choose which version of it that you want to use after you uninstall 6.5.0 SP1.

Determining your base directory

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

C:\>qconfig
QNX Installations

  Installation Name: QNX Software Development Platform 6.5.0
            Version: 6.5.0
     Base Directory: C:/QNX650/
           QNX_HOST: C:/QNX650/host/win32/x86/
         QNX_TARGET: C:/QNX650/target/qnx6/

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

Getting started with the documentation

After you've installed QNX SDP, you'll find an extensive set of HTML documentation:

  • On Linux and Windows development hosts, you can read it in the Integrated Development Environment's help system. On Linux, use the qde command to start the IDE; on Windows, use the desktop icon.
  • On self-hosted QNX Neutrino systems, you can read it in the Photon helpviewer, or you can use a web browser to display:

    ${QNX_TARGET}/usr/help/product/momentics/bookset.html

The “roadmap” page contains links to the various HTML booksets that accompany the OS. We recommend that you start with Welcome to the QNX Software Development Platform for an overview of QNX SDP. Next, see 10 Steps to Developing a QNX Program: Quickstart Guide for a short tutorial that will help you get started, and then refer to the other documents (System Architecture, QNX Neutrino Programmer's Guide, Library Reference, Utilities Reference, and so on).

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

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.

For questions about installing and using QNX SDP, see the QNX Momentics Getting Started forum on our Foundry27 site, http://community.qnx.com. There are other forums for specific topics, including the QNX Neutrino RTOS, development tools, networking, Board Support Packages, and so on.