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

QNX Technical Articles

QNX® Momentics® Professional Edition IDE 4.0.1 Installation Note -- Linux Hosts

QNX® Momentics® Professional Edition IDE 4.0.1

Date of this edition: April 12, 2007

Target OS: QNX® Neutrino® 6.3.0 SP1 or later

Host OS: Linux Red Hat 8 or 9, Red Hat Enterprise WS 3 or 4, Red Hat Fedora Core 3 or 4, Debian 3.1, or SUSE 10

For more information about IDE 4.0.1, see the release notes, which you'll find in IDE_directory/install/ide/4.0/rel_ide_4.0.1.html after you've installed IDE 4.0.1. For the most current version of these notes, go to our website, www.qnx.com, log in to your myQNX account, and then go to the Download Center.

Note:
  • We're deprecating support for Linux Red Hat 8 and 9; QNX Momentics 6.3.0 is the last release that you can use with these host versions.
  • As of Eclipse 3.2, Motif is no longer supported for Linux or Solaris hosts. As a result, we're deprecating support for the IDE on Linux Red Hat 8 and 9. IDE 4.0.1 is the last version of the IDE that you can use on these hosts.
Caution: If you installed an experimental version of this software, uninstall it before installing the production version.

Contents

System requirements

Host OS:

  • Linux Red Hat 8 or 9
  • Red Hat Enterprise Linux WS 3 or 4
  • Red Hat Fedora Core 3 or 4
  • Debian Linux 3.1
  • SUSE Linux 10
Minimum Recommended
Processor Pentium III, 700 MHz Pentium 4, 2 GHz or more
RAM 256 MB 512 MB
Disk space 1.6 GB 1.6 GB
Monitor 1024*768 1280*1024

In order to install IDE 4.0.1, you need 440 MB of disk space, including temporary space used in installing the files. About half of this disk space must be where your temporary directory resides.

Note: Depending on the version of Linux that you're using, you might need some additional libraries to support the advanced graphics (e.g. alpha blending, antialiasing, patterns and transformations) used in some perspectives and views. If you receive the following error: 
SWTException: Unable to load graphics library

you need to download the Cairo library from http://cairographics.org. You should install the library in /usr/lib or have a symbolic link from /usr/lib/libcairo.so to wherever you installed the library, so that all users on the system can access it. (Ref# 39915)

Installing IDE 4.0.1

Note: If you have an existing installation of IDE 4.0 on your machine, you can use the IDE Software Updates manager to update the IDE to version 4.0.1 (see "Upgrading using the IDE Software Update manager"); otherwise, you will need to follow the alternate installation instructions for a new installation (see "Performing a new installation of the IDE") .

IDE 4.0.1 doesn't change any user files. For a list of the affected files, see IDE_directory/install/ide/4.0.1/shiplist after installing IDE 4.0.1.

Note:
  • If you don't install all the components of QNX Momentics, and you install IDE 4.0.1, then if you later decide to install additional components, you must uninstall IDE 4.0.1 first. If you install the Standard Edition and then install IDE 4.0.1, if you want to upgrade to the Professional Edition, you must uninstall IDE 4.0.1 first.
  • If you haven't set your HOME environment variable, the IDE 4.0.1 installer sets it to be the directory where you installed QNX Momentics (e.g. /opt/qnx630).
  • If you're running selinux (secure Linux), disable it before installing IDE 4.0.1. Otherwise, the installation might fail with the following error: 
    java.lang.UnsatisfiedLinkError: no qnxlic in java.library.path
Caution: Installing IDE 4.0.1 removes any third-party Eclipse plugins on your host. You'll need to reinstall them after installing IDE 4.0.1.

Upgrading using the IDE Software Update manager

If you have an existing installation of IDE 4.0 on your machine, you can use the IDE Software Updates manager to update the IDE to version 4.0.1.

To update from IDE 4.0 to 4.0.1 using the Software Updates manager:

  1. Log in as a user who has system-administrator privileges.
  2. Start the QNX Momentics IDE.
  3. Click Help-->Software Updates-->Find and install.
  4. Select Search for updates of the currently installed features.
  5. Click Finish.
  6. If prompted for an update site, click OK to select the default update site, or choose another mirror site from the list.
  7. When prompted, log into your myQNX account with a valid user name and password, and then click OK.
  8. Select QNX Momentics Update Site.

    You can expand QNX Momentics Update Site to see the selection of QNX momentics IDE 4.0.1.v20070221-LXrUHoJhrJnxRzy for installation.

  9. Click Next.
  10. Carefully review the license agreements for the update. If the terms of all these licenses are acceptable, select I accept the terms in the license agreements. Do not proceed to download the features if the license terms are not acceptable. If a feature selected for installing includes optional features, a page is displayed to let you select whether you want to continue.
  11. Click Next.
  12. Click Finish.
  13. Click Install All to allow the installation process to proceed.
  14. After the new feature and plugins are downloaded successfully, and their files are installed into the IDE on the local computer, a new configuration is formulated.
  15. Click Yes when prompted to exit, and restart the workbench for this update to take effect.

Optionally, you can install the SDK only after you've successfully installed the IDE 4.0.1 update.

To install the SDK:

  1. From within the IDE, click Help-->Software Updates-->Find and install.
  2. Select Search for new features to install.
  3. Click Next.
  4. Select QNX Momentics Update Site.
  5. Click Finish.
  6. When prompted, log into your myQNX account and click OK.
  7. Expand QNX Momentics Update Site and select Eclipse SDK Updates.
  8. Click Next.
  9. Carefully review the license agreements for the update. If the terms of all these licenses are acceptable, select I accept the terms in the license agreements. Do not proceed to download the features if the license terms are not acceptable. If a feature selected for installing includes optional features, a page is displayed to let you select whether you want to continue.
  10. Click Next.
  11. Click Finish.
  12. Click Install All to allow the installation process to proceed.
  13. Click Yes when prompted to exit and restart the workbench for this update to take effect.

Next, you will need to update qconn.

To update qconn on your development system:

  1. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu.
  2. Click OK to agree to let the IDE update qconn.

Next, you will need to determine if you need to install the optional Memory Analysis Tool Patch. For instructions about this patch, see "Updating the Memory Analysis Target Patch".

If you need to install this patch, go to the QNX Download Center (from the QNX website, click Download Center-->Products & Updates-->QNX Momentics-->QNX Momentics 6.3.x-->QNX Momentics 6.3.0 Service Pack 2 and related downloads-->QNX Momentics 6.3.0 Service Pack 2 Patches and Updates and to download the patch-630SP2-0525-malloc-g.tar. Follow the instructions in the installation notes for the Memory Analysis Target Patch (ID 525).

Performing a new installation of the IDE

Note:

Close all QNX Momentics applications before you install IDE 4.0.1. If you've installed IDE 4.0, you must uninstall it before installing IDE 4.0.1.

If you currently have IDE 4.0 installed and you do not use the IDE Software Updates manager to update the IDE, you must first uninstall IDE 4.0 before you can install IDE 4.0.1. Close all QNX Momentics applications before you begin this process. For detailed instructions about uninstalling IDE, see "Uninstalling the IDE".

To install IDE 4.0.1, do the following:

  1. Log in as root.
  2. On Debian 3.1 hosts, set up your environment by typing: 
    source /etc/profile
  3. Log into your myQNX account on our website, and then go to the Download Center.
  4. Download the IDE 4.0.1 package, ide-4.0.1-nnnnnnnnnnn-linux.bin, where nnnnnnnnnnn is the 11-digit build number. The package is a .bin script.
  5. Run chmod to make the script executable. For example: 
    chmod a+x ide-4.0.1-20070382300-linux.bin
  6. Run the script at the system prompt. For example: 
    ./ide-4.0-20070382300-linux.bin
    Note: If you have a separately installed JVM, there will be a 30 second delay while the installer searches for it. To avoid this delay, use the -is:javahome JVM_DIR option to direct the installer to use the specified JVM.

    During the installation process, you'll be prompted to install the libmalloc patch. For information about this patch, see "Updating the Memory Analysis Target Patch".

  7. Follow the instructions provided by InstallShield.
  8. Next, you will need to determine the additional patches you should install:
    • qconn Patch for IDE 4.0.1 -- the patch ID you use depends on which version of the OS you've installed: Patch ID 0486 (Core OS 6.3.2 or 6.3.2A), Patch ID 0487 (6.3.0 SP2 or 6.3.0 SP3), or Patch ID 0488 (6.3.0 SP1). You need to apply this update as described in the Installation Notes for the individual patch files.

      You can also let the QNX Software Updates installer automatically update qconn for you. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu, and click OK to let the IDE update qconn on your host.

    • If InstallShield doesn't display the release notes, launch a browser and use it to display IDE_directory/install/ide/4.0/rel_ide_4.0.1.html.
    • If you're installing on a Red Hat Enterprise version 4 host, log out and back in again.
Note:
  • For profile shared libraries and DLLs with the Application Profiler, you need to update libc on your host system by downloading the libc Patch for IDE 4.0 (Patch ID 383) from our website and installing it on your system.
  • You must set LD_LIBRARY_PATH before running the IDE; otherwise, your licensing will fail. Launch the IDE using this command line:

    LD_LIBRARY_PATH=$QNX_HOST/usr/bin:$LD_LIBRARY_PATH   installation_dir/eclipse/qde

    where installation_dir is the directory you installed the IDE in, as defined in /etc/qnx/qconfig/qnx_ide_4.0.xml. (Ref# 39660)

  • The first time you use the IDE, you're prompted to choose a location for your workspace. If you already have a workspace, choose a different location because the IDE 4.0.1 workspace might not be compatible with earlier versions of the IDE.

Updating the Memory Analysis Target Patch

Before installing this patch, you need to determine the patch number of the Memory Analysis Target Patch that you have currently installed on your system.

To verify if you should install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525) on your system:

  1. For Linux, start a shell.
  2. Navigate to the location base_dir/patches.
  3. Run the following command:

    ls */rel*libmalloc_g*.html

    If the command returns the message "No such file or directory", install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525).

    If the command returns one or more files, each file will have the following format:

    630<version>-<number>/rel_libmalloc_g_patch<number>.html

    where version is the product version identifier assigned to the patch, and number is the identifier assigned to the patch.

    If you have only files in which the number is less than 0525, then you should install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525). Otherwise, if the number is greater than 0525, and the patch with that number has been applied on your system, then you should not install patch 0525.

Installing the IDE qconn update

After you've installed IDE 4.0.1, you may need to update qconn on your target systems to take advantage of the new features. IDE 4.0.1 will work with older versions of qconn, but not all features will be available.

Note: Only users with system administrator privileges (host and target) can perform the qconn update.

To update qconn on your development system:

  1. In IDE 4.0.1, choose Software Updates-->Qconn Updates... from the Help menu.
  2. Agree to let the IDE update qconn on your host.

You then need to update the version of qconn on your target machine. How you do this depends on your target system; you might have to build a new image, or you might simply have to copy the new version to your target. For example:

  1. Use slay qconn on the target to stop any existing qconn.
  2. Copy $QNX_TARGET/target/usr/sbin/qconn to your target system's /usr/sbin directory.
  3. Make sure the qconn in the target's /usr/sbin directory is executable; if it isn't, use chmod +x to make it executable.
  4. On the target, launch the new qconn.

Uninstalling the IDE

Note: Before you can uninstall QNX Momentics completely, you must uninstall qconn (if previously installed), followed by the IDE, and then any BSPs, DDKs, TDKs, or other products.
Caution: Use our uninstaller to remove the IDE; if you delete the directories, your machine might end up in an inconsistent state, and you may not be able to run the IDE.

To uninstall the IDE, do the following:

  1. Log in as root.
  2. If you have the qconn update installed, you will need to uninstall it.
    1. Start the QNX Momentics IDE.
    2. Select Help-->Software Updates-->Qconn Updates
    3. Click OK when you are prompted to uninstall qconn.
    4. Close the QNX Momentics IDE.
  3. Go to the IDE_directory/_uninstall/ide/4.0.1 directory, where IDE_directory is the directory that you installed the IDE.
  4. Start the QNX InstallShield application: 
    ./uninstaller.bin

    InstallShield will now remove the IDE from your computer. It also restores qconn and the malloc libraries.

How can I tell if I've already installed IDE 4.0.1?

To determine whether or not you've installed IDE 4.0.1:
Run the qconfig command and look for IDE 4.0.1 in the output.

To see what qconfig's output looks like, see the "Determining your base directory," section 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 SP3
            Version: 6.3.0 SP3
     Base Directory: /opt/qnx630
           QNX_HOST: /opt/qnx630/host/win32/x86
         QNX_TARGET: /opt/qnx630/target/qnx6

Additional Packages

          Package Name: QNX Momentics Professional Edition IDE
               Version: 4.0.1
                  Base: QNX Momentics 6.3.0 SP1, SP2, or SP3
          Install Path: /opt/qnx/Momentics/IDE40

The base directory in this example is /opt/qnx/Momentics/IDE4, but it could be different on you machine, depending on where you installed QNX Momentics.

Getting started with the documentation

After you've installed our development suite, you'll find an extensive set of online documentation in HTML format. In the IDE, choose Help-->Help Contents, and then click on QNX Momentics Professional Edition.

You might want to start with A Roadmap to the QNX Momentics Professional Edition. 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.).

Note: This package doesn't update the QNX Momentics documentation outside the IDE (i.e. the version in ${QNX_TARGET}/usr/help/product).

You'll find the installation and release notes in the IDE_directory/install/ide/4.0.1 directory, where IDE_directory is the directory where you installed the IDE (for example, on Linux, the default is /opt/qnx/Momentics/IDE4).

Note: For the most up-to-date version of all these notes, go to our website, www.qnx.com, log into your myQNX account, and then go to the Download Center.

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.

Note: 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 Welcome to QNX Momentics guide or visit our website, www.qnx.com.