Developer Resources
Board support packages
Foundry27 projects
Forums
Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Software Development Platform for x86 Targets 6.4.1: Installation Note — Linux Hosts

QNX® Software Development Platform for x86 Targets 6.4.1: Installation Note — Linux Hosts

Date of this edition: July 06, 2009

Target OS: This development platform produces software that's compatible with x86 targets that are running QNX® Neutrino® 6.4.1.

Host OS: You can install this package on Linux Red Hat Enterprise Workstation 4.0 or 5.0, Red Hat Enterprise Server 5.1 64-bit, Red Hat Fedora 10, Ubuntu 8.04 LTS or 8.10, or SUSE 11.

Caution: If you installed an alpha version of this software, uninstall it before installing the production version.
Note:
  • This is a special version of QNX SDP that's for x86 targets only. If you want to develop for other targets, install the full QNX Software Development Platform 6.4.1. You can't upgrade the x86 development suite into the full version.
  • You can't install QNX SDP 6.4.1 on machines that are running 64-bit Linux Ubuntu 7.10. (Ref# 56182)
  • We no longer support development for ARMBE targets, but we once again support it for MIPS.
  • If you've already installed an evaluation version of QNX SDP 6.4.1, and you've purchased and received a commercial QNX license, please go to “Commercializing your evaluation software,” below.
  • This installer does a fresh installation of the QNX Software Development Platform 6.4.1. It can coexist with earlier versions of the QNX Momentics® development suite.
  • For information about using BSPs with QNX SDP 6.4.1, see the BSP Migration Guide in the BSPs and Drivers project on Foundry27.
  • For information about QNX SDP, including any host-specific issues, see the release notes. For the most up-to-date version of these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download area.

Contents

System requirements

Host OS:

  • Red Hat Enterprise Workstation 4.0 or 5.0
  • Red Hat Enterprise Server 5.1 64-bit
  • Red Hat Fedora 10
  • Ubuntu 8.04 LTS or 8.10
  • SUSE 11
Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MB 512 MB
Disk space 1.1 GB 1.1 GB
Monitor 1024×768 1280×1024

In order to install QNX SDP 6.4.1, you need 1300 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.1

Note:
  • If you're running selinux (secure Linux), disable it before installing 6.4.1. 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
  • We've done some testing of QNX SDP on Ubuntu 8.10 64-bit. In order to run the installer and the IDE, you need to install the 32-bit libraries: 
    sudo apt-get install ia32-libs

    Answer “yes” to all the questions. (Ref# 67109)

  • 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)

To install this software:

  1. Boot into Linux and log in as root.
  2. Log into your myQNX account on our website, and then go to the Download area.
  3. Download the QNX SDP 6.4.1 package, qnxsdp-6.4.1-nnnnnnnnnnnn-linux.bin, where nnnnnnnnnnnn is a build number. The package is a .bin script.
  4. Run chmod to make the script executable. For example: 
    chmod a+x qnxsdp-6.4.1-20081234567-linux.bin
  5. Run the script at the system prompt. For example: 
    ./qnxsdp-6.4.1-20081234567-linux.bin
  6. Follow the instructions on your screen. We recommend you use the default location for the software, /opt/qnx641.

    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.

    Note: The installer launches a web browser at the end of installation to display a landing page on the QNX website. On some versions of Linux, the installer can't launch the browser, but sometimes only if you already have QNX Momentics 6.3.2 installed. (Ref# 24429, 61494)
  7. Log out and log back in again, so that the environment is set up correctly.

Congratulations — you've completed the installation! You'll find a copy of the license agreements in base_dir/install/qnxsdp/6.4.1, where base_dir is where you installed SDP (see “Determining your base directory,” below).

Activating QNX SDP 6.4.1

QNX SDP 6.4.1 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.

Note:
  • On some distributions of Linux, you might not be able to activate QNX SDP 6.4.1 immediately after installing it. (Ref# 59063)

    Workaround: Log out and back in again before trying to activate.

  • 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

If your development host is connected to the Internet, you can activate QNX SDP 6.4.1 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, /etc/qnx/license/activate_prompt_key.txt. 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 Manual Product Activatation (6.3.x or 6.4.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 /etc/qnx/license/activate_response_key.txt on your QNX SDP development host.
  7. If you closed the QNX SDP Activation dialog, open it again by entering the following at a terminal prompt: 
    /etc/qnx/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 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.4.1, 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:

    base_directory/install/qnxsdp/6.4.1/AddLicense.bin

    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 SDP 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.1

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*.bin"`

where base_directory is where you installed the QNX Software Development Platform.

To uninstall QNX SDP 6.4.1, do the following:

  1. Log in as root.
  2. Go to a directory outside the base_dir directory (see “Determining your base directory,” below) and run:

    base_dir/_uninstall/qnxsdp/6.4.1/uninstaller.bin

  3. Log out and back in again.
Note: If the uninstaller doesn't fully remove all the components, you can use the QNXLinuxCleanup utility to cleanup your machine. You can find this utility and documentation for it in the Utilities directory on the DVD, or on our website.

Uninstalling previous versions

To uninstall a previous version, for example, QNX Momentics 6.3.2, do the following:

  1. Log in as root.
  2. Type: 
    <632_base>/_uninstall/qnx632/uninstaller.bin
  3. Log out and back in again.
Note: You must specify the full path name of the uninstaller in order to succesfully remove the previous version of QNX Momentics. (Ref# 61384)
Note: You must perform the additional steps described in the Release Notes under Known Issues: Installing and uninstalling, (Ref# 58784).

Determining your base directory

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

$ qconfig
QNX Installations

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

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

Getting started with the docs

After you've installed QNX SDP 6.4.1, 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.).

Note: The online documentation also includes the installation and release notes. For the most up-to-date version of these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

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.

Note: Coexistence of QNX SDP 6.4 or QNX Momentics 6.3 with QNX Momentics 6.2.1 is supported only on Windows hosts (we didn't support Linux hosts in 6.2.1).

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.