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

QNX Technical Articles

QNX® Momentics® Development Suite 6.3.0 Service Pack 2 Professional and Standard Editions Installation Note -- QNX® Neutrino® Hosts

QNX® Momentics® Development Suite 6.3.0 Service Pack 2

Date of this edition: August 25, 2006

Target OS: QNX® Neutrino® 6.3.0 or 6.3.0 SP1

Host OS: QNX® Neutrino® 6.3.0 or 6.3.0 SP1

Caution: If you installed the beta version of SP2, uninstall it before installing the production version.

If you've already used the IDE, back up all the workspace directories on your system before you install SP2. Each user has a $HOME/workspace directory. You'll need these backups if you later decide to uninstall SP2.

Note:
  • You must install QNX Momentics 6.3.0 before installing Service Pack 2. SP2 includes everything from Service Pack 1, so you don't have to install SP1 before installing SP2.
  • For more information about Service Pack 2, see the release notes, which you'll find in ${QNX_TARGET}/etc/readme/patches/6.3.0sp2/rel_6.3.0_SP2.html after you've installed SP2.
  • For the most up-to-date version of these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

Contents

System requirements

Minimum Recommended
Processor 2 GHz or more Intel Pentium 4 2 GHz or more Intel Pentium 4
RAM 256 MB 512 MB
Disk space (6.3.0 plus SP1 and/or SP2) 2.1 GB 2.1 GB
Monitor 1024×768 1280×1024

In order to install SP2, you need 650 MB of disk space, which includes the space required for backups and temporary space used in installing the files.

The System Profiler in the SP2 version of the IDE requires a minimum color depth of 16 bits.

BIOS settings

We recommend you use the following BIOS settings:

  • Disable Plug and Play OS.
  • Set any parallel ports and onboard serial ports to specific addresses, if possible, instead of using an automatic setting.

Related products

If you installed an earlier version of the following QNX Momentics products, you should install the latest version of them after you install SP2:

Product Version
Symmetric Multiprocessing Technology Development Kit (TDK) 1.0.2
Freescale Total5200/Lite5200EVB Board Support Package (BSP) 1.0.2
Renesas Lanbic BSP 1.0.0
Renesas EDOSK 7780 BSP 1.0.0
Platform Core Source Kit (SK) 1.0.1

Any other products that we've released for SP1 are compatible with SP2.

Installation procedure

The SP2 installer backs up the affected files, and it stores the backup in base_directory/backup/patches/6.3.0sp2/backup.tgz (see “Determining your base directory,” below).

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

  • base_directory/backup/patches/6.3.0sp2
  • base_directory/install/patches/6.3.0sp2

SP2 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 SP2.

Note:
  • 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 SP2 first. If you install the Standard Edition and then install SP2, if you want to upgrade to the Professional Edition, you must uninstall SP2 first. Similarly, if you don't install the SP2 version of the IDE, and later want to install it, you must uninstall SP2 first.
  • If you use the IDE, back up all the workspace directories on your system before you install SP2. Each user has a $HOME/workspace directory. You'll need these backups if you later decide to uninstall SP2.
  • Close all QNX Momentics applications before you install SP2.
  • If you haven't set your HOME environment variable, the SP2 installer sets it to be the directory where you installed QNX Momentics (e.g. /usr/qnx630).
Caution: Installing SP2 removes any third-party Eclipse plugins on your host. You'll have to reinstall them after installing SP2.

To install SP2, do the following:

  1. Log in as root.
  2. Log into your myQNX account on our website, and then go to the Download Center.
  3. Download the SP2 package, 6.3.0sp2-qnx6-nnnnnnnnnnn.sh, where nnnnnnnnnnn is the 11-digit build number. The package is a shell script.
  4. Run chmod to make the script executable. For example: 
    chmod a+x 6.3.0sp2-qnx6-20043030202.sh
  5. Run the script at the system prompt. For example: 
    ./6.3.0sp2-qnx6-20043030202.sh
  6. Follow the instructions on your screen.
Note: 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 SP2 on a self-hosted Neutrino system, qconfig erroneously lists 6.3.0 and 6.3.0 SP2 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 SP2

Note: If you previously installed SP1, uninstalling SP2 takes you back to SP1; if you previously installed only 6.3.0, uninstalling SP2 takes you back to 6.3.0.

You should uninstall QNX products in the reverse order in which you installed them. To determine this order, use a command like this: 

ls -lt `find base_directory -name "*uninstall*.sh"`

where base_directory is where you installed QNX Momentics.

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

Use our uninstaller to remove SP2; if you simply delete the directories, your machine might end up in an inconsistent state, and you might not be able to run the IDE.

To uninstall SP2, do the following:

  1. Log in as root.
  2. Go to the base_directory/install/patches/6.3.0sp2 directory (see “Determining your base directory,” below).
  3. Run the uninstaller script: 
    ./uninstall.sh
  4. If you use the IDE, restore each user's $HOME/workspace directory from the backups that you made before you installed SP2. You'll need to reimport any projects that you created in the IDE since you installed SP2.
Note: The 6.3.0 installer installed certain files under $QNX_TARGET, but didn't also install them under /. If you uninstall SP2, your system retains these files:
  • /lib/crt1.o
  • /lib/crtbegin.o
  • /lib/crtbeginG.o
  • /lib/crtend.o
  • /lib/crtendG.o
  • /lib/crti.o
  • /lib/crtn.o
  • /lib/mcrt1.o
  • /usr/bin/gdb — a symbolic link to ntox86-gdb
  • /usr/bin/ntoarm-gdb
  • /usr/bin/ntomips-gdb
  • /usr/bin/ntoppc-gdb
  • /usr/bin/ntosh-gdb
  • /usr/bin/ntox86-gdb
  • /usr/share/bison — a symbolic link to /usr/qnx630/host/qnx6/x86/usr/share/bison

as well as the following under $QNX_TARGET/x86/boot/fs:

  • qnxbase.ifs
  • qnxbasedma.ifs
  • qnxbasesmp.ifs

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

To determine whether or not you've installed SP2, check for the existence of the base_directory/install/patches/6.3.0sp2 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 documentation

After you've installed your development suite, you'll find an extensive set of online documentation in HTML format. Choose Help from the Launch menu or from the shelf on the right side of the screen, or look under the following directory:

${QNX_TARGET}/usr/help/product/momentics/bookset.html

This “roadmap” page contains links to the various HTML booksets that accompany the OS (e.g. System Architecture, Programmer's Guide, Library Reference, Utilities Reference, etc.).

You'll find the installation and release notes in the following directories:

6.3.0
${QNX_TARGET}/etc/readme/
SP2
${QNX_TARGET}/etc/readme/patches/6.3.0sp2/
Note:
  • SP2 includes all of the fixes in SP1; for more information, see the SP1 release notes, ${QNX_TARGET}/etc/readme/patches/6.3.0sp2/rel_6.3.0_SP1.html.
  • For the most up-to-date version of all these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

You can install and work with multiple versions of QNX Neutrino. Whether you're using the command line or the IDE, you can choose which version of the OS to build programs for. For more information, see the IDE User's Guide or the QNX Neutrino Programmer's Guide.

Note: Coexistence of 6.3.0 and 6.2.1 is supported only on Windows and Solaris hosts.

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 online version of the Welcome to QNX Momentics guide, or visit our website, www.qnx.com.

Note: The telephone numbers and email addresses for Technical Support in the printed version of the Welcome to QNX Momentics guide are now obsolete. (Ref# 26700)