QNX® Aviage Multimedia Suite 1.2.0 Installation Note

Date of this edition: November 20, 2009

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

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

Version of QNX SDP Microsoft Windows Linux
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
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

Caution:
  • A client application compiled against QNX Aviage Multimedia Suite (MME) 1.0.n must be recompiled in order to work with QNX Aviage Multimedia Suite (MME) 1.2.0.
  • You must update all system components to QNX Aviage Multimedia Suite 1.2.0. Your environment must not contain both 1.0.n and 1.2.0 multimedia components.

Required software

To support USB transport connections to iPods (“one-wire” connections), you need the following patch:

Required disk space and dependencies

The table below lists the minimum disk space requirements (in megabytes) for installation of the different MME components, as well as component dependencies.

 Component  Neutrino   Linux   Windows   Dependencies
QNX Aviage Multimedia Core 1.2.0    63  190   80  None
QNX Aviage Multimedia Software Codec for AAC 1.2.0      9   19   29  Core
QNX Aviage Multimedia Software Codec for MP3 1.2.0      8   19   28  Core
QNX Aviage Multimedia Software Codec for WMA9 1.2.0     11   21   31  Core
QNX Aviage Multimedia Interface for iPod 1.2.0      9   19   28  Core
 Software Codec for AAC, if AAC codec support is required.
QNX Aviage Multimedia Interface for PlaysForSure 1.2.0      8   19   28  Core
 Software Codec for WMA9, if WMA9 codec support is required.
 Interface for WMDRM10-ND, if DRM support is required.
QNX Aviage Multimedia Interface for WMDRM10-ND 1.2.0      8   19   28 Core
 Interface for PlaysForSure
QNX Aviage Multimedia Interface for Zune 1.2.0      8   18   28  Core
 Interface for PlaysForSure
QNX Aviage Multimedia DVD Playback 1.2.0     11   20   30  Core
 Aviage Multimedia Suite 1.2.0 Intel Performance Primitive Codecs package: patch-640-1507-ipp-decoder.tar
 Aviage Multimedia Suite 1.2.0 A/V Sync patch: patch-640-1521-av-sync.tar
QNX Aviage Multimedia Interface for TI OMAP Codec Engine 1.2.0  n/a n/a 625  Core

Contents...

For information about what's in this release, see the Release Notes. For the latest version of this Installation Note or the Release Notes, go to our website, www.qnx.com, log into your myQNX account, then go to the Download Center.

Installing the QNX Aviage Multimedia Suite

This section explains how to install the QNX Aviage Multimedia Core 1.2.0 and optional components. For detailed information about supported hosts and targets, see the release notes. For information about how to get the QNX Aviage Multimedia Suite's MME (MultiMedia Engine) up and running, see the chapter “Quickstart Guide” in Introduction to the MME.

Upgrades

If you are upgrading from an older version of the QNX Aviage Multimedia Suite, before you begin the installation you need to:


Note: Before restarting the MME, you will also need to replace the QBD configuration file, qdb.cfg, as instructed in the Quickstart Guide chapter of Introduction to the MME.

On a QNX Neutrino host

  1. Log in as root.
  2. Log into your myQNX account on our website, then go to the Download Center.
  3. Download the installation package, qnxaviage-mmedia-core-1.2.0-nnnnnnnnnnnn-nto.sh, where nnnnnnnnnnnn is an 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 qnxaviage-mmedia-core-1.2.0-200904231718-nto.sh
  5. Run the script at the system prompt. For example:
    # ./qnxaviage-mmedia-core-1.2.0-200904231718-nto.sh
  6. Follow the instructions on your screen.

On a Linux host

  1. Log in as root.
  2. Log into your myQNX account on our website, then go to the Download Center.
  3. Download the installation package, qnxaviage-mmedia-core-1.2.0-nnnnnnnnnnnn-host.bin, where host is linux, and nnnnnnnnnnnn is an 12-digit build number. The package is in the form of a .bin script.
  4. Run chmod to make the script executable. For example:
    # qnxaviage-mmedia-core-1.2.0-200904231718-linux.bin
  5. Run the script at the system prompt. For example:
    # ./qnxaviage-mmedia-core-1.2.0-200904231718-linux.bin
  6. Follow the instructions provided by InstallShield.

Ubuntu hosts

On Ubuntu hosts, you must run the installation script with the sudo command -E option in order set the correct environment for the installation. For example:

# sudo -E ./qnxaviage-mmedia-core-1.2.0-200904231718-linux.bin

On a Windows host


Note: If you have more than one version of QNX SDP that co-exist on your system (for example, 6.3.2 and 6.4.n, where n is the 6.4. version number):
  • Set your configuration to 6.4.n (for example, 6.4.1) — you can't install a 6.4.1 product, such as the QNX Aviage Multimedia Suite, when the active version is QNX SDP 6.3.2.
  • If you switch your configuration, you must log out of your user session and log back in before starting an installation.

  1. Log in as a user with system-administrator privileges.
  2. Log into your myQNX account on our website, then go to the Download Center.
  3. Download the installation package, qnxaviage-mmedia-core-1.2.0-nnnnnnnnnnnn-win32.exe, where nnnnnnnnnnnn is an 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.

    Note: Windows XP SP2 may display a security warning the first time you install the QNX Aviage Multimedia Suite. You can verify the checksums for the installation package when you download the file from our website.

Installing optional components

To install optional components, download the appropriate installation package and follow the instructions for installing the QNX Aviage Multimedia Core 1.2.0 for the host OS, substituting the appropriate name where required, and taking note of the information below.

Please note the following when installing QNX Aviage MME 1.2.0 optional components:


Caution:
  • Installing an optional package under QNX SDP 6.4.0 when optional packages are already installed under QNX SDP 6.4.1 requires the same workaround.
  • The installer will not display an error message if there is an error (a typo) in the command-line argument. It will simply ignore the argument. Thus, a typo in the command-line argument specifying the installation location will have the same result as not specifying the installation location, and you may erroneously overwrite an already installed package.


Note: If you are installing the QNX Aviage Multimedia Interface for TI OMAP Codec Engine, after the installation has completed you must also launch dsp-bins/omap3530image.exe and complete the click-through license agreement to install the sample DSP image on your host.

Dependencies

The QNX Aviage Multimedia Interface for iPod and the QNX Aviage Multimedia Interface for PlaysForSure packages are designed for use with the QNX Aviage Multimedia Core package. If you intend to use these packages independently of the QNX Aviage Multimedia Core package, please contact your sales support team.

For a complete list of dependencies between MME packages, see “Dependencies” in the Release Notes.

Uninstalling the QNX Aviage Multimedia Suite

This section explains how to uninstall the QNX Aviage Multimedia Core 1.2.0 and optional components.


Caution:
  • Always uninstall the QNX Aviage Multimedia Suite optional components before uninstalling the QNX Aviage Multimedia Core 1.2.0.
  • Always uninstall the QNX Aviage Multimedia Interface for WMDRM10-ND before uninstalling the QNX Aviage Multimedia Interface for PlaysForSure.

Deleting the MME database tables

When you uninstall the QNX Aviage Multimedia Suite, you must delete the old MME database tables and schema files, for example:

# cd /db

# rm *mme* usb*

If you do not know where the MME database and schema files are stored, see your qdb.cfg file for the location of your database. This file is usually located under /db (from the root directory).

On a QNX Neutrino host

  1. Log in as root.
  2. Go to the directory with the QNX Aviage Multimedia Suite uninstall script; for example:
    # cd
  3. Run the uninstaller script:
    # /usr/qnx640/install/mmedia-core/1.2.0/uninstall.sh

On a Linux host

  1. Log in as root.
  2. Go to the base_dir/_uninstall/mmedia-core/1.2.0 directory, where base_dir is the directory where QNX SDP is installed; for example:
    # cd
  3. Start the QNX InstallShield application:
    # /opt/qnx640/_uninstall/mmedia-core/1.2.0/uninstaller.bin

    InstallShield will now remove the MME.


Note: In the case of coexistence, if you've installed MME 1.2 on multiple baselines (for example 6.4.0 and 6.4.1), before you uninstall make sure that you select as the active configuration the baseline from which you want to remove the MME or the MME component.

On a Windows host

  1. Log in as a user with system-administrator privileges.
  2. Open the Control Panel (e.g. on Windows XP: Start-->Control Panel-->Add or Remove Programs).
  3. Select the QNX MME, then click the Change/Remove button.

Note: In the case of coexistence, if you've installed MME 1.2 on multiple baselines (for example 6.4.0 and 6.4.1), don't use Add or Remove Programs to uninstall MME 1.2:
  1. Make sure that you select as the active configuration the baseline from which you want to remove the MME or the MME component.
  2. Launch the uninstaller directly. For example: qnx_base_dir\_uninstall\mmedia-core\1.2.0\uninstaller.exe.

Uninstalling optional components

To uninstall optional components, follow the uninstall instructions for the host OS, substituting the appropriate component path and name where required.

Documentation

The documentation for this release includes:

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 the QNX Software Development Platform guide or visit our website, www.qnx.com.