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 -- Solaris Hosts

QNX® Momentics® Professional Edition IDE 4.0.1

Date of this edition: March 26, 2007

Target OS: QNX® Neutrino® 6.3.0 SP1 or later

Host OS: Sun Solaris 8, 9, or 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 into your myQNX account, and then go to the Download Center.

Note:
  • We're deprecating support for Solaris 8 and 9; QNX Momentics 6.3.0 is the last release that you can use with these hosts.
  • With Eclipse 3.2, Motif is no longer supported for Solaris hosts; if you're using Solaris 8 or 9, you'll need to run GNOME and GTK instead. For more information, see "System requirements," below.
  • GNOME is available for but not supported on Solaris 7 (see http://www.sun.com/bigadmin/xperts/sessions/08_gnome/#5). As a result, we can't support IDE 4.0 on this host.
Caution: If you installed an experimental version of this software, uninstall it before installing the production version.

Contents

System requirements

Minimum Recommended
Host OS Solaris 8, 9, or 10 Solaris 10
Workstation Sparc Ultra 5 Sparc Ultra 10
RAM 512 MB 1.0 GB
Disk space 1.9 GB 1.9 GB
Monitor 1024*768 1280*1024

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

Note: Ensure that 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 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
Solaris 9
112785-30 113096-03
Solaris 10
None
Note: Reboot your machine after installing these patches and before installing QNX Momentics. The installer checks to make sure you've installed the right patches.

To successfully install IDE 4.0.1, you need approximately 440 MB of disk space, including temporary space used to install any required files. Approximately half of this disk space must be where your temporary directory resides.

In the IDE for Solaris 8, in order for the graphics, such as those in the System Profiler perspective, to display properly, the system requires a minimum color depth of 32 bits. (Ref# 43989)

To change the color depth setting:

  1. Stop the IDE and open a command window.
  2. Execute the following command:

    fbconfig -res 1024x768 -depth 32

  3. Start the IDE.
Note: With Eclipse 3.2, Motif is no longer supported for Solaris hosts; if you're using Solaris 8, or 9, you'll need to install the following:

Installing IDE 4.0.1

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

Note:
  • For Solaris, the IDE Software Updates manager is not available for upgrading from IDE 4.0 to IDE 4.0.1; you'll need to follow the full installation instructions described below.
  • If you currently have IDE 4.0 installed, you must first uninstall IDE 4.0 before you can install IDE 4.0.1. For detailed instructions, see "Uninstalling the IDE".
  • If you chose not to install all components of QNX Momentics, and you install this service pack, 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.
  • Close all QNX Momentics applications before you install IDE 4.0.1.
  • 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).
Caution: Installing IDE 4.0.1 removes any third-party Eclipse plugins on your host. You'll have to reinstall them after installing IDE 4.0.1.

To install IDE 4.0.1, do the following:

  1. Log in as root.
  2. Open a web browser, go to our website, www.qnx.com, and log on to your myQNX account.
  3. Click Download Center-->Products & Updates-->QNX Momentics-->QNX Momentics 6.3.x.
  4. Download the IDE 4.0.1 package, ide-4.0.1-nnnnnnnnnnn-solaris.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-solaris.bin
  6. Run the script at the system prompt. For example: 
    ./ide-4.0.1.-2007038230-solaris.bin
    Note: 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 IDE 4.0.1.
  7. You will need to determine if you need to install the optional Memory Analysis Tool Patch (Patch ID 525). For instructions about this patch, see "Updating the Memory Analysis Target Patch".
  8. Follow the instructions provided by InstallShield.
  9. Next, you will need to determine the additional patches you should install. For information about these patches, see "After you install".

After you install

After you install the IDE, you can install the following patches:

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

Note:
  • To 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.1 (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.

  • If you're using GTK and GNOME on Solaris 8 or 9, you need to set LD_LIBRARY_PATH to include your GTK library files. For example, if you installed GTK with /usr/local as your base directory, launch the IDE using this command line:
  • LD_LIBRARY_PATH=/usr/local/lib:$QNX_HOST/usr/bin:$LD_LIBRARY_PATH   installation_dir/eclipse/qde
  • The first time you use the IDE, you're asked 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

The libmalloc patch is an optional patch that updates the debug malloc libraries to provide full support for the features of the Memory Allocation perspective in the IDE.

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 Solaris, 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
    • 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 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 updates to qconn.

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 attempt to delete the directories, your machine might become 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 in.
  4. Start the QNX InstallShield application: 
    ./uninstaller.bin

    InstallShield will now remove the IDE. 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

          Package Name: QNX Neutrino Core OS
               Version: 6.3.2
                  Base: QNX Momentics 6.3.0 SP1, SP2, or SP3
          Install Path: /opt/qnx630

The base directory in this example is /opt/qnx/Momentics/IDE40, 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. In the IDE, choose Help-->Help Contents, and then click QNX Momentics Professional Edition.

Note: To view the online help, you will need to install a web browser. For Solaris, the IDE qconn supports the Mozilla web browzer version 1.6 or higher.

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 Solaris, the default is /opt/qnx/Momentics/IDE4).

Note:
  • 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 Center.
  • 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.

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.