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

QNX Technical Articles

QNX® Aviage® HMI Suite 2.0 Documentation Patch (Patch ID 1490) Installation Note

QNX® Aviage® HMI Suite 2.0 Documentation Patch (Patch ID 1490) Installation Note

Date of this edition: June 15, 2009

Target OS: This patch is compatible with targets that are running QNX® Neutrino® 6.4.0.

Host OS: In order to apply this patch, you must have installed the QNX Software Development Platform on Microsoft Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4.

Note: For information about the issues that this patch addresses, see the release notes.

This note includes:

Installation procedure

  1. Log in with administrator privileges on Windows.
  2. Download the patch-640-1490-HMI20-DOCS-WIN.tar archive to your host environment.
  3. Determine the base directory of your QNX Software Development Platform installation by opening a command shell and using the qconfig command. For example: 
    $ qconfig
QNX Installations

  Installation Name: QNX Software Development Platform 6.4.0
              Version: 6.4.0
       Base Directory: C:/QNX640
             QNX_HOST: C:/QNX640/host/win32/x86
           QNX_TARGET: C:/QNX640/target/qnx6

    The base directory in this example is C:/QNX640, but it could be different on your machine, depending on your host and where you installed QNX Software Development Platform.

  4. Open a command prompt (cmd.exe) and switch to the drive indicated in the base directory that you found earlier (e.g. C:).
  5. Copy the archive to your base directory, replacing base_dir with the path you found earlier:

    copy drive:\patch-640-1490-HMI20-DOCS-WIN.tar base_dir

  6. Use the following commands to extract the archive contents. Don't specify the drive letter in the archive path:

    cd base_dir
    tar -xvf patch-640-1490-HMI20-DOCS-WIN.tar

Structure of a patch

The patch is installed in the base_dir/patches/640-1490/ directory. This directory includes:

version
Includes the patch number and the build information.
manifest
Contains the checksums of the files shipped in the patch (as generated by the cksum utility).
shiplist
A list of the files included in the patch.
target
A directory of fixes related to components that would be built into QNX Neutrino target or runtime systems.

Applying the patch

Caution: Since this is a destructive procedure, we recommend that you create a backup of the affected files.

Creating a backup

To create a backup:

  1. From the cmd.exe prompt, run ksh.
  2. Go to the base directory:

    cd base_dir

  3. Make a backup of the files that will be overwritten:

    pax -w < patches/640-1490/shiplist > patches/640-1490-backup.tar

    You can use whatever name you like for the backup archive. The pax utility might display some error messages when it attempts to back up nonexistent files for host operating systems other than the one you're using. You can ignore these messages.

  4. Exit ksh.

To apply the patch from the command prompt (remember to switch back to cmd.exe from ksh):

  1. Switch to the drive specified in your base directory (e.g. C:).
  2. Go to the patch directory (remember to replace / characters in the base directory with \):

    cd base_dir\patches\640-1490

  3. Type the following command to install the target updates:

    cp -Rp target base_dir\.

    Note: You must restart the IDE for the patch to take effect.

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