QNX Technical Articles

Date of this edition: January 19, 2005

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Sun Solaris 7/8

If you've already installed an evaluation version of QNX Momentics 6.3.0, and you've purchased and received a commercial QNX License Certificate, please go to "Commercializing your evaluation software," below. 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. We highly recommend that you install Service Pack 1 after installing QNX Momentics 6.3.0. For more information, see the Download Center area of our website.

Contents

• Technical support
• Minimum system requirements
• Installation procedure
• Commercializing your evaluation software
• Uninstalling QNX Momentics
• Getting started with the docs

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.

Minimum system requirements

• Solaris 7/8
• Sparc Ultra 5 workstation
• 256M RAM
• 1.5G disk space.

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

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

Reboot your machine after installing these patches and before installing QNX Momentics. The installer checks to make sure you've installed the right patches.

Installation procedure

QNX Momentics 6.3.0 includes everything you need to build for all supported platforms (ARM, MIPS, PowerPC, SH-4, XScale, and x86).

If you installed a beta version of QNX Momentics 6.3.0, you must uninstall it before installing the released version. See "Uninstalling QNX Momentics," below.

To install this software:

1. Boot into Solaris and log in as root.
2. Insert the QNX Momentics 6.3.0 Installation CD in the CD drive.
3. Type this at a command prompt:

   /cdrom/cdrom0/qnxSetupSolarisSparc.bin
     

   You don't need to specify any options or arguments.

4. Follow the instructions on your screen.

   ---

   The installer doesn't close the window that it uses to indicate its progress. You can close it when the installation is complete.

   ---

Congratulations -- you've completed the installation!

After installing, you're asked to activate the product, either online or by email. If you don't activate the product within the specified timeframe, the product will cease to function until you activate it. No personal data is transferred during the activation process. If you choose not to activate at the time of installation, you can activate later by entering the following at a terminal prompt: /etc/qnx/bin/qnxactivate -a

Commercializing your evaluation software

If you installed an evaluation copy of QNX Momentics 6.3.0, and you've now received a commercial QNX License Certificate, do the following to add your commercial license:

1. Type the following at a terminal prompt:

   /etc/qnx/bin/qnxactivate -l
     

2. In the QNX Momentics License Key Entry dialog, fill in the field with the license-key information that's on your commercial QNX License Certificate.
3. When you've finished entering the information, click Add to save the license-key information and configure your QNX Momentics tools to use this file.

Uninstalling QNX Momentics

To uninstall QNX Momentics, log in as root, go to the directory where you installed QNX Momentics, and then run _uninstall/qnx630/uninstaller.bin.

Getting started with the docs

For information about QNX Momentics 6.3.0, see:

• the Release Notes on the CD
• the Welcome message at ${QNX_TARGET}/etc/welcome/index.html
• the online documentation at ${QNX_TARGET}/usr/help/product/momentics/bookset.html.

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.