Java™ 2 SDK, Enterprise Edition - 1.3 Beta Release

   
   
Early Access Index


1.3 Beta Release

Installation Instructions
Document Revised: 2/5/01

Before you can install the software or documentation onto your system, you must download the appropriate bundle from our web site. For instructions on downloading bundles, see the download page. After downloading a bundle, please follow the installation instructions for your platform:

Solaris TM Operating Environment



Windows



Linux



After you've performed the installation, please read the section "Where do I go from here?"

Installing the Solaris Software Bundle

1. Change to the directory where you want to install the software.

 

For example, if you want to install the software under /usr/local you would type this command: 
cd /usr/local

In step 3, unpacking the bundle automatically creates a subdirectory called j2sdkee1.3.



2. If you downloaded the software into multiple files, you must concatenate them together.

 

Note: If you downloaded the software as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting archive. These are the files you have downloaded:

j2sdkee-1_3-beta-solsparc-a.sh
j2sdkee-1_3-beta-solsparc-b.sh
j2sdkee-1_3-beta-solsparc-c.sh
. . .
j2sdkee-1_3-beta-solsparc-j.sh

Execute the following command to concatenate the downloaded files into a single file:

cat j2sdkee-1_3-beta-solsparc-* > j2sdkee-1_3-beta-solsparc.sh


3. Unpack the download bundle.

 

The download bundle for the software is in the j2sdkee-1_3-beta-solsparc.sh file. In the following commands, replace <path> with the actual path of the download bundle:

chmod a+x <path>/j2sdkee-1_3-beta-solsparc.sh
<path>/j2sdkee-1_3-beta-solsparc.sh

After you agree to the license, the j2sdkee1.3 directory is created and the software is installed into it.



4. Edit the user configuration script.

 

The Java 2 SDK, Enterprise Edition relies on the environment variables that are set in the user configuration script. This script is in the userconfig.sh file of the bin directory of your installation.

The userconfig.sh file sets these environment variables:

  • J2EE_CLASSPATH - the classpath referenced by the J2EE server. J2EE_CLASSPATH must include the location of JDBC driver classes (except for those used by the Cloudscape DBMS included in this download bundle). Each location is delimited by a colon. J2EE_CLASSPATH does not need to include the Java 2 SDK, Enterprise Edition classes (j2ee-jar); the Java 2 SDK, Standard Edition software; or the classes contained in the enterprise application.

  • JAVA_HOME - the absolute path of the directory in which the Java 2 SDK, Standard Edition is installed.


Here's an example of how you might edit the userconfig.sh file:

J2EE_CLASSPATH=/opt/oracle/jdbc:/usr/local/db/driver.zip
export J2EE_CLASSPATH

JAVA_HOME=/usr/local/java/jdk1.3
export JAVA_HOME



5. Update the PATH environment variable.

You should update the PATH variable so that it includes the bin directory of this release.


6. Install the documentation.

If you haven't already done so, install the documentation bundle. See the next section for instructions.


7. See "Where do I go from here?"

Installing the Solaris Documentation Bundle

1. If you downloaded the documentation into multiple files, you must concatenate them together.

 

Note: If you downloaded the documentation as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting archive. These are the files you have downloaded: 

j2sdkee-1_3-beta-doc-solsparc-a.zip
j2sdkee-1_3-beta-doc-solsparc-b.zip
j2sdkee-1_3-beta-doc-solsparc-c.zip
. . .
j2sdkee-1_3-beta-doc-solsparc-e.zip



Execute the following command to concatenate the downloaded files into a single file:

cat j2sdkee-1_3-beta-doc-solsparc-* > j2sdkee-1_3-beta-doc-solsparc.zip




2. Change to the directory above the one in which you've installed the software.

 

For example, if you installed the software in /usr/local/j2sdkee1.3 you would type this command: 
cd /usr/local


3. Unpack the download bundle.

 

The download bundle for the documentation is in the j2sdkee-1_3-beta-doc-solsparc.zip file. In the following command, replace <path> with the actual path of the download bundle: 
unzip <path>/j2sdkee-1_3-beta-doc-solsparc.zip
The j2sdkee1.3/doc directory is created and the documentation is installed into it.


4. See "Where do I go from here?"

Installing the Windows Software Bundle

1. If you downloaded the software into multiple files, you must concatenate them together.

 

Note: If you downloaded the software as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting setup program. These are the files you have downloaded: 

j2sdkee-1_3-beta-win-a.exe
j2sdkee-1_3-beta-win-b.exe
j2sdkee-1_3-beta-win-c.exe
. . .
j2sdkee-1_3-beta-win-k.exe



Execute the following command to concatenate the downloaded files into a single file. (You may find it easier to copy this command into a batch file which you will then run.) 

copy /b j2sdkee-1_3-beta-win-a.exe +
j2sdkee-1_3-beta-win-b.exe + j2sdkee-1_3-beta-win-c.exe +
j2sdkee-1_3-beta-win-d.exe + j2sdkee-1_3-beta-win-e.exe +
j2sdkee-1_3-beta-win-f.exe + j2sdkee-1_3-beta-win-g.exe +
j2sdkee-1_3-beta-win-h.exe + j2sdkee-1_3-beta-win-i.exe + 
j2sdkee-1_3-beta-win-j.exe + j2sdkee-1_3-beta-win-k.exe 
j2sdkee-1_3-beta-win.exe



The resulting file (j2sdkee-1_3-beta-win.exe) is a self-extracting InstallShield setup program.



2. Run the setup program.

 

Double-click on the icon of the j2sdkee-1_3-beta-win.exe file, and then follow the instructions provided by the setup program. By default, the setup program installs the software in C:\j2sdkee1.3.

If you install the software after you install the documentation, you should install the software in the parent directory of the documentation.



3. Edit the user configuration script.

 

The Java 2 SDK, Enterprise Edition relies on the environment variables that are set in the user configuration script. This script is in the userconfig.bat file of the bin directory of your installation.

The userconfig.bat file sets these environment variables:

  • J2EE_CLASSPATH - the classpath referenced by the J2EE server. J2EE_CLASSPATH must include the location of JDBC driver classes (except for those used by the Cloudscape DBMS included in this download bundle). Each location is delimited by a semicolon. J2EE_CLASSPATH does not need to include the Java 2 SDK, Enterprise Edition classes (j2ee-jar) or the Java 2 SDK Standard Edition software.

     

  • JAVA_HOME - the directory where the Java 2 SDK Standard Edition is installed.
Here's an example of how you might edit the userconfig.bat file: 
set J2EE_CLASSPATH=C:\oracle\jdbc;C:\db\driver.zip
set JAVA_HOME=C:\jdk1.3




4. Set the environment variables.

 

  • J2EE_HOME - the directory where you've installed this release.
  • JAVA_HOME - the directory where the Java 2 SDK Standard Edition is installed.
  • PATH - include the bin directory beneath the directory where you've installed this release.

You can set the environment variables either with the command-line SET command or with the Environment Variables dialog. To reach this dialog on Windows 2000 Professional, right-click the My Computer icon, select the Properties menu item, select the Advanced tab, and click the Environment Variables button.



5. Install the documentation.

 

If you haven't already done so, install the documentation bundle. See the next section for instructions.


6. See "Where do I go from here?"

Installing the Windows Documentation Bundle

1. If you downloaded the documentation into multiple files, you must concatenate them together.

 

Note: If you downloaded the documentation as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting setup program. These are the files you have downloaded: 

j2sdkee-1_3-beta-doc-win-a.exe
j2sdkee-1_3-beta-doc-win-b.exe
j2sdkee-1_3-beta-doc-win-c.exe
. . .
j2sdkee-1_3-beta-doc-win-f.exe



Execute the following command to concatenate the downloaded files into a single file. (You may find it easier to copy this command into a batch file which you will then run.) 

copy /b j2sdkee-1_3-beta-doc-win-a.exe +
j2sdkee-1_3-beta-doc-win-b.exe + j2sdkee-1_3-beta-doc-win-c.exe +
j2sdkee-1_3-beta-doc-win-d.exe + j2sdkee-1_3-beta-doc-win-e.exe +
j2sdkee-1_3-beta-doc-win-f.exe 
j2sdkee-1_3-beta-doc-win.exe



The resulting file (j2sdkee-1_3-beta-doc-win.exe) is a self-extracting InstallShield setup program.



2. Run the setup program.

 

Double-click on the icon of the j2sdkee-1_3-beta-doc-win.exe file, and then follow the instructions provided by the setup program.

If you install the documentation after you install the software, the setup program chooses the proper directory in which to install the documentation.

3. See "Where do I go from here?"

Installing the Linux Software Bundle

1. Change to the directory where you want to install the software.

 

For example, if you want to install the software under /usr/local you would type this command: 
cd /usr/local


In step 3, unpacking the bundle automatically creates a subdirectory called j2sdkee1.3.



2. If you downloaded the software into multiple files, you must concatenate them together.

 

Note: If you downloaded the software as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting archive. These are the files you have downloaded: 

j2sdkee-1_3-beta-linux-a.tar.gz
j2sdkee-1_3-beta-linux-b.tar.gz
j2sdkee-1_3-beta-linux-c.tar.gz
. . .
j2sdkee-1_3-beta-linux-j.tar.gz



Execute the following command to concatenate the downloaded files into a single file:

cat j2sdkee-1_3-beta-linux-* > j2sdkee-1_3-beta-linux.tar.gz




3. Unpack the download bundle.

 

The download bundle for the software is in the j2sdkee-1_3-beta-linux.tar.gz file. To uncompress and unpack the download bundle bundle, run this command:

tar xvzf j2sdkee-1_3-beta-linux.tar.gz


The j2sdkee1.3 directory is created and the software is installed into it.



4. Edit the user configuration script.

 

The Java 2 SDK, Enterprise Edition relies on the environment variables that are set in the user configuration script. This script is in the userconfig.sh file of the bin directory of your installation.

The userconfig.sh file sets these environment variables:

  • J2EE_CLASSPATH - the classpath referenced by the J2EE server. J2EE_CLASSPATH must include the location of JDBC driver classes (except for those used by the Cloudscape DBMS included in this download bundle). Each location is delimited by a colon. J2EE_CLASSPATH does not need to include the Java 2 SDK, Enterprise Edition classes (j2ee-jar); the Java 2 SDK, Standard Edition software; or the classes contained in the enterprise application.
  • JAVA_HOME - the absolute path of the directory in which the Java 2 SDK, Standard Edition is installed.


Here's an example of how you might edit the userconfig.sh file:

 

J2EE_CLASSPATH=/opt/oracle/jdbc:/usr/local/db/driver.zip
export J2EE_CLASSPATH

JAVA_HOME=/usr/local/java/jdk1.3
export JAVA_HOME





5. Update the PATH environment variable.

 

You should update the PATH variable so that it includes the bin directory of this release.


6. Install the documentation.

 

If you haven't already done so, install the documentation bundle. See the next section for instructions.


7. See "Where do I go from here?"

Installing the Linux Documentation Bundle

1. If you downloaded the documentation into multiple files, you must concatenate them together.

 

Note: If you downloaded the documentation as a single file, you should skip this step.

To concatenate the files, you must have enough disk space for all the individual files plus an equal amount for the resulting self-extracting archive. These are the files you have downloaded:

j2sdkee-1_3-beta-doc-linux-a.tar.gz
j2sdkee-1_3-beta-doc-linux-b.tar.gz
j2sdkee-1_3-beta-doc-linux-c.tar.gz
j2sdkee-1_3-beta-doc-linux-d.tar.gz




2. Change to the directory above the one in which you've installed the software.

 

For example, if you installed the software in /usr/local/j2sdkee1.3 you would type this command: 
cd /usr/local


3. Unpack the download bundle.

 

The download bundle for the documentation is in the j2sdkee-1_3-beta-doc-linux.tar.gz file. To uncompress and unpack the bundle, run this command: 
tar xvzf j2sdkee-1_3-beta-doc-linux.tar.gz


The j2sdkee1.3/doc directory is created and the documentation is installed into it.



4. See "Where do I go from here?"

Where do I go from here?

After you've installed the documentation, you can use your browser to read the following HTML files.

  • The Release Notes list software requirements, supported platforms, and current limitations. The Release Notes are in the doc/release/ReleaseNotes.html file.
  • The Configuration Guide explains how to configure JDBC drivers and various J2EE properties. If you are using the Cloudscape DBMS included with the J2EE software bundle, you do not have to configure the Cloudscape JDBC drivers. The Configuration Guide is in the doc/release/ConfigGuide.html file.
  • The Getting Started chapter explains how to code, deploy, and run a simple client-server application that uses an enterprise bean. The Getting Started chapter is in the doc/guides/ejb/html/Started.fm.html file.
  • The Java Message Service Tutorial has step-by-step examples that feature the JMS API and message-driven beans. The table of contents for the tutorial is in the doc/guides/jms/html/jmsTOC.fm.html file.
  • The main page of the J2EE SDK documentation bundle is in the doc/index.html file. We recommend that you add a bookmark to this file in your browser.


Comments? Please send us feedback at J2EE-beta-feedback@sun.com.