3 - C H A P T E R -

C H A P T E R 3

Installing the Forte for Java 4 IDE

This chapter contains information on how to install Forte for Java 4, Enterprise Edition on each of the supported platforms. The subdirectories installed with the IDE are described and uninstallation instructions are also provided.

Supporting Previous Forte for Java Software Releases

To upgrade your previous version of the IDE to Forte for Java 4 software, you must do one of the following:

Determine if you want to keep your previous version of the IDE. If you do, identify a different directory in which to install the Forte for Java 4 software.

If you want to use the same installation directory as the previous IDE version, you must first uninstall the previous version of the IDE prior to installing Forte for Java 4 software.

Determine whether you want to keep your current IDE user settings. If you decide to use your current user settings with the new IDE version, you need to specify the location of your current user directory when prompted during the initial IDE setup. Read Chapter 4 for more information.

Creating a Shared Installation

If you want to share a Forte for Java installation between multiple users, you must install the Forte for Java 4 IDE into a shared directory.

After installation of the IDE in the supported Solaris environment or Red Hat Linux environment, all user settings are stored in the ffjuser40ee directory created under each user's home directory. This occurs for both shared and unshared installations.

After installation of the IDE in a Microsoft Windows system, you must set your own user directory using a dialog box that appears immediately upon initial startup of the IDE from your machine. This occurs for both shared and unshared installations.

The recommended name for the user directory in a Microsoft Windows system is drive:fully-qualified-path\ffjuser40ee. This name is entered as the UserDir value of the Software\SunMicrosystems, Inc.\Forte for Java key in the HKEY_CURRENT_USER registry. This value is not deleted when the IDE is uninstalled. If the UserDir value is not explicitly deleted from the Microsoft Windows Registry, it will be reused by future installations of this version of the IDE. Refer to some troubleshooting information in Chapter 9, if you want to use a different location for your user directory.

Installing the Forte for Java 4 IDE on the Supported Platforms

These instructions describe the installation process for each of the supported platforms.

Installation on Microsoft Windows Systems

You can install the Forte for Java 4 IDE on a supported Microsoft Windows system through an .exe file.

Note - You must have the J2SE, v. 1.3.1 platform or J2SE, v. 1.4.0 platform installed on your system before installing the Forte for Java 4 IDE. The recommended option is the J2SE, v. 1.4.0 platform with the Forte for Java 4 IDE. Read for instructions on installing the software.

1. If you have not already done so, download the ffj_ee_win32_en.exe installer file from http://www.sun.com/software/sundev/jde/buy/index.html or locate the file on the Forte for Java 4 product CD.

If you are downloading the file from the product download page, do the following:

a. Save it into the ffj-download-directory.

b. Write down the serial number provided to you on the download page.

If you are accessing the file from the Forte for Java 4 product CD, locate the serial number in the Forte for Java 4 product package.

2. Double-click the ffj_ee_win32_en.exe file in the ffj-download-directory or on the Forte for Java 4 product CD.

The InstallShield's Welcome screen appears.

Note - If you encounter errors at any point during the Forte for Java 4 IDE installation, refer to Chapter 9 for some troubleshooting hints.

3. In the Welcome screen, click Next.

4. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next.

You must agree to the license to continue with the installation.

InstallShield attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0 on your system.

5. Set the location of compatible Java 2 SDK software and click Next.

The Forte for Java 4 IDE requires local or network access to either v. 1.3.1 or v. 1.4.0 of the Java 2 SDK software. Specify which installed software to use by doing one of the following:

Accept the default location.

Select another location from the list of found Java 2 SDK software.

Click Browse to specify a different location.

Click Next after you have set the Java 2 SDK location.

6. Type the serial number provided with the product CD or available from the product download page. Alternatively, click Next without entering a serial number to generate a trial serial number.

a. Click Yes to automatically generate a trial serial number.

The trial serial number expires in 60 days.

b. Write down the trial serial number that appears.

The trial serial number gives you access to the Update Center services once you have registered the product. Read Chapter 4 for product registration information and Updating Modules With the Update Center for information on the Forte for Java Update Center.

c. Click Next a second time to continue with the installation.

7. Accept the default installation folder or click Browse to install the IDE in a different folder. Click Next to continue.

Note - The installation directory name cannot contain any spaces and it must be an empty or new directory.

8. Select the Forte for Java 4 components you want to install.

The following components are available:

Core Platform and Modules (required)

PointBase Server 4.2 Restricted Edition

Java 2 Platform, Enterprise Edition (J2EE) Reference Implementation 1.3.1

Note - The best option is to install the J2EE Reference Implementation 1.3.1 and the PointBase Server 4.2 Restricted Edition with the IDE. These software products are provided to enable you to quickly develop a simple J2EE application, as described in Chapter 5.

9. Confirm your installation choices in the installation summary dialog box and click Next.

InstallShield installs the Forte for Java 4 components you have selected.

10. Decide whether you want to associate .java and .nbm files with the Forte for Java 4 IDE. Click Next to continue.

If you decide to associate these file types, the Forte for Java 4 IDE will automatically launch when you open these files.

11. Click Finish to complete the installation.

12. Review the Release Notes file for important information regarding the release. You can access the Release Notes from the product CD or from http://forte.sun.com/ffj/documentation/index.html.

13. Continue to Chapter 4 for information on setting up the Forte for Java 4 IDE.

Installation in the Red Hat Linux Environment

You can install the Forte for Java 4 IDE in a supported Red Hat Linux environment with a .bin file.

1. If you have not already done so, download the ffj_ee_linux_en.bin installer file from http://www.sun.com/software/sundev/jde/buy/index.html or locate the file on the Forte for Java 4 product CD.

If you are downloading the file from the product download page, do the following:

a. Save it into the ffj-download-directory.

b. Write down the serial number provided to you on the download page.

If you are accessing the file from the Forte for Java 4 product CD, locate the serial number in the Forte for Java 4 product package.

2. Set the DISPLAY environment variable to display to your local system.

If you are installing to your local system, the DISPLAY environment variable should be set to :0.0. If you are using a superuser (root) account or are doing a remote installation, set your superuser session's DISPLAY environment variable to display to your local system.

For example, to set the variable from a root account running C-shell, type the following in your superuser session command prompt:

# setenv DISPLAY your-local-system:0.0

3. Set the execute permission on the ffj_ee_linux_en.bin file and execute it by double-clicking the file from the Forte for Java 4 product CD or by typing the following:

$ cd ffj-download-directory

$ chmod a+x ffj_ee_linux_en.bin

$ ffj_ee_linux_en.bin

Note - If you encounter errors at any point during the Forte for Java 4 IDE installation, refer to Chapter 9 for some troubleshooting hints.

4. In the Welcome screen, click Next.

5. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next.

You must agree to the license to continue with the installation.

InstallShield attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0 on your system.

6. Set the location of compatible Java 2 SDK software and click Next.

The Forte for Java 4 IDE requires local or network access to either v. 1.3.1 software or v. 1.4.0 of the Java 2 SDK software. Specify which installed software to use by doing one of the following:

Accept the default location.

Select another location from the list of found Java 2 SDK software.

Click Browse to specify a different location.

Click Next after you have set the Java 2 SDK location.

7. Type the serial number provided with the product CD or available from the product download page. Alternatively, click Next without entering a serial number to generate a trial serial number.

a. Click Yes to automatically generate a trial serial number.

The trial serial number expires in 60 days.

b. Write down the trial serial number that appears.

c. Click Next a second time to continue with the installation.

8. Accept the default installation directory or click Browse to install the IDE in a different directory. Click Next to continue.

Note - The installation directory name cannot contain any spaces and it must be an empty or new directory.

9. Select the Forte for Java 4 components you want to install.

The following components are available:

Core Platform and Modules (required)

PointBase Server 4.2 Restricted Edition

Java 2 Platform, Enterprise Edition (J2EE) Reference Implementation 1.3.1

10. Confirm your installation choices in the installation summary dialog box and click Next.

InstallShield installs the Forte for Java 4 components you have selected.

11. Click Finish to complete the installation.

12. Review the Release Notes file for important information regarding the release. You can access the Release Notes from the product CD or from http://forte.sun.com/ffj/documentation/index.html.

13. Continue to Chapter 4 for information on setting up the Forte for Java 4 IDE.

Installation in the Solaris Operating Environments

You can install the Forte for Java 4 IDE in a supported Solaris operating environment with a .bin file.

1. If you have not already done so, download the ffj_ee_solsparc_en.bin installer file from http://www.sun.com/software/sundev/jde/buy/index.html or locate it on the Forte for Java 4 product CD.

If you are downloading the file from the product download page, do the following:

a. Save it into the ffj-download-directory.

b. Write down the serial number provided to you on the download page.

If you are accessing the file from the Forte for Java 4 product CD, locate the serial number in the Forte for Java 4 product package.

2. Set the DISPLAY environment variable to display to your local system.

For example, to set the variable from a root account running C-shell, type the following in your superuser session command prompt:

# setenv DISPLAY your-local-system:0.0

3. Set the execute permission on the ffj_ee_solsparc_en.bin file and execute it by double-clicking the file from the Forte for Java 4 product CD or by typing the following:

$ cd ffj-download-directory

$ chmod a+x ffj_ee_solsparc_en.bin

$ ffj_ee_solsparc_en.bin

Note - If you encounter errors at any point during the Forte for Java 4 IDE installation, refer to Chapter 9 for some troubleshooting hints.

4. In the InstallShield's Welcome screen, click Next.

5. Read the license agreement carefully. To proceed, accept the terms of the license agreement, and click Next.

You must agree to the license to continue with the installation.

InstallShield attempts to locate a compatible Java 2 SDK v. 1.3.1 or v. 1.4.0 on your system.

6. Set the location of compatible Java 2 SDK software and click Next.

The Forte for Java 4 IDE requires local or network access to either v. 1.3.1 or v. 1.4.0 of the Java 2 SDK software. Specify which installed Java 2 SDK software to use by doing one of the following:

Accept the default location.

Select another location from the list of found Java 2 SDK software.

Click Browse to specify a different location.

Click Next after you have set the Java 2 SDK location.

7. Type the serial number provided with the product CD or available from the product download page. Alternatively, click Next without entering a serial number to generate a trial serial number.

a. Click Yes to automatically generate a trial serial number.

The trial serial number expires in 60 days.

b. Write down the trial serial number that appears.

c. Click Next a second time to continue with the installation.

8. Accept the default installation folder or click Browse to install the IDE in a different directory. Click Next to continue.

Note - The installation directory name cannot contain any spaces and it must be an empty or new directory.

9. Select the Forte for Java 4 components you want to install.

The following components are available:

Core Platform and Modules (required)

PointBase Server 4.2 Restricted Edition

Java 2 Platform, Enterprise Edition (J2EE) Reference Implementation 1.3.1

Solaris Developer Modules

10. If you chose to install the Solaris Developer Modules, specify the path to the Forte Compiler Collection (FCC).

If you are installing the IDE on a server that will be accessed by multiple users, the path name specified for the FCC software must be valid and accessible to all those IDE users.

If you have not installed the Forte Compiler Collection or you do not readily know the path to the Forte Compiler Collection, leave the FCC Path blank and click Next.

The Forte Compiler Collection software refers to an installation of Forte Developer 7 software and you can download it from http://www.sun.com/software/sundev/suncc/buy/.

You can set or reset the FCC path at a later time by using the forte_fcc utility, which can be found in ffj-install-dir/bin/forte_fcc. Read the forte_fcc man page at ffj-install-dir/man/man1 for additional information.

11. Confirm your installation choices in the installation summary pane and click Next.

InstallShield installs the Forte for Java 4 components you selected.

12. Click Finish to complete the installation.

13. Review the Release Notes file for important information regarding the release. You can access the Release Notes from the product CD or from http://forte.sun.com/ffj/documentation/index.html.

14. Continue to Chapter 4 for information on setting up the Forte for Java 4 IDE.

Installing the IDE Using the Command-line Options

If you prefer to install the Forte for Java 4 IDE using the command line, use the following steps to guide you. You need to create a file called installer.sp and add to the file the command-line options you want to use to install the IDE.

1. If you have not already done so, download the installer file for your supported platform from http://www.sun.com/software/sundev/jde/buy/index.html or locate the file on the Forte for Java 4 product CD.

a. Save the installer file into the ffj-download-directory.

On a Microsoft Windows systems, download the ffj_ee_win32_en.exe file. In a Solaris environment, download the ffj_ee_solsparc_en.bin file. In a Red Hat Linux environment, download the ffj_ee_linux_en.bin file.

b. Write down the serial number provided to you on the download page or locate the serial number in the Forte for Java 4 product package, if you are using the product CD.

2. Create an installer.sp file in the ffj-download-directory.

The IDE installer will read the command-line options you include in the installer.sp file.

On a Microsoft Windows system, create a file called ffj_ee_win32_en.sp and place the file in the ffj-download-directory.

For the Solaris and Linux environments, name the file ffj_ee_solsparc_en.sp and ffj_ee_linux_en.sp, respectively.

3. Determine the command-line options and corresponding values you want to use, and include them in the installer.sp file.

TABLE 3-1 lists the different command-line options and their default values, if any. You can use either the long or short name for each option.


Installation Options	Description
`fortehome=`ffj-install-dir `fh=`ffj-install-dir	Specifies the directory into which you want the IDE installed. This is a mandatory command-line parameter for the `-silent` mode.
`jdkhome=`jdkhome-dir `jh=`jdkhome-dir	Sets the location of the valid Java 2 SDK version to use with the IDE. The installer will configure the IDE to use this Java 2 SDK software. This is a mandatory command-line parameter for the `-silent` mode.
`serialnumber=`serial-number `serialnumber=trial` `sn=`serial-number `sn=`trial	Sets the serial number for the IDE. Use the serial number you received when you downloaded the Forte for Java 4 IDE installer software, or the one included with the Forte for Java 4 product package. You may also specify the value `trial` to generate a temporary license that will expire after 60 day. This is a mandatory command-line parameter for the `-silent` mode.
pointbaseinstall=`yes` pointbaseinstall=`no` `pi=`yes `pi=`no	Specifies whether to install the PointBase Server 4.1 Network Edition. The default value is `yes`.
j2eeinstall=yes j2eeinstall=no `ji=`yes `ji=`no	Specifies whether to install the J2EE Reference Implementation 1.3.1. The default value is `yes`.
fccHome=FCC_path fch=FCC_path	(Solaris only) Sets the path to the directory where the Forte Compiler Collection (FCC) is installed. This option is valid only on a supported Solaris environment.
si=`yes` si=`no` soldevInstall=`yes` soldevInstall=`no`	(Solaris only) Specifies whether to install the Solaris Developer Modules. The default value is `yes`. This option is valid only on supported Solaris environments.
-silent	Specify this option on the command line and not in the installer`.sp` file. If not specified, the Installshield wizard will appear. If specified, any error messages will be displayed on the command window from which the installer was invoked.

For example, on a Microsoft Windows system, the ffj_ee_win32_en.sp might have the following contents:

fh=C:\forte4j

jh=C:\j2sdk1.4.0

sn=trial

pi=yes

ji=yes

On a Solaris environment, the ffj_ee_solsparc_en.sp might have the following contents:

fh=/yourserver/forte4j

jh=/usr/j2se

sn=trial

pi=yes

ji=yes

si=yes

fch=/yourserver/fcc

4. Invoke the installer from the command line.

For example, on a Microsoft Windows system, type the following in a command prompt window:

C:\>cd ffj-download-directory

C:\ffj-download-directory> ffj_ee_win32_en.exe -silent

In a Solaris environment, type the following in a terminal window, for example:

$ cd ffj-download-directory

$ ffj_ee_solsparc_en.bin -silent

The installer uses the options you have specified in the installer.sp file for your system and displays the following on the command prompt window:

InstallShield Wizard

Initializing InstallShield Wizard...

Searching for Java(tm) Virtual Machine...

.........

Running InstallShield Wizard...

If there are any errors encountered, messages are displayed on the command prompt window.

Note - If you encounter errors at any point during the Forte for Java 4 IDE installation, refer to Chapter 9 for some troubleshooting hints.

5. Continue to Chapter 4 for information on setting up the Forte for Java 4 IDE.

Finding Installation Subdirectories

After you have installed the Forte for Java 4 IDE, the subdirectories listed in TABLE 3-2 can be found under ffj-install-dir, your Forte for Java 4 installation directory.


Subdirectory Name	Description
`LICENSE.html`	Contains the Sun Microsystems, Inc. binary code license agreement.
`/_uninst`	Contains the files used to uninstall in the IDE.
`/beans`	Contains JavaBeans components installed in the IDE.
`/bin`	Includes the Forte for Java startup scripts (as well as the `ide.cfg` file in Microsoft Windows installations). (Solaris only) Also contains launch points for the standalone applications delivered with the Solaris tools, including `xemacs`, `gvim`, `xdesigner`, and `forte_fcc`.
`/docs`	Contains the Forte for Java help files and other miscellaneous documentation.
`/emacs`	(Solaris only) Contains emacs files.
`/examples`	Contains source files for examples that illustrate several key features of the Forte for Java 4, Enterprise Edition.
`/j2sdkee1.3.1`	Contains the J2EE Reference Implementation v. 1.3.1 files, if you chose to install those files during the Forte for Java installation process.
`/jwsdp`	Contains files and directories specific to the Java Web Services Developer Pack.
`/lib`	Contains the JAR files that make up the IDE's core implementation and the open APIs.
`/man`	(Solaris only) Contains man pages for Solaris Developer Modules, if installed.
`/modules`	Stores Forte for Java modules as JAR files.
`/platform`	(Solaris only) Contains platform-specific files.
`/pointbase`	Contains four subdirectories, `client`, `databases`, `docs`, and `server`. The `client` directory contains the PointBase console, command-line utilities, and examples of a PointBase application. The `databases` directory contains a sample database. The `docs` directory contains PointBase documentation. The `server` directory contains the PointBase server.
`/sources`	Contains sources for libraries that might be redistributed with user applications.
`/system`	Includes files and directories used by the IDE for special purposes. Go to your individual ffj-user-dir`/system` directory to get the `ide.log`, which provides information useful when requesting technical support, and to view `project.basic` and `project.last` files, which contain information on Forte for Java projects. On a Microsoft Windows system, this ffj-user-dir`/system` directory contains the project-specific files under `project.basic_hidden` and `project.last` files.
`/tomcat401`	Contains Tomcat-specific files.
`update_tracking.xml`	Contains information used by the AutoUpdate Center.

Uninstalling the Forte for Java 4 IDE

An uninstaller wizard is available to assist you in the uninstallation of the Forte for Java 4 IDE. Follow these steps to uninstall your copy of the Forte for Java 4 IDE:

1. Start the uninstaller from the ffj-install-dir/_uninst directory.

In a supported Solaris operating environment or Red Hat Linux environment, ensure that your DISPLAY environment variable is defined correctly, and then type:

$ java -jar uninstall.jar

On a Microsoft Windows system, execute the uninstaller.exe file located in the ffj-install-dir/_uninst directory or use the Add/Remove Program utility in the Control Panel.

The uninstaller's Welcome screen appears.

2. Click Next from the Welcome screen.

A list of Forte for Java components is displayed.

3. Select the components you want to uninstall and click Next.

4. Click Next to confirm the components to be uninstalled.

The uninstaller wizard proceeds with the uninstallation of the IDE.

5. Click Finish to close the uninstaller wizard.