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:
SolarisTM 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.
| 
Print-friendly Version
