QNX Technical Articles
QNX® Momentics® Development Suite 6.3.0 Service Pack 2 Professional and Standard Editions Installation Note -- Linux Hosts
Date of this edition: August 25, 2006
Target OS: QNX® Neutrino® 6.3.0 or 6.3.0 SP1
Host OS: Linux Red Hat 8, 9, or Enterprise WS 3 or 4
 |
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. |
 |
|
Contents
- System requirements
- Related products
- Installation procedure
- Uninstalling SP2
- How can I tell if I've already installed SP2?
- Determining your base directory
- Getting started with the documentation
- Technical support
System requirements
| Minimum | Recommended | |
|---|---|---|
| Host OS | Linux Red Hat 8.0 or 9.0 | Linux Red Hat Enterprise WS 3 or 4 |
| Processor | Pentium III, 700 MHz | Pentium 4, 2 GHz or more |
| RAM | 256 MB | 512 MB |
| Disk space (6.3.0 plus SP1 and/or SP2) | 1.6 GB | 1.6 GB |
| Monitor | 1024×768 | 1280×1024 |
In order to install SP2, you need 770 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. SP2 needs only 350 MB once it's installed, because it replaces some existing 6.3.0 files.
The SP2 installer doesn't support JRE 1.5. The installer needs the Sun JVM; it doesn't work with the IBM JVM.
The System Profiler in the SP2 version of the IDE requires a minimum color depth of 16 bits.
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/install/backup/patches/6.3.0sp2/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 SP2, you must delete these directories:
- base_directory/install/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.
|
|
|
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:
- Log in as root.
- Log into your myQNX account on our website, and then go to the Download Center.
- Download the SP2 package, 6.3.0sp2-linux-nnnnnnnnnnn.bin, where nnnnnnnnnnn is the 11-digit build number. The package is a .bin script.
- Run chmod to make the script executable. For example:
chmod a+x 6.3.0sp2-linux-20043030202.bin
- Run the script at the system prompt. For example:
./6.3.0sp2-linux-20043030202.bin
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 SP2. - Follow the instructions provided by InstallShield.
- If InstallShield doesn't display the release notes, launch a browser and use it to display ${QNX_TARGET}/etc/readme/patches/6.3.0sp2/rel_6.3.0_SP2.html.
- If you're installing on a Red Hat Enterprise version 4 host, log out and back in again.
Uninstalling SP2
|
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*.bin"` where base_directory is where you installed QNX Momentics. |
|
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:
- Log in as root.
- Go to the base_directory/_uninstall/6.3.0sp2 directory (see “Determining your base directory,” below).
- Start the QNX InstallShield application:
./uninstaller.bin
InstallShield will now remove SP2.
- 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.
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: /opt/qnx630/
QNX_HOST: /opt/qnx630/host/linux/x86/
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 following directories:
- 6.3.0
- ${QNX_TARGET}/etc/readme/
- SP2
- ${QNX_TARGET}/etc/readme/patches/6.3.0sp2/
|
|
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 (we didn't support Linux hosts in 6.2.1). |
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.
|
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) |