J2EE Tools - J2EE Management Solaris Installation Notes

Print-friendly Version

Solaris Installation Notes

The J2EE Management 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, Community Edition (formerly Forte Community Edition (CE) for Java 3.0)
• Java 2, Enterprise Edition (J2EE) SDK, version 1.3.1_mgmt
• The file j2eemgmt.nbm

The following sections describe the steps needed to download and install these components and run this module on a Solaris/SPARC system.

• Download and install the J2SE SDK and Sun ONE Studio Software
• Install the J2EE SDK 1.3.1_mgmt Software
• Install the J2EE Management Netbeans Module
• Start the J2EE SDK 1.3.1_mgmt Server
• Use the J2EE Management NetBeans Module with the Sun ONE Studio 4.0 Software

Download and Install the J2SE SDK and Sun ONE Studio Software

Complete the following steps to download and install the J2SE SDK and Sun ONE Studio 3.0, Community Edition software on a Solaris/SPARC system:

1. Download the J2SE 1.3.1_02 or 1.3.1_03 SDK for Solaris from the http://java.sun.com/j2se/1.3/ Web site and install. Make sure you install all the appropriate OS patches for the OS.

2. Install the Sun ONE Studio 3.0, Community Edition software for Solaris. 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 software from the Web page.

Note: The J2EE Management software should work with the J2SE 1.4.0 SDK and the Sun ONE Studio 4.0 software if you follow the instructions in Use the J2EE Management NetBeans Module with the Sun ONE Studio 4.0 Software. Our software has not been exhaustively tested with the Sun ONE Studio 4.0 software, but has been with the previously released J2SE 1.4.0 SDK/Sun ONE Studio 3.0, Community Edition cobundle.

Install the J2EE SDK 1.3.1_mgmt Software

Complete the following steps to download and install the J2EE SDK 1.3.1_mgmt software:

1. Set the environment variable JAVA_HOME to the directory where you installed the J2SE SDK software. For example, you could use a C shell to set JAVA_HOME as follows:

   setenv JAVA_HOME install_path

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

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

3. Change into the temporary directory.

4. Unzip the file j2ee_mgmt-1_0-fr-ri-solaris.zip.

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

5. Change to the j2eemgmt/appserver directory.

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

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

Start the Sun ONE Studio Software and Install the J2EE Management NetBeans Module

Complete the following steps to start the Sun ONE Studio software and install the J2EE Management NetBeans module:

1. Change to the $FORTE_INSTALL_DIR/bin directory, where FORTE_INSTALL_DIR is the directory into which you installed the Sun ONE Studio software. Invoke the following script to start the software:

   runide.sh

   Note that the first time you start the Sun ONE Studio software, you will be prompted to enter the name of a directory into which your Sun ONE Studio user files will be written. This directory is referred to as the FORTE_USER_DIR directory.

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 j2eemgmt.nbm file. The file is in the j2eemgmt/tools directory.

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

   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. If you are using Sun ONE Studio 4.0, complete the steps in Use the J2EE Management NetBeans Module with the Sun ONE Studio 4.0 Software.

6. 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_mgmt installation changes after you install the J2EE Management NetBeans module, you need to edit the file $FORTE_INSTALL_DIR/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_mgmt server software is installed.

Start the J2EE SDK 1.3.1_mgmt Server

Complete the following steps to start the J2EE SDK 1.3.1_mgmt server:

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

   cd $J2EE_HOME/bin
   j2ee -verbose

Use the J2EE Management NetBeans Module with the Sun ONE Studio 4.0 Software

If you installed the J2EE Management module with the Sun ONE Studio V4.0 software, you need to complete the following procedure:

1. Move the J2EEDeployAPIPlatforms directory from the $FORTE_INSTALL_DIR/system directory to the $FORTE_USER_DIR/system directory.

2. Create the ext directory under the $FORTE_USER_DIR/modules directory.

3. Move the ManagementClient.ear file from the $FORTE_INSTALL_DIR/modules/ext directory to the $FORTE_USER_DIR/modules/ext directory.

4. Move the j2ee_samples directory from the $FORTE_INSTALL_DIR/sampledir directory to the $FORTE_USER_DIR/sampledir directory.

5. Restart the Sun ONE Studio software.

   You will now be able to work with the J2EE Management Reference Implementation.