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

QNX Technical Articles

QNX® Aviage® Acoustic Processing 2.0.0 Rev. 1 Installation Note

QNX® Aviage® Acoustic Processing 2.0 Rev. 1: Installation Note

Date of this edition: June 12, 2012

Target OS: This software is compatible with target systems running QNX® Neutrino® 6.3.2 through 6.5.0.

Host OS: You must have already installed the QNX® Software Development Platform:

  • on a self-hosted QNX Neutrino development system on a physical machine, or as a virtual machine on VMware Workstation 6.5 or 7.0, VMware Player 3.0, or Microsoft VirtualPC 2007
  • or on one of the following development hosts:
    Version Microsoft Windows Linux
    QNX Momentics 6.3.2 Windows Vista, XP SP2, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7.0.4, or SUSE 10
    QNX SDP 6.4.0 Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Enterprise Server 5.1 64-bit, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7, or SUSE 10
    QNX SDP 6.4.1 Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4 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
    QNX SDP 6.5.0 Windows 7 Professional 32- and 64-bit, Vista Business 32- and 64-bit, XP Professional SP3, or 2000 SP4 Linux Red Hat Enterprise Linux 5.4 Desktop 32- and 64-bit, Red Hat Fedora 12, Ubuntu Workstation 9.10 32- and 64-bit, or openSUSE 11.2

Contents...

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

Before you install

Before you install this package, note the following:

  • Uninstall any earlier versions of QNX Aviage Acoustic Processing or the Acoustic Processing TDK before installing this version. (Ref# 59132)
  • You need approximately the following amounts of disk space in order to install this package:
    On: You need:
    Windows 42.7 MB
    Linux 28.7 MB
    QNX Neutrino 35.3 MB
  • Each Board Support Package, Driver Development Kit, Technology Development Kit, and Source Kit contains a standalone directory hierarchy. If you're installing more than one of these products, don't combine the directories, or you might overwrite some of the files.

On a Windows host

Note:
  • If you've installed Cygwin on your machine, you need to make sure that the installer uses the version shipped with QNX Momentics. If necessary, change your PATH environment variable so that $QNX_HOST/usr/bin appears before the directory where your other version of Cygwin is installed, and then log out and back in again. (Ref# 53746)
  • You must have installed Microsoft .NET Framework 2.0 in order to use the QWALive client.
  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-ap-2.0-nnnnnnnnnnn-win32.exe, where nnnnnnnnnnn is an 11-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.
    Note: 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

Note: 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-ap-2.0-nnnnnnnnnnn-linux.bin, where nnnnnnnnnnn is an 11-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 qnxaviage-ap-2.0-20081234567-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 ./qnxaviage-ap-2.0-20081234567-linux.bin
    • On other hosts, type (for example): 
      ./qnxaviage-ap-2.0-20081234567-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.

Note: 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, qnxaviage-ap-2.0-nnnnnnnnnnn-nto.sh, where nnnnnnnnnnn is an 11-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 qnxaviage-ap-2.0-20081234567-nto.sh
  5. Run the script at the system prompt. For example, on QNX Neutrino 6.3.2 or 6.4.*, type: 
    ./qnxaviage-ap-2.0-20081234567-nto.sh

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

    HEAD_LEGACY=1 ./qnxaviage-ap-2.0-20081234567-nto.sh
  6. Follow the instructions on your screen.

Uninstalling this package

Before you uninstall

Before you uninstall this package, note the following:

  • If QNX Momentics 6.3 and QNX SDP 6.4 coexist on your system, then before you uninstall Acoustic Processing, use QWinCfg or qconfig to select the version of QNX Momentics or QNX SDP that you want to uninstall Acoustic Processing from.
  • On Windows hosts, the Add or Remove Programs or Programs and Features item in the Control panel lets you remove only the last instance of QNX Aviage Acoustic Processing that you installed, even if it isn't in the currently active version of QNX Momentics or QNX SDP. After that, the product is removed from the list even if another instance is present on another QNX baseline. If you've installed more than one instance of Acoustic Processing, invoke the uninstaller from the command line, as described below.
  • If you decide to uninstall QNX Momentics or QNX SDP, 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. Use QWinCfg to select the version of QNX Momentics or QNX SDP that you want to uninstall Acoustic Processing from.
  3. If you've installed only one instance of QNX Aviage Acoustic Processing, do the following:
    1. Open the Control Panel (e.g. on Windows 2000: Start-->Settings-->Control Panel).
    2. Select Add or Remove Programs.
    3. Select QNX Aviage Acoustic Processing, and then click the Remove button.
  4. If you've installed more than one instance of QNX Aviage Acoustic Processing, do the following:
    1. Run the uninstaller as:

      base_dir\_uninstall\aviage-ap\2.0\uninstaller.exe

      where base_dir is the directory where you installed whichever of QNX Momentics or QNX SDP you want to uninstall QNX Aviage Acoustic Processing from.

On a Linux host

  1. Log in as root, or as a user with administrative privileges on Ubuntu.
  2. Use qconfig to select the version of QNX Momentics or QNX SDP that you want to uninstall Acoustic Processing from.
  3. Go to the base_dir/_uninstall/aviage-ap/2.0 directory, where base_dir is the directory where you installed QNX Momentics or QNX SDP.
  4. Start the QNX InstallShield application:
    • On Ubuntu, type: 
      sudo -E ./uninstaller.bin
    • On other hosts, type: 
      ./uninstaller.bin

    InstallShield will now remove the package.

On a QNX Neutrino host

  1. Log in as root.
  2. Use qconfig to select the version of QNX Momentics or QNX SDP that you want to uninstall Acoustic Processing from.
  3. Go to the base_dir/install/aviage-ap/2.0 directory, where base_dir is the directory where you installed QNX Momentics or QNX SDP.
  4. Run the uninstaller script: 
    ./uninstall.sh

Documentation

The functionality provided by this package is described in the QNX Aviage Acoustic Processing User's Guide, which you'll find in the IDE's help system on Linux and Windows systems. On self-hosted Neutrino systems, you can find the documentation in the Photon helpviewer.

You'll find the QWALive User's Guide installed as base_dir\install\qnxaviage-ap\2.0\QWALive.pdf on Windows systems, where base_dir is where you installed QNX Momentics or QNX SDP.

You'll find the sample programs and a PDF version of the Acoustic Processing User's Guide in the $QNX_TARGET/etc/readme/qnxaviage-ap directory.

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.