QNX Technical Articles

Date of this edition: May 13, 2010

Target OS: This software is compatible with target systems running QNX^® Neutrino^® 6.4.0, 6.4.1, or 6.5.0.

Host OS: You must have already installed the QNX^® Software Development Platform 6.4.0, 6.4.1, or 6.5.0 as a self-hosted QNX Neutrino system, or on one of the following hosts:

Contents...

• Installing this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Uninstalling this package
  • On a Windows host
  • On a Linux host
  • On a QNX Neutrino host
• Documentation
• Technical support

---

This product includes the QNX Aviage HMI Player for Adobe Flash Lite 3 which, when operating outside the Photon environment, requires new composition and window management technology from QNX Software Systems. QNX SDP version 6.4.1 or later will include this technology. If you're installing this product on QNX SDP 6.4.0, and you wish to run the HMI Player outside of the Photon graphics environment, QNX Neutrino RTOS Core Graphics Composition Manager GA Patch. Refer to the QNX Neutrino RTOS Core Graphics Composition Manager patch (Patch ID 1347) install note for more information about downloading and installing the Composition Manager.

---

For information about what's in this package, see the release notes. For the latest version, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

Installing this package

---

The installers underestimate the amount of disk space that you need in order to install this product. The installation procedure requires excess disk space to install the product. (Ref# 53603) Workaround: You need the following amounts (approximately) for each host OS: Host OS Disk space required QNX Neutrino 26.1 MB Windows 38.8 MB Linux 39.6 MB

---

---

You cannot install more than one version of the HMI Suite on the same QNX SDP baseline installation. You must always uninstall pre-existing versions of the HMI Suite from your current baseline before performing a new installation.

---

---

If you've installed QNX SDP versions 6.4.0 or 6.4.1 so that they coexist on your Windows or Linux host, you may have to log out of your user session and log back in before installing this package.

---

On a Windows host

1. Log in as a user with system-administrator privileges.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, qnxaviage-hmi_suite-2.0-nnnnnnnnnnnn-win32.exe, where nnnnnnnnnnn is a 12-digit build number. The package is in the form of an executable (.exe) file.
4. Double-click the file in Windows Explorer or run it at the command line.
5. Follow the instructions provided by InstallShield.

   ---

   Windows XP SP2 may display a security warning when you install this package. You can verify the package's checksums when you download the file from our website.

   ---

On a Linux host

---

If you've installed more than one version of QNX SDP on your system so that they coexist, see “Coexistence on Linux,” below.

---

1. 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 Center.
3. Download the package, qnxaviage-hmi_suite-2.0-nnnnnnnnnnn-linux.bin, where nnnnnnnnnnn is a 12-digit build number. The package is in the form of a .bin script.
4. Run chmod to make the script executable. For example:

   chmod a+x hmi_suite-2.0-20091234567-linux.bin

5. 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 ./hmi_suite-2.0-20091234567-linux.bin
         

   • On other hosts, type (for example):

     ./hmi_suite-2.0-20091234567-linux.bin
         

6. Follow the instructions provided by InstallShield.

Coexistence on Linux (Ref# 73411)

It's possible to have more than one version of the QNX Software Development Platform installed on your system, and it's possible to install QNX Aviage products for each version of QNX SDP. However, due to a limitation in InstallShield, you have to take some extra steps installing QNX Aviage products on Linux hosts.

When two or more versions of QNX SDP coexist on Linux, you use the following command to switch between configurations to set up the environment in the current shell:

eval `qconfig -n "installation_name_as_displayed_by_qconfig" -e`

When you launch any of the QNX Aviage installers from that shell, the environment picked up by InstallShield is whatever version of QNX SDP you installed last, not the version that you selected using the command above.

For example, if you install QNX SDP 6.4.0, then QNX 6.4.1, and you then choose 6.4.0 and try to install a QNX Aviage product on the 6.4.0 baseline, the installation location displayed by the installers isn't /opt/qnx640 (as expected), but /opt/qnx641.

In order to work around this issue, you must edit /etc/profile.

---

We recommend that you save a copy of this file before you edit it.

---

Edit /etc/profile, and find the section that looks like this:

# Begin INSTALLSHIELD Environment Variable Section
# Do not edit this section manually.
# var 0 QNX_CONFIGURATION=/etc/qnx
QNX_CONFIGURATION=/etc/qnx
export QNX_CONFIGURATION

# var 0 QNX_TARGET=/opt/qnx641/target/qnx6
QNX_TARGET=/opt/qnx641/target/qnx6
export QNX_TARGET

# var 0 MAKEFLAGS=-I/opt/qnx641/target/qnx6/usr/include
MAKEFLAGS=-I/opt/qnx641/target/qnx6/usr/include
export MAKEFLAGS

# var 1 : PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin:/etc/qnx/bin:/root/bin:/etc/qnx/bin:/root/bin:/opt/qnx641/host/linux/x86/usr/bin:/etc/qnx/bin
PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin:/etc/qnx/bin:/root/bin:/etc/qnx/bin:/root/bin:/opt/qnx641/host/linux/x86/usr/bin:/etc/qnx/bin
export PATH

# var 0 QNX_HOST=/opt/qnx641/host/linux/x86
QNX_HOST=/opt/qnx641/host/linux/x86
export QNX_HOST

# var 1 : LD_LIBRARY_PATH=echo $LD_LIBRARY_PATH:/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
if [ -z "echo $LD_LIBRARY_PATH" ]
then
LD_LIBRARY_PATH=/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
else
LD_LIBRARY_PATH=echo $LD_LIBRARY_PATH:/opt/qnx640/host/linux/x86/usr/lib:/opt/qnx641/host/linux/x86/usr/lib
fi
export LD_LIBRARY_PATH

# var 0 QNX_JAVAHOME=/opt/qnx641/_jvm
QNX_JAVAHOME=/opt/qnx641/_jvm
export QNX_JAVAHOME

# End INSTALLSHIELD Environment Variable Section

Ignore the “Do not edit this section manually” instruction, and change (in this example) all occurrences of the 6.4.1 installation directory (/opt/qnx641) into the directory where you installed 6.4.0. Save your changes, and then continue with the installation.

Once you've installed the QNX Aviage product, you might want to restore /etc/profile from the backup that you made.

On a QNX Neutrino host

1. Log in as root.
2. Log into your myQNX account on our website, and then go to the Download Center.
3. Download the package, hmi_suite-2.0-nnnnnnnnnnn-nto.sh, where nnnnnnnnnnn is a 12-digit build number. The package is in the form of a shell script.
4. Run chmod to make the script executable. For example:

   chmod a+x hmi_suite-2.0-20091234567-nto.sh

5. Run the script at the system prompt. For example, on QNX Neutrino 6.4.*, type:

   ./hmi_player-2.0-20091234567-nto.sh
       

   On QNX Neutrino 6.5.0, invoke the installer using the legacy behavior of the head utility:

   HEAD_LEGACY=1 ./hmi_player-2.0-20091234567-nto.sh
       

6. Follow the instructions on your screen.

Uninstalling this package

---

If you decide to uninstall the QNX Software Development Platform, uninstall its related products first, or you'll leave your system in an inconsistent state.

---

On a Windows host

1. Log in as a user with system-administrator privileges.
2. Open the Control Panel (e.g. on Windows 2000: Start-->Settings-->Control Panel).
3. Select Add or Remove Programs.
4. Select QNX Aviage HMI Suite, and then click the Remove button.

   ---

   On Windows Vista, choose Programs and Features, select QNX Aviage HMI Suite, and then click Uninstall/Change.

   ---

On a Linux host

1. Log in as root, or as a user with administrative privileges on Ubuntu.
2. Start the QNX InstallShield application:
   • On Ubuntu, run:

     sudo -E base_dir/_uninstall/qnxaviage-hmi_suite/2.0/uninstaller.bin
         

   • On other hosts, run:

     base_dir/_uninstall/qnxaviage-hmi_suite/2.0/uninstaller.bin
         

   InstallShield will now remove the package.

On a QNX Neutrino host

1. Log in as root.
2. Run the uninstaller script:

   base_dir/install/qnxaviage-hmi_suite/2.0/uninstall.sh

Documentation

The functionality provided by this package is described in the QNX Aviage HMI Suite Developer's Guide, which you'll find in the IDE's help system. On self-hosted Neutrino systems, you can find the documentation in the Photon helpviewer, or, you can use a browser to load $QNX_TARGET/usr/help/product/hmi_player_en/bookset.html.

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.