QNX® Software Development Platform 6.4.0: Installation Note — Windows Hosts

Date of this edition: July 06, 2009

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

Host OS: You can install this package on Microsoft Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4.

Contents

• System requirements
• Installing QNX SDP 6.4.0
• Activating QNX SDP 6.4.0
• Important notes
• Commercializing your evaluation software
• Uninstalling QNX SDP 6.4.0
• Determining your base directory
• Getting started with the docs
• Technical support

System requirements

Host OS:

• 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	2.1 GBa	2.1 GBa
Monitor	1024×768	1280×1024

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

In order to install 6.4.0, you need 1500 MB of disk space, including the space required for backups and temporary space used in installing the files. About half of this disk space must be where your temporary directory resides.

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

Installing QNX SDP 6.4.0

To install this software:

1. Boot into Windows and log in as the system administrator.
2. Log into your myQNX account on our website, and then go to the Download area.
3. Download the the QNX SDP 6.4.0 package, qnxsdp-6.4.0-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 (e.g. qnxsdp-6[1].4.0-20083081248-win32.exe) These extra characters shouldn't cause any problems.

   ---

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

   ---

   Windows XP may display a security warning when you install QNX SDP 6.4.0. You can verify the archive's checksum when you download the file from our website.

   ---

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

   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, 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.

6. Log out and back in again. (Ref# 39631)

Congratulations — you've completed the installation! Your desktop should now include an icon for starting the QNX Momentics IDE. You'll find a copy of the license agreements in base_dir/install/qnxsdp/6.4.0, where base_dir is where you installed SDP (see “Determining your base directory,” below).

Activating QNX SDP 6.4.0

QNX SDP 6.4.0 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 development host is connected to the Internet, you can activate QNX SDP 6.4.0 automatically; 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 6.4.0. 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 Activate Products (6.3.x).
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.4.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.4.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 6.4.0.

Important notes

• We provide the Korn shell (ksh.exe), which you'll find under ${QNX_HOST}/usr/bin (e.g. C:\QNX640\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)

Commercializing your evaluation software

If you installed an evaluation copy of QNX SDP 6.4.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.4.0-->License Management-->Add License from the Start menu, or enter the following at the command prompt:

   base_directory\install\qnxsdp\6.4.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 Momentics 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.4.0

To uninstall QNX SDP 6.4.0, do the following:

1. Log in as the system administrator.
2. Do one of the following:
   • Choose Programs-->QNX Software Development Platform 6.4.0-->Uninstall QNX Software Development Platform 6.4.0 from the Start menu.

     or:

   • Choose Add or Remove Programs from the Control Panel.

     or:

   • On Windows Vista, choose Programs and Features, select QNX Software Development Platform 6.4.0, and then click Uninstall/Change.

     or:

   • Go to the directory where you installed QNX SDP 6.4.0 and run _uninstall/qnxsdp/6.4.0/uninstaller.exe.
3. Restart your machine.

   ---

   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)

   ---

Determining your base directory

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

C:\>qconfig
QNX Installations

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

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

Getting started with the docs

After you've installed QNX SDP 6.4.0, 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 (e.g. System Architecture, QNX Neutrino Programmer's Guide, Library Reference, Utilities Reference, etc.).

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.