Linux Installation Notes

Print-friendly Version

Linux Installation Notes

The J2EE Deployment software is part of an integrated package that consists of the following components:

• Java 2, Standard Edition (J2SE) SDK, versions 1.3.1_02 and 1.3.1_03
• Sun ONE Studio 3.0 (formerly Forte Community Edition (CE) for Java 3.0)
• Java 2, Enterprise Edition (J2EE) SDK, version 1.3.1_deployapi
• The file j2eedeployapi.nbm

The following sections describe the steps needed to download and install these components and run this module on a Linux system:

• Download and install the J2SE and Sun ONE Studio Software
• Install the J2EE SDK 1.3.1_deployapi Software
• Install the J2EE Deployment Netbeans Module
• Start the J2EE SDK 1.3.1_deployapi Application Server

Download and Install the J2SE and Sun ONE Studio Software

Complete the following steps to download and install the J2SE and Sun ONE Studio 3.0 software on a Red Hat Linux/Intel system.

1. Download and install the J2SE 1.3.1_02 or 1.3.1_03 SDK for Linux.
   http://java.sun.com/j2se/1.3/

2. Install the Sun ONE Studio 3.0 software for Linux. Download a copy from the Sun ONE Studio Web page (http://www.sun.com/software/sundev/archive/ffj) and follow the installation instructions. Note that you will need to register to download Sun ONE Studio 3.0 from the Web page.

Note: The J2EE Deployment software should work with the J2SE 1.4.0 and Sun ONE Studio 4.0 software. Our software has not been tested with the Sun ONE Studio 4.0 software, but has been with the previously released J2SE 1.4/Sun ONE Studio 3.0, Community Edition cobundle.

Install the J2EE SDK 1.3.1_deployapi Software

Complete the following steps to download and install the J2EE SDK 1.3.1_deployapi software.

1. 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.

2. Copy the zip file j2ee_deployapi-1_0-fr-ri-linux.zip into a temporary directory (for example, /tmp).

3. Change into the temporary directory.

4. Unzip the file j2ee_deployapi-1_0-fr-ri-linux.zip.

   The directory j2eedeployapi, which contains three directories (appserver, doc, and tools) is created.

5. Change to the j2eedeployapi/appserver directory.

6. Unzip the j2sdk1.3.1_deployapi.zip file. This installs the J2EE SDK 1.3.1_deployapi software.

7. In your shell environment, set the J2EE_HOME environment variable to the directory where you installed the J2EE SDK 1.3.1_deployapi software.

Start the Sun ONE Studio and Install the J2EE Deployment NetBeans Module

Complete the following steps to start the Sun ONE Studio 3.0 and install the J2EE Deployment NetBeans module:

1. Change to the FORTE_HOME/bin directory, where FORTE_HOME is the directory where you installed the Sun ONE Studio 3.0 software. Invoke the following script to start the software:

   runide.sh

2. In the IDE, select Tools --> Update Center, and use the Wizard to complete the following steps:

   1. Select the radio button "Install Manually Downloaded Modules (.nbm Files)".

   2. Click the Next button.

   3. Click the Add button.

   4. Enter the location of the j2eedeployapi.nbm file. The file is in the j2eedeployapi/tools directory.

      The NBM file is a NetBeans module that extends the basic functionality of the Sun ONE Studio 3.0 IDE and adds support for J2EE Deployment.

   5. Click the OK button.

   6. Click the Next button in the Update Center Wizard's "Select Modules to Install (Continued)" panel.

   7. Click the Next button in the Update Center Wizard's "Select Modules to Install" panel.

   8. Click the Accept button in the License Agreement dialog that pops up.

   9. Click the Next button in the Update Center Wizard's "Download Modules" panel.

   10. Click on the checkbox labeled "JSR-77 & JSR-88 IDE Toolkit Module - version1.3.1  Not Signed".

   11. Click on the Yes button in the dialog that pops up and asks "Do you really want to install an unsigned module?"

   12. Click the Finish button in the Update Center Wizard's "View Certificates and Install Modules" panel.

3. At this point, the IDE will install the NetBeans module and automatically restart.

4. When you are prompted for the location of the installed J2EE Reference Implementation, either click on the Browse button and locate the J2EE SDK or enter the location in the field and press the OK button.

5. Choose Help Sets->JSR77-JSR88 J2EE IDE Toolkit Software Help from the Help menu and run the three tutorials to learn how to use the Toolkit.

Note: If the location of your J2EE SDK 1.3.1_deployapi installation changes after you install the J2EE Deployment NetBeans module, you need to 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 the J2EE SDK 1.3.1_deployapi application server software is installed.

Start the J2EE SDK 1.3.1_deployapi Application Server

Complete the following steps to start the J2EE SDK 1.3.1_deployapi application server:

1. In your shell environment, set the following environment variables:
   • JAVA_HOME to the directory where you installed the J2SE software
   • J2EE_HOME to the directory where you installed the J2EE SDK 1.3.1_deployapi software
2. In a terminal window, change to the $J2EE_HOME/bin directory and then start the J2EE SDK 1.3.1_deployapi application server:

   cd $J2EE_HOME/bin
   j2ee -verbose