JBuilder 3.5 Foundation for Solaris

System Requirements

Installing JBuilder 3.5 Foundation

Please read these instructions entirely before installing JBuilder 3.5 Foundation.

1. Install JBuilder 3.5 Foundation.
2. Install the Documentation files.
3. Install the Samples.
4. Install the OpenTools documentation files.
5. Run JBuilder 3.5 Foundation.

Installing JBuilder Foundation

This version of JBuilder 3 contains an updated version of JDK 1.2.2 and JPDA.You should use this version instead of any earlier version that you might have.

Note: You may need to install Solaris System Patches to run the latest version of the JDK which is included in this installer. If you think you may need to install these patches, they can be found on the following web page: http://java.sun.com/products/jdk/1.2/install-solaris-patches.html (These patches are created and distributed by Sun, and are in no way supported by Inprise Corporation.)

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. 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 CD.
4. From the command line, enter jbuilder/sol_linux/foundation/solaris/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.
5. To continue the installation process, you will need to add the location of the JDK to your path.
   From the command line (using either the Bourne [sh] or Korn [ksh] shell), 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.
6. From the command line, enter sh jbuilder/sol_linux/ent/install.bin to launch the second part of the installation program.
   1. When prompted, choose a JDK from the list.
   2. Follow the prompts and click Next.
   3. Accept the license agreement when prompted, then click Next.
   4. Choose the directory where JBuilder is installed, then click Next.
   5. 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 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.

• Insufficient available disk space reported with NFS volumes mounted
  If you have any NFS volumes mounted, the installation may fail with an error reporting insufficient available disk space. If you encounter this error and are certain they you have enough disk space available for installation, disable NFS before installing JBuilder, then re-enable it after the installation has successfully completed.

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 that 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. Enter your serial number and license key, then click OK.
4. Accept the license agreement when prompted, 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.