Microsoft Windows Hosts

This chapter includes the following:


Note: If you've already installed an evaluation version of QNX SDP 6.5.0, and you've purchased and received a commercial QNX license, please go to Commercializing your evaluation software,” below.

System requirements

Host OS:

Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MBa 512 MBa
Disk space 2.5 GBa 3.4 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


Note: 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)

To install QNX SDP 6.5.0, do the following:

  1. Boot into Windows and 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. Insert the QNX Software Development Platform 6.5.0 Installation DVD in the DVD drive. The installation should start automatically; if it doesn't, double-click qnxsdp-6.5.0-nnnnnnnnnnnn-win32.exe (where nnnnnnnnnnnn is a build number), which you'll find in the root directory of the disk.

    Note: 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-nnnnnnnnnnnn-win32.exe -console
    
    

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


  4. Follow the instructions provided by InstallShield. We recommend you use the default location for the software, C:\QNX650.

    The installer will also 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.

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

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


Note: 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)

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.

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 the 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. This can eliminate 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.

Important notes

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


Note: 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:
  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.

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.