This document addresses JBuilder Foundation installation issues on Linux.

For information on installing JBuilder Foundation on other operating systems, please search for article 20535, JBuilder Foundation Installation FAQ.

Linux Install Checklist:

1. Install from within XWindows (these window managers have worked so far: KDE, GNOME, WindowMaker, and Enlightenment).
2. Install Sun's JDK 1.2.2 (as specified on our website) for Linux. Other JDK's (including Blackdown's) do not have some of the fixes needed to run JBuilder Foundation. Use any other JDK at your own risk as JBuilder Foundation is not currently supported on other JDK's.
3. Make sure you have the right version of your Linux kernel for the JDK. Version 2.2.5 or higher is needed. You can find out which kernel you're using with the command uname -a.
4. Make sure you have the right version of glibc for the JDK. Version 2.1.2 or higher is needed. You can check this with the command ldd --version.
5. Check your path, making sure it includes <jdk install path>/bin. For example, if you installed the JDK in /usr/local, your PATH needs to include /usr/local/jdk1.2.2/bin. To check your PATH variable, type echo $PATH. If it is neccessary for you to modify your path, try this:

   export PATH=/usr/local/jdk1.2.2/bin:$PATH (if your using a sh or bash shell)
   set PATH=/usr/local/jdk1.2.2/bin:$PATH (if you're using the csh or tcsh shells)
    

6. If, after modifying the PATH as above, the JBuilder Foundation installer still can not find your JDK, run the installer like this:

   sh ./install.bin LAX_VM <path the java executable>

   For example:

   sh ./install.bin LAX_VM /usr/local/jdk1.2.2/bin/java
    

7. If the JBuilder Foundation installer exits to the command prompt under JDK 1.2.2, then you can try running it with JDK or JRE 1.1.7. You can download JDK/JRE 1.1.7 from Blackdown. After installing the JDK/JRE, launch the installer as described above, using the LAX_VM option.
8. Check the LANG environment variable. If it is not set to "en_US", you may need to unset it prior to running th installer (using unset LANG). There seems to be some issues with international support in InstallAnywhere. Note: the LANG variable needs to be unset only inside the teminal window used to launch the install program.
9. If the install still doesn't work try changing your display color depth to anything but 16bpp (i.e. 32, 24, 8, etc.). There are some problems with AWT and 16bpp color displays, but this change usually fixes the problem (note, you may or may not need to leave this change in order to run JBuilder).
10. If you can't close the Welcome Project try putting the following in your jbuilder script on the line that issues the command that launches JBuilder Foundation:

    Dfile.encoding=ISO8859_1

11. If JBuilder seems to run slow on your machine check to be sure that Linux is recognizing all of your RAM. You can do this following these steps:
    • su as root
    • cat /proc/meminfo (this will show you how much memory Linux is recognizing)
    • Edit /etc/lilo.conf and add append="mem=128M" to it.
    • Open a console prompt and type "lilo" and press enter.
    • reboot