JBuilder 3.5 Foundation for Linux

System Requirements

Installing JBuilder 3.5 Foundation

Please read these instructions entirely before installing JBuilder 3.5 Foundation.

1. Downland and install the JDK.
2. Install the JBuilder JIT for Linux.
3. Install JBuilder 3.5 Foundation.
4. Install the Documentation files.
5. Install the Samples.
6. Install the OpenTools documentation files.
7. Run JBuilder 3.5 Foundation.

Installing the JDK

Before installing JBuilder Foundation, you will need to install JDK 1.2.2 for Linux. It is available from the JavaSoft web site: http://www.javasoft.com. Download and install this JDK before continuing.

Installing JBuilder Foundation

You will need write access to the directory locations you specify during the installation process. You should also have at least 150 MB of available hard disk space.

Inportant! If you have a previous installation of JBuilder 3 Foundation or JBuilder 3 for Solaris, you will need to uninstall that version before installing JBuilder 3.5. See Uninstalling JBuilder for instructions for uninstalling JBuilder.

JBuilder 3.5 Foundation requires these installation steps:

1. Using X-Windows, open a terminal window. Keep this window open until you have installed all of the components of JBuilder 3.5 Foundation.
2. Change to the CD-ROM directory. (For example: From the command line, enter: cd /mnt/cdrom)
3. Change to the JBuilder 3.5 Foundation directory.
4. Before you begin the installation process, you will need to add the location of the JDK to your path.
   From the command line, enter export PATH=/usr/local/jdk1.2.2/bin:$PATH.
   Note: If you installed the JDK to a different directory, then substitute your own path and directory.
5. From the command line, enter jbuilder/sol_linux/foundation/no_vm/install.bin to launch the first part of the installation program.
   1. Follow the prompts and click Next.
   2. Accept the license agreement when prompted, then click Next.
   3. Choose the directory where you want JBuilder installed, then click Next. Do not choose a directory that contains spaces in its name. JBuilder will not run if the name of the directory in which it is installed contains spaces.
   4. When the installation program is completed, click Done.

Installation Notes

• Installing JBuilder as "root"
  This note applies only if you are installing JBuilder as a super-user through the "su" command.

  XWindows has security restrictions that can cause a GUI application to fail if running the application as a different user than the one logged in. One such case is when you open a terminal window and use the "su" command to become "root". The error message issued is usually 'Xlib: connection to ":0.0" refused by server'. This is a security feature, not a bug. To avoid this problem open a terminal window and type the following command:
      xhost +localhost
  This command notifies XWindows that any user on your machine is authorized to use your display. After the installation you can run the command:
      xhost -localhost
  to reset the value to the default.

  Another possible side effect of this is that you will get an icon for JBuilder Foundation installed on your desktop that does not work when selected. To fix this:

  1. Log back in as root using the "su" command.
  2. Copy the link created for the icon to your local desktop.

Installing the JBuilder 3.5 Documentation

1. From the command line, enter sh jbuilder/sol_linux/docs/install.bin to launch the installation program.
2. When prompted, choose a JDK from the list.
3. Follow the prompts and click Next.
4. Accept the license agreement when prompted, then click Next.
5. Choose the directory where JBuilder is installed, then click Next.
   Note: If you install the JBuilder documentation into a location different from the suggested default directory, the documentation will not be accessible from the JBuilder Help Viewer.
6. When the installation program is completed, click Done.

Installing the JBuilder 3.5 Samples

1. From the command line, enter sh jbuilder/sol_linux/samples/install.bin to launch the installation program.
2. When prompted, choose a JDK from the list.
3. Follow the prompts and click Next.
4. Accept the license agreement when prompted, then click Next.
5. Choose the directory where JBuilder is installed, then click Next.
6. When the installation program is completed, click Done.

Installing the JBuilder 3.5 OpenTools Documentation

1. The OpenTools documentation is available at following location: jbuilder/sol_linux/opentools/opentools.tar.
2. Unarchive these files into the directory where you would like this documentation stored.
   Note: The files will be unarchived beginning at the root of the directory you choose. We suggest you unarchive these files to one of these directories:
   • jbuilder35/doc/opentools
   • jbuilder35/opentools

Running JBuilder 3.5 Foundation

1. Start JBuilder 3.5 Foundation.
2. When the License Manager appears, enter your name and your company name, then click Add.
3. Accept the license agreement when prompted, then click OK.
4. Enter your serial number and license key, then click OK.
5. Click OK to exit the License Manager.
6. Click OK to exit the License Information dialog box.
7. JBuilder 3.5 Foundation is now running.

Uninstalling JBuilder

1. Locate the directory where JBuilder was installed.
2. Delete the JBuilder directory.
3. Delete the .jbuilder directory under your home directory.