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

QNX Technical Articles

QNX® Momentics® Development Suite 6.3.0 SP2 to SP3 Upgrade Professional and Standard Editions Installation Note - Solaris Hosts

QNX® Momentics® Development Suite 6.3.0 SP2 to SP3 Upgrade

Date of this edition: September 29, 2006

Target OS: QNX® Neutrino® 6.3.0 SP2

Host OS: Sun Solaris 7, 8, 9, or 10

Caution: If you installed a beta version of this software, uninstall it before installing the production version.
Note:
  • We're deprecating support for Solaris 7, 8, and 9; QNX Momentics 6.3.0 is the last release that you can install on these hosts.
  • Before installing the SP2 to SP3 Upgrade, you must install:
    1. QNX Momentics 6.3.0
    2. QNX Momentics 6.3.0 Service Pack 2

    The SP2 to SP3 Upgrade includes the latest documentation, including the Documentation Update 1.0.0. Don't install the Documentation Update 1.0.0 after installing the SP2 to SP3 Upgrade, or your system's documentation will be in an inconsistent state.

    For a fresh installation of QNX Momentics, install Service Pack 3 instead of the SP2 to SP3 Upgrade.

  • For more information about the SP2 to SP3 Upgrade, see the release notes, which you'll find in base_dir/install/patches/6.3.0sp2tosp3/rel_6.3.0sp2tosp3.html, where base_dir is where you installed QNX Momentics (see the output of the qconfig command).
  • 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

Host OS: Solaris 7, 8, or 9

Minimum Recommended
Workstation Sparc Ultra 5 Sparc Ultra 10
RAM 256 MB 512 MB
Disk space 1.9 GB 1.9 GB
Monitor 1024×768 1280×1024

You need at least 500 MB of free swap space to install this software.

Note: Make sure you've installed the appropriate patch to run the 1.4.2 VM under Solaris. You can download the patch from the Downloads section of java.sun.com; choose Java 2 Platform, Standard Edition (J2SE), then J2SE 1.4.2, then the appropriate patch under Solaris OS Patches (or go directly to http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/J2SE).

You'll need these patches:

Solaris 7
106300-21 106327-20 106541-30 106950-24 106980-23 107081-55 107226-19 107544-03 107636-10 107656-11 107702-12 107834-04 108374-07 108376-44
Solaris 8
108434-13 108435-13 108528-28 108652-76 108773-18 108921-18 108940-57 108987-13 108989-02 108993-31 109147-27 109326-12 110386-03 110615-10 111023-03 111111-03 111308-04 111310-01 111317-05 112003-03 112396-02 112438-02 112472-01 113648-03 115827-01 116602-01
Solaris 9
112785-30 113096-03
Note: Reboot your machine after installing these patches and before installing QNX Momentics. The installer checks to make sure you've installed the right patches.

In order to install the SP2 to SP3 Upgrade, you need 77 MB of disk space, including the space required for backups and temporary space used in installing the files. About half of this disk space must be where your temporary directory resides. The SP2 to SP3 Upgrade needs only 53 MB once it's installed, because it replaces some existing 6.3.0 files.

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

SP3 update paths

There are several ways that you incorporate QNX Momentics 6.3.0 Service Pack 3 in your system, depending on what you've already installed:

SP3 update paths

Here's a summary:

  • To do a fresh installation, use QNX Momentics 6.3.0 Service Pack 3.
  • If you've already installed 6.3.0 SP2, install the 6.3.0 SP2 to SP3 Upgrade.
  • You can install the QNX Neutrino Core OS 6.3.2A on a system that has SP3, or SP2 plus the 6.3.0 SP2 to SP3 Upgrade.
  • If you've installed the QNX Neutrino Core OS 6.3.2 or the QNX Neutrino Core OS 6.3.2A on a system that has 6.3.0 SP2, and you want to upgrade to SP3, install the 6.3.0 SP2 to SP3 Upgrade.

    Installing the 6.3.0 SP2 to SP3 Upgrade on a system with the QNX Neutrino Core OS 6.3.2 updates the core OS to 6.3.2A.

Installing the SP2 to SP3 Upgrade

The SP2 to SP3 Upgrade installer backs up the affected files, and it stores stores the backup in base_directory/install/backup/patches/6.3.0sp2tosp3/backup.jar (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 the SP2 to SP3 Upgrade, you must delete these directories:

  • base_directory/install/backup/patches/6.3.0sp2tosp3
  • base_directory/install/patches/6.3.0sp2tosp3

The SP2 to SP3 Upgrade doesn't change any user files. For a list of the affected files, see base_directory/install/patches/6.3.0sp2tosp3/shiplist after installing the SP2 to SP3 Upgrade.

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 the SP2 to SP3 Upgrade first. If you install the Standard Edition and then install the SP2 to SP3 Upgrade, if you want to upgrade to the Professional Edition, you must uninstall the SP2 to SP3 Upgrade first.
  • Close all QNX Momentics applications before you install the SP2 to SP3 Upgrade.
  • If you haven't set your HOME environment variable, the installer sets it to be the directory where you installed QNX Momentics (e.g. /opt/qnx630).

To install the SP2 to SP3 Upgrade, 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 to SP3 Upgrade package, momentics-6.3.0sp2tosp3-nnnnnnnnnnn-solaris.bin, where nnnnnnnnnnn is the 11-digit build number. The package is a .bin script.
  4. Run chmod to make the script executable. For example: 
    chmod a+x momentics-6.3.0sp2tosp3-20061631018-solaris.bin
  5. Run the script at the system prompt. For example: 
    ./momentics-6.3.0sp2tosp3-20061631018-solaris.bin
    Note: If InstallShield complains that it can't find a JVM, make sure that you've successfully installed QNX Momentics 6.3.0 before you try to install the SP2 to SP3 Upgrade.
  6. Follow the instructions provided by InstallShield.

Uninstalling the SP2 to SP3 Upgrade

Note: 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*.bin"`

where base_directory is where you installed QNX Momentics.

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

Use our uninstaller to remove the SP2 to SP3 Upgrade; 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 the SP2 to SP3 Upgrade, do the following:

  1. Log in as root.
  2. Go to the base_directory/_uninstall/6.3.0sp2tosp3 directory (see “Determining your base directory,” below).
  3. Start the QNX InstallShield application: 
    ./uninstaller.bin

    InstallShield will now remove the SP2 to SP3 Upgrade.

How can I tell if I've already installed the SP2 to SP3 Upgrade?

To determine whether or not you've installed the SP2 to SP3 Upgrade, use the qconfig command.

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: /opt/qnx630/
           QNX_HOST: /opt/qnx630/host/solaris/sparc
         QNX_TARGET: /opt/qnx630/target/qnx6/

The base directory in this example is /opt/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. 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 base_dir/install/patches/6.3.0sp2tosp3 directory, where base_dir is where you installed QNX Momentics (see the output of the qconfig command).

Note:
  • 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.
  • By default, the IDE uses Mozilla (which isn't installed) as the browser for displaying help documentation. You need to change this to hotjava; in the IDE, choose Windows-->Preferences-->Help and change the Custom Browser Command from mozilla %1 to hotjava %1.

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.

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.