Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

QNX® Momentics® Development Suite 6.3.0 SP1 Professional and Standard Editions Installation Note -- QNX® Neutrino® Hosts

QNX® Momentics® Development Suite 6.3.0 SP1

Date of this edition: April 24, 2006

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: QNX^® Neutrino^® 6.3.0

You must install QNX Momentics 6.3.0 before installing Service Pack 1.
For more information about Service Pack 1, see the release notes, which you'll find in ${QNX_TARGET}/etc/readme/patches/6.3.0sp1/rel_6.3.0_SP1.html after you've installed SP1.
For the most up-to-date version of these notes, log into your myQNX account, and then go to the Download Center area of www.qnx.com.

System requirements
Related products
Installation procedure
Uninstalling SP1
How can I tell if I've already installed SP1?
Determining your base directory
Getting started with the docs
Technical support

System requirements

SP1 requires 225 MB of disk space, which includes the space required for backups and temporary space used in installing the files. SP1 won't take up this much space once it's installed, because it replaces some existing files.

Installation procedure

The SP1 installer backs up the affected files, and it stores the backup in the base_directory/backup/patches/6.3.0sp1 directory (see "Determining your base directory," below). The backup files are:

backup.tgz: Software files.
doc.zip: Documentation.

If you interrupt the backup, or it fails, the installation is aborted. Before you can try again to install SP1, you must delete these directories:

base_directory/backup/patches/6.3.0sp1
base_directory/install/patches/6.3.0sp1

SP1 doesn't change any user files. For a list of the affected files, see the shiplist file in each directory under $QNX_TARGET/install/ after installing SP1.

Service Pack 1 updates all of the components of QNX Momentics that you've installed.
If you chose not to install all components of QNX Momentics, and you install this service pack, then if you later decide to install additional components, you must uninstall SP1 first. Similarly, if you install the Standard Edition and then install SP1, if you want to upgrade to the Professional Edition, you must uninstall SP1 first.
If you use the IDE, back up all the .metadata directories on your system before you install SP1. Each user has a $HOME/workspace/.metadata directory. You'll need these backups if you later decide to uninstall SP1.
Close all QNX Momentics applications before you install SP1.
If you haven't set your HOME environment variable, the SP1 installer sets it to be the directory where you installed QNX Momentics (e.g. /usr/qnx630).

To install SP1, do the following:

Log in as root.
Log into your myQNX account on our website, and then go to the Download Center.
Download the SP1 package, 6.3.0sp1-qnx6-nnnnnnnnnnn.sh, where nnnnnnnnnnn is the 11-digit build number. The package is a shell script.
Run chmod to make the script executable. For example:
```
chmod a+x 6.3.0sp1-qnx6-20043030202.sh
```
Run the script at the system prompt. For example:
```
./6.3.0sp1-qnx6-20043030202.sh
```
Follow the instructions on your screen.

The installer rebuilds the boot image in /.boot, as follows:

mkifs /boot/build/qnxbasedma.build /.boot

If the buildfile that you normally use isn't /boot/build/qnxbasedma.build, run the following before rebooting:

mkifs your_build_file /.boot

After you've installed SP1 on a self-hosted Neutrino system, qconfig erroneously lists 6.3.0 and 6.3.0 SP1 as separate versions. It doesn't matter which version you choose. (Ref# 23085)

Workaround: Install the qconfig Patch (Patch ID 205), which installs a new version of qconfig that provides more information about the QNX products that you've installed. You can get this patch from the Download Center on our website after you've logged into your myQNX account.

Uninstalling SP1

If you want to uninstall QNX Momentics completely, uninstall SP1 and any BSPs, DDKs, TDKs, or other products before you uninstall QNX Momentics itself.

If you delete or rename the backup that was made when you installed SP1, or if the backup has been corrupted, the uninstaller will warn you. Continuing to uninstall SP1 will leave your system with an incomplete version of QNX Momentics 6.3.0, and you won't be able to reinstall SP1; you'll likely have to completely reinstall QNX Momentics 6.3.0.

To uninstall SP1, do the following:

Log in as root.
Go to the base_directory/install/patches/6.3.0sp1 directory (see "Determining your base directory," below).
Run the uninstaller script:
```
./uninstall.sh
  
```
If you use the IDE, restore each user's $HOME/workspace/.metadata directory from the backups that you made before you installed SP1. You'll need to reimport any projects that you created in the IDE since you installed SP1.

How can I tell if I've already installed SP1?

To determine whether or not you've installed SP1, check for the existence of the base_directory/install/patches/6.3.0sp1 directory (see "Determining your base directory," below).

Determining your base directory

To determine the base directory for QNX Momentics, open a command shell and use 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 where you installed QNX Momentics.

Getting started with the docs

For information about QNX Momentics 6.3.0, see:

the Release Notes in the Download area of our website
the Welcome message at ${QNX_TARGET}/etc/welcome/index.html
the online documentation at ${QNX_TARGET}/usr/help/product/momentics/bookset.html.

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.