Before you install this software, note the following:

• We post CRC and MD5 checksums with the packages in the Download area on our website. If you download 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.
• There are several QNX Development License streams that govern how the QNX CAR 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 the product; that development license governs your use of the product.

  Once you've installed the QNX CAR platform, you'll find a copy of all the license agreements in base_dir/qnxcar2/install, where base_dir is where you installed the product.

  For more information about licensing, visit the Licensing area of http://www.qnx.com, where you'll find details on our licensing model, types of licenses, etc., or email mailto:licensing@qnx.com.

• For information about features and known issues in the QNX CAR platform, see the release notes. For the most up-to-date version, go to our website, http://www.qnx.com, log into your myQNX account, and then go to the Download area.

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

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

To install this product, 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. Log into your myQNX account on our website, and then go to the Download area.
4. Download the QNX CAR platform package, qnxcar-2.0-nnnnnnnnnnnn.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 this product. 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:\qnxcar-2.0-nnnnnnnnnnnn.exe -console
         

     where drive is the drive letter for your DVD 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:\qnxcar2.

   If you install the QNX CAR platform on a host with an existing installation of QNX SDP 6.5.0, the installer asks if you want to use the same QNX_CONFIGURATION directory. If you choose "Yes", the QNX CAR licenses are written to the same license file as your QNX SDP licenses, and you'll be able to use the Configuration tool or the IDE to choose which version of QNX Neutrino you want to develop applications for. Choosing "No" causes the installer to use the QNX CAR platform configuration settings. (Ref# 260840)

   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. To set up the environment, run:

   base_directory\QNXSDP-env.bat
     

   where base_directory is where you installed the software.

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

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.

base_directory\QNXSDP-env.bat
"%QNX_CONFIGURATION%/bin/qnxactivate.exe" -d "%QNX_CONFIGURATION%"

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

1. Set up your environment and run addLicense.exe by entering the following at the command prompt:

   base_directory\QNXSDP-env.bat
   base_directory\install\addLicense.exe
     

   where base_directory is where you installed this product (see "Determining your base directory," below).

2. In the QNX 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 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.

To uninstall this product, 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 CAR 2 > Uninstaller from the Start menu.

     or:

   • Choose Add or Remove Programs from the Control Panel, select "QNX CAR 2 Software Development Platform", and then click the Remove button.

     or:

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

     or:

   • Go to the directory that contains the qnxcar2 folder and run qnxcar2\install\uninstaller.exe.

If you have a command shell with the environment set up for the QNX CAR development platform, you can determine the base directory by using the qconfig command. For example:

C:\>qconfig
QNX Installations

  Installation Name: QNX CAR 2 Software Development Platform
            Version: 8.0.0
     Base Directory: C:\qnxcar2
           QNX_HOST: C:\qnxcar2\host\win32\x86
         QNX_TARGET: C:\qnxcar2\target\qnx6

The base directory in this example is C:\qnxcar2\, but it could be different on your machine, depending on where you installed the product.

If you don't have the environment set up, and you can't remember where you installed this product, search for QNXSDP-env.bat. This file is in the base directory. To set up the environment, run:

base_directory\QNXSDP-env.bat

After you've installed this product, 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. To start the IDE on Linux, use this command:

base_directory/run-qde.sh

On Windows, use the desktop icon or run:

base_directory\run-qde.bat

where base_directory is where you installed the software.

For the latest version of the documentation, see our Foundry27 site, http://community.qnx.com.

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.