Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX CAR™ platform 2.0 Reference Release: Installation Note -- Linux Hosts

QNX CAR platform 2.0 Reference Release: Installation Note -- Linux Hosts

Electronic edition published: Thursday,  January  3,  2013

Host OS: You can install this package on Linux Red Hat Enterprise Linux 5.4 Desktop 32- and 64-bit, or Ubuntu Workstation 12.10 32- and 64-bit.

The QNX CAR platform 2.0 RR includes the following:

  • QNX CAR application platform 2.0 RR: runtime components
  • QNX CAR development platform 2.0 RR: compiler, linker, libraries, an Integrated Development Environment (IDE), and other tools

You use the QNX CAR development platform to develop automotive infotainment systems to run on the QNX CAR application platform.

Note: If you've already installed an evaluation version of this product, and you've purchased and received a commercial QNX license or you've received an evaluation extension license, see "Commercializing your evaluation software," below.

Before you start

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.
  • If you're running selinux (secure Linux), disable it before installing this product. Otherwise, after you've entered the license key and clicked Next, the installation will fail with this error:
    java.lang.UnsatisfiedLinkError: no qnxlic in java.library.path
    
  • In order to run the installer and the IDE on Ubuntu 64-bit, you need to install the 32-bit libraries:
    sudo apt-get install ia32-libs
      

    Answer yes to all the questions. (Ref# 70567)

  • 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 typing:
    chmod a+rw /etc/qnx/license/licenses
      

    (Ref# 62419)

System requirements

Host OS:

  • Linux Red Hat Enterprise Linux 5.4 Desktop 32- and 64-bit
  • Ubuntu Workstation 12.10 32- and 64-bit
  Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MB 512 MB
Disk space 2.2 GB 3.1 GB
Monitor 1024×768 1280×1024

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

Installing this product

To install this product, do the following:

  1. Boot into Linux and log in as root, or as a user with administrative privileges on Ubuntu.
  2. Log into your myQNX account on our website, and then go to the Download area.
  3. Download the QNX CAR platform package, qnxcar-2.0-nnnnnnnnnnnn.bin, where nnnnnnnnnnnn is a build number. The package is a .bin script.
  4. Verify that the checksum of the package matches the one given in the Download area.
  5. Go to the directory where you downloaded the script.
  6. Run chmod to make the script executable. For example:
    chmod a+x qnxcar-2.0-20131234567.bin
    
  7. Run the script at the system prompt:
    • If you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment. For example:
      sudo -E ./qnxcar-2.0-20131234567.bin
          
    • On other Linux hosts, type (for example):
      ./qnxcar-2.0-20131234567.bin
          
  8. Follow the instructions on your screen. We recommend you use the default location for the software, /opt/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 license file in the location identified by QNX_CONFIGURATION, 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.

  9. To set up the environment in your current shell, run:
    source base_directory/QNXSDP-env.sh
      

    where base_directory is where you installed the software.

Activating this product

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: On some distributions, the activation dialog doesn't appear automatically. (Ref# 68599)

Workaround: Set up the environment and then start the activation program manually:

source base_directory/QNXSDP-env.sh
$QNX_CONFIGURATION/bin/qnxactivate –d $QNX_CONFIGURATION
  

where base_directory is where you installed the software.

Activating automatically

If your development host is connected to the Internet, you can activate this product 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 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, /etc/qnx/license/activate_prompt_key.txt. 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, http://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 /etc/qnx/license/activate_response_key.txt on your Linux development host.
  7. If you closed the QNX Activation dialog, set up the environment and then open it again by entering the following at a terminal prompt:
    source base_directory/QNXSDP-env.sh
    $QNX_CONFIGURATION/bin/qnxactivate -a
      

    where base_directory is where you installed the software.

  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 setting up the environment and running qnxactivate as described above.

Commercializing your evaluation software

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. Type the following at a terminal prompt:
    source base_directory/QNXSDP-env.sh
    base_directory/install/addLicense.bin
      

    where base_directory is where you installed the 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.

Uninstalling this product

Note:
  • You should uninstall QNX products in the reverse order in which you installed them. To determine this order, use a command like this:
    ls -lt `find base_directory -name "*uninstall*"`
    

    where base_directory is where you installed the software.

  • If you earlier installed the QNX Software Development Platform and you used the same QNX_CONFIGURATION directory when you installed the QNX CAR platform, and you then uninstall QNX SDP, its uninstaller removes that directory, including the licenses, licensing binaries, and so on for the QNX CAR platform. (Ref# 264895)

    Workaround: Don't uninstall QNX SDP while the QNX CAR platform is still installed, or back up the directory identified by QNX_CONFIGURATION, uninstall QNX SDP, and then restore the directory.

To uninstall this product, do the following:

  1. Boot into Linux and log in as root, or as a user with administrative privileges on Ubuntu.
  2. Go to a directory outside the base_dir directory (see "Determining your base directory," below) and run the uninstaller:
    • If you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment:
      sudo -E base_dir/qnxcar2/install/uninstaller
          
    • On other Linux hosts, type:
      base_dir/qnxcar2/install/uninstaller
          

Determining your base directory

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:

$ qconfig
QNX Installations

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

The base directory in this example is /opt/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, run the following command (with sudo on systems such as Ubuntu):

find / -name "QNXSDP-env.sh"

This file is in the base directory. To set up the environment for your current shell, run:

source base_directory/QNXSDP-env.sh

Getting started with the documentation

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.

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.