Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® 4 Product Suite 2011 Installation Note

Date of this edition: June 08, 2011


Caution: If you installed an experimental version of this software, uninstall it before installing the production version.

Contents...

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

Parts list

The QNX 4 Product Suite 2011 comes in these forms:

  • a physical package that includes the QNX 4 Product Suite 2011 CD.

    If you've purchased new licenses, you will have also received a license certificate for the products you purchased. You might also have received a floppy diskette (labeled “Bootable Install/License Disk”).

  • an ISO image that you can download from our website, www.qnx.com

About the QNX 4 Product Suite

Each edition of the QNX 4 Product Suite contains the latest releases of the QNX Software Systems product offerings for the QNX 4 operating system. With the appropriate software license keys, you can install software products or modules from this CD or ISO onto the hard drive of your computer.

You can use this CD or ISO to install QNX 4 products for the first time (onto a standard desktop PC) or to upgrade QNX 4 products you've installed before.


Note: Before installing these products, be sure to read the release notes. In particular, make sure that you read and understand the “Security updates” section.

Be sure to select your time zone carefully during the installation. For information about the current North American time zones, see the Changes to Daylight Saving Time in North America technote in the Products-->Operating System-->QNX RTOS v4 area of our website. Also, make sure that the keyboard selection (in the bottom left corner of the screen) is correct.

System requirements

If you're downloading this product suite from our website, you'll need a computer that you can use to burn a CD.

The system that you want to install QNX 4 on should have at least the following:

  • sufficient free hard disk space — the amount depends on how many products you plan to install (you'll need about 200 MB to install a typical development environment, 500 MB to install everything in the ISO)
  • 1.44M floppy drive (optional)
  • 12 MB RAM
  • ATAPI (IDE), SATA, or SCSI CD-ROM drive
  • VGA-compatible graphics display
  • AT-compatible keyboard
  • mouse (not absolutely required, but highly recommended)

Note:
  • If your QNX 4 computer has a SATA drive, modify the BIOS so that the controller uses IDE legacy/compatibility mode. (Ref# 56067)
  • You can't install the QNX 4 Product Suite on the following:
    • Dell Latitude D830 (Ref# 72181)
    • Dell Latitude E5500 (Ref# 72180, 72181)
  • The boot utility now correctly calculates the CPU frequency on most processors. If your PC fails to boot, edit the buildfile for the OS image, use the boot command's new -c option to specify the CPU frequency (in MHz), and then build a new OS image. For more information, see the Building an OS Image chapter of the Installation & Configuration guide. (Ref# 43481)

Download the ISO

If you don't have a physical QNX 4 Product Suite 2011 CD, start by downloading the ISO onto a computer that can burn CDs:

  1. Go to our website, www.qnx.com, log into your myQNX account, and then go to the QNX RTOS 4.x part of the Download area.
  2. Download the ISO for the QNX 4 Product Suite 2011, and then burn it to a CD.
  3. Proceed as described below for a first-time installation or to upgrade an existing QNX 4 system.

First-time installation

  1. Insert the CD in the CD-ROM drive.
  2. If your system can boot from floppy, but not from CD, insert the Bootable Install/License Disk into the floppy drive.
  3. Reboot your PC and follow the instructions on your screen.

    If you run into any problems during the installation, you should try the online Installer's various debug options. You could also try installing on a different machine — your problem may be the hardware. If you're still having trouble, see Technical support,” below.

  4. When the installer prompts you for license keys, enter the keys from your license certificate, or use the Bootable Install/License Disk as instructed.

    Note: Press Start / F2 to begin installing the packages that you've provided license keys for. If you press Finish / F3, phinstall doesn't install anything, and you won't be able to successfully boot your system.

  5. Reboot and get started with the online docs for each product. Use the Photon Helpviewer or our Voyager HTML browser to view the docs.

Upgrading existing QNX 4 software

To update the software on an existing QNX 4 system, you can either boot from the CD, or run phinstall manually.

Booting from the CD

To upgrade by booting from the CD, do the following:

  1. Insert the CD in the CD-ROM drive.
  2. If your system can boot from floppy, but not from CD, insert the Bootable Install/License Disk into the floppy drive.
  3. Reboot your PC and follow the instructions on your screen.
  4. On the Choose a Target for the QNX Filesystem panel, select Allow Upgrades / F7.
  5. Press Start / F2. The next panel has Allow upgrading selected.
  6. Press Start / F2. The installer indicates which packages (and versions) you currently have installed on your system.
  7. For each product that you want to update, do the following:
    1. Click on the + box to expand each component, repeating for each subcomponent until the round markers are displayed.
    2. If the round marker for the latest patch isn't green, select it. The round marker for the currently installed patch level turns yellow, and a check mark appears in the marker for the latest patch.
  8. Press the Start/F2 button or press F2, and follow the prompts.

Running phinstall manually

To upgrade by running phinstall manually, do the following:

  1. Boot your system, log in as root, and then start Photon.
  2. If the Iso9660fsys driver isn't already running, start the driver and reassign the CD-ROM drive as follows:
    
    Iso9660fsys &
    prefix -A /cd=/cdX
      

    where X is the number assigned to your CD-ROM drive (e.g. 0).

  3. As a precaution, we suggest that you back up /etc/passwd and /etc/shadow — perhaps on a diskette — before you start updating your system. If the update is successful, and all users can successfully login, you can delete the backup files.
  4. Insert the QNX 4 Product Suite 2011 CD in the system's CD drive.
  5. Start the QNX package installer, /cd/bin/phinstall. For detailed instructions, see Using phinstall,” below.

    The installer indicates which packages (and versions) you currently have installed on your system.

  6. For each product that you want to update, do the following:
    1. Click on the + box to expand each component, repeating for each subcomponent until the round markers are displayed.
    2. If the round marker for the latest patch isn't green, select it. The round marker for the currently installed patch level turns yellow, and a check mark appears in the marker for the latest patch.
  7. Press the Start/F2 button or press F2, and follow the prompts.
  8. After completing the installation:
    • Make any necessary changes to configuration files.
    • If necessary, rebuild your OS boot image. For details on rebuilding boot images, see the Building an OS Image chapter of the QNX 4 Installation and Configuration guide.
  9. Although it isn't always necessary, we suggest that you reboot your system to ensure that everything is in a consistent state.
  10. Make sure that all users are able to login successfully:
    • If they can't login, restore /etc/passwd and /etc/shadow from the backups that you made before starting the update.
    • If they can login, delete /etc/shadow.qcrypt.

Using phinstall

Photon 1.13 or later?

If you're running Photon 1.13 or later, you can launch the Installer simply by clicking the Add/Remove Programs icon.

If you're running anything else

If you're running any of the following:

  • Photon 1.12 or earlier
  • X Window System for QNX
  • QNX Windows

then you must run the installer from a QNX 4 text-mode console (i.e. exit to text mode from your windowing system first!) by entering this command:

/cd/bin/phinstall

Old FLS fonts and Photon 1.14?

To use your existing Foreign Language Supplement (FLS) fonts for Chinese, Japanese, or Cyrillic with Photon 1.14, you must first remove the *sll and the P* shared libraries (under /dev/shmem) and then run phinstall.

Keyboard input

To avoid mouse conflicts on your system, this CD version of the Installer won't start a mouse driver — only keyboard input will work. You can navigate with these keys:

To: Press:
Go to the next button or text field Tab
Go to the previous button or text field Shift-Tab
Toggle an option Space
Make a selection Enter
Move up and down Up and down arrow keys
Expand an item Right arrow key
Collapse an item Left arrow key

If you wish, you can start the mouse driver that's appropriate for your system.

Online documentation

You can read our HTML-based online documentation by using the Photon Helpviewer or a browser, such as our Voyager HTML browser.

Technical support

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.


© 2011, QNX Software Systems Limited. All rights reserved.

QNX, Photon, Photon microGUI, Voyager and Foundry27 are trademarks of QNX Software Systems Limited, which are registered and/or used in certain jurisdictions. All other trademarks belong to their respective owners.