QNX Technical Articles

Date of this edition: January 19, 2005

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: QNX Neutrino 6.3.0

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
• System requirements
• Keeping QNX Momentics 6.2
• Installation procedure
• Installing additional software or license keys
• Commercializing your evaluation software
• Creating a bootable floppy
• 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.

System requirements

Make sure that Plug and Play OS is disabled in the BIOS before you run QNX Neutrino.

Keeping QNX Momentics 6.2

For QNX Neutrino self-hosted development, it's possible to have both QNX Momentics 6.2.x and 6.3.0 installed on your computer at the same time. Here's how:

1. Boot your 6.2.x partition.
2. Use fdisk to change the partition type from 79 to 78 or 77:
   1. Start fdisk in interactive mode, specifying the correct disk number for n:

      fdisk /dev/hdn

   2. Save the details about your 6.2.x partition (e.g. by writing them on a piece of paper), because fdisk blanks the fields as you edit them.
   3. Choose your 6.2.x partition, by typing its partition number (1, 2, 3, or 4), or by using the Next and Previous commands. Remember the partition number.
   4. Press C to invoke the Change command.
   5. Change the partition type to 78 or 77, and then press Enter.
   6. Retype the starting and ending cylinder numbers, pressing Enter after each.
   7. If the partition was bootable before you changed its type, use the Boot command to make it bootable again.
   8. Save your changes.
3. Shut down 6.2.x.
4. Install QNX Momentics 6.3.0 into an empty partition. Remember the partition number.

When you boot, you're asked to choose the partition by its number. If you're prompted to choose from multiple .diskroot files, choose the one that corresponds to the partition:

• For 6.3.0, select the one with hd0t79 in its path.
• For 6.2.x, select the one with hd0t78 or hd0t77 (depending on which type you assigned to the partition) in its path.

Installation procedure

You must do a fresh installation of this software. If you want to retain an earlier released version of QNX Momentics, see "Keeping QNX Momentics 6.2," above. If you installed a beta version of QNX Momentics 6.3.0, you should replace it with the released product.

QNX Momentics 6.3.0 includes everything you need to build for all supported platforms (ARM, MIPS, PowerPC, SH-4, XScale, and x86). This CD includes the runtime version of the QNX Neutrino RTOS, as well as development tools that you can optionally install.

To install this software:

1. Insert the QNX Momentics 6.3.0 Installation CD in the CD drive.
2. Boot from the CD and follow the instructions on your screen.

   When you type your license key, it doesn't matter if you include or omit the hyphens. Note that in text mode, we support only the US keyboard layout.

   When prompted, indicate whether or not you wish to install the optional components of the development suite. For development, we recommend you install all available components. To install only the QNX Neutrino x86 runtime, don't install any of the optional components.

3. Remove the CD from the drive and then reboot.
4. Log in as root or click Superuser. This account initially has no password.

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 selecting Configure-->Activate License from the Launch menu, or by entering the following at a terminal prompt: /etc/qnx/bin/qnxactivate -a

Installing additional software or license keys

If you didn't initially install all of the available features or if you've purchased an upgraded license, you can install new or remaining features as follows:

1. Insert the CD and run the install script in the root of the CD. For example, at a command prompt, type:

   /fs/cdn/install

   where n is the number of the CD drive.

   (There's also an install2 script on the CD, but you should ignore it.)

2. Follow the instructions on the screen to select the features to install.

The system won't prompt you for a new license key when you do the above. If you need to enter a new license key, choose Configure-->Add License from the Launch menu, or type: qinst l license_key

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. Choose Configure-->Add License from the Launch menu, or 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.

Creating a bootable floppy

We recommend that you install QNX Momentics on a machine that can boot from a CD-ROM. If your machine can't do this, you can create a bootable floppy.

The root directory of the QNX Momentics installation CD contains an image of a bootable floppy, named instflop.dat. To copy this file to a boot disk:

• On UNIX-style machines (including QNX Neutrino), use the dd utility to copy this image to a boot disk:

  dd if=instflop.dat of=/dev/fd0

• On Windows, you need a raw-copy utility. Although we don't support any such utilities, we recommend you use rawwrite, which you can find at:

  http://uranus.it.swin.edu.au/~jn/linux/rawwrite.htm

  Download this utility and extract it to a folder.

  To create a bootable floppy:

  1. Start rawwrite.
  2. Make sure the Floppy Drive combo box refers to your floppy drive.
  3. Under the Write tab, specify the location of instflop.dat in the Image File field, and click Write.

Getting started with the docs

For information about QNX Momentics 6.3.0:

• Read the Release Notes on the CD.
• Click the Welcome button at the upper right corner of your screen (or view ${QNX_TARGET}/etc/welcome/index.html).
• Choose Help from the Launch menu to see the online documentation (or view ${QNX_TARGET}/usr/help/product/momentics/bookset.html).

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.

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