J2EE IDE Toolkit Software 2.1 - Linux Installation Notes

The J2EE IDE Toolkit Software is an integrated tool consisting of four components:

  • Java 2 Platform, Standard Edition ("J2SE") SDK, version 1.3.1_01
  • Java 2 Platform, Enterprise Edition ("J2EE") SDK, version 1.3_01
  • Forte Community Edition (CE) for Java 3.0
  • The file j2eeidetk-2_1-fcs-sol-linux.zip

The following sections describe the steps needed to download and install these components and run this tool on a Red Hat Linux/Intel system:

Download and Install J2SE, J2EE, and Forte CE

Download and install the J2SE 1.3.1_01 SDK for Linux.

Download and install the J2EE 1.3_01 SDK (j2sdkee1.3) for Linux.

Install Forte CE for Java 3.0 for Linux. Download a copy from the Forte Web page and follow the installation instructions. Note that you will need to register to download Forte CE from the Web page.

Install the J2EE IDE Toolkit

Set the environment variable JAVA_HOME to the directory where you installed J2SE. For example, you could use the default bash shell to set JAVA_HOME as follows:



                  export JAVA_HOME=
                    install_path

where install_path is the directory where you installed J2SE. For example, install_path could be /jdk1.3.1.

Copy the zip file j2eeidetk-2_1-fcs-sol-linux.zip into a temporary directory (for example, /tmp).

cd into the temporary directory.

Unzip the file j2eeidetk-2_1-fcs-sol-linux.zip.

From the temporary directory, run the InstallToolkit.sh script, which brings up a wizard to guide you through the installation.

Note: Do not run the script from any directory other than the directory to which you extracted it.

Make sure to enter the correct J2EE_HOME directory in the installation wizard. J2EE_HOME is the directory where you installed J2EE 1.3. For example, J2EE_HOME could be /j2sdkee1.3.

Make sure to enter the correct FORTE_HOME directory in the installation wizard. FORTE_HOME is the directory where you installed Forte CE. For example, FORTE_HOME could be /forte4j.

If you have an installation of Version 1.0 or 2.0 of the J2EE IDE Toolkit in your FORTE_HOME directory, the wizard automatically detects it and asks if you want to disable the earlier version. You must disable the earlier version before you can continue the installation. You can quit if you choose not to disable your earlier version.

If you have already installed Version 2.1 of the J2EE IDE Toolkit and want to reinstall it, the wizard automatically detects it and asks if you want to disable the existing installation. You must disable the existing installation before you can continue the reinstallation. You can quit if you choose not to disable your existing version.

Run Forte CE with the Toolkit

Shut down any other running J2EE SDKs.

cd into the FORTE_HOME/bin directory. Invoke the following script to start the Toolkit:

runide.sh

The first time you run this script, it invokes a Setup Wizard. One of the Wizard screens asks if you want to install a Complete Set of Modules (the default), a Basic Set of Modules, or a Custom set. Choose the Complete Set in order to run the Toolkit.

Note: If you have registered to receive updates through the Update Center, do not accept any automatic IDE updates when running the tool. Click No in this dialog box if it appears.

Choose Help Sets->J2EE IDE Toolkit Software Help from the Help menu to learn how to use the Toolkit.

You will find a copy of the file README.IDE-TK, which contains a known problems list, in the FORTE_HOME directory.

Note: If the location of your J2EE 1.3 installation changes after you install the toolkit, edit the file FORTE_HOME/system/idetoolkit.cfg to point to the new location. The contents of the file look like this: 

J2EE_HOME=

                     install_path
Change install_path to the new location where J2EE 1.3 is installed.

Disable or Uninstall the Toolkit

The Forte CE IDE allows users to enable or disable any module within the framework. If you want to disable the J2EE IDE Toolkit from within Forte CE, do the following:

Choose Options from the Tools menu.

In the Options dialog, expand the Modules node.

Under the expanded Modules node, select the J2EE IDE Toolkit Module node.

On the right side of the panel, toggle the Enabled option from True to False.

This removes the J2EE IDE Toolkit from the Forte CE framework. You can toggle this option back to True any time you choose to enable the J2EE IDE Toolkit in the Forte CE environment.

Disabling the Toolkit module does not remove from Forte CE all the files related to the J2EE IDE Toolkit. If you want to remove all the files related to the J2EE IDE Toolkit from your Forte CE environment (in other words, if you want to do a clean uninstall of the J2EE IDE Toolkit), you need to run the UninstallToolkit script:

Set the JAVA_HOME environment variable, if it is not set already. See Step 1 under Install the J2EE IDE Toolkit for details on setting JAVA_HOME.

Set the FORTE_HOME environment variable to the directory where you installed Forte CE. For example, you could use the default bash shell to set FORTE_HOME as follows:



                  export FORTE_HOME=
                    install_path

where install_path is the directory where you installed Forte CE. For example, install_path could be /forte4j.

cd into the FORTE_HOME/bin directory and run the UninstallToolkit.sh script (make sure it has execute permission first):

UninstallToolkit.sh