QNX Technical Articles
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.
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:
- Boot into Linux and log in as root, or as a user with administrative privileges on Ubuntu.
- Log into your myQNX account on our website, and then go to the Download area.
- Download the QNX CAR platform package, qnxcar-2.0-nnnnnnnnnnnn.bin, where nnnnnnnnnnnn is a build number. The package is a .bin script.
- Verify that the checksum of the package matches the one given in the Download area.
- Go to the directory where you downloaded the script.
- Run chmod to make the script executable. For example:
chmod a+x qnxcar-2.0-20131234567.bin
- 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
- If you use sudo (as would be the case on Ubuntu),
you must specify the -E option to preserve the environment.
For example:
- 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.
- 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.
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:
- 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.
- Transfer the activate-prompt key to the machine that's connected to the Internet.
- Go to our website, http://www.qnx.com/, log into your myQNX account, and choose Manual Product Activation.
- Enter the activate-prompt key into the form that appears, and then click Generate Response Key. This will return an activate-response key.
- Copy the activate-response key and paste it in a file.
- Transfer the file into /etc/qnx/license/activate_response_key.txt on your Linux development host.
- 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.
- 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
- 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).
- In the QNX License Key Entry dialog, fill in the field with the license-key information.
- When you've finished entering the information, click Add to save the license-key information and configure your QNX tools to use this file.
- 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
-
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:
- Boot into Linux and log in as root, or as a user with administrative privileges on Ubuntu.
- 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
- If you use sudo (as would be the case on Ubuntu),
you must specify the -E option to preserve the environment:
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.