Linux Hosts

This chapter includes the following:

Before you start
System requirements
Installing QNX SDP
Activating QNX SDP
Commercializing your evaluation software
Uninstalling QNX SDP
Determining your base directory

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

Before you start

If you're running selinux (secure Linux), disable it before installing QNX SDP. 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 libgtk2.0-0:i386 libXtst6:i386 libcanberra-gtk-module:i386 \
gtk2-engines-murrine:i386 libdbus-glib-1-2:i386
  
```
Answer yes to all the questions. (Ref# 70567, J237671)
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 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
Red Hat Fedora 12
Ubuntu Workstation 9.10, 11.04, and 12.04 32- and 64-bit
openSUSE 11.2

	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.

QNX SDP 6.5.0 SP1 requires 250 MB of disk space; the version for x86 targets requires 140 MB.

Installing QNX SDP 6.5.0 SP1

If you just installed QNX SDP 6.5.0, be sure to log out and back in again before you install Service Pack 1. If you don't, the environment won't be set up properly, and some files might not be installed properly.

To install QNX SDP 6.5.0 SP1, do the following:

Boot into Linux and log in as root, or as a user with administrative privileges on Ubuntu.
Log in to your myQNX account on our website, and then go to the Download area.
Download the QNX SDP 6.5.0 SP1 package, qnxsdp-6.5.0SP1-nnnnnnnnnnnn-linux.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.
Run chmod to make the script executable. For example:
```
chmod a+x qnxsdp-6.5.0SP1-20121234567-linux.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 ./qnxsdp-6.5.0SP1-20121234567-linux.bin
    
```
- On other Linux hosts, type (for example):
```
./qnxsdp-6.5.0SP1-20121234567-linux.bin
    
```
Follow the instructions on your screen.
Log out and log back in again, so that the environment is set up correctly.

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.

On some distributions, the activation dialog doesn't appear automatically. (Ref# 68599)

Workaround: Log out and back in again, and then start the activation program manually:

/etc/qnx/bin/qnxactivate -a

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:

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, /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, www.qnx.com, log in to 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 QNX SDP development host.
If you closed the QNX SDP Activation dialog, open it again by entering the following at a terminal prompt:
```
/etc/qnx/bin/qnxactivate -a
  
```
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 entering the following at a terminal prompt:

/etc/qnx/bin/qnxactivate -a

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:

Type the following at a terminal prompt:
base_directory/install/qnxsdp/6.5.0/AddLicense.bin
where base_directory is where you installed QNX SDP (see “Determining your base directory,” below).
In the QNX SDP 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 SDP 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 QNX SDP 6.5.0 and SP1

It isn't possible to uninstall just QNX SDP 6.5.0 SP1; if you uninstall it, you'll completely uninstall QNX SDP 6.5.0.
Use the 6.5.0 SP1 uninstaller, not the one for 6.5.0.
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*.bin"`
where base_directory is where you installed the QNX Software Development Platform.

To uninstall QNX SDP, 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/_uninstall/qnxsdp/6.5.0SP1/uninstaller.bin
- On other Linux hosts, type:
  base_dir/_uninstall/qnxsdp/6.5.0SP1/uninstaller.bin
The command-line prompt doesn't return after a successful uninstallation. (Ref# 161467)
Workaround: Press Ctrl-C.
Log out and back in again.

If the uninstaller doesn't fully remove all the components, you can use the QNXLinuxCleanup 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.
If you have other versions of QNX SDP installed, you need to explicitly choose which version of it that you want to use after you uninstall 6.5.0 SP1.

Determining your base directory

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

$ qconfig
QNX Installations

  Installation Name: QNX Software Development Platform 6.5.0
            Version: 6.5.0
     Base Directory: /opt/qnx650/
           QNX_HOST: /opt/qnx650/host/linux/x86/
         QNX_TARGET: /opt/qnx650/target/qnx6/

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