Solaris Installation Notes

The Java 2 Platform,Enterprise Edition (J2EE) Deployment software is part of an integrated package that consists of the following components:

• Java 2 Platform, 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)


• 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 Solaris/SPARC system:

• Download and install the J2SE SDK 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


• Use the J2EE Deployment 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 the Sun ONE Studio software from the Web page.
   
   Note: The J2EE Deployment 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 Deployment 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_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 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_deployapi-1_0-fr-ri-solaris.zip into a temporary directory (for example, /tmp).



3. Change into the temporary directory.



4. Unzip the file j2ee_deployapi-1_0-fr-ri-solaris.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 Software and Install the J2EE Deployment NetBeans Module

Complete the following steps to start the Sun ONE Studio software and install the J2EE Deployment 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 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 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. If you are using Sun ONE Studio 4.0, complete the steps in Use the J2EE Deployment 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_deployapi installation changes after you install the J2EE Deployment 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_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

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

If you installed the J2EE Deployment 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 Deployment Reference Implementation.