QNX Technical Articles

Date of this edition: September 28, 2007

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Linux Red Hat 8.0, 9.0, or Enterprise 3 or 4

---

If you've already installed an evaluation version of QNX Momentics 6.3.0, and you've purchased and received a commercial QNX License Certificate, please go to “Commercializing your evaluation software,” below. For the most up-to-date version of these notes, log into your myQNX account, and then go to the Download Center area of www.qnx.com. We highly recommend that you install Service Pack 1 after installing QNX Momentics 6.3.0. For more information, see the Download Center area of our website.

---

Contents

• Technical support
• System requirements
• Installation procedure
• Commercializing your evaluation software
• Uninstalling QNX Momentics
• Getting started with the docs

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.

System requirements

Installation procedure

QNX Momentics 6.3.0 includes everything you need to build for all supported platforms (ARM, MIPS, PowerPC, SH-4, XScale, and x86).

---

If you installed a beta version of QNX Momentics 6.3.0, you must uninstall it before installing the released version. See “Uninstalling QNX Momentics,” below.

---

To install this software:

1. Boot into Linux and log in as root.
2. Insert the QNX Momentics 6.3.0 Installation CD in the CD drive.
3. On a Red Hat Enterprise host, you need to install a more recent version of the JRE, because the JRE bundled in the QNX Momentics 6.3.0 installer (JRE 1.3.1_06) doesn't run in RedHat Linux Enterprise workstation v3. In this case, don't run the installer on the CD; instead, do the following:
   1. Download and install the latest JRE (we recommend JRE 1.4.2_x) from:

      http://java.sun.com/j2se/1.4.2/download.html

   2. Start a bash shell.
   3. Assuming the JRE is installed in /opt/j2sdk1.4.2_x, set the PATH environment variable as follows:

      export PATH=/opt/j2sdk1.4.2_x/bin:$PATH
          

   4. Start the QNX Momentics installer as follows:

      java -jar mountpoint/qnx_linux_setup.jar
          

      where mountpoint is where the 6.3.0 Momentics CD is mounted. In Red Hat Enterprise version 3, it's /mnt/cdrom; in version 4, it's /media/cdrom.

4. On other versions of Linux, if the system offers to run autorun, choose Yes; otherwise, in a terminal window, type:

   /mnt/cdromn/qnxSetupLinux.bin

   where n is the number (if any) for the CD drive.

5. Follow the instructions on your screen.
6. If InstallShield doesn't display the release notes, launch a browser and use it to display ${QNX_TARGET}/etc/readme/release_notes.html.

Congratulations — you've completed the installation!

---

If the system displays this message: error while loading shared libraries: libstdc++-libc6.1-1.so.2: cannot open shared object file: No such file or directory or if InstallShield simply won't start, download and install compat-libstdc++-7.3-2.96.110. Alternatively, you can install a later version of JRE that doesn't require this library; see the instructions for installing on Red Hat Enterprise, above.

---

After installing, you're asked to activate the product, either online or by email. 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 you choose not to activate at the time of installation, you can activate later by selecting Programming-->QNX Momentics 6.3.0 Activate License from the Start menu, or by entering the following at a terminal prompt:

/etc/qnx/bin/qnxactivate -a

Installing on Red Hat Enterprise Linux Workstation 5

Installing QNX Momentics 6.3.0 on RHEL WS 5 (a host that we don't officially support for this release) requires a special method. Note that the graphical installer won't work on this version of Linux. Here's what to do:

• Unmount the directory where the CD was automounted.
• Create another directory, such as /media/mycd.
• Mount the CD drive:

  mount /dev/cdrom /media/mycd
    

• Make sure that SUN JRE 1.4.2.X is installed on your system, as described above.
• Run java -version to verify that you're using the correct version.
• Install QNX Momentics like this:

  java -jar /media/mycd/qnx_linux_setup.jar -console
    

  Provide all the input from the terminal.

• After installing, log out and log back in.
• The 6.3.0 version of the IDE won't run on RHEL 5, so if you want to use the IDE, you should install 6.3.0 SP2. Install 6.3.0 SP2 like this:

  java -jar /media/mycd/6.3.0sp2-linux-20052661645.bin -console
    

  Provide all the necessary input.

• Before running the IDE, edit your environment by doing:

  export PATH=$QNX_HOST/usr/bin:$PATH
    

  This fixes a problem that causes make to fail on RHEL 5.

• Log out and log back in.

Commercializing your evaluation software

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

1. Choose Programming-->QNX Momentics 6.3.0 Add License from the Start menu, or type the following at a terminal prompt:

   /etc/qnx/bin/qnxactivate -l
     

2. In the QNX Momentics License Key Entry dialog, fill in the field with the license-key information that's on your commercial QNX License Certificate.
3. When you've finished entering the information, click Add to save the license-key information and configure your QNX Momentics tools to use this file.

Uninstalling QNX Momentics

To uninstall QNX Momentics, log in as root and then either:

• Choose Programming-->Uninstall QNX Momentics 6.3.0 from the Start menu

  Or:

• go to the directory where you installed QNX Momentics and run _uninstall/qnx630/uninstaller.bin.

Getting started with the docs

For information about QNX Momentics 6.3.0, see:

• the Release Notes on the CD
• the Welcome message at ${QNX_TARGET}/etc/welcome/index.html
• the online documentation at ${QNX_TARGET}/usr/help/product/momentics/bookset.html.

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.

---

Coexistence of 6.3.0 and 6.2.1 is supported only on Windows and Solaris hosts (we didn't support Linux hosts in 6.2.1).

---