Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Momentics® Development Suite 6.3.0 Service Pack 2 or 3 BSP Utilities Patch (Patch ID 725) Installation Note

QNX® Momentics® Development Suite 6.3.0 Service Pack 2 or 3 BSP Utilities Patch (Patch ID 725) Installation Note

Date of this edition: September 13, 2007

Target OS: This patch is compatible with targets that are running QNX® Neutrino® 6.3.0 SP2 or SP3.

Host OS: In order to apply this patch, you must have installed QNX Momentics 6.3.0 SP2 or SP3 on one of the following host OSs:

  • Microsoft Windows Vista, XP SP1 and SP2, 2000 SP4, or NT SP6a
  • Sun Solaris 7, 8, 9, or 10
  • QNX® Neutrino® 6.3.0 SP2 or SP3
  • Linux Red Hat 8 or 9, Red Hat Enterprise WS 3 or 4, Red Hat Fedora Core 3 or 4, Debian 3.1, or SUSE 10

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

This note includes:

Installation procedure

  1. Log in as root (or with administrator privileges on Windows).
  2. On Debian 3.1 hosts, set up your environment by typing:
    source /etc/profile
      
  3. Download the patch-632-0725-bsputils.tar archive to your host environment.
  4. Determine the base directory of your QNX Momentics installation by opening a command shell and using the qconfig command. For example:
    $ qconfig
    QNX Installations
    
    Installation Name: QNX Momentics 6.3.0
    Version: 6.3.0
    Base Directory: /usr/qnx630/
    QNX_HOST: /usr/qnx630/host/qnx6/x86/
    QNX_TARGET: /usr/qnx630/target/qnx6/
      

    The base directory in this example is /usr/qnx630/, but it could be different on your machine, depending on your host and where you installed QNX Momentics.

  5. Extract the archive you downloaded into the base directory:
    • Windows hosts:
      1. Open a command prompt (cmd.exe) and switch to the drive indicated in the base directory that you found in step 2 (e.g. C:).
      2. Copy the archive to your base directory, replacing base_dir with the path you found in step 2:

        copy drive:\patch-632-0725-bsputils.tar base_dir

      3. 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-632-0725-bsputils.tar

    • Neutrino, Linux, and Solaris hosts:

      Open a command shell and use the following commands (replacing base_dir with the path found in step 2, and archive_path with the full path to the downloaded archive):

      cd base_dir
      tar -x -v -f archive_path/patch-632-0725-bsputils.tar

Structure of a patch

The patch is installed in the base_dir/patches/632-0725/ 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.
host
A directory of fixes related to components that would be built into host-specific development systems.

Note: These fixes might include components for hosts other than the one you're using. After installing and applying the patch, you can remove any unnecessary directories under base_dir/host.

Applying the patch

Next, you must replace the files on your development host with the patched files.


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 on any of our hosts:

  1. (Windows only) 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/632-0725/shiplist > patches/632-0725-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. (Windows only) Exit ksh.

Copying the files -- Windows hosts

To apply the patch on a Windows system 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\632-0725

  3. Install the host updates:

    cp -Rp host base_dir\.

Copying the files -- Neutrino, Linux, and Solaris hosts

To apply the patch on a Neutrino, Linux, or Solaris system:

  1. Go to the patch directory:

    cd base_dir/patches/632-0725

  2. Install the host updates:

    cp -Rp host base_dir/.

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.