Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

QNX® Momentics® 6.3.0 SP2 PE and SE qnxactivate Patch (Patch ID 361) Installation Note

QNX® Momentics® Development Suite 6.3.0 Service Pack 2

Date of this edition: April 04, 2007

Target OS: QNX^® Neutrino^® 6.3.0 SP2

Host OS: Microsoft Windows XP SP1 and SP2, 2000 SP4, or NT SP6a; Sun Solaris 7, 8, 9, or 10; QNX^® Neutrino^® 6.3.0 SP2; Linux Red Hat 8, 9, or Enterprise WS 3 or 4

This patch supersedes the qnxactivate Patch (Patch ID 282). For information about the issues that this patch addresses, see the release notes.

This note includes:

Installation procedure
Structure of a patch
Determining if you need to apply this patch
Applying the patch
Technical support

Installation procedure

Log in as root (or with administrator privileges on Windows).
Download the patch-630SP2-0361-qnxactivate.tar archive to your host environment.
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.

Extract the archive you downloaded into the base directory:

Method 1: Command-line based

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-630SP2-0361-qnxactivate.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-630SP2-0361-qnxactivate.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-630SP2-0361-qnxactivate.tar

Method 2: GUI based

Use any GUI-based application that supports the TAR format (e.g. WinZIP under Windows). Ensure that the destination directory is your base directory.

If you use WinZIP, choose Options-->Configuration, switch to the Miscellaneous tab in this dialog, and turn off the TAR file smart CR/LF conversion option. If this option is turned on, and you extract the archive, then your shiplist file will contain ^M characters.

Structure of a patch

The patch is installed in the base_dir/patches/630SP2-0361/ 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.

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.

Determining if you need to apply this patch

To determine if you need to apply this patch, look at the contents of $QNX_CONFIGURATION/bin/activator_version.txt and base_dir/patches/630SP2-0361/host/x86/usr/bin/activator_version.txt. These files include a release number (e.g. 6.3.0) and an 11-digit build number.

You need to apply the patch only if:

the release number in the patched file is greater than or equal to that in the installed file
and:
the build number in the patched file is greater than that in the installed file

Otherwise, delete the base_dir/patches/630SP2-0361 directory.

Applying the patch

If you've determined that you need this patch, you must next replace the files on your development host with the patched files.

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 Windows:

From the cmd.exe prompt, run ksh.
Go to the base directory:
cd base_dir

Create a backup for qnxactivate.exe:

pax -w $QNX_CONFIGURATION/bin/qnxactivate.exe $QNX_CONFIGURATION/bin/activator_version.txt > patches/630SP2-0361-backup.tar

You can use whatever name you like for the backup archive.

Exit ksh.

To create a backup on any of our other hosts:

Go to the base directory:
cd base_dir

Create a backup for qnxactivate:

pax -w $QNX_CONFIGURATION/bin/qnxactivate $QNX_CONFIGURATION/bin/activator_version.txt > patches/630SP2-0361-backup.tar

You can use whatever name you like for the backup archive.

Moving 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):

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

Install the host update:

bash
cd patches/630SP2-0361/host/win32/x86/usr/bin
mv activation.exe "`cygpath -u "$QNX_CONFIGURATION\bin\qnxactivate.exe"`"
mv activator_version.txt "`cygpath -u "$QNX_CONFIGURATION\bin\activator_version.txt"`"
exit

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

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

Go to the host directory for the patch:
cd base_dir/patches/630SP2-0361/host/this_host/usr/bin
where this_host is one of linux/x86, solaris/sparc, or qnx6/x86.
Install the host updates:
```
mv activation $QNX_CONFIGURATION/bin/qnxactivate
mv activator_version.txt $QNX_CONFIGURATION/bin/activator_version.txt
  
```
(You don't have to update /usr/bin/qnxactivate on self-hosted Neutrino systems because it's a symbolic link to $QNX_CONFIGURATION/bin/qnxactivate.)

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.