Installation Instructions

Document Revised: 17 January 2002

Before you can install the software onto your system, you must download the appropriate bundle from our web site. For instructions on downloading bundles, see the http://java.sun.com/j2ee/sdk_1.3/index.html. While installing the Java^TM 2 SDK Enterprise Edition (J2EE^TM SDK) you should shut down all other applications running on your machine, including anti-virus software. Proceed by following the installation instructions for your platform:

• Installing the Solaris Bundle
• Installing the Windows Bundle
• Installing the Linux Bundle

Note: The J2EE SDK does NOT support Windows 95,Windows 98, or Windows ME. Please see the "Supported Platforms" and "Required Software" sections of the Release Notes. The J2EE SDK FAQ contains information about running the J2EE SDK on unsupported operating systems.

Installing the Solaris 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

Unpacking the bundle automatically creates a subdirectory in this directory called j2sdkee1.3.1. If you have installed a previous version of the J2EE SDK product, you must delete or un-install the previous version from your computer before proceeding with the new version.

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

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

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

Before running the J2EE SDK, you must set these 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.

If you need help setting these variables, see Setting Environment Variables. You need to logout and login again for these changes to take effect.

Installing the Windows Bundle

1. If you have installed a previous version of the J2EE SDK product, you must delete or un-install the previous version from your computer before proceeding with the new version. When you are ready, run the setup program.

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

Before running the J2EE SDK, you must set these environment variables:

• J2EE_HOME - the directory where you 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.

If you need help with setting these variables, see Setting Environment Variables.

Installing the Linux 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

Unpacking the bundle automatically creates a subdirectory in this directory called j2sdkee1.3.1.

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

tar xvzf j2sdkee-1_3_1-linux.tar.gz

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

Before running the J2EE SDK, you must set these 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.

If you need help setting these variables, see Setting Environment Variables. You need to logout and login again for these changes to take effect.

Setting Environment Variables

This section shows how to set environment variables on different operating systems and shells. Each example sets the variable MYVAR to the value widget. The term "local" means that the setting is in effect only for that terminal window. "Global" means that the variable is set for all terminal windows that are subsequently launched.

Unix Bourne and Korn Shells (sh, ksh)

Local:

$ MYVAR=widget
$ export MYVAR

Global:

Edit the $HOME/.profile script so that it includes the preceding assignment and export commands. You need to logout and login again for these changes to take effect.

Local:

$ setenv MYVAR widget

Global:

Edit the $HOME/.login file so that it includes the preceding setenv command. You need to logout and login again for these changes to take effect.

Local:

C:\> SET MYVAR=widget

Global:

Use the System Variables dialog. To reach this dialog, right-click the My Computer icon, select the Properties menu item, and select the Advanced tab. Then click the Environment Variable button. Click the New button, enter the variable name and its value in the New User Variable dialog, and click the OK button

Local:

C:\> SET MYVAR=widget

Global:

Use the System Variables dialog. To reach this dialog, right-click the My Computer icon, select the Properties menu item, and select the Environment tab. Enter the variable name and its value, and click the Set button.

Where do I go from here?

After you've installed the bundle, you can find out more about the J2EE SDK from the following documentation:

• The J2EE Tutorial is a beginner's guide to developing enterprise applications on the J2EE SDK. The Getting Started chapter explains how to code, deploy, and run a simple J2EE application that features a JSP page and an enterprise bean.
• The Java Message Service Tutorial introduces the JMS API to new users and explains how to use the API with the J2EE SDK.
• 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 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.